---
title: "Convert numbers between bases (2..36) and Roman numerals"
method: POST
path: "/number-base.php"
tags: ["data"]
---

# Convert numbers between bases (2..36) and Roman numerals

`POST /number-base.php`

## Request

- Base URL: `https://mate.tools/api/v1`
- URL: `https://mate.tools/api/v1/number-base.php`
- Auth: none declared

Convert any integer between base 2..36 and Roman numerals. Big-int safe when GMP is available. Pass `from_base` as integer 2..36 or "roman"; `to_bases` is an array of the same.

## Request body

- object
  - `value` string, required
  - `from_base` union
    - integer
    - string
  - `to_bases` unknown[]
    - unknown

## Response `200`

Success

## Other responses

- `400`: Malformed request
- `429`: Rate limit exceeded (60/min, 600/hour per IP). Includes Retry-After header.

---

[API](https://skmtc.dev/mate/apis/mate-tools-api.md) · [All operations](https://skmtc.dev/mate/apis/mate-tools-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mate/apis/mate-tools-api/revisions/874670b78962?raw)