# Generate UUIDs

`POST /v1/generate/uuid/{version}`

Generates between 1 and 100 version 4 UUIDs, or a single version 1 UUID (time based UUIDs generated in a burst can collide). The body is optional and defaults to one UUID.

## Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| version | one of: v1, v4 | yes |  |

## Request body

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| count | integer | no | Number of IDs to generate (1-100) (default `1`) |

## Example request

A request body that works, as JSON.

```json
{}
```

## Response

The fields inside `data` of a successful response.

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| ids | array of string | yes | Generated IDs |
| type | string | yes | Type of IDs generated |
| count | integer | yes | Number of IDs generated |

## Example response

A real answer from the operation, as JSON. The fields in the table above are inside `data`.

```json
{
  "data": {
    "ids": [
      "c737fba0-d1d6-11f1-be36-65815f19c660"
    ],
    "type": "uuid_v1",
    "count": 1
  },
  "errors": null,
  "meta": {
    "request_id": "f9513326-cd1c-46d8-aff2-50cc6d150a50",
    "timestamp": "2026-10-27T07:19:42.073824Z",
    "version": "2026-03-26"
  },
  "pagination": null
}
```

## Responses

| Status | When it happens |
| --- | --- |
| 200 | Successful Response |
| 400 | The body respects the operation schema, but the use case rejected it. Each problem is one ApiError entry |
| 413 | The request is larger than the request size limit of the API allows |
| 422 | The body does not respect the operation schema. Each problem is one ApiError entry with the code validation_error |
| 500 | Something failed inside the server and was not an input problem. The same envelope, errors may be empty |

---
Source: https://skillfulsardine.com/developers/api/generate-uuid/