Numbers roman
Exactnumbers_romanDeterministic and authoritative — the canonical answer for this input.
Convert between integers and Roman numerals (1–3999). A numeric input becomes a numeral; a numeral becomes an integer (canonical form is validated, so 'IIII' is rejected). Processing multiple inputs? Use `numbers_roman_batch` to do up to 1000 in one call.
Parameters
valuestringrequiredAn integer (1–3999) or a Roman numeral.
Call it
curl -X POST https://api.snipget.ai/v1/numbers/roman \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{"value":"1994"}'The Batch tab sends up to 1000 inputs in one call via /v1/numbers/roman/batch.
Example response
{
"input": "1994",
"is_valid": true,
"direction": "int_to_roman",
"output": "MCMXCIV",
"value": 1994
}FAQ
Which direction does it convert?
Both. A number becomes a Roman numeral (1994 becomes MCMXCIV) and a numeral becomes a number (MCMXCIV becomes 1994). It detects the direction from the input, and the result's direction field tells you which way it went.
What range of numbers is supported?
1 through 3999, the range classic Roman numerals can express. Zero, negatives, fractions, and 4000+ (which needs overline notation) all come back as invalid with a reason.
Does it accept sloppy numerals like IIII?
No. Lowercase is fine (mcmxciv works), but non-standard forms like IIII or IM are rejected: every numeral is round-trip validated against its canonical spelling, so you can trust an accepted numeral is well-formed.
What happens with an invalid input?
You get a result with confidence 0 and a reason (out of range, or not a valid numeral), never an error, so batch runs over messy data do not blow up.