{"openapi":"3.1.0","info":{"title":"Locale Format API","version":"0.1.0","description":"Verified, CLDR-versioned locale formatting for ~700 locales: currency amounts, numbers, dates and the raw rules — plus a verify endpoint to check your own output. Formatting per CLDR conventions — informational, not legal advice.","x-guidance":"All endpoints are GET with query parameters, $0.001 each via x402 (USDC on Base). Use /v1/currency, /v1/number, /v1/datetime to format values for a BCP 47 locale (de-DE, de-CH, en-IN, ja-JP, ar-EG …); /v1/rules for a locale's raw conventions (separators, symbol position, date order); /v1/verify to check a string YOU formatted against the canonical CLDR output before putting it in an invoice or document. Every response carries the CLDR/ICU version (source) for auditability. GET /v1/locales and /health are free.","contact":{"email":"paulos@voiceagenten.com"}},"paths":{"/v1/currency":{"get":{"operationId":"formatCurrency","summary":"Format a currency amount per CLDR for a locale","tags":["Format"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"amount","in":"query","required":true,"description":"amount, '.' as decimal separator","schema":{"type":"number"}},{"name":"currency","in":"query","required":true,"description":"ISO 4217 code","schema":{"type":"string"}},{"name":"locale","in":"query","required":true,"description":"BCP 47 locale tag, e.g. de-DE, de-CH, en-IN, ja-JP, ar-EG","schema":{"type":"string"}},{"name":"display","in":"query","required":false,"description":"symbol|narrowSymbol|code|name","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"formatted":{"type":"string"},"resolvedLocale":{"type":"string"},"source":{"type":"string"},"verifiedAt":{"type":"string"},"parts":{"type":"object"}},"required":["formatted"]}}}},"402":{"description":"Payment Required"}}}},"/v1/number":{"get":{"operationId":"formatNumber","summary":"Format a number/percent per CLDR for a locale","tags":["Format"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"value","in":"query","required":true,"description":"the number","schema":{"type":"number"}},{"name":"locale","in":"query","required":true,"description":"BCP 47 locale tag, e.g. de-DE, de-CH, en-IN, ja-JP, ar-EG","schema":{"type":"string"}},{"name":"style","in":"query","required":false,"description":"decimal|percent","schema":{"type":"string"}},{"name":"digits","in":"query","required":false,"description":"0-20","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"formatted":{"type":"string"},"resolvedLocale":{"type":"string"},"source":{"type":"string"},"verifiedAt":{"type":"string"},"numberingSystem":{"type":"string"}},"required":["formatted"]}}}},"402":{"description":"Payment Required"}}}},"/v1/datetime":{"get":{"operationId":"formatDatetime","summary":"Format an ISO date/time per CLDR for a locale","tags":["Format"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"iso","in":"query","required":true,"description":"ISO 8601 date/datetime","schema":{"type":"string"}},{"name":"locale","in":"query","required":true,"description":"BCP 47 locale tag, e.g. de-DE, de-CH, en-IN, ja-JP, ar-EG","schema":{"type":"string"}},{"name":"dateStyle","in":"query","required":false,"description":"full|long|medium|short","schema":{"type":"string"}},{"name":"timeStyle","in":"query","required":false,"description":"full|long|medium|short","schema":{"type":"string"}},{"name":"timeZone","in":"query","required":false,"description":"IANA zone","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"formatted":{"type":"string"},"resolvedLocale":{"type":"string"},"source":{"type":"string"},"verifiedAt":{"type":"string"},"hourCycle":{"type":["string","null"]}},"required":["formatted"]}}}},"402":{"description":"Payment Required"}}}},"/v1/rules":{"get":{"operationId":"localeRules","summary":"Raw CLDR formatting rules for a locale","tags":["Rules"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"locale","in":"query","required":true,"description":"BCP 47 locale tag, e.g. de-DE, de-CH, en-IN, ja-JP, ar-EG","schema":{"type":"string"}},{"name":"currency","in":"query","required":false,"description":"ISO 4217 for currency rules (default USD)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"decimalSeparator":{"type":["string","null"]},"groupSeparator":{"type":["string","null"]},"currencyPosition":{"type":"string"},"dateOrder":{"type":"string"},"firstDayOfWeek":{"type":["integer","null"]},"resolvedLocale":{"type":"string"}},"required":["decimalSeparator"]}}}},"402":{"description":"Payment Required"}}}},"/v1/verify":{"get":{"operationId":"verifyFormatting","summary":"Verify your own formatted string against canonical CLDR output","tags":["Verify"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"type","in":"query","required":true,"description":"currency|number|datetime","schema":{"type":"string"}},{"name":"formatted","in":"query","required":true,"description":"string to verify","schema":{"type":"string"}},{"name":"locale","in":"query","required":true,"description":"BCP 47 locale tag, e.g. de-DE, de-CH, en-IN, ja-JP, ar-EG","schema":{"type":"string"}},{"name":"amount","in":"query","required":false,"description":"for type=currency","schema":{"type":"number"}},{"name":"currency","in":"query","required":false,"description":"for type=currency","schema":{"type":"string"}},{"name":"value","in":"query","required":false,"description":"for type=number","schema":{"type":"number"}},{"name":"iso","in":"query","required":false,"description":"for type=datetime","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"valid":{"type":"boolean"},"expected":{"type":"string"},"differences":{"type":"array","items":{"type":"string"}}},"required":["valid","expected"]}}}},"402":{"description":"Payment Required"}}}},"/v1/locales":{"get":{"operationId":"listLocales","summary":"Free list of supported locales","responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer"},"locales":{"type":"array","items":{"type":"string"}}},"required":["locales"]}}}}}}},"/health":{"get":{"operationId":"health","summary":"Free health + CLDR version check","responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"source":{"type":"string"}},"required":["status"]}}}}}}}}}