The platform · data.castomapi.com
Data
Free global reference data: countries, languages, currencies, logistics, standards — tens of millions of records, no key.
The reference tables every product needs and nobody wants to maintain: ISO codes, dialling codes, time zones, currencies with their minor units, ports, airports, HS codes, units, and more. Read-only, CORS open, GET only, the same envelope everywhere.
It is served as a PHP port on shared hosting on purpose — reference data has to survive the rest of the estate being rebuilt.
Operations
| Method | Path | Description |
|---|---|---|
| GET | /v1/address-schemas/{countryCode} | Get Country Postal Address Layout Schema |
| GET | /v1/airports/search | Search Airports & Aviation Hubs |
| GET | /v1/airports/{countryCode} | Get Airports by Country Code |
| GET | /v1/calling-codes/{countryCode} | Get E.164 Calling Prefix & Area Codes by Country |
| GET | /v1/cities/country/{countryCode} | Get Cities by Country Code |
| GET | /v1/cities/nearby | Find Cities Near a Point |
| GET | /v1/cities/search | Search Cities & Populated Places |
| GET | /v1/cities/{id} | Get a City by GeoNames ID |
| GET | /v1/continents | Get Continents (English Default) |
| GET | /v1/continents/{lang} | Get Continents by Language Path |
| GET | /v1/countries | Get All Countries (English Default) |
| GET | /v1/countries/{lang} | Get All Countries by Language Path |
| GET | /v1/countries/{lang}/{code} | Get Country by Code & Language Path |
| GET | /v1/currencies | Get All Currencies (English Default) |
| GET | /v1/currencies/{lang} | Get All Currencies by Language Path |
| GET | /v1/currencies/{lang}/{code} | Get Currency by Code & Language Path |
| GET | /v1/currency-rules/{currencyCode} | Get Currency Formatting Rules & Precision |
| GET | /v1/demonyms/{countryCode} | Get Demonyms for Country (English Default) |
| GET | /v1/demonyms/{countryCode}/{lang} | Get Demonyms for Country by Language Path |
| GET | /v1/dialects | Get Dialects (English Default) |
| GET | /v1/dialects/{lang} | Get Dialects by Language Path |
| GET | /v1/exchange-rates/history/{currency} | Get ECB Reference Rate History for One Currency |
| GET | /v1/exchange-rates/latest | Get Latest ECB Reference Rates (base EUR) |
| GET | /v1/exchange-rates/latest/{currency} | Get Latest ECB Reference Rate for One Currency |
| GET | /v1/exchange-rates/on/{date} | Get All ECB Reference Rates for a Specific Date |
| GET | /v1/exchange-rates/{from}/{to} | Convert Between Two Currencies (triangulated through EUR) |
| GET | /v1/exonyms/search | Search Multilingual Exonyms |
| GET | /v1/holidays/{countryCode}/{year} | Get National & Bank Holidays by Country and Year |
| GET | /v1/languages | Get Languages (English Default) |
| GET | /v1/languages/{lang} | Get Languages by Language Path |
| GET | /v1/locales | Get CLDR Locales |
| GET | /v1/observances | List religious observances |
| GET | /v1/places/country/{countryCode} | Get Geographic Features by Country |
| GET | /v1/places/search | Search All Geographic Features |
| GET | /v1/places/{id} | Get a Geographic Feature by GeoNames ID |
| GET | /v1/places/{id}/names | Get Alternate Names for a Place |
| GET | /v1/places/{id}/parents | Get the Administrative Breadcrumb for a Place |
| GET | /v1/postal-codes/search | Search Postal & Zip Codes |
| GET | /v1/postal-codes/{countryCode}/{postalCode} | Lookup Postal Code by Country |
| GET | /v1/prayer-times | Compute salah times for a place and date |
| GET | /v1/prayer-times/methods | List salah calculation conventions |
| GET | /v1/prayers | List prayers |
| GET | /v1/prayers/search | Search prayer wording |
| GET | /v1/prayers/{code}/{lang} | Get a prayer's wording in a language |
| GET | /v1/religions | List religions |
| GET | /v1/religions/{code} | Get a religion |
| GET | /v1/religions/{code}/denominations | List denominations of a religion |
| GET | /v1/scripts | Get Writing Systems & Scripts (ISO 15924) |
| GET | /v1/scripture/editions/{editionId}/{book}/{chapter} | Get a chapter of a scripture edition |
| GET | /v1/scripture/search | Full-text search across ingested scripture |
| GET | /v1/scripture/texts | List sacred texts and the reach of their edition catalogue |
| GET | /v1/scripture/texts/{textCode}/editions | List editions of a sacred text |
| GET | /v1/seaports/search | Search Seaports & Trade Locations (UN/LOCODE) |
| GET | /v1/seaports/{countryCode} | Get Seaports by Country Code |
| GET | /v1/subdivisions/{countryCode} | Get Subdivisions by Country (English Default) |
| GET | /v1/subdivisions/{countryCode}/{lang} | Get Subdivisions by Country & Language Path |
| GET | /v1/timezones | Get All Timezones (English Default) |
| GET | /v1/timezones/{lang} | Get All Timezones by Language Path |
| GET | /v1/units | Get All Measurement Units (UCUM) |
| GET | /v1/units/{category} | Get Measurement Units by Category |
| GET | /v1/vehicles/makes | List vehicle brands |
| GET | /v1/vehicles/makes/search | Search vehicle brands |
| GET | /v1/vehicles/makes/{id} | Get a vehicle brand by id |
| GET | /v1/vehicles/makes/{id}/models | List models of a vehicle brand |
| GET | /v1/vehicles/manufacturers/{countryCode} | List vehicle manufacturers by country |
| GET | /v1/vehicles/models/search | Search vehicle models |
| GET | /v1/vehicles/models/{id} | Get a vehicle model by id |
| GET | /v1/vehicles/vin/{vin} | Decode a VIN |
| GET | /v1/vehicles/wmi/{wmi} | Look up a World Manufacturer Identifier |
Base URL: https://data.castomapi.com · Open the live docs
The platform
Auth
One identity for every product: sign-in, sessions, OAuth clients, projects and the revocation keys every service checks.
Billing & plans
Plan entitlements for every castomo product: Stripe subscriptions in, effective quotas out, pushed to the product that enforces them.
Pay
Payments between people and businesses on the platform, with Stripe underneath.
Book
Bookings and availability: resources, slots, reservations, reminders and refunds by policy.
Events
A free global events API: what is happening where, for dashboards and sites that need a calendar they did not write.
Query
Read-only SQL and document queries against the customer's own MySQL, PostgreSQL or MongoDB, from a browser, safely.