# Generate random strings

`POST /v1/generate/string/{charset}`

Generates between 1 and 100 random strings made of letters and digits, hexadecimal characters or digits only. The body is optional and sets the count and the length.

## Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| charset | one of: alphanumeric, hex, digits | yes |  |

## Request body

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| count | integer | no | Number of IDs to generate (1-100) (default `1`) |
| length | integer | no | Length of the random string (3-32 characters) (default `16`) |

## Example request

A request body that works, as JSON.

```json
{
  "length": 16
}
```

## 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": [
      "E1fhkCtirys4fzl3"
    ],
    "type": "random_alphanumeric",
    "count": 1
  },
  "errors": null,
  "meta": {
    "request_id": "bb88085c-d067-4303-8520-e9cbae0b3694",
    "timestamp": "2026-10-27T07:19:42.077743Z",
    "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-random-string/