Endpoint
POST https://requiems.xyz/v1/technology/base/batch
Batch Convert Base
Convert up to 50 numbers between bases in a single request. Results are returned in input order. Per-item errors are reported inline.
Parameters
| Name |
Type |
Required |
Location |
Description |
items |
array |
yes |
body |
List of conversion requests (1–50 items). |
items[].from |
integer |
yes |
body |
Source base (2, 8, 10, or 16). |
items[].to |
integer |
yes |
body |
Target base (2, 8, 10, or 16). |
items[].value |
string |
yes |
body |
The number as a string. Accepts optional prefixes: 0x (hex), 0b (binary), 0o (octal). |
Request Example
{
"items": [
{ "from": 10, "to": 16, "value": "255" },
{ "from": 2, "to": 10, "value": "1111" }
]
}
Response Example
{
"data": {
"results": [
{ "from": 10, "to": 16, "input": "255", "result": "ff" },
{ "from": 2, "to": 10, "input": "1111", "result": "15" }
],
"total": 2
},
"metadata": { "timestamp": "2026-01-01T00:00:00Z" }
}
Response Fields
| Field |
Type |
Description |
results |
array |
Per-item results in input order. |
results[].from |
integer |
The source base used for conversion. |
results[].to |
integer |
The target base used for conversion. |
results[].input |
string |
The original value as provided in the request. |
results[].result |
string |
The converted value in the target base (omitted on error). |
results[].error |
string |
Error message if this item failed (omitted on success). |
total |
integer |
Total number of items processed. |
Errors
422 validation_failed — The items array is missing, empty, or exceeds 50 items.400 bad_request — The request body is missing or malformed.
1---2name: number-base-conversion-post-batch3description: Convert up to 50 numbers between bases in a single request. Results are returned in input order. Per-item errors are reported inline.4---5
6## Endpoint
7
8**POST https://requiems.xyz/v1/technology/base/batch**
9
10## Batch Convert Base
11
12Convert up to 50 numbers between bases in a single request. Results are returned in input order. Per-item errors are reported inline.
13
14## Parameters
15
16| Name | Type | Required | Location | Description |
17| ---- | ---- | -------- | -------- | ----------- |
18| `items` | array<object> | yes | body | List of conversion requests (1–50 items). |
19| `items[].from` | integer | yes | body | Source base (2, 8, 10, or 16). |
20| `items[].to` | integer | yes | body | Target base (2, 8, 10, or 16). |
21| `items[].value` | string | yes | body | The number as a string. Accepts optional prefixes: 0x (hex), 0b (binary), 0o (octal). |
22
23## Request Example
24
25```json
26{
27 "items": [
28 { "from": 10, "to": 16, "value": "255" },
29 { "from": 2, "to": 10, "value": "1111" }
30 ]
31}
32```
33
34## Response Example
35
36```json
37{
38 "data": {
39 "results": [
40 { "from": 10, "to": 16, "input": "255", "result": "ff" },
41 { "from": 2, "to": 10, "input": "1111", "result": "15" }
42 ],
43 "total": 2
44 },
45 "metadata": { "timestamp": "2026-01-01T00:00:00Z" }
46}
47```
48
49## Response Fields
50
51| Field | Type | Description |
52| ----- | ---- | ----------- |
53| `results` | array<object> | Per-item results in input order. |
54| `results[].from` | integer | The source base used for conversion. |
55| `results[].to` | integer | The target base used for conversion. |
56| `results[].input` | string | The original value as provided in the request. |
57| `results[].result` | string | The converted value in the target base (omitted on error). |
58| `results[].error` | string | Error message if this item failed (omitted on success). |
59| `total` | integer | Total number of items processed. |
60
61## Errors
62
63- `422` **validation_failed** — The items array is missing, empty, or exceeds 50 items.
64- `400` **bad_request** — The request body is missing or malformed.
gabrielmoreira