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