{"openapi":"3.0.3","info":{"title":"castomAPI Free Global Reference Infrastructure","description":"Free, open, zero-authentication public reference data API serving 34M+ standardized records across geography, languages, currencies, logistics, and global standards.","version":"1.0.0"},"servers":[{"url":"https://data.castomapi.com","description":"Production Cloudflare Edge CDN"}],"tags":[{"name":"Geographic & Places","description":"Continents, countries, administrative subdivisions, cities, and postal codes."},{"name":"Linguistics & Localization","description":"Languages, dialects, writing systems, locales, exonyms, and demonyms."},{"name":"Financials & Commerce","description":"ISO currencies, minor unit rules, and country postal address layout schemas."},{"name":"Logistics & Infrastructure","description":"Global airports (IATA/ICAO) and seaport clearance ports (UN/LOCODE)."},{"name":"Time & Global Standards","description":"IANA timezones, E.164 dialing prefixes, public bank holidays, and UCUM units."}],"paths":{"/health":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"ok","type":"string"},"countries":{"type":"number"},"places":{"type":"boolean"},"scripture":{"type":"boolean"}},"required":["status","countries","places","scripture"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"ok","type":"string"},"countries":{"type":"number"},"places":{"type":"boolean"},"scripture":{"type":"boolean"}},"required":["status","countries","places","scripture"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"ok","type":"string"},"countries":{"type":"number"},"places":{"type":"boolean"},"scripture":{"type":"boolean"}},"required":["status","countries","places","scripture"]}}}},"503":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"unavailable","type":"string"},"countries":{"type":"number"},"places":{"type":"boolean"},"scripture":{"type":"boolean"}},"required":["status","countries","places","scripture"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"unavailable","type":"string"},"countries":{"type":"number"},"places":{"type":"boolean"},"scripture":{"type":"boolean"}},"required":["status","countries","places","scripture"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"unavailable","type":"string"},"countries":{"type":"number"},"places":{"type":"boolean"},"scripture":{"type":"boolean"}},"required":["status","countries","places","scripture"]}}}}},"operationId":"getHealth","summary":"Service Health Check","tags":["Time & Global Standards"]}},"/v1/continents":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","name","latitude","longitude"],"properties":{"code":{"example":"EU","type":"string"},"name":{"example":"Europe","type":"string"},"latitude":{"nullable":true,"anyOf":[{"example":54.526,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":15.2551,"type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","name","latitude","longitude"],"properties":{"code":{"example":"EU","type":"string"},"name":{"example":"Europe","type":"string"},"latitude":{"nullable":true,"anyOf":[{"example":54.526,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":15.2551,"type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","name","latitude","longitude"],"properties":{"code":{"example":"EU","type":"string"},"name":{"example":"Europe","type":"string"},"latitude":{"nullable":true,"anyOf":[{"example":54.526,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":15.2551,"type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1Continents","summary":"Get Continents (English Default)","tags":["Geographic & Places"]}},"/v1/continents/{lang}":{"get":{"parameters":[{"description":"ISO 639-1 language code","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","minLength":2,"maxLength":2,"example":"pl"},"in":"path","name":"lang","required":true}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","name","latitude","longitude"],"properties":{"code":{"example":"EU","type":"string"},"name":{"example":"Europe","type":"string"},"latitude":{"nullable":true,"anyOf":[{"example":54.526,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":15.2551,"type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","name","latitude","longitude"],"properties":{"code":{"example":"EU","type":"string"},"name":{"example":"Europe","type":"string"},"latitude":{"nullable":true,"anyOf":[{"example":54.526,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":15.2551,"type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","name","latitude","longitude"],"properties":{"code":{"example":"EU","type":"string"},"name":{"example":"Europe","type":"string"},"latitude":{"nullable":true,"anyOf":[{"example":54.526,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":15.2551,"type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1ContinentsByLang","summary":"Get Continents by Language Path","tags":["Geographic & Places"]}},"/v1/countries":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","name","capital","region","subregion","continentCode","isoAlpha3","isoNumeric","currency","phoneCode","latitude","longitude"],"properties":{"code":{"example":"US","type":"string"},"name":{"example":"United States","type":"string"},"capital":{"nullable":true,"anyOf":[{"example":"Washington, D.C.","type":"string"},{"type":"null"}]},"region":{"example":"Americas","type":"string"},"subregion":{"nullable":true,"anyOf":[{"example":"Northern America","type":"string"},{"type":"null"}]},"continentCode":{"example":"NA","type":"string"},"isoAlpha3":{"example":"USA","type":"string"},"isoNumeric":{"example":"840","type":"string"},"currency":{"example":"USD","type":"string"},"phoneCode":{"nullable":true,"anyOf":[{"example":"+1","type":"string"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","name","capital","region","subregion","continentCode","isoAlpha3","isoNumeric","currency","phoneCode","latitude","longitude"],"properties":{"code":{"example":"US","type":"string"},"name":{"example":"United States","type":"string"},"capital":{"nullable":true,"anyOf":[{"example":"Washington, D.C.","type":"string"},{"type":"null"}]},"region":{"example":"Americas","type":"string"},"subregion":{"nullable":true,"anyOf":[{"example":"Northern America","type":"string"},{"type":"null"}]},"continentCode":{"example":"NA","type":"string"},"isoAlpha3":{"example":"USA","type":"string"},"isoNumeric":{"example":"840","type":"string"},"currency":{"example":"USD","type":"string"},"phoneCode":{"nullable":true,"anyOf":[{"example":"+1","type":"string"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","name","capital","region","subregion","continentCode","isoAlpha3","isoNumeric","currency","phoneCode","latitude","longitude"],"properties":{"code":{"example":"US","type":"string"},"name":{"example":"United States","type":"string"},"capital":{"nullable":true,"anyOf":[{"example":"Washington, D.C.","type":"string"},{"type":"null"}]},"region":{"example":"Americas","type":"string"},"subregion":{"nullable":true,"anyOf":[{"example":"Northern America","type":"string"},{"type":"null"}]},"continentCode":{"example":"NA","type":"string"},"isoAlpha3":{"example":"USA","type":"string"},"isoNumeric":{"example":"840","type":"string"},"currency":{"example":"USD","type":"string"},"phoneCode":{"nullable":true,"anyOf":[{"example":"+1","type":"string"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1Countries","summary":"Get All Countries (English Default)","tags":["Geographic & Places"]}},"/v1/countries/{lang}":{"get":{"parameters":[{"description":"ISO 639-1 language code","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","minLength":2,"maxLength":2,"example":"pl"},"in":"path","name":"lang","required":true}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","name","capital","region","subregion","continentCode","isoAlpha3","isoNumeric","currency","phoneCode","latitude","longitude"],"properties":{"code":{"example":"US","type":"string"},"name":{"example":"United States","type":"string"},"capital":{"nullable":true,"anyOf":[{"example":"Washington, D.C.","type":"string"},{"type":"null"}]},"region":{"example":"Americas","type":"string"},"subregion":{"nullable":true,"anyOf":[{"example":"Northern America","type":"string"},{"type":"null"}]},"continentCode":{"example":"NA","type":"string"},"isoAlpha3":{"example":"USA","type":"string"},"isoNumeric":{"example":"840","type":"string"},"currency":{"example":"USD","type":"string"},"phoneCode":{"nullable":true,"anyOf":[{"example":"+1","type":"string"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","name","capital","region","subregion","continentCode","isoAlpha3","isoNumeric","currency","phoneCode","latitude","longitude"],"properties":{"code":{"example":"US","type":"string"},"name":{"example":"United States","type":"string"},"capital":{"nullable":true,"anyOf":[{"example":"Washington, D.C.","type":"string"},{"type":"null"}]},"region":{"example":"Americas","type":"string"},"subregion":{"nullable":true,"anyOf":[{"example":"Northern America","type":"string"},{"type":"null"}]},"continentCode":{"example":"NA","type":"string"},"isoAlpha3":{"example":"USA","type":"string"},"isoNumeric":{"example":"840","type":"string"},"currency":{"example":"USD","type":"string"},"phoneCode":{"nullable":true,"anyOf":[{"example":"+1","type":"string"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","name","capital","region","subregion","continentCode","isoAlpha3","isoNumeric","currency","phoneCode","latitude","longitude"],"properties":{"code":{"example":"US","type":"string"},"name":{"example":"United States","type":"string"},"capital":{"nullable":true,"anyOf":[{"example":"Washington, D.C.","type":"string"},{"type":"null"}]},"region":{"example":"Americas","type":"string"},"subregion":{"nullable":true,"anyOf":[{"example":"Northern America","type":"string"},{"type":"null"}]},"continentCode":{"example":"NA","type":"string"},"isoAlpha3":{"example":"USA","type":"string"},"isoNumeric":{"example":"840","type":"string"},"currency":{"example":"USD","type":"string"},"phoneCode":{"nullable":true,"anyOf":[{"example":"+1","type":"string"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1CountriesByLang","summary":"Get All Countries by Language Path","tags":["Geographic & Places"]}},"/v1/countries/{lang}/{code}":{"get":{"parameters":[{"description":"ISO 639-1 language code","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","minLength":2,"maxLength":2,"example":"pl"},"in":"path","name":"lang","required":true},{"description":"ISO 3166-1 alpha-2 or alpha-3 country code","schema":{"type":"string","pattern":"^[A-Za-z]{2,3}$","minLength":2,"maxLength":3,"example":"POL"},"in":"path","name":"code","required":true}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["code","name","capital","region","subregion","continentCode","isoAlpha3","isoNumeric","currency","phoneCode","latitude","longitude"],"properties":{"code":{"example":"US","type":"string"},"name":{"example":"United States","type":"string"},"capital":{"nullable":true,"anyOf":[{"example":"Washington, D.C.","type":"string"},{"type":"null"}]},"region":{"example":"Americas","type":"string"},"subregion":{"nullable":true,"anyOf":[{"example":"Northern America","type":"string"},{"type":"null"}]},"continentCode":{"example":"NA","type":"string"},"isoAlpha3":{"example":"USA","type":"string"},"isoNumeric":{"example":"840","type":"string"},"currency":{"example":"USD","type":"string"},"phoneCode":{"nullable":true,"anyOf":[{"example":"+1","type":"string"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["code","name","capital","region","subregion","continentCode","isoAlpha3","isoNumeric","currency","phoneCode","latitude","longitude"],"properties":{"code":{"example":"US","type":"string"},"name":{"example":"United States","type":"string"},"capital":{"nullable":true,"anyOf":[{"example":"Washington, D.C.","type":"string"},{"type":"null"}]},"region":{"example":"Americas","type":"string"},"subregion":{"nullable":true,"anyOf":[{"example":"Northern America","type":"string"},{"type":"null"}]},"continentCode":{"example":"NA","type":"string"},"isoAlpha3":{"example":"USA","type":"string"},"isoNumeric":{"example":"840","type":"string"},"currency":{"example":"USD","type":"string"},"phoneCode":{"nullable":true,"anyOf":[{"example":"+1","type":"string"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["code","name","capital","region","subregion","continentCode","isoAlpha3","isoNumeric","currency","phoneCode","latitude","longitude"],"properties":{"code":{"example":"US","type":"string"},"name":{"example":"United States","type":"string"},"capital":{"nullable":true,"anyOf":[{"example":"Washington, D.C.","type":"string"},{"type":"null"}]},"region":{"example":"Americas","type":"string"},"subregion":{"nullable":true,"anyOf":[{"example":"Northern America","type":"string"},{"type":"null"}]},"continentCode":{"example":"NA","type":"string"},"isoAlpha3":{"example":"USA","type":"string"},"isoNumeric":{"example":"840","type":"string"},"currency":{"example":"USD","type":"string"},"phoneCode":{"nullable":true,"anyOf":[{"example":"+1","type":"string"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]}}}},"required":["status","data"]}}}},"404":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1CountriesByLangByCode","summary":"Get Country by Code & Language Path","tags":["Geographic & Places"]}},"/v1/subdivisions/{countryCode}":{"get":{"parameters":[{"description":"ISO 3166-1 alpha-2 country code","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","minLength":2,"maxLength":2,"example":"PL"},"in":"path","name":"countryCode","required":true}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","countryCode","name","type","latitude","longitude"],"properties":{"code":{"example":"US-CA","type":"string"},"countryCode":{"example":"US","type":"string"},"name":{"example":"California","type":"string"},"type":{"example":"State","type":"string"},"latitude":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","countryCode","name","type","latitude","longitude"],"properties":{"code":{"example":"US-CA","type":"string"},"countryCode":{"example":"US","type":"string"},"name":{"example":"California","type":"string"},"type":{"example":"State","type":"string"},"latitude":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","countryCode","name","type","latitude","longitude"],"properties":{"code":{"example":"US-CA","type":"string"},"countryCode":{"example":"US","type":"string"},"name":{"example":"California","type":"string"},"type":{"example":"State","type":"string"},"latitude":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1SubdivisionsByCountryCode","summary":"Get Subdivisions by Country (English Default)","tags":["Geographic & Places"]}},"/v1/subdivisions/{countryCode}/{lang}":{"get":{"parameters":[{"description":"ISO 3166-1 alpha-2 country code","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","minLength":2,"maxLength":2,"example":"PL"},"in":"path","name":"countryCode","required":true},{"description":"ISO 639-1 language code","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","minLength":2,"maxLength":2,"example":"pl"},"in":"path","name":"lang","required":true}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","countryCode","name","type","latitude","longitude"],"properties":{"code":{"example":"US-CA","type":"string"},"countryCode":{"example":"US","type":"string"},"name":{"example":"California","type":"string"},"type":{"example":"State","type":"string"},"latitude":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","countryCode","name","type","latitude","longitude"],"properties":{"code":{"example":"US-CA","type":"string"},"countryCode":{"example":"US","type":"string"},"name":{"example":"California","type":"string"},"type":{"example":"State","type":"string"},"latitude":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","countryCode","name","type","latitude","longitude"],"properties":{"code":{"example":"US-CA","type":"string"},"countryCode":{"example":"US","type":"string"},"name":{"example":"California","type":"string"},"type":{"example":"State","type":"string"},"latitude":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1SubdivisionsByCountryCodeByLang","summary":"Get Subdivisions by Country & Language Path","tags":["Geographic & Places"]}},"/v1/cities/search":{"get":{"parameters":[{"description":"Search query string (e.g. Warsaw, Los Angeles)","schema":{"type":"string"},"in":"query","name":"q","required":true},{"schema":{"minimum":1,"maximum":200,"default":50,"anyOf":[{"format":"integer","default":0,"type":"string"},{"minimum":1,"maximum":200,"default":50,"type":"integer"}]},"in":"query","name":"limit","required":false}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","name","countryCode","subdivisionCode","featureCode","population","latitude","longitude","elevation","timezone"],"properties":{"id":{"example":756135,"description":"GeoNames geonameid; stable across reseeds","type":"number"},"name":{"example":"Warsaw","type":"string"},"countryCode":{"example":"PL","type":"string"},"subdivisionCode":{"nullable":true,"anyOf":[{"example":"PL-14","type":"string"},{"type":"null"}]},"featureCode":{"nullable":true,"anyOf":[{"example":"PPLC","description":"GeoNames populated-place code: PPLC national capital, PPLA first-order admin seat, PPLA2–PPLA4 lower admin seats, PPL ordinary place, PPLX section of a place","type":"string"},{"type":"null"}]},"population":{"nullable":true,"anyOf":[{"example":1795000,"type":"number"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":52.2297,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":21.0122,"type":"number"},{"type":"null"}]},"elevation":{"nullable":true,"anyOf":[{"example":113,"description":"Metres above sea level","type":"number"},{"type":"null"}]},"timezone":{"nullable":true,"anyOf":[{"example":"Europe/Warsaw","type":"string"},{"type":"null"}]}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","name","countryCode","subdivisionCode","featureCode","population","latitude","longitude","elevation","timezone"],"properties":{"id":{"example":756135,"description":"GeoNames geonameid; stable across reseeds","type":"number"},"name":{"example":"Warsaw","type":"string"},"countryCode":{"example":"PL","type":"string"},"subdivisionCode":{"nullable":true,"anyOf":[{"example":"PL-14","type":"string"},{"type":"null"}]},"featureCode":{"nullable":true,"anyOf":[{"example":"PPLC","description":"GeoNames populated-place code: PPLC national capital, PPLA first-order admin seat, PPLA2–PPLA4 lower admin seats, PPL ordinary place, PPLX section of a place","type":"string"},{"type":"null"}]},"population":{"nullable":true,"anyOf":[{"example":1795000,"type":"number"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":52.2297,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":21.0122,"type":"number"},{"type":"null"}]},"elevation":{"nullable":true,"anyOf":[{"example":113,"description":"Metres above sea level","type":"number"},{"type":"null"}]},"timezone":{"nullable":true,"anyOf":[{"example":"Europe/Warsaw","type":"string"},{"type":"null"}]}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","name","countryCode","subdivisionCode","featureCode","population","latitude","longitude","elevation","timezone"],"properties":{"id":{"example":756135,"description":"GeoNames geonameid; stable across reseeds","type":"number"},"name":{"example":"Warsaw","type":"string"},"countryCode":{"example":"PL","type":"string"},"subdivisionCode":{"nullable":true,"anyOf":[{"example":"PL-14","type":"string"},{"type":"null"}]},"featureCode":{"nullable":true,"anyOf":[{"example":"PPLC","description":"GeoNames populated-place code: PPLC national capital, PPLA first-order admin seat, PPLA2–PPLA4 lower admin seats, PPL ordinary place, PPLX section of a place","type":"string"},{"type":"null"}]},"population":{"nullable":true,"anyOf":[{"example":1795000,"type":"number"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":52.2297,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":21.0122,"type":"number"},{"type":"null"}]},"elevation":{"nullable":true,"anyOf":[{"example":113,"description":"Metres above sea level","type":"number"},{"type":"null"}]},"timezone":{"nullable":true,"anyOf":[{"example":"Europe/Warsaw","type":"string"},{"type":"null"}]}}}}},"required":["status","data"]}}}},"400":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1CitiesSearch","summary":"Search Cities & Populated Places","description":"Sub-millisecond trigram full-text search across the curated populated-place set. Coverage depends on the GEONAMES_DATASET the database was built with. For the full 13.4M-feature GeoNames corpus — terrain, water, parks, buildings — use `/v1/places/search`.","tags":["Geographic & Places"]}},"/v1/cities/nearby":{"get":{"parameters":[{"description":"Latitude in decimal degrees","schema":{"minimum":-90,"maximum":90,"example":52.2297,"anyOf":[{"format":"numeric","default":0,"type":"string"},{"minimum":-90,"maximum":90,"description":"Latitude in decimal degrees","example":52.2297,"type":"number"}]},"in":"query","name":"lat","required":true},{"description":"Longitude in decimal degrees","schema":{"minimum":-180,"maximum":180,"example":21.0122,"anyOf":[{"format":"numeric","default":0,"type":"string"},{"minimum":-180,"maximum":180,"description":"Longitude in decimal degrees","example":21.0122,"type":"number"}]},"in":"query","name":"lon","required":true},{"description":"Search radius in kilometres","schema":{"minimum":0.1,"maximum":500,"default":25,"example":25,"anyOf":[{"format":"numeric","default":0,"type":"string"},{"minimum":0.1,"maximum":500,"default":25,"description":"Search radius in kilometres","example":25,"type":"number"}]},"in":"query","name":"radius","required":false},{"schema":{"minimum":1,"maximum":200,"default":50,"anyOf":[{"format":"integer","default":0,"type":"string"},{"minimum":1,"maximum":200,"default":50,"type":"integer"}]},"in":"query","name":"limit","required":false}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","name","countryCode","subdivisionCode","featureCode","population","latitude","longitude","elevation","timezone","distanceKm"],"properties":{"id":{"example":756135,"description":"GeoNames geonameid; stable across reseeds","type":"number"},"name":{"example":"Warsaw","type":"string"},"countryCode":{"example":"PL","type":"string"},"subdivisionCode":{"nullable":true,"anyOf":[{"example":"PL-14","type":"string"},{"type":"null"}]},"featureCode":{"nullable":true,"anyOf":[{"example":"PPLC","description":"GeoNames populated-place code: PPLC national capital, PPLA first-order admin seat, PPLA2–PPLA4 lower admin seats, PPL ordinary place, PPLX section of a place","type":"string"},{"type":"null"}]},"population":{"nullable":true,"anyOf":[{"example":1795000,"type":"number"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":52.2297,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":21.0122,"type":"number"},{"type":"null"}]},"elevation":{"nullable":true,"anyOf":[{"example":113,"description":"Metres above sea level","type":"number"},{"type":"null"}]},"timezone":{"nullable":true,"anyOf":[{"example":"Europe/Warsaw","type":"string"},{"type":"null"}]},"distanceKm":{"example":3.2,"description":"Great-circle distance from the queried point","type":"number"}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","name","countryCode","subdivisionCode","featureCode","population","latitude","longitude","elevation","timezone","distanceKm"],"properties":{"id":{"example":756135,"description":"GeoNames geonameid; stable across reseeds","type":"number"},"name":{"example":"Warsaw","type":"string"},"countryCode":{"example":"PL","type":"string"},"subdivisionCode":{"nullable":true,"anyOf":[{"example":"PL-14","type":"string"},{"type":"null"}]},"featureCode":{"nullable":true,"anyOf":[{"example":"PPLC","description":"GeoNames populated-place code: PPLC national capital, PPLA first-order admin seat, PPLA2–PPLA4 lower admin seats, PPL ordinary place, PPLX section of a place","type":"string"},{"type":"null"}]},"population":{"nullable":true,"anyOf":[{"example":1795000,"type":"number"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":52.2297,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":21.0122,"type":"number"},{"type":"null"}]},"elevation":{"nullable":true,"anyOf":[{"example":113,"description":"Metres above sea level","type":"number"},{"type":"null"}]},"timezone":{"nullable":true,"anyOf":[{"example":"Europe/Warsaw","type":"string"},{"type":"null"}]},"distanceKm":{"example":3.2,"description":"Great-circle distance from the queried point","type":"number"}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","name","countryCode","subdivisionCode","featureCode","population","latitude","longitude","elevation","timezone","distanceKm"],"properties":{"id":{"example":756135,"description":"GeoNames geonameid; stable across reseeds","type":"number"},"name":{"example":"Warsaw","type":"string"},"countryCode":{"example":"PL","type":"string"},"subdivisionCode":{"nullable":true,"anyOf":[{"example":"PL-14","type":"string"},{"type":"null"}]},"featureCode":{"nullable":true,"anyOf":[{"example":"PPLC","description":"GeoNames populated-place code: PPLC national capital, PPLA first-order admin seat, PPLA2–PPLA4 lower admin seats, PPL ordinary place, PPLX section of a place","type":"string"},{"type":"null"}]},"population":{"nullable":true,"anyOf":[{"example":1795000,"type":"number"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":52.2297,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":21.0122,"type":"number"},{"type":"null"}]},"elevation":{"nullable":true,"anyOf":[{"example":113,"description":"Metres above sea level","type":"number"},{"type":"null"}]},"timezone":{"nullable":true,"anyOf":[{"example":"Europe/Warsaw","type":"string"},{"type":"null"}]},"distanceKm":{"example":3.2,"description":"Great-circle distance from the queried point","type":"number"}}}}},"required":["status","data"]}}}},"400":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1CitiesNearby","summary":"Find Cities Near a Point","description":"Cities within `radius` kilometres of a coordinate, nearest first, with the great-circle distance on each result. Cities with no coordinates are excluded.","tags":["Geographic & Places"]}},"/v1/cities/country/{countryCode}":{"get":{"parameters":[{"description":"ISO 3166-1 alpha-2 country code","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","minLength":2,"maxLength":2,"example":"PL"},"in":"path","name":"countryCode","required":true},{"schema":{"minimum":1,"maximum":500,"default":100,"anyOf":[{"format":"integer","default":0,"type":"string"},{"minimum":1,"maximum":500,"default":100,"type":"integer"}]},"in":"query","name":"limit","required":false},{"description":"Opaque cursor from a previous response's nextCursor; do not construct one","schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,256}$","maxLength":256,"example":"MTc0MDAwMCA3NTYxMzU"},"in":"query","name":"cursor","required":false}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","name","countryCode","subdivisionCode","featureCode","population","latitude","longitude","elevation","timezone"],"properties":{"id":{"example":756135,"description":"GeoNames geonameid; stable across reseeds","type":"number"},"name":{"example":"Warsaw","type":"string"},"countryCode":{"example":"PL","type":"string"},"subdivisionCode":{"nullable":true,"anyOf":[{"example":"PL-14","type":"string"},{"type":"null"}]},"featureCode":{"nullable":true,"anyOf":[{"example":"PPLC","description":"GeoNames populated-place code: PPLC national capital, PPLA first-order admin seat, PPLA2–PPLA4 lower admin seats, PPL ordinary place, PPLX section of a place","type":"string"},{"type":"null"}]},"population":{"nullable":true,"anyOf":[{"example":1795000,"type":"number"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":52.2297,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":21.0122,"type":"number"},{"type":"null"}]},"elevation":{"nullable":true,"anyOf":[{"example":113,"description":"Metres above sea level","type":"number"},{"type":"null"}]},"timezone":{"nullable":true,"anyOf":[{"example":"Europe/Warsaw","type":"string"},{"type":"null"}]}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","name","countryCode","subdivisionCode","featureCode","population","latitude","longitude","elevation","timezone"],"properties":{"id":{"example":756135,"description":"GeoNames geonameid; stable across reseeds","type":"number"},"name":{"example":"Warsaw","type":"string"},"countryCode":{"example":"PL","type":"string"},"subdivisionCode":{"nullable":true,"anyOf":[{"example":"PL-14","type":"string"},{"type":"null"}]},"featureCode":{"nullable":true,"anyOf":[{"example":"PPLC","description":"GeoNames populated-place code: PPLC national capital, PPLA first-order admin seat, PPLA2–PPLA4 lower admin seats, PPL ordinary place, PPLX section of a place","type":"string"},{"type":"null"}]},"population":{"nullable":true,"anyOf":[{"example":1795000,"type":"number"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":52.2297,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":21.0122,"type":"number"},{"type":"null"}]},"elevation":{"nullable":true,"anyOf":[{"example":113,"description":"Metres above sea level","type":"number"},{"type":"null"}]},"timezone":{"nullable":true,"anyOf":[{"example":"Europe/Warsaw","type":"string"},{"type":"null"}]}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","name","countryCode","subdivisionCode","featureCode","population","latitude","longitude","elevation","timezone"],"properties":{"id":{"example":756135,"description":"GeoNames geonameid; stable across reseeds","type":"number"},"name":{"example":"Warsaw","type":"string"},"countryCode":{"example":"PL","type":"string"},"subdivisionCode":{"nullable":true,"anyOf":[{"example":"PL-14","type":"string"},{"type":"null"}]},"featureCode":{"nullable":true,"anyOf":[{"example":"PPLC","description":"GeoNames populated-place code: PPLC national capital, PPLA first-order admin seat, PPLA2–PPLA4 lower admin seats, PPL ordinary place, PPLX section of a place","type":"string"},{"type":"null"}]},"population":{"nullable":true,"anyOf":[{"example":1795000,"type":"number"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":52.2297,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":21.0122,"type":"number"},{"type":"null"}]},"elevation":{"nullable":true,"anyOf":[{"example":113,"description":"Metres above sea level","type":"number"},{"type":"null"}]},"timezone":{"nullable":true,"anyOf":[{"example":"Europe/Warsaw","type":"string"},{"type":"null"}]}}}}},"required":["status","data"]}}}},"400":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1CitiesCountryByCountryCode","summary":"Get Cities by Country Code","description":"Retrieves populated places for a country ordered by population.","tags":["Geographic & Places"]}},"/v1/cities/{id}":{"get":{"parameters":[{"description":"GeoNames geonameid","schema":{"minimum":1,"anyOf":[{"format":"integer","default":0,"type":"string"},{"minimum":1,"description":"GeoNames geonameid","type":"integer"}]},"in":"path","name":"id","required":true}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["id","name","countryCode","subdivisionCode","featureCode","population","latitude","longitude","elevation","timezone"],"properties":{"id":{"example":756135,"description":"GeoNames geonameid; stable across reseeds","type":"number"},"name":{"example":"Warsaw","type":"string"},"countryCode":{"example":"PL","type":"string"},"subdivisionCode":{"nullable":true,"anyOf":[{"example":"PL-14","type":"string"},{"type":"null"}]},"featureCode":{"nullable":true,"anyOf":[{"example":"PPLC","description":"GeoNames populated-place code: PPLC national capital, PPLA first-order admin seat, PPLA2–PPLA4 lower admin seats, PPL ordinary place, PPLX section of a place","type":"string"},{"type":"null"}]},"population":{"nullable":true,"anyOf":[{"example":1795000,"type":"number"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":52.2297,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":21.0122,"type":"number"},{"type":"null"}]},"elevation":{"nullable":true,"anyOf":[{"example":113,"description":"Metres above sea level","type":"number"},{"type":"null"}]},"timezone":{"nullable":true,"anyOf":[{"example":"Europe/Warsaw","type":"string"},{"type":"null"}]}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["id","name","countryCode","subdivisionCode","featureCode","population","latitude","longitude","elevation","timezone"],"properties":{"id":{"example":756135,"description":"GeoNames geonameid; stable across reseeds","type":"number"},"name":{"example":"Warsaw","type":"string"},"countryCode":{"example":"PL","type":"string"},"subdivisionCode":{"nullable":true,"anyOf":[{"example":"PL-14","type":"string"},{"type":"null"}]},"featureCode":{"nullable":true,"anyOf":[{"example":"PPLC","description":"GeoNames populated-place code: PPLC national capital, PPLA first-order admin seat, PPLA2–PPLA4 lower admin seats, PPL ordinary place, PPLX section of a place","type":"string"},{"type":"null"}]},"population":{"nullable":true,"anyOf":[{"example":1795000,"type":"number"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":52.2297,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":21.0122,"type":"number"},{"type":"null"}]},"elevation":{"nullable":true,"anyOf":[{"example":113,"description":"Metres above sea level","type":"number"},{"type":"null"}]},"timezone":{"nullable":true,"anyOf":[{"example":"Europe/Warsaw","type":"string"},{"type":"null"}]}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["id","name","countryCode","subdivisionCode","featureCode","population","latitude","longitude","elevation","timezone"],"properties":{"id":{"example":756135,"description":"GeoNames geonameid; stable across reseeds","type":"number"},"name":{"example":"Warsaw","type":"string"},"countryCode":{"example":"PL","type":"string"},"subdivisionCode":{"nullable":true,"anyOf":[{"example":"PL-14","type":"string"},{"type":"null"}]},"featureCode":{"nullable":true,"anyOf":[{"example":"PPLC","description":"GeoNames populated-place code: PPLC national capital, PPLA first-order admin seat, PPLA2–PPLA4 lower admin seats, PPL ordinary place, PPLX section of a place","type":"string"},{"type":"null"}]},"population":{"nullable":true,"anyOf":[{"example":1795000,"type":"number"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":52.2297,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":21.0122,"type":"number"},{"type":"null"}]},"elevation":{"nullable":true,"anyOf":[{"example":113,"description":"Metres above sea level","type":"number"},{"type":"null"}]},"timezone":{"nullable":true,"anyOf":[{"example":"Europe/Warsaw","type":"string"},{"type":"null"}]}}}},"required":["status","data"]}}}},"400":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}},"404":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1CitiesById","summary":"Get a City by GeoNames ID","description":"The identifier is the GeoNames geonameid and is stable across reseeds, so it is safe to store against a record of your own.","tags":["Geographic & Places"]}},"/v1/places/search":{"get":{"parameters":[{"description":"Search query (e.g. Everest, Danube, Warsaw)","schema":{"type":"string"},"in":"query","name":"q","required":true},{"description":"GeoNames feature class: A admin, H water, L parks, P populated, R roads, S spots, T terrain, U undersea, V forest","schema":{"type":"string","pattern":"^[AHLPRSTUVahlprstuv]$","minLength":1,"maxLength":1,"example":"P"},"in":"query","name":"class","required":false},{"schema":{"minimum":1,"maximum":200,"default":50,"anyOf":[{"format":"integer","default":0,"type":"string"},{"minimum":1,"maximum":200,"default":50,"type":"integer"}]},"in":"query","name":"limit","required":false}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","name","asciiName","countryCode","featureClass","featureCode","admin1Code","admin2Code","latitude","longitude","population","elevation","timezone"],"properties":{"id":{"example":756135,"description":"GeoNames geonameid","type":"number"},"name":{"example":"Warsaw","type":"string"},"asciiName":{"nullable":true,"anyOf":[{"example":"Warsaw","type":"string"},{"type":"null"}]},"countryCode":{"nullable":true,"anyOf":[{"example":"PL","type":"string"},{"type":"null"}]},"featureClass":{"nullable":true,"anyOf":[{"example":"P","description":"A, H, L, P, R, S, T, U or V","type":"string"},{"type":"null"}]},"featureCode":{"nullable":true,"anyOf":[{"example":"PPLC","type":"string"},{"type":"null"}]},"admin1Code":{"nullable":true,"anyOf":[{"example":"78","type":"string"},{"type":"null"}]},"admin2Code":{"nullable":true,"anyOf":[{"example":"1465","type":"string"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":52.22977,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":21.01178,"type":"number"},{"type":"null"}]},"population":{"nullable":true,"anyOf":[{"example":1702139,"type":"number"},{"type":"null"}]},"elevation":{"nullable":true,"anyOf":[{"example":113,"type":"number"},{"type":"null"}]},"timezone":{"nullable":true,"anyOf":[{"example":"Europe/Warsaw","type":"string"},{"type":"null"}]}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","name","asciiName","countryCode","featureClass","featureCode","admin1Code","admin2Code","latitude","longitude","population","elevation","timezone"],"properties":{"id":{"example":756135,"description":"GeoNames geonameid","type":"number"},"name":{"example":"Warsaw","type":"string"},"asciiName":{"nullable":true,"anyOf":[{"example":"Warsaw","type":"string"},{"type":"null"}]},"countryCode":{"nullable":true,"anyOf":[{"example":"PL","type":"string"},{"type":"null"}]},"featureClass":{"nullable":true,"anyOf":[{"example":"P","description":"A, H, L, P, R, S, T, U or V","type":"string"},{"type":"null"}]},"featureCode":{"nullable":true,"anyOf":[{"example":"PPLC","type":"string"},{"type":"null"}]},"admin1Code":{"nullable":true,"anyOf":[{"example":"78","type":"string"},{"type":"null"}]},"admin2Code":{"nullable":true,"anyOf":[{"example":"1465","type":"string"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":52.22977,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":21.01178,"type":"number"},{"type":"null"}]},"population":{"nullable":true,"anyOf":[{"example":1702139,"type":"number"},{"type":"null"}]},"elevation":{"nullable":true,"anyOf":[{"example":113,"type":"number"},{"type":"null"}]},"timezone":{"nullable":true,"anyOf":[{"example":"Europe/Warsaw","type":"string"},{"type":"null"}]}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","name","asciiName","countryCode","featureClass","featureCode","admin1Code","admin2Code","latitude","longitude","population","elevation","timezone"],"properties":{"id":{"example":756135,"description":"GeoNames geonameid","type":"number"},"name":{"example":"Warsaw","type":"string"},"asciiName":{"nullable":true,"anyOf":[{"example":"Warsaw","type":"string"},{"type":"null"}]},"countryCode":{"nullable":true,"anyOf":[{"example":"PL","type":"string"},{"type":"null"}]},"featureClass":{"nullable":true,"anyOf":[{"example":"P","description":"A, H, L, P, R, S, T, U or V","type":"string"},{"type":"null"}]},"featureCode":{"nullable":true,"anyOf":[{"example":"PPLC","type":"string"},{"type":"null"}]},"admin1Code":{"nullable":true,"anyOf":[{"example":"78","type":"string"},{"type":"null"}]},"admin2Code":{"nullable":true,"anyOf":[{"example":"1465","type":"string"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":52.22977,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":21.01178,"type":"number"},{"type":"null"}]},"population":{"nullable":true,"anyOf":[{"example":1702139,"type":"number"},{"type":"null"}]},"elevation":{"nullable":true,"anyOf":[{"example":113,"type":"number"},{"type":"null"}]},"timezone":{"nullable":true,"anyOf":[{"example":"Europe/Warsaw","type":"string"},{"type":"null"}]}}}}},"required":["status","data"]}}}},"400":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1PlacesSearch","summary":"Search All Geographic Features","description":"Trigram search across 13.4M GeoNames features — populated places, terrain, water, parks, roads and undersea features. Filter with `class` to narrow to one feature class.","tags":["Geographic & Places"]}},"/v1/places/country/{countryCode}":{"get":{"parameters":[{"description":"ISO 3166-1 alpha-2 country code","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","minLength":2,"maxLength":2,"example":"PL"},"in":"path","name":"countryCode","required":true},{"description":"GeoNames feature class: A admin, H water, L parks, P populated, R roads, S spots, T terrain, U undersea, V forest","schema":{"type":"string","pattern":"^[AHLPRSTUVahlprstuv]$","minLength":1,"maxLength":1,"example":"P"},"in":"query","name":"class","required":false},{"schema":{"minimum":1,"maximum":500,"default":100,"anyOf":[{"format":"integer","default":0,"type":"string"},{"minimum":1,"maximum":500,"default":100,"type":"integer"}]},"in":"query","name":"limit","required":false},{"description":"Opaque cursor from a previous response's nextCursor; do not construct one","schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,256}$","maxLength":256,"example":"MTc0MDAwMCA3NTYxMzU"},"in":"query","name":"cursor","required":false}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","name","asciiName","countryCode","featureClass","featureCode","admin1Code","admin2Code","latitude","longitude","population","elevation","timezone"],"properties":{"id":{"example":756135,"description":"GeoNames geonameid","type":"number"},"name":{"example":"Warsaw","type":"string"},"asciiName":{"nullable":true,"anyOf":[{"example":"Warsaw","type":"string"},{"type":"null"}]},"countryCode":{"nullable":true,"anyOf":[{"example":"PL","type":"string"},{"type":"null"}]},"featureClass":{"nullable":true,"anyOf":[{"example":"P","description":"A, H, L, P, R, S, T, U or V","type":"string"},{"type":"null"}]},"featureCode":{"nullable":true,"anyOf":[{"example":"PPLC","type":"string"},{"type":"null"}]},"admin1Code":{"nullable":true,"anyOf":[{"example":"78","type":"string"},{"type":"null"}]},"admin2Code":{"nullable":true,"anyOf":[{"example":"1465","type":"string"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":52.22977,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":21.01178,"type":"number"},{"type":"null"}]},"population":{"nullable":true,"anyOf":[{"example":1702139,"type":"number"},{"type":"null"}]},"elevation":{"nullable":true,"anyOf":[{"example":113,"type":"number"},{"type":"null"}]},"timezone":{"nullable":true,"anyOf":[{"example":"Europe/Warsaw","type":"string"},{"type":"null"}]}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","name","asciiName","countryCode","featureClass","featureCode","admin1Code","admin2Code","latitude","longitude","population","elevation","timezone"],"properties":{"id":{"example":756135,"description":"GeoNames geonameid","type":"number"},"name":{"example":"Warsaw","type":"string"},"asciiName":{"nullable":true,"anyOf":[{"example":"Warsaw","type":"string"},{"type":"null"}]},"countryCode":{"nullable":true,"anyOf":[{"example":"PL","type":"string"},{"type":"null"}]},"featureClass":{"nullable":true,"anyOf":[{"example":"P","description":"A, H, L, P, R, S, T, U or V","type":"string"},{"type":"null"}]},"featureCode":{"nullable":true,"anyOf":[{"example":"PPLC","type":"string"},{"type":"null"}]},"admin1Code":{"nullable":true,"anyOf":[{"example":"78","type":"string"},{"type":"null"}]},"admin2Code":{"nullable":true,"anyOf":[{"example":"1465","type":"string"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":52.22977,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":21.01178,"type":"number"},{"type":"null"}]},"population":{"nullable":true,"anyOf":[{"example":1702139,"type":"number"},{"type":"null"}]},"elevation":{"nullable":true,"anyOf":[{"example":113,"type":"number"},{"type":"null"}]},"timezone":{"nullable":true,"anyOf":[{"example":"Europe/Warsaw","type":"string"},{"type":"null"}]}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","name","asciiName","countryCode","featureClass","featureCode","admin1Code","admin2Code","latitude","longitude","population","elevation","timezone"],"properties":{"id":{"example":756135,"description":"GeoNames geonameid","type":"number"},"name":{"example":"Warsaw","type":"string"},"asciiName":{"nullable":true,"anyOf":[{"example":"Warsaw","type":"string"},{"type":"null"}]},"countryCode":{"nullable":true,"anyOf":[{"example":"PL","type":"string"},{"type":"null"}]},"featureClass":{"nullable":true,"anyOf":[{"example":"P","description":"A, H, L, P, R, S, T, U or V","type":"string"},{"type":"null"}]},"featureCode":{"nullable":true,"anyOf":[{"example":"PPLC","type":"string"},{"type":"null"}]},"admin1Code":{"nullable":true,"anyOf":[{"example":"78","type":"string"},{"type":"null"}]},"admin2Code":{"nullable":true,"anyOf":[{"example":"1465","type":"string"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":52.22977,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":21.01178,"type":"number"},{"type":"null"}]},"population":{"nullable":true,"anyOf":[{"example":1702139,"type":"number"},{"type":"null"}]},"elevation":{"nullable":true,"anyOf":[{"example":113,"type":"number"},{"type":"null"}]},"timezone":{"nullable":true,"anyOf":[{"example":"Europe/Warsaw","type":"string"},{"type":"null"}]}}}}},"required":["status","data"]}}}},"400":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1PlacesCountryByCountryCode","summary":"Get Geographic Features by Country","description":"Ordered by population. Narrow with `class` — e.g. `?class=T` for terrain.","tags":["Geographic & Places"]}},"/v1/places/{id}/names":{"get":{"parameters":[{"description":"GeoNames geonameid","schema":{"minimum":1,"anyOf":[{"format":"integer","default":0,"type":"string"},{"minimum":1,"description":"GeoNames geonameid","type":"integer"}]},"in":"path","name":"id","required":true},{"description":"ISO 639-1 language code","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","minLength":2,"maxLength":2,"example":"pl"},"in":"query","name":"lang","required":false},{"schema":{"minimum":1,"maximum":500,"default":100,"anyOf":[{"format":"integer","default":0,"type":"string"},{"minimum":1,"maximum":500,"default":100,"type":"integer"}]},"in":"query","name":"limit","required":false}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["name","langCode","isPreferred","isShort","isColloquial","isHistoric"],"properties":{"name":{"example":"Warszawa","type":"string"},"langCode":{"nullable":true,"anyOf":[{"example":"pl","type":"string"},{"type":"null"}]},"isPreferred":{"example":0,"type":"number"},"isShort":{"example":0,"type":"number"},"isColloquial":{"example":0,"type":"number"},"isHistoric":{"example":0,"type":"number"}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["name","langCode","isPreferred","isShort","isColloquial","isHistoric"],"properties":{"name":{"example":"Warszawa","type":"string"},"langCode":{"nullable":true,"anyOf":[{"example":"pl","type":"string"},{"type":"null"}]},"isPreferred":{"example":0,"type":"number"},"isShort":{"example":0,"type":"number"},"isColloquial":{"example":0,"type":"number"},"isHistoric":{"example":0,"type":"number"}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["name","langCode","isPreferred","isShort","isColloquial","isHistoric"],"properties":{"name":{"example":"Warszawa","type":"string"},"langCode":{"nullable":true,"anyOf":[{"example":"pl","type":"string"},{"type":"null"}]},"isPreferred":{"example":0,"type":"number"},"isShort":{"example":0,"type":"number"},"isColloquial":{"example":0,"type":"number"},"isHistoric":{"example":0,"type":"number"}}}}},"required":["status","data"]}}}},"400":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}},"404":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1PlacesByIdNames","summary":"Get Alternate Names for a Place","description":"Localized, historical and colloquial variants from the 19M-row GeoNames alternate-name set. Filter by `lang`.","tags":["Geographic & Places"]}},"/v1/places/{id}/parents":{"get":{"parameters":[{"description":"GeoNames geonameid","schema":{"minimum":1,"anyOf":[{"format":"integer","default":0,"type":"string"},{"minimum":1,"description":"GeoNames geonameid","type":"integer"}]},"in":"path","name":"id","required":true},{"description":"ISO 639-1 language code","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","minLength":2,"maxLength":2,"example":"pl"},"in":"query","name":"lang","required":false}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["level","code","name","geonameId"],"properties":{"level":{"description":"Administrative depth of this rung, outermost first","anyOf":[{"const":"country","type":"string"},{"const":"admin1","type":"string"},{"const":"admin2","type":"string"}]},"code":{"example":"PL.78","description":"ISO 3166-1 alpha-2 at country level, GeoNames dotted key below it","type":"string"},"name":{"nullable":true,"anyOf":[{"example":"Mazovia","type":"string"},{"type":"null"}]},"geonameId":{"nullable":true,"anyOf":[{"example":858787,"description":"The feature that is this division — resolvable via /v1/places/:id","type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["level","code","name","geonameId"],"properties":{"level":{"description":"Administrative depth of this rung, outermost first","anyOf":[{"const":"country","type":"string"},{"const":"admin1","type":"string"},{"const":"admin2","type":"string"}]},"code":{"example":"PL.78","description":"ISO 3166-1 alpha-2 at country level, GeoNames dotted key below it","type":"string"},"name":{"nullable":true,"anyOf":[{"example":"Mazovia","type":"string"},{"type":"null"}]},"geonameId":{"nullable":true,"anyOf":[{"example":858787,"description":"The feature that is this division — resolvable via /v1/places/:id","type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["level","code","name","geonameId"],"properties":{"level":{"description":"Administrative depth of this rung, outermost first","anyOf":[{"const":"country","type":"string"},{"const":"admin1","type":"string"},{"const":"admin2","type":"string"}]},"code":{"example":"PL.78","description":"ISO 3166-1 alpha-2 at country level, GeoNames dotted key below it","type":"string"},"name":{"nullable":true,"anyOf":[{"example":"Mazovia","type":"string"},{"type":"null"}]},"geonameId":{"nullable":true,"anyOf":[{"example":858787,"description":"The feature that is this division — resolvable via /v1/places/:id","type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}}}},"400":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}},"404":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1PlacesByIdParents","summary":"Get the Administrative Breadcrumb for a Place","description":"The administrative chain containing this feature, outermost first: country, then first- and second-level division. Resolved from the GeoNames admin codes on the feature itself, so it answers for 99.9% of features at level 1 and 85% at level 2 — a feature carrying no second-level code returns a two-rung chain rather than a guess. Division names are localized from the alternate-name set via `lang`, falling back to the GeoNames default. Note these are FIPS 10-4 codes, not ISO 3166-2: use /v1/subdivisions for the ISO view.","tags":["Geographic & Places"]}},"/v1/places/{id}":{"get":{"parameters":[{"description":"GeoNames geonameid","schema":{"minimum":1,"anyOf":[{"format":"integer","default":0,"type":"string"},{"minimum":1,"description":"GeoNames geonameid","type":"integer"}]},"in":"path","name":"id","required":true}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["id","name","asciiName","countryCode","featureClass","featureCode","admin1Code","admin2Code","latitude","longitude","population","elevation","timezone"],"properties":{"id":{"example":756135,"description":"GeoNames geonameid","type":"number"},"name":{"example":"Warsaw","type":"string"},"asciiName":{"nullable":true,"anyOf":[{"example":"Warsaw","type":"string"},{"type":"null"}]},"countryCode":{"nullable":true,"anyOf":[{"example":"PL","type":"string"},{"type":"null"}]},"featureClass":{"nullable":true,"anyOf":[{"example":"P","description":"A, H, L, P, R, S, T, U or V","type":"string"},{"type":"null"}]},"featureCode":{"nullable":true,"anyOf":[{"example":"PPLC","type":"string"},{"type":"null"}]},"admin1Code":{"nullable":true,"anyOf":[{"example":"78","type":"string"},{"type":"null"}]},"admin2Code":{"nullable":true,"anyOf":[{"example":"1465","type":"string"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":52.22977,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":21.01178,"type":"number"},{"type":"null"}]},"population":{"nullable":true,"anyOf":[{"example":1702139,"type":"number"},{"type":"null"}]},"elevation":{"nullable":true,"anyOf":[{"example":113,"type":"number"},{"type":"null"}]},"timezone":{"nullable":true,"anyOf":[{"example":"Europe/Warsaw","type":"string"},{"type":"null"}]}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["id","name","asciiName","countryCode","featureClass","featureCode","admin1Code","admin2Code","latitude","longitude","population","elevation","timezone"],"properties":{"id":{"example":756135,"description":"GeoNames geonameid","type":"number"},"name":{"example":"Warsaw","type":"string"},"asciiName":{"nullable":true,"anyOf":[{"example":"Warsaw","type":"string"},{"type":"null"}]},"countryCode":{"nullable":true,"anyOf":[{"example":"PL","type":"string"},{"type":"null"}]},"featureClass":{"nullable":true,"anyOf":[{"example":"P","description":"A, H, L, P, R, S, T, U or V","type":"string"},{"type":"null"}]},"featureCode":{"nullable":true,"anyOf":[{"example":"PPLC","type":"string"},{"type":"null"}]},"admin1Code":{"nullable":true,"anyOf":[{"example":"78","type":"string"},{"type":"null"}]},"admin2Code":{"nullable":true,"anyOf":[{"example":"1465","type":"string"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":52.22977,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":21.01178,"type":"number"},{"type":"null"}]},"population":{"nullable":true,"anyOf":[{"example":1702139,"type":"number"},{"type":"null"}]},"elevation":{"nullable":true,"anyOf":[{"example":113,"type":"number"},{"type":"null"}]},"timezone":{"nullable":true,"anyOf":[{"example":"Europe/Warsaw","type":"string"},{"type":"null"}]}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["id","name","asciiName","countryCode","featureClass","featureCode","admin1Code","admin2Code","latitude","longitude","population","elevation","timezone"],"properties":{"id":{"example":756135,"description":"GeoNames geonameid","type":"number"},"name":{"example":"Warsaw","type":"string"},"asciiName":{"nullable":true,"anyOf":[{"example":"Warsaw","type":"string"},{"type":"null"}]},"countryCode":{"nullable":true,"anyOf":[{"example":"PL","type":"string"},{"type":"null"}]},"featureClass":{"nullable":true,"anyOf":[{"example":"P","description":"A, H, L, P, R, S, T, U or V","type":"string"},{"type":"null"}]},"featureCode":{"nullable":true,"anyOf":[{"example":"PPLC","type":"string"},{"type":"null"}]},"admin1Code":{"nullable":true,"anyOf":[{"example":"78","type":"string"},{"type":"null"}]},"admin2Code":{"nullable":true,"anyOf":[{"example":"1465","type":"string"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":52.22977,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":21.01178,"type":"number"},{"type":"null"}]},"population":{"nullable":true,"anyOf":[{"example":1702139,"type":"number"},{"type":"null"}]},"elevation":{"nullable":true,"anyOf":[{"example":113,"type":"number"},{"type":"null"}]},"timezone":{"nullable":true,"anyOf":[{"example":"Europe/Warsaw","type":"string"},{"type":"null"}]}}}},"required":["status","data"]}}}},"400":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}},"404":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1PlacesById","summary":"Get a Geographic Feature by GeoNames ID","tags":["Geographic & Places"]}},"/v1/postal-codes/search":{"get":{"parameters":[{"description":"Search query string (e.g. 90210, Beverly Hills)","schema":{"type":"string"},"in":"query","name":"q","required":true},{"schema":{"minimum":1,"maximum":200,"default":50,"anyOf":[{"format":"integer","default":0,"type":"string"},{"minimum":1,"maximum":200,"default":50,"type":"integer"}]},"in":"query","name":"limit","required":false}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","countryCode","postalCode","placeName","adminName1","adminName2","latitude","longitude"],"properties":{"id":{"example":1,"type":"number"},"countryCode":{"example":"US","type":"string"},"postalCode":{"example":"90210","type":"string"},"placeName":{"example":"Beverly Hills","type":"string"},"adminName1":{"nullable":true,"anyOf":[{"example":"California","type":"string"},{"type":"null"}]},"adminName2":{"nullable":true,"anyOf":[{"example":"Los Angeles","type":"string"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":34.0901,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":-118.4065,"type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","countryCode","postalCode","placeName","adminName1","adminName2","latitude","longitude"],"properties":{"id":{"example":1,"type":"number"},"countryCode":{"example":"US","type":"string"},"postalCode":{"example":"90210","type":"string"},"placeName":{"example":"Beverly Hills","type":"string"},"adminName1":{"nullable":true,"anyOf":[{"example":"California","type":"string"},{"type":"null"}]},"adminName2":{"nullable":true,"anyOf":[{"example":"Los Angeles","type":"string"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":34.0901,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":-118.4065,"type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","countryCode","postalCode","placeName","adminName1","adminName2","latitude","longitude"],"properties":{"id":{"example":1,"type":"number"},"countryCode":{"example":"US","type":"string"},"postalCode":{"example":"90210","type":"string"},"placeName":{"example":"Beverly Hills","type":"string"},"adminName1":{"nullable":true,"anyOf":[{"example":"California","type":"string"},{"type":"null"}]},"adminName2":{"nullable":true,"anyOf":[{"example":"Los Angeles","type":"string"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":34.0901,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":-118.4065,"type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}}}},"400":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1Postal-codesSearch","summary":"Search Postal & Zip Codes","description":"Sub-millisecond full-text trigram search across 2M+ global postal codes and cities.","tags":["Geographic & Places"]}},"/v1/postal-codes/{countryCode}/{postalCode}":{"get":{"parameters":[{"description":"ISO 3166-1 alpha-2 country code","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","minLength":2,"maxLength":2,"example":"PL"},"in":"path","name":"countryCode","required":true},{"description":"Postal or ZIP code","schema":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9 \\-]{0,15}$","minLength":1,"maxLength":16,"example":"00-001"},"in":"path","name":"postalCode","required":true}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","countryCode","postalCode","placeName","adminName1","adminName2","latitude","longitude"],"properties":{"id":{"example":1,"type":"number"},"countryCode":{"example":"US","type":"string"},"postalCode":{"example":"90210","type":"string"},"placeName":{"example":"Beverly Hills","type":"string"},"adminName1":{"nullable":true,"anyOf":[{"example":"California","type":"string"},{"type":"null"}]},"adminName2":{"nullable":true,"anyOf":[{"example":"Los Angeles","type":"string"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":34.0901,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":-118.4065,"type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","countryCode","postalCode","placeName","adminName1","adminName2","latitude","longitude"],"properties":{"id":{"example":1,"type":"number"},"countryCode":{"example":"US","type":"string"},"postalCode":{"example":"90210","type":"string"},"placeName":{"example":"Beverly Hills","type":"string"},"adminName1":{"nullable":true,"anyOf":[{"example":"California","type":"string"},{"type":"null"}]},"adminName2":{"nullable":true,"anyOf":[{"example":"Los Angeles","type":"string"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":34.0901,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":-118.4065,"type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","countryCode","postalCode","placeName","adminName1","adminName2","latitude","longitude"],"properties":{"id":{"example":1,"type":"number"},"countryCode":{"example":"US","type":"string"},"postalCode":{"example":"90210","type":"string"},"placeName":{"example":"Beverly Hills","type":"string"},"adminName1":{"nullable":true,"anyOf":[{"example":"California","type":"string"},{"type":"null"}]},"adminName2":{"nullable":true,"anyOf":[{"example":"Los Angeles","type":"string"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":34.0901,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":-118.4065,"type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}}}},"404":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1Postal-codesByCountryCodeByPostalCode","summary":"Lookup Postal Code by Country","description":"Retrieves geographic location details for a specific country and postal code.","tags":["Geographic & Places"]}},"/v1/languages":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","iso6391","iso6392","iso6393","isRtl","name"],"properties":{"code":{"example":"en","type":"string"},"iso6391":{"nullable":true,"anyOf":[{"example":"en","type":"string"},{"type":"null"}]},"iso6392":{"nullable":true,"anyOf":[{"example":"eng","type":"string"},{"type":"null"}]},"iso6393":{"example":"eng","type":"string"},"isRtl":{"example":0,"type":"number"},"name":{"example":"English","type":"string"}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","iso6391","iso6392","iso6393","isRtl","name"],"properties":{"code":{"example":"en","type":"string"},"iso6391":{"nullable":true,"anyOf":[{"example":"en","type":"string"},{"type":"null"}]},"iso6392":{"nullable":true,"anyOf":[{"example":"eng","type":"string"},{"type":"null"}]},"iso6393":{"example":"eng","type":"string"},"isRtl":{"example":0,"type":"number"},"name":{"example":"English","type":"string"}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","iso6391","iso6392","iso6393","isRtl","name"],"properties":{"code":{"example":"en","type":"string"},"iso6391":{"nullable":true,"anyOf":[{"example":"en","type":"string"},{"type":"null"}]},"iso6392":{"nullable":true,"anyOf":[{"example":"eng","type":"string"},{"type":"null"}]},"iso6393":{"example":"eng","type":"string"},"isRtl":{"example":0,"type":"number"},"name":{"example":"English","type":"string"}}}}},"required":["status","data"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1Languages","summary":"Get Languages (English Default)","tags":["Linguistics & Localization"]}},"/v1/languages/{lang}":{"get":{"parameters":[{"description":"ISO 639-1 language code","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","minLength":2,"maxLength":2,"example":"pl"},"in":"path","name":"lang","required":true}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","iso6391","iso6392","iso6393","isRtl","name"],"properties":{"code":{"example":"en","type":"string"},"iso6391":{"nullable":true,"anyOf":[{"example":"en","type":"string"},{"type":"null"}]},"iso6392":{"nullable":true,"anyOf":[{"example":"eng","type":"string"},{"type":"null"}]},"iso6393":{"example":"eng","type":"string"},"isRtl":{"example":0,"type":"number"},"name":{"example":"English","type":"string"}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","iso6391","iso6392","iso6393","isRtl","name"],"properties":{"code":{"example":"en","type":"string"},"iso6391":{"nullable":true,"anyOf":[{"example":"en","type":"string"},{"type":"null"}]},"iso6392":{"nullable":true,"anyOf":[{"example":"eng","type":"string"},{"type":"null"}]},"iso6393":{"example":"eng","type":"string"},"isRtl":{"example":0,"type":"number"},"name":{"example":"English","type":"string"}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","iso6391","iso6392","iso6393","isRtl","name"],"properties":{"code":{"example":"en","type":"string"},"iso6391":{"nullable":true,"anyOf":[{"example":"en","type":"string"},{"type":"null"}]},"iso6392":{"nullable":true,"anyOf":[{"example":"eng","type":"string"},{"type":"null"}]},"iso6393":{"example":"eng","type":"string"},"isRtl":{"example":0,"type":"number"},"name":{"example":"English","type":"string"}}}}},"required":["status","data"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1LanguagesByLang","summary":"Get Languages by Language Path","tags":["Linguistics & Localization"]}},"/v1/dialects":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","languageCode","regionCode","name"],"properties":{"code":{"example":"en-US","type":"string"},"languageCode":{"example":"en","type":"string"},"regionCode":{"nullable":true,"anyOf":[{"example":"US","type":"string"},{"type":"null"}]},"name":{"example":"American English","type":"string"}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","languageCode","regionCode","name"],"properties":{"code":{"example":"en-US","type":"string"},"languageCode":{"example":"en","type":"string"},"regionCode":{"nullable":true,"anyOf":[{"example":"US","type":"string"},{"type":"null"}]},"name":{"example":"American English","type":"string"}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","languageCode","regionCode","name"],"properties":{"code":{"example":"en-US","type":"string"},"languageCode":{"example":"en","type":"string"},"regionCode":{"nullable":true,"anyOf":[{"example":"US","type":"string"},{"type":"null"}]},"name":{"example":"American English","type":"string"}}}}},"required":["status","data"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1Dialects","summary":"Get Dialects (English Default)","tags":["Linguistics & Localization"]}},"/v1/dialects/{lang}":{"get":{"parameters":[{"description":"ISO 639-1 language code","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","minLength":2,"maxLength":2,"example":"pl"},"in":"path","name":"lang","required":true}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","languageCode","regionCode","name"],"properties":{"code":{"example":"en-US","type":"string"},"languageCode":{"example":"en","type":"string"},"regionCode":{"nullable":true,"anyOf":[{"example":"US","type":"string"},{"type":"null"}]},"name":{"example":"American English","type":"string"}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","languageCode","regionCode","name"],"properties":{"code":{"example":"en-US","type":"string"},"languageCode":{"example":"en","type":"string"},"regionCode":{"nullable":true,"anyOf":[{"example":"US","type":"string"},{"type":"null"}]},"name":{"example":"American English","type":"string"}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","languageCode","regionCode","name"],"properties":{"code":{"example":"en-US","type":"string"},"languageCode":{"example":"en","type":"string"},"regionCode":{"nullable":true,"anyOf":[{"example":"US","type":"string"},{"type":"null"}]},"name":{"example":"American English","type":"string"}}}}},"required":["status","data"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1DialectsByLang","summary":"Get Dialects by Language Path","tags":["Linguistics & Localization"]}},"/v1/scripts":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","numericCode","name","direction"],"properties":{"code":{"example":"Latn","type":"string"},"numericCode":{"example":"215","type":"string"},"name":{"example":"Latin","type":"string"},"direction":{"example":"LTR","type":"string"}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","numericCode","name","direction"],"properties":{"code":{"example":"Latn","type":"string"},"numericCode":{"example":"215","type":"string"},"name":{"example":"Latin","type":"string"},"direction":{"example":"LTR","type":"string"}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","numericCode","name","direction"],"properties":{"code":{"example":"Latn","type":"string"},"numericCode":{"example":"215","type":"string"},"name":{"example":"Latin","type":"string"},"direction":{"example":"LTR","type":"string"}}}}},"required":["status","data"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1Scripts","summary":"Get Writing Systems & Scripts (ISO 15924)","tags":["Linguistics & Localization"]}},"/v1/locales":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","languageCode","scriptCode","countryCode","name"],"properties":{"code":{"example":"en-US","type":"string"},"languageCode":{"example":"en","type":"string"},"scriptCode":{"nullable":true,"anyOf":[{"example":"Latn","type":"string"},{"type":"null"}]},"countryCode":{"nullable":true,"anyOf":[{"example":"US","type":"string"},{"type":"null"}]},"name":{"example":"English (United States)","type":"string"}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","languageCode","scriptCode","countryCode","name"],"properties":{"code":{"example":"en-US","type":"string"},"languageCode":{"example":"en","type":"string"},"scriptCode":{"nullable":true,"anyOf":[{"example":"Latn","type":"string"},{"type":"null"}]},"countryCode":{"nullable":true,"anyOf":[{"example":"US","type":"string"},{"type":"null"}]},"name":{"example":"English (United States)","type":"string"}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","languageCode","scriptCode","countryCode","name"],"properties":{"code":{"example":"en-US","type":"string"},"languageCode":{"example":"en","type":"string"},"scriptCode":{"nullable":true,"anyOf":[{"example":"Latn","type":"string"},{"type":"null"}]},"countryCode":{"nullable":true,"anyOf":[{"example":"US","type":"string"},{"type":"null"}]},"name":{"example":"English (United States)","type":"string"}}}}},"required":["status","data"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1Locales","summary":"Get CLDR Locales","tags":["Linguistics & Localization"]}},"/v1/exonyms/search":{"get":{"parameters":[{"description":"Search query (e.g. Varsovie, Warsaw)","schema":{"type":"string"},"in":"query","name":"q","required":true},{"schema":{"minimum":1,"maximum":200,"default":50,"anyOf":[{"format":"integer","default":0,"type":"string"},{"minimum":1,"maximum":200,"default":50,"type":"integer"}]},"in":"query","name":"limit","required":false}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","entityType","entityId","langCode","name"],"properties":{"id":{"example":1,"type":"number"},"entityType":{"example":"city","type":"string"},"entityId":{"example":"Warsaw","type":"string"},"langCode":{"example":"pl","type":"string"},"name":{"example":"Warszawa","type":"string"}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","entityType","entityId","langCode","name"],"properties":{"id":{"example":1,"type":"number"},"entityType":{"example":"city","type":"string"},"entityId":{"example":"Warsaw","type":"string"},"langCode":{"example":"pl","type":"string"},"name":{"example":"Warszawa","type":"string"}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","entityType","entityId","langCode","name"],"properties":{"id":{"example":1,"type":"number"},"entityType":{"example":"city","type":"string"},"entityId":{"example":"Warsaw","type":"string"},"langCode":{"example":"pl","type":"string"},"name":{"example":"Warszawa","type":"string"}}}}},"required":["status","data"]}}}},"400":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1ExonymsSearch","summary":"Search Multilingual Exonyms","tags":["Linguistics & Localization"]}},"/v1/demonyms/{countryCode}":{"get":{"parameters":[{"description":"ISO 3166-1 alpha-2 country code","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","minLength":2,"maxLength":2,"example":"PL"},"in":"path","name":"countryCode","required":true}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["countryCode","langCode","singular","plural","adjective","forms"],"properties":{"countryCode":{"example":"PL","type":"string"},"langCode":{"example":"pl","type":"string"},"singular":{"nullable":true,"anyOf":[{"example":"Polak","type":"string"},{"type":"null"}]},"plural":{"nullable":true,"anyOf":[{"example":"Polacy","type":"string"},{"type":"null"}]},"adjective":{"nullable":true,"anyOf":[{"example":"polski","type":"string"},{"type":"null"}]},"forms":{"type":"array","items":{"type":"object","required":["value","gender","number"],"properties":{"value":{"example":"Polak","type":"string"},"gender":{"nullable":true,"anyOf":[{"example":"masculine","type":"string"},{"type":"null"}]},"number":{"nullable":true,"anyOf":[{"example":"singular","type":"string"},{"type":"null"}]}}}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["countryCode","langCode","singular","plural","adjective","forms"],"properties":{"countryCode":{"example":"PL","type":"string"},"langCode":{"example":"pl","type":"string"},"singular":{"nullable":true,"anyOf":[{"example":"Polak","type":"string"},{"type":"null"}]},"plural":{"nullable":true,"anyOf":[{"example":"Polacy","type":"string"},{"type":"null"}]},"adjective":{"nullable":true,"anyOf":[{"example":"polski","type":"string"},{"type":"null"}]},"forms":{"type":"array","items":{"type":"object","required":["value","gender","number"],"properties":{"value":{"example":"Polak","type":"string"},"gender":{"nullable":true,"anyOf":[{"example":"masculine","type":"string"},{"type":"null"}]},"number":{"nullable":true,"anyOf":[{"example":"singular","type":"string"},{"type":"null"}]}}}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["countryCode","langCode","singular","plural","adjective","forms"],"properties":{"countryCode":{"example":"PL","type":"string"},"langCode":{"example":"pl","type":"string"},"singular":{"nullable":true,"anyOf":[{"example":"Polak","type":"string"},{"type":"null"}]},"plural":{"nullable":true,"anyOf":[{"example":"Polacy","type":"string"},{"type":"null"}]},"adjective":{"nullable":true,"anyOf":[{"example":"polski","type":"string"},{"type":"null"}]},"forms":{"type":"array","items":{"type":"object","required":["value","gender","number"],"properties":{"value":{"example":"Polak","type":"string"},"gender":{"nullable":true,"anyOf":[{"example":"masculine","type":"string"},{"type":"null"}]},"number":{"nullable":true,"anyOf":[{"example":"singular","type":"string"},{"type":"null"}]}}}}}}},"required":["status","data"]}}}},"404":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1DemonymsByCountryCode","summary":"Get Demonyms for Country (English Default)","tags":["Linguistics & Localization"]}},"/v1/demonyms/{countryCode}/{lang}":{"get":{"parameters":[{"description":"ISO 3166-1 alpha-2 country code","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","minLength":2,"maxLength":2,"example":"PL"},"in":"path","name":"countryCode","required":true},{"description":"ISO 639-1 language code","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","minLength":2,"maxLength":2,"example":"pl"},"in":"path","name":"lang","required":true}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["countryCode","langCode","singular","plural","adjective","forms"],"properties":{"countryCode":{"example":"PL","type":"string"},"langCode":{"example":"pl","type":"string"},"singular":{"nullable":true,"anyOf":[{"example":"Polak","type":"string"},{"type":"null"}]},"plural":{"nullable":true,"anyOf":[{"example":"Polacy","type":"string"},{"type":"null"}]},"adjective":{"nullable":true,"anyOf":[{"example":"polski","type":"string"},{"type":"null"}]},"forms":{"type":"array","items":{"type":"object","required":["value","gender","number"],"properties":{"value":{"example":"Polak","type":"string"},"gender":{"nullable":true,"anyOf":[{"example":"masculine","type":"string"},{"type":"null"}]},"number":{"nullable":true,"anyOf":[{"example":"singular","type":"string"},{"type":"null"}]}}}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["countryCode","langCode","singular","plural","adjective","forms"],"properties":{"countryCode":{"example":"PL","type":"string"},"langCode":{"example":"pl","type":"string"},"singular":{"nullable":true,"anyOf":[{"example":"Polak","type":"string"},{"type":"null"}]},"plural":{"nullable":true,"anyOf":[{"example":"Polacy","type":"string"},{"type":"null"}]},"adjective":{"nullable":true,"anyOf":[{"example":"polski","type":"string"},{"type":"null"}]},"forms":{"type":"array","items":{"type":"object","required":["value","gender","number"],"properties":{"value":{"example":"Polak","type":"string"},"gender":{"nullable":true,"anyOf":[{"example":"masculine","type":"string"},{"type":"null"}]},"number":{"nullable":true,"anyOf":[{"example":"singular","type":"string"},{"type":"null"}]}}}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["countryCode","langCode","singular","plural","adjective","forms"],"properties":{"countryCode":{"example":"PL","type":"string"},"langCode":{"example":"pl","type":"string"},"singular":{"nullable":true,"anyOf":[{"example":"Polak","type":"string"},{"type":"null"}]},"plural":{"nullable":true,"anyOf":[{"example":"Polacy","type":"string"},{"type":"null"}]},"adjective":{"nullable":true,"anyOf":[{"example":"polski","type":"string"},{"type":"null"}]},"forms":{"type":"array","items":{"type":"object","required":["value","gender","number"],"properties":{"value":{"example":"Polak","type":"string"},"gender":{"nullable":true,"anyOf":[{"example":"masculine","type":"string"},{"type":"null"}]},"number":{"nullable":true,"anyOf":[{"example":"singular","type":"string"},{"type":"null"}]}}}}}}},"required":["status","data"]}}}},"404":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1DemonymsByCountryCodeByLang","summary":"Get Demonyms for Country by Language Path","tags":["Linguistics & Localization"]}},"/v1/currencies":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","numericCode","name","symbol","symbolNative","decimalDigits","rounding"],"properties":{"code":{"example":"USD","type":"string"},"numericCode":{"nullable":true,"anyOf":[{"example":"840","type":"string"},{"type":"null"}]},"name":{"example":"US Dollar","type":"string"},"symbol":{"example":"$","type":"string"},"symbolNative":{"example":"$","type":"string"},"decimalDigits":{"example":2,"type":"number"},"rounding":{"example":0,"type":"number"}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","numericCode","name","symbol","symbolNative","decimalDigits","rounding"],"properties":{"code":{"example":"USD","type":"string"},"numericCode":{"nullable":true,"anyOf":[{"example":"840","type":"string"},{"type":"null"}]},"name":{"example":"US Dollar","type":"string"},"symbol":{"example":"$","type":"string"},"symbolNative":{"example":"$","type":"string"},"decimalDigits":{"example":2,"type":"number"},"rounding":{"example":0,"type":"number"}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","numericCode","name","symbol","symbolNative","decimalDigits","rounding"],"properties":{"code":{"example":"USD","type":"string"},"numericCode":{"nullable":true,"anyOf":[{"example":"840","type":"string"},{"type":"null"}]},"name":{"example":"US Dollar","type":"string"},"symbol":{"example":"$","type":"string"},"symbolNative":{"example":"$","type":"string"},"decimalDigits":{"example":2,"type":"number"},"rounding":{"example":0,"type":"number"}}}}},"required":["status","data"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1Currencies","summary":"Get All Currencies (English Default)","tags":["Financials & Commerce"]}},"/v1/currencies/{lang}":{"get":{"parameters":[{"description":"ISO 639-1 language code","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","minLength":2,"maxLength":2,"example":"pl"},"in":"path","name":"lang","required":true}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","numericCode","name","symbol","symbolNative","decimalDigits","rounding"],"properties":{"code":{"example":"USD","type":"string"},"numericCode":{"nullable":true,"anyOf":[{"example":"840","type":"string"},{"type":"null"}]},"name":{"example":"US Dollar","type":"string"},"symbol":{"example":"$","type":"string"},"symbolNative":{"example":"$","type":"string"},"decimalDigits":{"example":2,"type":"number"},"rounding":{"example":0,"type":"number"}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","numericCode","name","symbol","symbolNative","decimalDigits","rounding"],"properties":{"code":{"example":"USD","type":"string"},"numericCode":{"nullable":true,"anyOf":[{"example":"840","type":"string"},{"type":"null"}]},"name":{"example":"US Dollar","type":"string"},"symbol":{"example":"$","type":"string"},"symbolNative":{"example":"$","type":"string"},"decimalDigits":{"example":2,"type":"number"},"rounding":{"example":0,"type":"number"}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","numericCode","name","symbol","symbolNative","decimalDigits","rounding"],"properties":{"code":{"example":"USD","type":"string"},"numericCode":{"nullable":true,"anyOf":[{"example":"840","type":"string"},{"type":"null"}]},"name":{"example":"US Dollar","type":"string"},"symbol":{"example":"$","type":"string"},"symbolNative":{"example":"$","type":"string"},"decimalDigits":{"example":2,"type":"number"},"rounding":{"example":0,"type":"number"}}}}},"required":["status","data"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1CurrenciesByLang","summary":"Get All Currencies by Language Path","tags":["Financials & Commerce"]}},"/v1/currencies/{lang}/{code}":{"get":{"parameters":[{"description":"ISO 639-1 language code","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","minLength":2,"maxLength":2,"example":"pl"},"in":"path","name":"lang","required":true},{"description":"ISO 4217 currency code","schema":{"type":"string","pattern":"^[A-Za-z]{3}$","minLength":3,"maxLength":3,"example":"USD"},"in":"path","name":"code","required":true}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["code","numericCode","name","symbol","symbolNative","decimalDigits","rounding"],"properties":{"code":{"example":"USD","type":"string"},"numericCode":{"nullable":true,"anyOf":[{"example":"840","type":"string"},{"type":"null"}]},"name":{"example":"US Dollar","type":"string"},"symbol":{"example":"$","type":"string"},"symbolNative":{"example":"$","type":"string"},"decimalDigits":{"example":2,"type":"number"},"rounding":{"example":0,"type":"number"}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["code","numericCode","name","symbol","symbolNative","decimalDigits","rounding"],"properties":{"code":{"example":"USD","type":"string"},"numericCode":{"nullable":true,"anyOf":[{"example":"840","type":"string"},{"type":"null"}]},"name":{"example":"US Dollar","type":"string"},"symbol":{"example":"$","type":"string"},"symbolNative":{"example":"$","type":"string"},"decimalDigits":{"example":2,"type":"number"},"rounding":{"example":0,"type":"number"}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["code","numericCode","name","symbol","symbolNative","decimalDigits","rounding"],"properties":{"code":{"example":"USD","type":"string"},"numericCode":{"nullable":true,"anyOf":[{"example":"840","type":"string"},{"type":"null"}]},"name":{"example":"US Dollar","type":"string"},"symbol":{"example":"$","type":"string"},"symbolNative":{"example":"$","type":"string"},"decimalDigits":{"example":2,"type":"number"},"rounding":{"example":0,"type":"number"}}}},"required":["status","data"]}}}},"404":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1CurrenciesByLangByCode","summary":"Get Currency by Code & Language Path","tags":["Financials & Commerce"]}},"/v1/currency-rules/{currencyCode}":{"get":{"parameters":[{"description":"ISO 4217 currency code","schema":{"type":"string","pattern":"^[A-Za-z]{3}$","minLength":3,"maxLength":3,"example":"USD"},"in":"path","name":"currencyCode","required":true}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["code","decimalDigits","rounding","symbolNative"],"properties":{"code":{"type":"string"},"decimalDigits":{"type":"number"},"rounding":{"type":"number"},"symbolNative":{"type":"string"}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["code","decimalDigits","rounding","symbolNative"],"properties":{"code":{"type":"string"},"decimalDigits":{"type":"number"},"rounding":{"type":"number"},"symbolNative":{"type":"string"}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["code","decimalDigits","rounding","symbolNative"],"properties":{"code":{"type":"string"},"decimalDigits":{"type":"number"},"rounding":{"type":"number"},"symbolNative":{"type":"string"}}}},"required":["status","data"]}}}},"404":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1Currency-rulesByCurrencyCode","summary":"Get Currency Formatting Rules & Precision","tags":["Financials & Commerce"]}},"/v1/address-schemas/{countryCode}":{"get":{"parameters":[{"description":"ISO 3166-1 alpha-2 country code","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","minLength":2,"maxLength":2,"example":"PL"},"in":"path","name":"countryCode","required":true}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["countryCode","formatTemplate","requiredFields","zipRegex"],"properties":{"countryCode":{"example":"US","type":"string"},"formatTemplate":{"description":"JSON string specifying line ordering and structure","type":"string"},"requiredFields":{"description":"JSON array of mandatory address fields","type":"string"},"zipRegex":{"nullable":true,"anyOf":[{"example":"^\\d{5}(-\\d{4})?$","type":"string"},{"type":"null"}]}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["countryCode","formatTemplate","requiredFields","zipRegex"],"properties":{"countryCode":{"example":"US","type":"string"},"formatTemplate":{"description":"JSON string specifying line ordering and structure","type":"string"},"requiredFields":{"description":"JSON array of mandatory address fields","type":"string"},"zipRegex":{"nullable":true,"anyOf":[{"example":"^\\d{5}(-\\d{4})?$","type":"string"},{"type":"null"}]}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["countryCode","formatTemplate","requiredFields","zipRegex"],"properties":{"countryCode":{"example":"US","type":"string"},"formatTemplate":{"description":"JSON string specifying line ordering and structure","type":"string"},"requiredFields":{"description":"JSON array of mandatory address fields","type":"string"},"zipRegex":{"nullable":true,"anyOf":[{"example":"^\\d{5}(-\\d{4})?$","type":"string"},{"type":"null"}]}}}},"required":["status","data"]}}}},"404":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1Address-schemasByCountryCode","summary":"Get Country Postal Address Layout Schema","tags":["Financials & Commerce"]}},"/v1/exchange-rates/latest":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["date","currency","rateToEur"],"properties":{"date":{"example":"2026-08-24","type":"string"},"currency":{"example":"USD","type":"string"},"rateToEur":{"example":1.0921,"description":"Units of currency per 1 EUR","type":"number"}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["date","currency","rateToEur"],"properties":{"date":{"example":"2026-08-24","type":"string"},"currency":{"example":"USD","type":"string"},"rateToEur":{"example":1.0921,"description":"Units of currency per 1 EUR","type":"number"}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["date","currency","rateToEur"],"properties":{"date":{"example":"2026-08-24","type":"string"},"currency":{"example":"USD","type":"string"},"rateToEur":{"example":1.0921,"description":"Units of currency per 1 EUR","type":"number"}}}}},"required":["status","data"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1Exchange-ratesLatest","summary":"Get Latest ECB Reference Rates (base EUR)","tags":["Financials & Commerce"]}},"/v1/exchange-rates/latest/{currency}":{"get":{"parameters":[{"description":"ISO 4217 currency code","schema":{"type":"string","pattern":"^[A-Za-z]{3}$","minLength":3,"maxLength":3,"example":"USD"},"in":"path","name":"currency","required":true}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["date","currency","rateToEur"],"properties":{"date":{"example":"2026-08-24","type":"string"},"currency":{"example":"USD","type":"string"},"rateToEur":{"example":1.0921,"description":"Units of currency per 1 EUR","type":"number"}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["date","currency","rateToEur"],"properties":{"date":{"example":"2026-08-24","type":"string"},"currency":{"example":"USD","type":"string"},"rateToEur":{"example":1.0921,"description":"Units of currency per 1 EUR","type":"number"}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["date","currency","rateToEur"],"properties":{"date":{"example":"2026-08-24","type":"string"},"currency":{"example":"USD","type":"string"},"rateToEur":{"example":1.0921,"description":"Units of currency per 1 EUR","type":"number"}}}},"required":["status","data"]}}}},"404":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1Exchange-ratesLatestByCurrency","summary":"Get Latest ECB Reference Rate for One Currency","tags":["Financials & Commerce"]}},"/v1/exchange-rates/on/{date}":{"get":{"parameters":[{"description":"Date in YYYY-MM-DD","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","example":"2026-08-24"},"in":"path","name":"date","required":true}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["date","currency","rateToEur"],"properties":{"date":{"example":"2026-08-24","type":"string"},"currency":{"example":"USD","type":"string"},"rateToEur":{"example":1.0921,"description":"Units of currency per 1 EUR","type":"number"}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["date","currency","rateToEur"],"properties":{"date":{"example":"2026-08-24","type":"string"},"currency":{"example":"USD","type":"string"},"rateToEur":{"example":1.0921,"description":"Units of currency per 1 EUR","type":"number"}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["date","currency","rateToEur"],"properties":{"date":{"example":"2026-08-24","type":"string"},"currency":{"example":"USD","type":"string"},"rateToEur":{"example":1.0921,"description":"Units of currency per 1 EUR","type":"number"}}}}},"required":["status","data"]}}}},"404":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1Exchange-ratesOnByDate","summary":"Get All ECB Reference Rates for a Specific Date","tags":["Financials & Commerce"]}},"/v1/exchange-rates/{from}/{to}":{"get":{"parameters":[{"description":"ISO 4217 currency code","schema":{"type":"string","pattern":"^[A-Za-z]{3}$","minLength":3,"maxLength":3,"example":"USD"},"in":"path","name":"from","required":true},{"description":"ISO 4217 currency code","schema":{"type":"string","pattern":"^[A-Za-z]{3}$","minLength":3,"maxLength":3,"example":"USD"},"in":"path","name":"to","required":true},{"description":"Date in YYYY-MM-DD","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","example":"2026-08-24"},"in":"query","name":"date","required":false}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["date","from","to","rate"],"properties":{"date":{"example":"2026-08-24","type":"string"},"from":{"example":"USD","type":"string"},"to":{"example":"PLN","type":"string"},"rate":{"description":"1 unit of `from` expressed in `to`","type":"number"}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["date","from","to","rate"],"properties":{"date":{"example":"2026-08-24","type":"string"},"from":{"example":"USD","type":"string"},"to":{"example":"PLN","type":"string"},"rate":{"description":"1 unit of `from` expressed in `to`","type":"number"}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["date","from","to","rate"],"properties":{"date":{"example":"2026-08-24","type":"string"},"from":{"example":"USD","type":"string"},"to":{"example":"PLN","type":"string"},"rate":{"description":"1 unit of `from` expressed in `to`","type":"number"}}}},"required":["status","data"]}}}},"404":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1Exchange-ratesByFromByTo","summary":"Convert Between Two Currencies (triangulated through EUR)","description":"Computed from ECB EUR-base rates, not a directly quoted market cross-rate. Optional ?date= picks the rate as of that date (falls back to the most recent prior publication, since ECB does not publish on weekends/holidays); omitted, it uses each currency's most recent rate independently.","tags":["Financials & Commerce"]}},"/v1/exchange-rates/history/{currency}":{"get":{"parameters":[{"description":"ISO 4217 currency code","schema":{"type":"string","pattern":"^[A-Za-z]{3}$","minLength":3,"maxLength":3,"example":"USD"},"in":"path","name":"currency","required":true},{"description":"Date in YYYY-MM-DD","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","example":"2026-08-24"},"in":"query","name":"from","required":true},{"description":"Date in YYYY-MM-DD","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","example":"2026-08-24"},"in":"query","name":"to","required":true}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["date","currency","rateToEur"],"properties":{"date":{"example":"2026-08-24","type":"string"},"currency":{"example":"USD","type":"string"},"rateToEur":{"example":1.0921,"description":"Units of currency per 1 EUR","type":"number"}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["date","currency","rateToEur"],"properties":{"date":{"example":"2026-08-24","type":"string"},"currency":{"example":"USD","type":"string"},"rateToEur":{"example":1.0921,"description":"Units of currency per 1 EUR","type":"number"}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["date","currency","rateToEur"],"properties":{"date":{"example":"2026-08-24","type":"string"},"currency":{"example":"USD","type":"string"},"rateToEur":{"example":1.0921,"description":"Units of currency per 1 EUR","type":"number"}}}}},"required":["status","data"]}}}},"400":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1Exchange-ratesHistoryByCurrency","summary":"Get ECB Reference Rate History for One Currency","tags":["Financials & Commerce"]}},"/v1/airports/search":{"get":{"parameters":[{"description":"Search query (e.g. JFK, Warsaw, EPWA)","schema":{"type":"string"},"in":"query","name":"q","required":true},{"schema":{"minimum":1,"maximum":200,"default":50,"anyOf":[{"format":"integer","default":0,"type":"string"},{"minimum":1,"maximum":200,"default":50,"type":"integer"}]},"in":"query","name":"limit","required":false}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","iata","icao","name","countryCode","cityName","latitude","longitude","elevationFt"],"properties":{"id":{"example":"WAW","type":"string"},"iata":{"nullable":true,"anyOf":[{"example":"WAW","type":"string"},{"type":"null"}]},"icao":{"nullable":true,"anyOf":[{"example":"EPWA","type":"string"},{"type":"null"}]},"name":{"example":"Warsaw Chopin Airport","type":"string"},"countryCode":{"example":"PL","type":"string"},"cityName":{"nullable":true,"anyOf":[{"example":"Warsaw","type":"string"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":52.1657,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":20.9671,"type":"number"},{"type":"null"}]},"elevationFt":{"nullable":true,"anyOf":[{"example":361,"type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","iata","icao","name","countryCode","cityName","latitude","longitude","elevationFt"],"properties":{"id":{"example":"WAW","type":"string"},"iata":{"nullable":true,"anyOf":[{"example":"WAW","type":"string"},{"type":"null"}]},"icao":{"nullable":true,"anyOf":[{"example":"EPWA","type":"string"},{"type":"null"}]},"name":{"example":"Warsaw Chopin Airport","type":"string"},"countryCode":{"example":"PL","type":"string"},"cityName":{"nullable":true,"anyOf":[{"example":"Warsaw","type":"string"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":52.1657,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":20.9671,"type":"number"},{"type":"null"}]},"elevationFt":{"nullable":true,"anyOf":[{"example":361,"type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","iata","icao","name","countryCode","cityName","latitude","longitude","elevationFt"],"properties":{"id":{"example":"WAW","type":"string"},"iata":{"nullable":true,"anyOf":[{"example":"WAW","type":"string"},{"type":"null"}]},"icao":{"nullable":true,"anyOf":[{"example":"EPWA","type":"string"},{"type":"null"}]},"name":{"example":"Warsaw Chopin Airport","type":"string"},"countryCode":{"example":"PL","type":"string"},"cityName":{"nullable":true,"anyOf":[{"example":"Warsaw","type":"string"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":52.1657,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":20.9671,"type":"number"},{"type":"null"}]},"elevationFt":{"nullable":true,"anyOf":[{"example":361,"type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}}}},"400":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1AirportsSearch","summary":"Search Airports & Aviation Hubs","description":"Full-text search across 45,000+ airports by IATA code, ICAO code, name, or city.","tags":["Logistics & Infrastructure"]}},"/v1/airports/{countryCode}":{"get":{"parameters":[{"description":"ISO 3166-1 alpha-2 country code","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","minLength":2,"maxLength":2,"example":"PL"},"in":"path","name":"countryCode","required":true},{"schema":{"minimum":1,"maximum":500,"default":100,"anyOf":[{"format":"integer","default":0,"type":"string"},{"minimum":1,"maximum":500,"default":100,"type":"integer"}]},"in":"query","name":"limit","required":false},{"description":"Opaque cursor from a previous response's nextCursor; do not construct one","schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,256}$","maxLength":256,"example":"MTc0MDAwMCA3NTYxMzU"},"in":"query","name":"cursor","required":false}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","iata","icao","name","countryCode","cityName","latitude","longitude","elevationFt"],"properties":{"id":{"example":"WAW","type":"string"},"iata":{"nullable":true,"anyOf":[{"example":"WAW","type":"string"},{"type":"null"}]},"icao":{"nullable":true,"anyOf":[{"example":"EPWA","type":"string"},{"type":"null"}]},"name":{"example":"Warsaw Chopin Airport","type":"string"},"countryCode":{"example":"PL","type":"string"},"cityName":{"nullable":true,"anyOf":[{"example":"Warsaw","type":"string"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":52.1657,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":20.9671,"type":"number"},{"type":"null"}]},"elevationFt":{"nullable":true,"anyOf":[{"example":361,"type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","iata","icao","name","countryCode","cityName","latitude","longitude","elevationFt"],"properties":{"id":{"example":"WAW","type":"string"},"iata":{"nullable":true,"anyOf":[{"example":"WAW","type":"string"},{"type":"null"}]},"icao":{"nullable":true,"anyOf":[{"example":"EPWA","type":"string"},{"type":"null"}]},"name":{"example":"Warsaw Chopin Airport","type":"string"},"countryCode":{"example":"PL","type":"string"},"cityName":{"nullable":true,"anyOf":[{"example":"Warsaw","type":"string"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":52.1657,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":20.9671,"type":"number"},{"type":"null"}]},"elevationFt":{"nullable":true,"anyOf":[{"example":361,"type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","iata","icao","name","countryCode","cityName","latitude","longitude","elevationFt"],"properties":{"id":{"example":"WAW","type":"string"},"iata":{"nullable":true,"anyOf":[{"example":"WAW","type":"string"},{"type":"null"}]},"icao":{"nullable":true,"anyOf":[{"example":"EPWA","type":"string"},{"type":"null"}]},"name":{"example":"Warsaw Chopin Airport","type":"string"},"countryCode":{"example":"PL","type":"string"},"cityName":{"nullable":true,"anyOf":[{"example":"Warsaw","type":"string"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":52.1657,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":20.9671,"type":"number"},{"type":"null"}]},"elevationFt":{"nullable":true,"anyOf":[{"example":361,"type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}}}},"400":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1AirportsByCountryCode","summary":"Get Airports by Country Code","tags":["Logistics & Infrastructure"]}},"/v1/seaports/search":{"get":{"parameters":[{"description":"Search query (e.g. PLGDN, Gdansk, Hamburg)","schema":{"type":"string"},"in":"query","name":"q","required":true},{"schema":{"minimum":1,"maximum":200,"default":50,"anyOf":[{"format":"integer","default":0,"type":"string"},{"minimum":1,"maximum":200,"default":50,"type":"integer"}]},"in":"query","name":"limit","required":false}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","countryCode","name","functionCode","latitude","longitude"],"properties":{"code":{"example":"PLGDN","type":"string"},"countryCode":{"example":"PL","type":"string"},"name":{"example":"Port of Gdańsk","type":"string"},"functionCode":{"nullable":true,"anyOf":[{"example":"1234----","type":"string"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":54.3822,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":18.6631,"type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","countryCode","name","functionCode","latitude","longitude"],"properties":{"code":{"example":"PLGDN","type":"string"},"countryCode":{"example":"PL","type":"string"},"name":{"example":"Port of Gdańsk","type":"string"},"functionCode":{"nullable":true,"anyOf":[{"example":"1234----","type":"string"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":54.3822,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":18.6631,"type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","countryCode","name","functionCode","latitude","longitude"],"properties":{"code":{"example":"PLGDN","type":"string"},"countryCode":{"example":"PL","type":"string"},"name":{"example":"Port of Gdańsk","type":"string"},"functionCode":{"nullable":true,"anyOf":[{"example":"1234----","type":"string"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":54.3822,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":18.6631,"type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}}}},"400":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1SeaportsSearch","summary":"Search Seaports & Trade Locations (UN/LOCODE)","description":"Full-text search across 110,000+ maritime ports and container terminals.","tags":["Logistics & Infrastructure"]}},"/v1/seaports/{countryCode}":{"get":{"parameters":[{"description":"ISO 3166-1 alpha-2 country code","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","minLength":2,"maxLength":2,"example":"PL"},"in":"path","name":"countryCode","required":true},{"schema":{"minimum":1,"maximum":500,"default":100,"anyOf":[{"format":"integer","default":0,"type":"string"},{"minimum":1,"maximum":500,"default":100,"type":"integer"}]},"in":"query","name":"limit","required":false},{"description":"Opaque cursor from a previous response's nextCursor; do not construct one","schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,256}$","maxLength":256,"example":"MTc0MDAwMCA3NTYxMzU"},"in":"query","name":"cursor","required":false}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","countryCode","name","functionCode","latitude","longitude"],"properties":{"code":{"example":"PLGDN","type":"string"},"countryCode":{"example":"PL","type":"string"},"name":{"example":"Port of Gdańsk","type":"string"},"functionCode":{"nullable":true,"anyOf":[{"example":"1234----","type":"string"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":54.3822,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":18.6631,"type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","countryCode","name","functionCode","latitude","longitude"],"properties":{"code":{"example":"PLGDN","type":"string"},"countryCode":{"example":"PL","type":"string"},"name":{"example":"Port of Gdańsk","type":"string"},"functionCode":{"nullable":true,"anyOf":[{"example":"1234----","type":"string"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":54.3822,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":18.6631,"type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","countryCode","name","functionCode","latitude","longitude"],"properties":{"code":{"example":"PLGDN","type":"string"},"countryCode":{"example":"PL","type":"string"},"name":{"example":"Port of Gdańsk","type":"string"},"functionCode":{"nullable":true,"anyOf":[{"example":"1234----","type":"string"},{"type":"null"}]},"latitude":{"nullable":true,"anyOf":[{"example":54.3822,"type":"number"},{"type":"null"}]},"longitude":{"nullable":true,"anyOf":[{"example":18.6631,"type":"number"},{"type":"null"}]}}}}},"required":["status","data"]}}}},"400":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1SeaportsByCountryCode","summary":"Get Seaports by Country Code","tags":["Logistics & Infrastructure"]}},"/v1/timezones":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","countryCode","name","gmtOffset","gmtOffsetName","abbreviation"],"properties":{"id":{"example":"Europe/Warsaw","type":"string"},"countryCode":{"example":"PL","type":"string"},"name":{"example":"Central European Summer Time","type":"string"},"gmtOffset":{"example":7200,"type":"number"},"gmtOffsetName":{"example":"UTC+02:00","type":"string"},"abbreviation":{"example":"CEST","type":"string"}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","countryCode","name","gmtOffset","gmtOffsetName","abbreviation"],"properties":{"id":{"example":"Europe/Warsaw","type":"string"},"countryCode":{"example":"PL","type":"string"},"name":{"example":"Central European Summer Time","type":"string"},"gmtOffset":{"example":7200,"type":"number"},"gmtOffsetName":{"example":"UTC+02:00","type":"string"},"abbreviation":{"example":"CEST","type":"string"}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","countryCode","name","gmtOffset","gmtOffsetName","abbreviation"],"properties":{"id":{"example":"Europe/Warsaw","type":"string"},"countryCode":{"example":"PL","type":"string"},"name":{"example":"Central European Summer Time","type":"string"},"gmtOffset":{"example":7200,"type":"number"},"gmtOffsetName":{"example":"UTC+02:00","type":"string"},"abbreviation":{"example":"CEST","type":"string"}}}}},"required":["status","data"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1Timezones","summary":"Get All Timezones (English Default)","tags":["Time & Global Standards"]}},"/v1/timezones/{lang}":{"get":{"parameters":[{"description":"ISO 639-1 language code","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","minLength":2,"maxLength":2,"example":"pl"},"in":"path","name":"lang","required":true}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","countryCode","name","gmtOffset","gmtOffsetName","abbreviation"],"properties":{"id":{"example":"Europe/Warsaw","type":"string"},"countryCode":{"example":"PL","type":"string"},"name":{"example":"Central European Summer Time","type":"string"},"gmtOffset":{"example":7200,"type":"number"},"gmtOffsetName":{"example":"UTC+02:00","type":"string"},"abbreviation":{"example":"CEST","type":"string"}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","countryCode","name","gmtOffset","gmtOffsetName","abbreviation"],"properties":{"id":{"example":"Europe/Warsaw","type":"string"},"countryCode":{"example":"PL","type":"string"},"name":{"example":"Central European Summer Time","type":"string"},"gmtOffset":{"example":7200,"type":"number"},"gmtOffsetName":{"example":"UTC+02:00","type":"string"},"abbreviation":{"example":"CEST","type":"string"}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","countryCode","name","gmtOffset","gmtOffsetName","abbreviation"],"properties":{"id":{"example":"Europe/Warsaw","type":"string"},"countryCode":{"example":"PL","type":"string"},"name":{"example":"Central European Summer Time","type":"string"},"gmtOffset":{"example":7200,"type":"number"},"gmtOffsetName":{"example":"UTC+02:00","type":"string"},"abbreviation":{"example":"CEST","type":"string"}}}}},"required":["status","data"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1TimezonesByLang","summary":"Get All Timezones by Language Path","tags":["Time & Global Standards"]}},"/v1/calling-codes/{countryCode}":{"get":{"parameters":[{"description":"ISO 3166-1 alpha-2 country code","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","minLength":2,"maxLength":2,"example":"PL"},"in":"path","name":"countryCode","required":true}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["countryCode","callingCode","areaCodes"],"properties":{"countryCode":{"example":"PL","type":"string"},"callingCode":{"example":"+48","type":"string"},"areaCodes":{"nullable":true,"anyOf":[{"description":"JSON string array of regional area codes","type":"string"},{"type":"null"}]}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["countryCode","callingCode","areaCodes"],"properties":{"countryCode":{"example":"PL","type":"string"},"callingCode":{"example":"+48","type":"string"},"areaCodes":{"nullable":true,"anyOf":[{"description":"JSON string array of regional area codes","type":"string"},{"type":"null"}]}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["countryCode","callingCode","areaCodes"],"properties":{"countryCode":{"example":"PL","type":"string"},"callingCode":{"example":"+48","type":"string"},"areaCodes":{"nullable":true,"anyOf":[{"description":"JSON string array of regional area codes","type":"string"},{"type":"null"}]}}}},"required":["status","data"]}}}},"404":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1Calling-codesByCountryCode","summary":"Get E.164 Calling Prefix & Area Codes by Country","tags":["Time & Global Standards"]}},"/v1/holidays/{countryCode}/{year}":{"get":{"parameters":[{"description":"ISO 3166-1 alpha-2 country code","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","minLength":2,"maxLength":2,"example":"PL"},"in":"path","name":"countryCode","required":true},{"description":"Calendar year","schema":{"minimum":1900,"maximum":2100,"example":2026,"anyOf":[{"format":"integer","default":0,"type":"string"},{"minimum":1900,"maximum":2100,"description":"Calendar year","example":2026,"type":"integer"}]},"in":"path","name":"year","required":true}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","countryCode","year","date","name","type"],"properties":{"id":{"example":1,"type":"number"},"countryCode":{"example":"PL","type":"string"},"year":{"example":2026,"type":"number"},"date":{"example":"2026-05-03","type":"string"},"name":{"example":"Święto Konstytucji 3 Maja","type":"string"},"type":{"example":"public","type":"string"}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","countryCode","year","date","name","type"],"properties":{"id":{"example":1,"type":"number"},"countryCode":{"example":"PL","type":"string"},"year":{"example":2026,"type":"number"},"date":{"example":"2026-05-03","type":"string"},"name":{"example":"Święto Konstytucji 3 Maja","type":"string"},"type":{"example":"public","type":"string"}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","countryCode","year","date","name","type"],"properties":{"id":{"example":1,"type":"number"},"countryCode":{"example":"PL","type":"string"},"year":{"example":2026,"type":"number"},"date":{"example":"2026-05-03","type":"string"},"name":{"example":"Święto Konstytucji 3 Maja","type":"string"},"type":{"example":"public","type":"string"}}}}},"required":["status","data"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1HolidaysByCountryCodeByYear","summary":"Get National & Bank Holidays by Country and Year","tags":["Time & Global Standards"]}},"/v1/units":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","category","system","symbol","conversionFactorToSi"],"properties":{"code":{"example":"km","type":"string"},"category":{"example":"length","type":"string"},"system":{"example":"SI","type":"string"},"symbol":{"example":"km","type":"string"},"conversionFactorToSi":{"example":1000,"type":"number"}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","category","system","symbol","conversionFactorToSi"],"properties":{"code":{"example":"km","type":"string"},"category":{"example":"length","type":"string"},"system":{"example":"SI","type":"string"},"symbol":{"example":"km","type":"string"},"conversionFactorToSi":{"example":1000,"type":"number"}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","category","system","symbol","conversionFactorToSi"],"properties":{"code":{"example":"km","type":"string"},"category":{"example":"length","type":"string"},"system":{"example":"SI","type":"string"},"symbol":{"example":"km","type":"string"},"conversionFactorToSi":{"example":1000,"type":"number"}}}}},"required":["status","data"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1Units","summary":"Get All Measurement Units (UCUM)","tags":["Time & Global Standards"]}},"/v1/units/{category}":{"get":{"parameters":[{"description":"Unit category (e.g. length, mass, volume, temperature)","schema":{"type":"string","pattern":"^[A-Za-z][A-Za-z_ -]{0,31}$","minLength":1,"maxLength":32,"example":"length"},"in":"path","name":"category","required":true}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","category","system","symbol","conversionFactorToSi"],"properties":{"code":{"example":"km","type":"string"},"category":{"example":"length","type":"string"},"system":{"example":"SI","type":"string"},"symbol":{"example":"km","type":"string"},"conversionFactorToSi":{"example":1000,"type":"number"}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","category","system","symbol","conversionFactorToSi"],"properties":{"code":{"example":"km","type":"string"},"category":{"example":"length","type":"string"},"system":{"example":"SI","type":"string"},"symbol":{"example":"km","type":"string"},"conversionFactorToSi":{"example":1000,"type":"number"}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","category","system","symbol","conversionFactorToSi"],"properties":{"code":{"example":"km","type":"string"},"category":{"example":"length","type":"string"},"system":{"example":"SI","type":"string"},"symbol":{"example":"km","type":"string"},"conversionFactorToSi":{"example":1000,"type":"number"}}}}},"required":["status","data"]}}}},"404":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}},"500":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1UnitsByCategory","summary":"Get Measurement Units by Category","tags":["Time & Global Standards"]}},"/v1/vehicles/makes":{"get":{"parameters":[{"description":"ISO 3166-1 alpha-2 country code","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","minLength":2,"maxLength":2,"example":"PL"},"in":"query","name":"country","required":false},{"schema":{"minimum":1,"maximum":500,"default":100,"anyOf":[{"format":"integer","default":0,"type":"string"},{"minimum":1,"maximum":500,"default":100,"type":"integer"}]},"in":"query","name":"limit","required":false},{"description":"Opaque cursor from a previous response's nextCursor; do not construct one","schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,256}$","maxLength":256,"example":"MTc0MDAwMCA3NTYxMzU"},"in":"query","name":"cursor","required":false}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","name","countryCode","foundedYear","parentName","isDefunct","wikidataId","source"],"properties":{"id":{"example":448,"type":"number"},"name":{"example":"Toyota","type":"string"},"countryCode":{"nullable":true,"anyOf":[{"example":"JP","type":"string"},{"type":"null"}]},"foundedYear":{"nullable":true,"anyOf":[{"example":1937,"type":"number"},{"type":"null"}]},"parentName":{"nullable":true,"anyOf":[{"example":"Toyota Group","type":"string"},{"type":"null"}]},"isDefunct":{"example":0,"description":"1 when the brand has been dissolved","type":"number"},"wikidataId":{"nullable":true,"anyOf":[{"example":"Q53268","type":"string"},{"type":"null"}]},"source":{"example":"vpic","description":"vpic | wikidata","type":"string"}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","name","countryCode","foundedYear","parentName","isDefunct","wikidataId","source"],"properties":{"id":{"example":448,"type":"number"},"name":{"example":"Toyota","type":"string"},"countryCode":{"nullable":true,"anyOf":[{"example":"JP","type":"string"},{"type":"null"}]},"foundedYear":{"nullable":true,"anyOf":[{"example":1937,"type":"number"},{"type":"null"}]},"parentName":{"nullable":true,"anyOf":[{"example":"Toyota Group","type":"string"},{"type":"null"}]},"isDefunct":{"example":0,"description":"1 when the brand has been dissolved","type":"number"},"wikidataId":{"nullable":true,"anyOf":[{"example":"Q53268","type":"string"},{"type":"null"}]},"source":{"example":"vpic","description":"vpic | wikidata","type":"string"}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","name","countryCode","foundedYear","parentName","isDefunct","wikidataId","source"],"properties":{"id":{"example":448,"type":"number"},"name":{"example":"Toyota","type":"string"},"countryCode":{"nullable":true,"anyOf":[{"example":"JP","type":"string"},{"type":"null"}]},"foundedYear":{"nullable":true,"anyOf":[{"example":1937,"type":"number"},{"type":"null"}]},"parentName":{"nullable":true,"anyOf":[{"example":"Toyota Group","type":"string"},{"type":"null"}]},"isDefunct":{"example":0,"description":"1 when the brand has been dissolved","type":"number"},"wikidataId":{"nullable":true,"anyOf":[{"example":"Q53268","type":"string"},{"type":"null"}]},"source":{"example":"vpic","description":"vpic | wikidata","type":"string"}}}}},"required":["status","data"]}}}},"400":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1VehiclesMakes","summary":"List vehicle brands","tags":["Automotive"]}},"/v1/vehicles/makes/search":{"get":{"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"q","required":true},{"schema":{"minimum":1,"maximum":200,"default":50,"anyOf":[{"format":"integer","default":0,"type":"string"},{"minimum":1,"maximum":200,"default":50,"type":"integer"}]},"in":"query","name":"limit","required":false}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","name","countryCode","foundedYear","parentName","isDefunct","wikidataId","source"],"properties":{"id":{"example":448,"type":"number"},"name":{"example":"Toyota","type":"string"},"countryCode":{"nullable":true,"anyOf":[{"example":"JP","type":"string"},{"type":"null"}]},"foundedYear":{"nullable":true,"anyOf":[{"example":1937,"type":"number"},{"type":"null"}]},"parentName":{"nullable":true,"anyOf":[{"example":"Toyota Group","type":"string"},{"type":"null"}]},"isDefunct":{"example":0,"description":"1 when the brand has been dissolved","type":"number"},"wikidataId":{"nullable":true,"anyOf":[{"example":"Q53268","type":"string"},{"type":"null"}]},"source":{"example":"vpic","description":"vpic | wikidata","type":"string"}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","name","countryCode","foundedYear","parentName","isDefunct","wikidataId","source"],"properties":{"id":{"example":448,"type":"number"},"name":{"example":"Toyota","type":"string"},"countryCode":{"nullable":true,"anyOf":[{"example":"JP","type":"string"},{"type":"null"}]},"foundedYear":{"nullable":true,"anyOf":[{"example":1937,"type":"number"},{"type":"null"}]},"parentName":{"nullable":true,"anyOf":[{"example":"Toyota Group","type":"string"},{"type":"null"}]},"isDefunct":{"example":0,"description":"1 when the brand has been dissolved","type":"number"},"wikidataId":{"nullable":true,"anyOf":[{"example":"Q53268","type":"string"},{"type":"null"}]},"source":{"example":"vpic","description":"vpic | wikidata","type":"string"}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","name","countryCode","foundedYear","parentName","isDefunct","wikidataId","source"],"properties":{"id":{"example":448,"type":"number"},"name":{"example":"Toyota","type":"string"},"countryCode":{"nullable":true,"anyOf":[{"example":"JP","type":"string"},{"type":"null"}]},"foundedYear":{"nullable":true,"anyOf":[{"example":1937,"type":"number"},{"type":"null"}]},"parentName":{"nullable":true,"anyOf":[{"example":"Toyota Group","type":"string"},{"type":"null"}]},"isDefunct":{"example":0,"description":"1 when the brand has been dissolved","type":"number"},"wikidataId":{"nullable":true,"anyOf":[{"example":"Q53268","type":"string"},{"type":"null"}]},"source":{"example":"vpic","description":"vpic | wikidata","type":"string"}}}}},"required":["status","data"]}}}},"400":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1VehiclesMakesSearch","summary":"Search vehicle brands","tags":["Automotive"]}},"/v1/vehicles/makes/{id}":{"get":{"parameters":[{"description":"Numeric resource identifier","schema":{"minimum":1,"maximum":9007199254740991,"example":474,"anyOf":[{"format":"numeric","default":0,"type":"string"},{"minimum":1,"maximum":9007199254740991,"description":"Numeric resource identifier","example":474,"type":"number"}]},"in":"path","name":"id","required":true},{"description":"ISO 639-1 language code","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","minLength":2,"maxLength":2,"example":"pl"},"in":"query","name":"lang","required":false}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["id","name","countryCode","foundedYear","parentName","isDefunct","wikidataId","source"],"properties":{"id":{"example":448,"type":"number"},"name":{"example":"Toyota","type":"string"},"countryCode":{"nullable":true,"anyOf":[{"example":"JP","type":"string"},{"type":"null"}]},"foundedYear":{"nullable":true,"anyOf":[{"example":1937,"type":"number"},{"type":"null"}]},"parentName":{"nullable":true,"anyOf":[{"example":"Toyota Group","type":"string"},{"type":"null"}]},"isDefunct":{"example":0,"description":"1 when the brand has been dissolved","type":"number"},"wikidataId":{"nullable":true,"anyOf":[{"example":"Q53268","type":"string"},{"type":"null"}]},"source":{"example":"vpic","description":"vpic | wikidata","type":"string"}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["id","name","countryCode","foundedYear","parentName","isDefunct","wikidataId","source"],"properties":{"id":{"example":448,"type":"number"},"name":{"example":"Toyota","type":"string"},"countryCode":{"nullable":true,"anyOf":[{"example":"JP","type":"string"},{"type":"null"}]},"foundedYear":{"nullable":true,"anyOf":[{"example":1937,"type":"number"},{"type":"null"}]},"parentName":{"nullable":true,"anyOf":[{"example":"Toyota Group","type":"string"},{"type":"null"}]},"isDefunct":{"example":0,"description":"1 when the brand has been dissolved","type":"number"},"wikidataId":{"nullable":true,"anyOf":[{"example":"Q53268","type":"string"},{"type":"null"}]},"source":{"example":"vpic","description":"vpic | wikidata","type":"string"}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["id","name","countryCode","foundedYear","parentName","isDefunct","wikidataId","source"],"properties":{"id":{"example":448,"type":"number"},"name":{"example":"Toyota","type":"string"},"countryCode":{"nullable":true,"anyOf":[{"example":"JP","type":"string"},{"type":"null"}]},"foundedYear":{"nullable":true,"anyOf":[{"example":1937,"type":"number"},{"type":"null"}]},"parentName":{"nullable":true,"anyOf":[{"example":"Toyota Group","type":"string"},{"type":"null"}]},"isDefunct":{"example":0,"description":"1 when the brand has been dissolved","type":"number"},"wikidataId":{"nullable":true,"anyOf":[{"example":"Q53268","type":"string"},{"type":"null"}]},"source":{"example":"vpic","description":"vpic | wikidata","type":"string"}}}},"required":["status","data"]}}}},"404":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1VehiclesMakesById","summary":"Get a vehicle brand by id","tags":["Automotive"]}},"/v1/vehicles/makes/{id}/models":{"get":{"parameters":[{"description":"Numeric resource identifier","schema":{"minimum":1,"maximum":9007199254740991,"example":474,"anyOf":[{"format":"numeric","default":0,"type":"string"},{"minimum":1,"maximum":9007199254740991,"description":"Numeric resource identifier","example":474,"type":"number"}]},"in":"path","name":"id","required":true},{"description":"ISO 639-1 language code","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","minLength":2,"maxLength":2,"example":"pl"},"in":"query","name":"lang","required":false},{"schema":{"minimum":1,"maximum":1000,"default":500,"anyOf":[{"format":"integer","default":0,"type":"string"},{"minimum":1,"maximum":1000,"default":500,"type":"integer"}]},"in":"query","name":"limit","required":false}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","makeId","makeName","name","vehicleType","countryCode","productionStart","source"],"properties":{"id":{"example":2201,"type":"number"},"makeId":{"example":448,"type":"number"},"makeName":{"example":"Toyota","type":"string"},"name":{"example":"Corolla","type":"string"},"vehicleType":{"nullable":true,"anyOf":[{"example":"Passenger Car","type":"string"},{"type":"null"}]},"countryCode":{"nullable":true,"anyOf":[{"example":"JP","type":"string"},{"type":"null"}]},"productionStart":{"nullable":true,"anyOf":[{"example":1966,"type":"number"},{"type":"null"}]},"source":{"example":"wikidata","type":"string"}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","makeId","makeName","name","vehicleType","countryCode","productionStart","source"],"properties":{"id":{"example":2201,"type":"number"},"makeId":{"example":448,"type":"number"},"makeName":{"example":"Toyota","type":"string"},"name":{"example":"Corolla","type":"string"},"vehicleType":{"nullable":true,"anyOf":[{"example":"Passenger Car","type":"string"},{"type":"null"}]},"countryCode":{"nullable":true,"anyOf":[{"example":"JP","type":"string"},{"type":"null"}]},"productionStart":{"nullable":true,"anyOf":[{"example":1966,"type":"number"},{"type":"null"}]},"source":{"example":"wikidata","type":"string"}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","makeId","makeName","name","vehicleType","countryCode","productionStart","source"],"properties":{"id":{"example":2201,"type":"number"},"makeId":{"example":448,"type":"number"},"makeName":{"example":"Toyota","type":"string"},"name":{"example":"Corolla","type":"string"},"vehicleType":{"nullable":true,"anyOf":[{"example":"Passenger Car","type":"string"},{"type":"null"}]},"countryCode":{"nullable":true,"anyOf":[{"example":"JP","type":"string"},{"type":"null"}]},"productionStart":{"nullable":true,"anyOf":[{"example":1966,"type":"number"},{"type":"null"}]},"source":{"example":"wikidata","type":"string"}}}}},"required":["status","data"]}}}}},"operationId":"getV1VehiclesMakesByIdModels","summary":"List models of a vehicle brand","tags":["Automotive"]}},"/v1/vehicles/models/search":{"get":{"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"q","required":true},{"schema":{"minimum":1,"maximum":200,"default":50,"anyOf":[{"format":"integer","default":0,"type":"string"},{"minimum":1,"maximum":200,"default":50,"type":"integer"}]},"in":"query","name":"limit","required":false}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","makeId","makeName","name","vehicleType","countryCode","productionStart","source"],"properties":{"id":{"example":2201,"type":"number"},"makeId":{"example":448,"type":"number"},"makeName":{"example":"Toyota","type":"string"},"name":{"example":"Corolla","type":"string"},"vehicleType":{"nullable":true,"anyOf":[{"example":"Passenger Car","type":"string"},{"type":"null"}]},"countryCode":{"nullable":true,"anyOf":[{"example":"JP","type":"string"},{"type":"null"}]},"productionStart":{"nullable":true,"anyOf":[{"example":1966,"type":"number"},{"type":"null"}]},"source":{"example":"wikidata","type":"string"}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","makeId","makeName","name","vehicleType","countryCode","productionStart","source"],"properties":{"id":{"example":2201,"type":"number"},"makeId":{"example":448,"type":"number"},"makeName":{"example":"Toyota","type":"string"},"name":{"example":"Corolla","type":"string"},"vehicleType":{"nullable":true,"anyOf":[{"example":"Passenger Car","type":"string"},{"type":"null"}]},"countryCode":{"nullable":true,"anyOf":[{"example":"JP","type":"string"},{"type":"null"}]},"productionStart":{"nullable":true,"anyOf":[{"example":1966,"type":"number"},{"type":"null"}]},"source":{"example":"wikidata","type":"string"}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","makeId","makeName","name","vehicleType","countryCode","productionStart","source"],"properties":{"id":{"example":2201,"type":"number"},"makeId":{"example":448,"type":"number"},"makeName":{"example":"Toyota","type":"string"},"name":{"example":"Corolla","type":"string"},"vehicleType":{"nullable":true,"anyOf":[{"example":"Passenger Car","type":"string"},{"type":"null"}]},"countryCode":{"nullable":true,"anyOf":[{"example":"JP","type":"string"},{"type":"null"}]},"productionStart":{"nullable":true,"anyOf":[{"example":1966,"type":"number"},{"type":"null"}]},"source":{"example":"wikidata","type":"string"}}}}},"required":["status","data"]}}}},"400":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1VehiclesModelsSearch","summary":"Search vehicle models","tags":["Automotive"]}},"/v1/vehicles/models/{id}":{"get":{"parameters":[{"description":"Numeric resource identifier","schema":{"minimum":1,"maximum":9007199254740991,"example":474,"anyOf":[{"format":"numeric","default":0,"type":"string"},{"minimum":1,"maximum":9007199254740991,"description":"Numeric resource identifier","example":474,"type":"number"}]},"in":"path","name":"id","required":true},{"description":"ISO 639-1 language code","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","minLength":2,"maxLength":2,"example":"pl"},"in":"query","name":"lang","required":false}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["id","makeId","makeName","name","vehicleType","countryCode","productionStart","source"],"properties":{"id":{"example":2201,"type":"number"},"makeId":{"example":448,"type":"number"},"makeName":{"example":"Toyota","type":"string"},"name":{"example":"Corolla","type":"string"},"vehicleType":{"nullable":true,"anyOf":[{"example":"Passenger Car","type":"string"},{"type":"null"}]},"countryCode":{"nullable":true,"anyOf":[{"example":"JP","type":"string"},{"type":"null"}]},"productionStart":{"nullable":true,"anyOf":[{"example":1966,"type":"number"},{"type":"null"}]},"source":{"example":"wikidata","type":"string"}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["id","makeId","makeName","name","vehicleType","countryCode","productionStart","source"],"properties":{"id":{"example":2201,"type":"number"},"makeId":{"example":448,"type":"number"},"makeName":{"example":"Toyota","type":"string"},"name":{"example":"Corolla","type":"string"},"vehicleType":{"nullable":true,"anyOf":[{"example":"Passenger Car","type":"string"},{"type":"null"}]},"countryCode":{"nullable":true,"anyOf":[{"example":"JP","type":"string"},{"type":"null"}]},"productionStart":{"nullable":true,"anyOf":[{"example":1966,"type":"number"},{"type":"null"}]},"source":{"example":"wikidata","type":"string"}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["id","makeId","makeName","name","vehicleType","countryCode","productionStart","source"],"properties":{"id":{"example":2201,"type":"number"},"makeId":{"example":448,"type":"number"},"makeName":{"example":"Toyota","type":"string"},"name":{"example":"Corolla","type":"string"},"vehicleType":{"nullable":true,"anyOf":[{"example":"Passenger Car","type":"string"},{"type":"null"}]},"countryCode":{"nullable":true,"anyOf":[{"example":"JP","type":"string"},{"type":"null"}]},"productionStart":{"nullable":true,"anyOf":[{"example":1966,"type":"number"},{"type":"null"}]},"source":{"example":"wikidata","type":"string"}}}},"required":["status","data"]}}}},"404":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1VehiclesModelsById","summary":"Get a vehicle model by id","tags":["Automotive"]}},"/v1/vehicles/manufacturers/{countryCode}":{"get":{"parameters":[{"description":"ISO 3166-1 alpha-2 country code","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","minLength":2,"maxLength":2,"example":"PL"},"in":"path","name":"countryCode","required":true},{"schema":{"minimum":1,"maximum":1000,"default":500,"anyOf":[{"format":"integer","default":0,"type":"string"},{"minimum":1,"maximum":1000,"default":500,"type":"integer"}]},"in":"query","name":"limit","required":false}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","name","commonName","countryCode","countryName"],"properties":{"id":{"example":955,"type":"number"},"name":{"example":"TESLA, INC.","type":"string"},"commonName":{"nullable":true,"anyOf":[{"example":"Tesla","type":"string"},{"type":"null"}]},"countryCode":{"nullable":true,"anyOf":[{"example":"US","type":"string"},{"type":"null"}]},"countryName":{"nullable":true,"anyOf":[{"example":"UNITED STATES (USA)","type":"string"},{"type":"null"}]}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","name","commonName","countryCode","countryName"],"properties":{"id":{"example":955,"type":"number"},"name":{"example":"TESLA, INC.","type":"string"},"commonName":{"nullable":true,"anyOf":[{"example":"Tesla","type":"string"},{"type":"null"}]},"countryCode":{"nullable":true,"anyOf":[{"example":"US","type":"string"},{"type":"null"}]},"countryName":{"nullable":true,"anyOf":[{"example":"UNITED STATES (USA)","type":"string"},{"type":"null"}]}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","name","commonName","countryCode","countryName"],"properties":{"id":{"example":955,"type":"number"},"name":{"example":"TESLA, INC.","type":"string"},"commonName":{"nullable":true,"anyOf":[{"example":"Tesla","type":"string"},{"type":"null"}]},"countryCode":{"nullable":true,"anyOf":[{"example":"US","type":"string"},{"type":"null"}]},"countryName":{"nullable":true,"anyOf":[{"example":"UNITED STATES (USA)","type":"string"},{"type":"null"}]}}}}},"required":["status","data"]}}}}},"operationId":"getV1VehiclesManufacturersByCountryCode","summary":"List vehicle manufacturers by country","tags":["Automotive"]}},"/v1/vehicles/wmi/{wmi}":{"get":{"parameters":[{"description":"World Manufacturer Identifier (VIN characters 1-3, or 1-3 + 12-14)","schema":{"type":"string","pattern":"^[A-HJ-NPR-Z0-9]{3}([A-HJ-NPR-Z0-9]{3})?$","minLength":3,"maxLength":6,"example":"5YJ"},"in":"path","name":"wmi","required":true}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["wmi","manufacturerId","manufacturerName","countryCode","countryName","vehicleType","dateAvailable"],"properties":{"wmi":{"example":"5YJ","type":"string"},"manufacturerId":{"nullable":true,"anyOf":[{"example":955,"type":"number"},{"type":"null"}]},"manufacturerName":{"example":"TESLA, INC.","type":"string"},"countryCode":{"nullable":true,"anyOf":[{"example":"US","type":"string"},{"type":"null"}]},"countryName":{"nullable":true,"anyOf":[{"example":"UNITED STATES (USA)","type":"string"},{"type":"null"}]},"vehicleType":{"nullable":true,"anyOf":[{"example":"Passenger Car","type":"string"},{"type":"null"}]},"dateAvailable":{"nullable":true,"anyOf":[{"example":"2015-01-01","type":"string"},{"type":"null"}]}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["wmi","manufacturerId","manufacturerName","countryCode","countryName","vehicleType","dateAvailable"],"properties":{"wmi":{"example":"5YJ","type":"string"},"manufacturerId":{"nullable":true,"anyOf":[{"example":955,"type":"number"},{"type":"null"}]},"manufacturerName":{"example":"TESLA, INC.","type":"string"},"countryCode":{"nullable":true,"anyOf":[{"example":"US","type":"string"},{"type":"null"}]},"countryName":{"nullable":true,"anyOf":[{"example":"UNITED STATES (USA)","type":"string"},{"type":"null"}]},"vehicleType":{"nullable":true,"anyOf":[{"example":"Passenger Car","type":"string"},{"type":"null"}]},"dateAvailable":{"nullable":true,"anyOf":[{"example":"2015-01-01","type":"string"},{"type":"null"}]}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["wmi","manufacturerId","manufacturerName","countryCode","countryName","vehicleType","dateAvailable"],"properties":{"wmi":{"example":"5YJ","type":"string"},"manufacturerId":{"nullable":true,"anyOf":[{"example":955,"type":"number"},{"type":"null"}]},"manufacturerName":{"example":"TESLA, INC.","type":"string"},"countryCode":{"nullable":true,"anyOf":[{"example":"US","type":"string"},{"type":"null"}]},"countryName":{"nullable":true,"anyOf":[{"example":"UNITED STATES (USA)","type":"string"},{"type":"null"}]},"vehicleType":{"nullable":true,"anyOf":[{"example":"Passenger Car","type":"string"},{"type":"null"}]},"dateAvailable":{"nullable":true,"anyOf":[{"example":"2015-01-01","type":"string"},{"type":"null"}]}}}},"required":["status","data"]}}}},"404":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1VehiclesWmiByWmi","summary":"Look up a World Manufacturer Identifier","tags":["Automotive"]}},"/v1/vehicles/vin/{vin}":{"get":{"parameters":[{"description":"17-character Vehicle Identification Number","schema":{"type":"string","pattern":"^[A-HJ-NPR-Z0-9]{17}$","minLength":17,"maxLength":17,"example":"5YJ3E1EA7HF000337"},"in":"path","name":"vin","required":true}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["vin","wmi","checkDigitValid","modelYearCandidates","manufacturer"],"properties":{"vin":{"example":"5YJ3E1EA7HF000337","type":"string"},"wmi":{"nullable":true,"anyOf":[{"example":"5YJ","type":"string"},{"type":"null"}]},"checkDigitValid":{"example":true,"description":"Position-9 check digit. Mandatory for North America, optional elsewhere.","type":"boolean"},"modelYearCandidates":{"example":[1987,2017],"type":"array","items":{"type":"number"}},"manufacturer":{"nullable":true,"anyOf":[{"type":"object","required":["wmi","manufacturerId","manufacturerName","countryCode","countryName","vehicleType","dateAvailable"],"properties":{"wmi":{"example":"5YJ","type":"string"},"manufacturerId":{"nullable":true,"anyOf":[{"example":955,"type":"number"},{"type":"null"}]},"manufacturerName":{"example":"TESLA, INC.","type":"string"},"countryCode":{"nullable":true,"anyOf":[{"example":"US","type":"string"},{"type":"null"}]},"countryName":{"nullable":true,"anyOf":[{"example":"UNITED STATES (USA)","type":"string"},{"type":"null"}]},"vehicleType":{"nullable":true,"anyOf":[{"example":"Passenger Car","type":"string"},{"type":"null"}]},"dateAvailable":{"nullable":true,"anyOf":[{"example":"2015-01-01","type":"string"},{"type":"null"}]}}},{"type":"null"}]}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["vin","wmi","checkDigitValid","modelYearCandidates","manufacturer"],"properties":{"vin":{"example":"5YJ3E1EA7HF000337","type":"string"},"wmi":{"nullable":true,"anyOf":[{"example":"5YJ","type":"string"},{"type":"null"}]},"checkDigitValid":{"example":true,"description":"Position-9 check digit. Mandatory for North America, optional elsewhere.","type":"boolean"},"modelYearCandidates":{"example":[1987,2017],"type":"array","items":{"type":"number"}},"manufacturer":{"nullable":true,"anyOf":[{"type":"object","required":["wmi","manufacturerId","manufacturerName","countryCode","countryName","vehicleType","dateAvailable"],"properties":{"wmi":{"example":"5YJ","type":"string"},"manufacturerId":{"nullable":true,"anyOf":[{"example":955,"type":"number"},{"type":"null"}]},"manufacturerName":{"example":"TESLA, INC.","type":"string"},"countryCode":{"nullable":true,"anyOf":[{"example":"US","type":"string"},{"type":"null"}]},"countryName":{"nullable":true,"anyOf":[{"example":"UNITED STATES (USA)","type":"string"},{"type":"null"}]},"vehicleType":{"nullable":true,"anyOf":[{"example":"Passenger Car","type":"string"},{"type":"null"}]},"dateAvailable":{"nullable":true,"anyOf":[{"example":"2015-01-01","type":"string"},{"type":"null"}]}}},{"type":"null"}]}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["vin","wmi","checkDigitValid","modelYearCandidates","manufacturer"],"properties":{"vin":{"example":"5YJ3E1EA7HF000337","type":"string"},"wmi":{"nullable":true,"anyOf":[{"example":"5YJ","type":"string"},{"type":"null"}]},"checkDigitValid":{"example":true,"description":"Position-9 check digit. Mandatory for North America, optional elsewhere.","type":"boolean"},"modelYearCandidates":{"example":[1987,2017],"type":"array","items":{"type":"number"}},"manufacturer":{"nullable":true,"anyOf":[{"type":"object","required":["wmi","manufacturerId","manufacturerName","countryCode","countryName","vehicleType","dateAvailable"],"properties":{"wmi":{"example":"5YJ","type":"string"},"manufacturerId":{"nullable":true,"anyOf":[{"example":955,"type":"number"},{"type":"null"}]},"manufacturerName":{"example":"TESLA, INC.","type":"string"},"countryCode":{"nullable":true,"anyOf":[{"example":"US","type":"string"},{"type":"null"}]},"countryName":{"nullable":true,"anyOf":[{"example":"UNITED STATES (USA)","type":"string"},{"type":"null"}]},"vehicleType":{"nullable":true,"anyOf":[{"example":"Passenger Car","type":"string"},{"type":"null"}]},"dateAvailable":{"nullable":true,"anyOf":[{"example":"2015-01-01","type":"string"},{"type":"null"}]}}},{"type":"null"}]}}}},"required":["status","data"]}}}}},"operationId":"getV1VehiclesVinByVin","summary":"Decode a VIN","description":"Resolves the manufacturer from the VIN's WMI prefix, validates the position-9 check digit, and decodes the model-year code. The year code repeats on a 30-year cycle, so both candidate years are returned.","tags":["Automotive"]}},"/v1/religions":{"get":{"parameters":[{"description":"ISO 639-1 language code","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","minLength":2,"maxLength":2,"example":"pl"},"in":"query","name":"lang","required":false}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","name","family","foundedYear","adherents","wikidataId"],"properties":{"code":{"example":"christianity","type":"string"},"name":{"example":"Christianity","type":"string"},"family":{"example":"Abrahamic","type":"string"},"foundedYear":{"nullable":true,"anyOf":[{"example":30,"description":"Negative values are BCE","type":"number"},{"type":"null"}]},"adherents":{"nullable":true,"anyOf":[{"example":2380000000,"type":"number"},{"type":"null"}]},"wikidataId":{"nullable":true,"anyOf":[{"example":"Q5043","type":"string"},{"type":"null"}]}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","name","family","foundedYear","adherents","wikidataId"],"properties":{"code":{"example":"christianity","type":"string"},"name":{"example":"Christianity","type":"string"},"family":{"example":"Abrahamic","type":"string"},"foundedYear":{"nullable":true,"anyOf":[{"example":30,"description":"Negative values are BCE","type":"number"},{"type":"null"}]},"adherents":{"nullable":true,"anyOf":[{"example":2380000000,"type":"number"},{"type":"null"}]},"wikidataId":{"nullable":true,"anyOf":[{"example":"Q5043","type":"string"},{"type":"null"}]}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","name","family","foundedYear","adherents","wikidataId"],"properties":{"code":{"example":"christianity","type":"string"},"name":{"example":"Christianity","type":"string"},"family":{"example":"Abrahamic","type":"string"},"foundedYear":{"nullable":true,"anyOf":[{"example":30,"description":"Negative values are BCE","type":"number"},{"type":"null"}]},"adherents":{"nullable":true,"anyOf":[{"example":2380000000,"type":"number"},{"type":"null"}]},"wikidataId":{"nullable":true,"anyOf":[{"example":"Q5043","type":"string"},{"type":"null"}]}}}}},"required":["status","data"]}}}}},"operationId":"getV1Religions","summary":"List religions","tags":["Religion"]}},"/v1/religions/{code}":{"get":{"parameters":[{"description":"Lower-case slug identifier","schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,63}$","minLength":1,"maxLength":64,"example":"lords-prayer"},"in":"path","name":"code","required":true},{"description":"ISO 639-1 language code","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","minLength":2,"maxLength":2,"example":"pl"},"in":"query","name":"lang","required":false}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["code","name","family","foundedYear","adherents","wikidataId"],"properties":{"code":{"example":"christianity","type":"string"},"name":{"example":"Christianity","type":"string"},"family":{"example":"Abrahamic","type":"string"},"foundedYear":{"nullable":true,"anyOf":[{"example":30,"description":"Negative values are BCE","type":"number"},{"type":"null"}]},"adherents":{"nullable":true,"anyOf":[{"example":2380000000,"type":"number"},{"type":"null"}]},"wikidataId":{"nullable":true,"anyOf":[{"example":"Q5043","type":"string"},{"type":"null"}]}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["code","name","family","foundedYear","adherents","wikidataId"],"properties":{"code":{"example":"christianity","type":"string"},"name":{"example":"Christianity","type":"string"},"family":{"example":"Abrahamic","type":"string"},"foundedYear":{"nullable":true,"anyOf":[{"example":30,"description":"Negative values are BCE","type":"number"},{"type":"null"}]},"adherents":{"nullable":true,"anyOf":[{"example":2380000000,"type":"number"},{"type":"null"}]},"wikidataId":{"nullable":true,"anyOf":[{"example":"Q5043","type":"string"},{"type":"null"}]}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["code","name","family","foundedYear","adherents","wikidataId"],"properties":{"code":{"example":"christianity","type":"string"},"name":{"example":"Christianity","type":"string"},"family":{"example":"Abrahamic","type":"string"},"foundedYear":{"nullable":true,"anyOf":[{"example":30,"description":"Negative values are BCE","type":"number"},{"type":"null"}]},"adherents":{"nullable":true,"anyOf":[{"example":2380000000,"type":"number"},{"type":"null"}]},"wikidataId":{"nullable":true,"anyOf":[{"example":"Q5043","type":"string"},{"type":"null"}]}}}},"required":["status","data"]}}}},"404":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1ReligionsByCode","summary":"Get a religion","tags":["Religion"]}},"/v1/religions/{code}/denominations":{"get":{"parameters":[{"description":"Lower-case slug identifier","schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,63}$","minLength":1,"maxLength":64,"example":"lords-prayer"},"in":"path","name":"code","required":true},{"description":"ISO 639-1 language code","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","minLength":2,"maxLength":2,"example":"pl"},"in":"query","name":"lang","required":false}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","religionCode","name","branch","foundedYear","wikidataId"],"properties":{"code":{"example":"catholicism","type":"string"},"religionCode":{"example":"christianity","type":"string"},"name":{"example":"Catholic Church","type":"string"},"branch":{"nullable":true,"anyOf":[{"example":"Catholicism","type":"string"},{"type":"null"}]},"foundedYear":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]},"wikidataId":{"nullable":true,"anyOf":[{"example":"Q9592","type":"string"},{"type":"null"}]}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","religionCode","name","branch","foundedYear","wikidataId"],"properties":{"code":{"example":"catholicism","type":"string"},"religionCode":{"example":"christianity","type":"string"},"name":{"example":"Catholic Church","type":"string"},"branch":{"nullable":true,"anyOf":[{"example":"Catholicism","type":"string"},{"type":"null"}]},"foundedYear":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]},"wikidataId":{"nullable":true,"anyOf":[{"example":"Q9592","type":"string"},{"type":"null"}]}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","religionCode","name","branch","foundedYear","wikidataId"],"properties":{"code":{"example":"catholicism","type":"string"},"religionCode":{"example":"christianity","type":"string"},"name":{"example":"Catholic Church","type":"string"},"branch":{"nullable":true,"anyOf":[{"example":"Catholicism","type":"string"},{"type":"null"}]},"foundedYear":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]},"wikidataId":{"nullable":true,"anyOf":[{"example":"Q9592","type":"string"},{"type":"null"}]}}}}},"required":["status","data"]}}}}},"operationId":"getV1ReligionsByCodeDenominations","summary":"List denominations of a religion","tags":["Religion"]}},"/v1/scripture/texts":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","religionCode","originalLanguage","canonicalUnits","editionCount","languageCount"],"properties":{"code":{"example":"bible","type":"string"},"religionCode":{"example":"christianity","type":"string"},"originalLanguage":{"nullable":true,"anyOf":[{"example":"grc","type":"string"},{"type":"null"}]},"canonicalUnits":{"nullable":true,"anyOf":[{"example":"book/chapter/verse","type":"string"},{"type":"null"}]},"editionCount":{"example":1667,"type":"number"},"languageCount":{"example":1242,"type":"number"}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","religionCode","originalLanguage","canonicalUnits","editionCount","languageCount"],"properties":{"code":{"example":"bible","type":"string"},"religionCode":{"example":"christianity","type":"string"},"originalLanguage":{"nullable":true,"anyOf":[{"example":"grc","type":"string"},{"type":"null"}]},"canonicalUnits":{"nullable":true,"anyOf":[{"example":"book/chapter/verse","type":"string"},{"type":"null"}]},"editionCount":{"example":1667,"type":"number"},"languageCount":{"example":1242,"type":"number"}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","religionCode","originalLanguage","canonicalUnits","editionCount","languageCount"],"properties":{"code":{"example":"bible","type":"string"},"religionCode":{"example":"christianity","type":"string"},"originalLanguage":{"nullable":true,"anyOf":[{"example":"grc","type":"string"},{"type":"null"}]},"canonicalUnits":{"nullable":true,"anyOf":[{"example":"book/chapter/verse","type":"string"},{"type":"null"}]},"editionCount":{"example":1667,"type":"number"},"languageCount":{"example":1242,"type":"number"}}}}},"required":["status","data"]}}}}},"operationId":"getV1ScriptureTexts","summary":"List sacred texts and the reach of their edition catalogue","tags":["Religion"]}},"/v1/scripture/texts/{textCode}/editions":{"get":{"parameters":[{"description":"Lower-case slug identifier","schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,63}$","minLength":1,"maxLength":64,"example":"lords-prayer"},"in":"path","name":"textCode","required":true},{"description":"ISO 639-1 or ISO 639-3 language code","schema":{"type":"string","pattern":"^[A-Za-z]{2,3}$","minLength":2,"maxLength":3,"example":"pol"},"in":"query","name":"lang","required":false},{"description":"Only editions whose verses are ingested","schema":{"type":"boolean","default":false},"in":"query","name":"withText","required":false},{"schema":{"minimum":1,"maximum":2000,"default":200,"anyOf":[{"format":"integer","default":0,"type":"string"},{"minimum":1,"maximum":2000,"default":200,"type":"integer"}]},"in":"query","name":"limit","required":false}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","textCode","source","langCode","languageName","title","shortTitle","script","direction","copyright","redistributable","hasText","verseCount"],"properties":{"id":{"example":"getbible:kjv","type":"string"},"textCode":{"example":"bible","type":"string"},"source":{"example":"getbible","type":"string"},"langCode":{"example":"en","type":"string"},"languageName":{"nullable":true,"anyOf":[{"example":"English","type":"string"},{"type":"null"}]},"title":{"example":"King James Version","type":"string"},"shortTitle":{"nullable":true,"anyOf":[{"example":"kjv","type":"string"},{"type":"null"}]},"script":{"nullable":true,"anyOf":[{"example":"Latn","type":"string"},{"type":"null"}]},"direction":{"example":"LTR","type":"string"},"copyright":{"nullable":true,"anyOf":[{"example":"Public Domain","type":"string"},{"type":"null"}]},"redistributable":{"example":1,"type":"number"},"hasText":{"example":1,"description":"1 when verse text has been ingested","type":"number"},"verseCount":{"example":31102,"type":"number"}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","textCode","source","langCode","languageName","title","shortTitle","script","direction","copyright","redistributable","hasText","verseCount"],"properties":{"id":{"example":"getbible:kjv","type":"string"},"textCode":{"example":"bible","type":"string"},"source":{"example":"getbible","type":"string"},"langCode":{"example":"en","type":"string"},"languageName":{"nullable":true,"anyOf":[{"example":"English","type":"string"},{"type":"null"}]},"title":{"example":"King James Version","type":"string"},"shortTitle":{"nullable":true,"anyOf":[{"example":"kjv","type":"string"},{"type":"null"}]},"script":{"nullable":true,"anyOf":[{"example":"Latn","type":"string"},{"type":"null"}]},"direction":{"example":"LTR","type":"string"},"copyright":{"nullable":true,"anyOf":[{"example":"Public Domain","type":"string"},{"type":"null"}]},"redistributable":{"example":1,"type":"number"},"hasText":{"example":1,"description":"1 when verse text has been ingested","type":"number"},"verseCount":{"example":31102,"type":"number"}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","textCode","source","langCode","languageName","title","shortTitle","script","direction","copyright","redistributable","hasText","verseCount"],"properties":{"id":{"example":"getbible:kjv","type":"string"},"textCode":{"example":"bible","type":"string"},"source":{"example":"getbible","type":"string"},"langCode":{"example":"en","type":"string"},"languageName":{"nullable":true,"anyOf":[{"example":"English","type":"string"},{"type":"null"}]},"title":{"example":"King James Version","type":"string"},"shortTitle":{"nullable":true,"anyOf":[{"example":"kjv","type":"string"},{"type":"null"}]},"script":{"nullable":true,"anyOf":[{"example":"Latn","type":"string"},{"type":"null"}]},"direction":{"example":"LTR","type":"string"},"copyright":{"nullable":true,"anyOf":[{"example":"Public Domain","type":"string"},{"type":"null"}]},"redistributable":{"example":1,"type":"number"},"hasText":{"example":1,"description":"1 when verse text has been ingested","type":"number"},"verseCount":{"example":31102,"type":"number"}}}}},"required":["status","data"]}}}}},"operationId":"getV1ScriptureTextsByTextCodeEditions","summary":"List editions of a sacred text","tags":["Religion"]}},"/v1/prayers":{"get":{"parameters":[{"description":"ISO 639-1 language code","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","minLength":2,"maxLength":2,"example":"pl"},"in":"query","name":"lang","required":false},{"description":"Lower-case slug identifier","schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,63}$","minLength":1,"maxLength":64,"example":"lords-prayer"},"in":"query","name":"religion","required":false},{"description":"Lower-case slug identifier","schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,63}$","minLength":1,"maxLength":64,"example":"lords-prayer"},"in":"query","name":"category","required":false}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","religionCode","denominationCode","category","sourceRef","title"],"properties":{"code":{"example":"lords-prayer","type":"string"},"religionCode":{"example":"christianity","type":"string"},"denominationCode":{"nullable":true,"anyOf":[{"type":"string"},{"type":"null"}]},"category":{"example":"daily","type":"string"},"sourceRef":{"nullable":true,"anyOf":[{"example":"Matthew 6:9-13; Luke 11:2-4","type":"string"},{"type":"null"}]},"title":{"nullable":true,"anyOf":[{"example":"The Lord's Prayer","type":"string"},{"type":"null"}]}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","religionCode","denominationCode","category","sourceRef","title"],"properties":{"code":{"example":"lords-prayer","type":"string"},"religionCode":{"example":"christianity","type":"string"},"denominationCode":{"nullable":true,"anyOf":[{"type":"string"},{"type":"null"}]},"category":{"example":"daily","type":"string"},"sourceRef":{"nullable":true,"anyOf":[{"example":"Matthew 6:9-13; Luke 11:2-4","type":"string"},{"type":"null"}]},"title":{"nullable":true,"anyOf":[{"example":"The Lord's Prayer","type":"string"},{"type":"null"}]}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","religionCode","denominationCode","category","sourceRef","title"],"properties":{"code":{"example":"lords-prayer","type":"string"},"religionCode":{"example":"christianity","type":"string"},"denominationCode":{"nullable":true,"anyOf":[{"type":"string"},{"type":"null"}]},"category":{"example":"daily","type":"string"},"sourceRef":{"nullable":true,"anyOf":[{"example":"Matthew 6:9-13; Luke 11:2-4","type":"string"},{"type":"null"}]},"title":{"nullable":true,"anyOf":[{"example":"The Lord's Prayer","type":"string"},{"type":"null"}]}}}}},"required":["status","data"]}}}}},"operationId":"getV1Prayers","summary":"List prayers","tags":["Religion"]}},"/v1/prayers/search":{"get":{"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":128},"in":"query","name":"q","required":true},{"schema":{"minimum":1,"maximum":100,"default":25,"anyOf":[{"format":"integer","default":0,"type":"string"},{"minimum":1,"maximum":100,"default":25,"type":"integer"}]},"in":"query","name":"limit","required":false}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["prayerCode","langCode","title","body"],"properties":{"prayerCode":{"type":"string"},"langCode":{"type":"string"},"title":{"type":"string"},"body":{"nullable":true,"anyOf":[{"type":"string"},{"type":"null"}]}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["prayerCode","langCode","title","body"],"properties":{"prayerCode":{"type":"string"},"langCode":{"type":"string"},"title":{"type":"string"},"body":{"nullable":true,"anyOf":[{"type":"string"},{"type":"null"}]}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["prayerCode","langCode","title","body"],"properties":{"prayerCode":{"type":"string"},"langCode":{"type":"string"},"title":{"type":"string"},"body":{"nullable":true,"anyOf":[{"type":"string"},{"type":"null"}]}}}}},"required":["status","data"]}}}},"400":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1PrayersSearch","summary":"Search prayer wording","tags":["Religion"]}},"/v1/prayers/{code}/{lang}":{"get":{"parameters":[{"description":"Lower-case slug identifier","schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,63}$","minLength":1,"maxLength":64,"example":"lords-prayer"},"in":"path","name":"code","required":true},{"description":"ISO 639-1 or ISO 639-3 language code","schema":{"type":"string","pattern":"^[A-Za-z]{2,3}$","minLength":2,"maxLength":3,"example":"pol"},"in":"path","name":"lang","required":true}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["code","religionCode","category","sourceRef","lang","renderings"],"properties":{"code":{"example":"lords-prayer","type":"string"},"religionCode":{"example":"christianity","type":"string"},"category":{"example":"daily","type":"string"},"sourceRef":{"nullable":true,"anyOf":[{"type":"string"},{"type":"null"}]},"lang":{"example":"en","type":"string"},"renderings":{"type":"array","items":{"type":"object","required":["source","editionId","editionTitle","reference","attribution","title","transliteration","text"],"properties":{"source":{"example":"scripture","description":"scripture | curated","type":"string"},"editionId":{"nullable":true,"anyOf":[{"example":"getbible:kjv","type":"string"},{"type":"null"}]},"editionTitle":{"nullable":true,"anyOf":[{"example":"King James Version","type":"string"},{"type":"null"}]},"reference":{"nullable":true,"anyOf":[{"example":"MAT 6:9-13","type":"string"},{"type":"null"}]},"attribution":{"nullable":true,"anyOf":[{"example":"Public Domain","type":"string"},{"type":"null"}]},"title":{"nullable":true,"anyOf":[{"type":"string"},{"type":"null"}]},"transliteration":{"nullable":true,"anyOf":[{"type":"string"},{"type":"null"}]},"text":{"type":"string"}}}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["code","religionCode","category","sourceRef","lang","renderings"],"properties":{"code":{"example":"lords-prayer","type":"string"},"religionCode":{"example":"christianity","type":"string"},"category":{"example":"daily","type":"string"},"sourceRef":{"nullable":true,"anyOf":[{"type":"string"},{"type":"null"}]},"lang":{"example":"en","type":"string"},"renderings":{"type":"array","items":{"type":"object","required":["source","editionId","editionTitle","reference","attribution","title","transliteration","text"],"properties":{"source":{"example":"scripture","description":"scripture | curated","type":"string"},"editionId":{"nullable":true,"anyOf":[{"example":"getbible:kjv","type":"string"},{"type":"null"}]},"editionTitle":{"nullable":true,"anyOf":[{"example":"King James Version","type":"string"},{"type":"null"}]},"reference":{"nullable":true,"anyOf":[{"example":"MAT 6:9-13","type":"string"},{"type":"null"}]},"attribution":{"nullable":true,"anyOf":[{"example":"Public Domain","type":"string"},{"type":"null"}]},"title":{"nullable":true,"anyOf":[{"type":"string"},{"type":"null"}]},"transliteration":{"nullable":true,"anyOf":[{"type":"string"},{"type":"null"}]},"text":{"type":"string"}}}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["code","religionCode","category","sourceRef","lang","renderings"],"properties":{"code":{"example":"lords-prayer","type":"string"},"religionCode":{"example":"christianity","type":"string"},"category":{"example":"daily","type":"string"},"sourceRef":{"nullable":true,"anyOf":[{"type":"string"},{"type":"null"}]},"lang":{"example":"en","type":"string"},"renderings":{"type":"array","items":{"type":"object","required":["source","editionId","editionTitle","reference","attribution","title","transliteration","text"],"properties":{"source":{"example":"scripture","description":"scripture | curated","type":"string"},"editionId":{"nullable":true,"anyOf":[{"example":"getbible:kjv","type":"string"},{"type":"null"}]},"editionTitle":{"nullable":true,"anyOf":[{"example":"King James Version","type":"string"},{"type":"null"}]},"reference":{"nullable":true,"anyOf":[{"example":"MAT 6:9-13","type":"string"},{"type":"null"}]},"attribution":{"nullable":true,"anyOf":[{"example":"Public Domain","type":"string"},{"type":"null"}]},"title":{"nullable":true,"anyOf":[{"type":"string"},{"type":"null"}]},"transliteration":{"nullable":true,"anyOf":[{"type":"string"},{"type":"null"}]},"text":{"type":"string"}}}}}}},"required":["status","data"]}}}},"404":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1PrayersByCodeByLang","summary":"Get a prayer's wording in a language","description":"Returns every available rendering. A prayer that is a scripture passage resolves from each ingested edition in the requested language, so its language coverage is the coverage of the scripture corpus rather than a hand-translated list.","tags":["Religion"]}},"/v1/prayer-times/methods":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","name","fajrAngle","ishaAngle","ishaIntervalMinutes","maghribAngle","region"],"properties":{"code":{"example":"MWL","type":"string"},"name":{"example":"Muslim World League","type":"string"},"fajrAngle":{"example":18,"type":"number"},"ishaAngle":{"nullable":true,"anyOf":[{"example":17,"type":"number"},{"type":"null"}]},"ishaIntervalMinutes":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]},"maghribAngle":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]},"region":{"nullable":true,"anyOf":[{"type":"string"},{"type":"null"}]}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","name","fajrAngle","ishaAngle","ishaIntervalMinutes","maghribAngle","region"],"properties":{"code":{"example":"MWL","type":"string"},"name":{"example":"Muslim World League","type":"string"},"fajrAngle":{"example":18,"type":"number"},"ishaAngle":{"nullable":true,"anyOf":[{"example":17,"type":"number"},{"type":"null"}]},"ishaIntervalMinutes":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]},"maghribAngle":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]},"region":{"nullable":true,"anyOf":[{"type":"string"},{"type":"null"}]}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","name","fajrAngle","ishaAngle","ishaIntervalMinutes","maghribAngle","region"],"properties":{"code":{"example":"MWL","type":"string"},"name":{"example":"Muslim World League","type":"string"},"fajrAngle":{"example":18,"type":"number"},"ishaAngle":{"nullable":true,"anyOf":[{"example":17,"type":"number"},{"type":"null"}]},"ishaIntervalMinutes":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]},"maghribAngle":{"nullable":true,"anyOf":[{"type":"number"},{"type":"null"}]},"region":{"nullable":true,"anyOf":[{"type":"string"},{"type":"null"}]}}}}},"required":["status","data"]}}}}},"operationId":"getV1Prayer-timesMethods","summary":"List salah calculation conventions","tags":["Religion"]}},"/v1/prayer-times":{"get":{"parameters":[{"description":"Latitude in decimal degrees","schema":{"minimum":-90,"maximum":90,"example":52.2297,"anyOf":[{"format":"numeric","default":0,"type":"string"},{"minimum":-90,"maximum":90,"description":"Latitude in decimal degrees","example":52.2297,"type":"number"}]},"in":"query","name":"latitude","required":true},{"description":"Longitude in decimal degrees","schema":{"minimum":-180,"maximum":180,"example":21.0122,"anyOf":[{"format":"numeric","default":0,"type":"string"},{"minimum":-180,"maximum":180,"description":"Longitude in decimal degrees","example":21.0122,"type":"number"}]},"in":"query","name":"longitude","required":true},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","example":"2026-08-15"},"in":"query","name":"date","required":true},{"schema":{"type":"string","pattern":"^[A-Za-z]{2,12}$","default":"MWL"},"in":"query","name":"method","required":false},{"schema":{"minimum":-12,"maximum":14,"default":0,"anyOf":[{"format":"numeric","default":0,"type":"string"},{"minimum":-12,"maximum":14,"default":0,"type":"number"}]},"in":"query","name":"timezoneOffset","required":false},{"schema":{"minimum":1,"maximum":2,"default":1,"anyOf":[{"format":"numeric","default":0,"type":"string"},{"minimum":1,"maximum":2,"default":1,"type":"number"}]},"in":"query","name":"asrShadowFactor","required":false}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["date","method","latitude","longitude","timezoneOffset","asrShadowFactor","times"],"properties":{"date":{"example":"2026-08-15","type":"string"},"method":{"example":"MWL","type":"string"},"latitude":{"example":21.4225,"type":"number"},"longitude":{"example":39.8262,"type":"number"},"timezoneOffset":{"example":3,"type":"number"},"asrShadowFactor":{"example":1,"type":"number"},"times":{"type":"object","required":["fajr","sunrise","dhuhr","asr","maghrib","isha"],"properties":{"fajr":{"nullable":true,"anyOf":[{"example":"04:38","type":"string"},{"type":"null"}]},"sunrise":{"nullable":true,"anyOf":[{"example":"05:59","type":"string"},{"type":"null"}]},"dhuhr":{"nullable":true,"anyOf":[{"example":"12:25","type":"string"},{"type":"null"}]},"asr":{"nullable":true,"anyOf":[{"example":"15:47","type":"string"},{"type":"null"}]},"maghrib":{"nullable":true,"anyOf":[{"example":"18:52","type":"string"},{"type":"null"}]},"isha":{"nullable":true,"anyOf":[{"example":"20:22","type":"string"},{"type":"null"}]}}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["date","method","latitude","longitude","timezoneOffset","asrShadowFactor","times"],"properties":{"date":{"example":"2026-08-15","type":"string"},"method":{"example":"MWL","type":"string"},"latitude":{"example":21.4225,"type":"number"},"longitude":{"example":39.8262,"type":"number"},"timezoneOffset":{"example":3,"type":"number"},"asrShadowFactor":{"example":1,"type":"number"},"times":{"type":"object","required":["fajr","sunrise","dhuhr","asr","maghrib","isha"],"properties":{"fajr":{"nullable":true,"anyOf":[{"example":"04:38","type":"string"},{"type":"null"}]},"sunrise":{"nullable":true,"anyOf":[{"example":"05:59","type":"string"},{"type":"null"}]},"dhuhr":{"nullable":true,"anyOf":[{"example":"12:25","type":"string"},{"type":"null"}]},"asr":{"nullable":true,"anyOf":[{"example":"15:47","type":"string"},{"type":"null"}]},"maghrib":{"nullable":true,"anyOf":[{"example":"18:52","type":"string"},{"type":"null"}]},"isha":{"nullable":true,"anyOf":[{"example":"20:22","type":"string"},{"type":"null"}]}}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"object","required":["date","method","latitude","longitude","timezoneOffset","asrShadowFactor","times"],"properties":{"date":{"example":"2026-08-15","type":"string"},"method":{"example":"MWL","type":"string"},"latitude":{"example":21.4225,"type":"number"},"longitude":{"example":39.8262,"type":"number"},"timezoneOffset":{"example":3,"type":"number"},"asrShadowFactor":{"example":1,"type":"number"},"times":{"type":"object","required":["fajr","sunrise","dhuhr","asr","maghrib","isha"],"properties":{"fajr":{"nullable":true,"anyOf":[{"example":"04:38","type":"string"},{"type":"null"}]},"sunrise":{"nullable":true,"anyOf":[{"example":"05:59","type":"string"},{"type":"null"}]},"dhuhr":{"nullable":true,"anyOf":[{"example":"12:25","type":"string"},{"type":"null"}]},"asr":{"nullable":true,"anyOf":[{"example":"15:47","type":"string"},{"type":"null"}]},"maghrib":{"nullable":true,"anyOf":[{"example":"18:52","type":"string"},{"type":"null"}]},"isha":{"nullable":true,"anyOf":[{"example":"20:22","type":"string"},{"type":"null"}]}}}}}},"required":["status","data"]}}}},"400":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}},"404":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1Prayer-times","summary":"Compute salah times for a place and date","description":"Computed from the sun's position, not looked up. A time is null where the sun never reaches the required depression that day, which is the honest answer at high latitude rather than a clamped one.","tags":["Religion"]}},"/v1/observances":{"get":{"parameters":[{"description":"Lower-case slug identifier","schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,63}$","minLength":1,"maxLength":64,"example":"lords-prayer"},"in":"query","name":"religion","required":false}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","religionCode","name","calendar","month","day","durationDays","ruleNote"],"properties":{"code":{"example":"ramadan","type":"string"},"religionCode":{"example":"islam","type":"string"},"name":{"example":"Ramadan","type":"string"},"calendar":{"example":"hijri","type":"string"},"month":{"nullable":true,"anyOf":[{"example":9,"type":"number"},{"type":"null"}]},"day":{"nullable":true,"anyOf":[{"example":1,"type":"number"},{"type":"null"}]},"durationDays":{"example":29,"type":"number"},"ruleNote":{"nullable":true,"anyOf":[{"type":"string"},{"type":"null"}]}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","religionCode","name","calendar","month","day","durationDays","ruleNote"],"properties":{"code":{"example":"ramadan","type":"string"},"religionCode":{"example":"islam","type":"string"},"name":{"example":"Ramadan","type":"string"},"calendar":{"example":"hijri","type":"string"},"month":{"nullable":true,"anyOf":[{"example":9,"type":"number"},{"type":"null"}]},"day":{"nullable":true,"anyOf":[{"example":1,"type":"number"},{"type":"null"}]},"durationDays":{"example":29,"type":"number"},"ruleNote":{"nullable":true,"anyOf":[{"type":"string"},{"type":"null"}]}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["code","religionCode","name","calendar","month","day","durationDays","ruleNote"],"properties":{"code":{"example":"ramadan","type":"string"},"religionCode":{"example":"islam","type":"string"},"name":{"example":"Ramadan","type":"string"},"calendar":{"example":"hijri","type":"string"},"month":{"nullable":true,"anyOf":[{"example":9,"type":"number"},{"type":"null"}]},"day":{"nullable":true,"anyOf":[{"example":1,"type":"number"},{"type":"null"}]},"durationDays":{"example":29,"type":"number"},"ruleNote":{"nullable":true,"anyOf":[{"type":"string"},{"type":"null"}]}}}}},"required":["status","data"]}}}}},"operationId":"getV1Observances","summary":"List religious observances","description":"Returned as rules in their own calendar system, not as precomputed Gregorian dates — a date is only meaningful together with the calendar it is counted in.","tags":["Religion"]}},"/v1/scripture/editions/{editionId}/{book}/{chapter}":{"get":{"parameters":[{"description":"Scripture edition identifier, source-prefixed","schema":{"type":"string","pattern":"^[a-z]+:[A-Za-z0-9._-]{1,64}$","minLength":3,"maxLength":80,"example":"getbible:kjv"},"in":"path","name":"editionId","required":true},{"description":"Canonical book code (USFM), or Q for the Qur'an","schema":{"type":"string","pattern":"^[A-Z0-9]{1,3}$","minLength":1,"maxLength":3,"example":"MAT"},"in":"path","name":"book","required":true},{"description":"Chapter number (surah for the Qur'an)","schema":{"minimum":1,"maximum":1000,"example":6,"anyOf":[{"format":"integer","default":0,"type":"string"},{"minimum":1,"maximum":1000,"description":"Chapter number (surah for the Qur'an)","example":6,"type":"integer"}]},"in":"path","name":"chapter","required":true}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["editionId","book","chapter","verse","text"],"properties":{"editionId":{"example":"getbible:kjv","type":"string"},"book":{"example":"MAT","type":"string"},"chapter":{"example":6,"type":"number"},"verse":{"example":9,"type":"number"},"text":{"example":"After this manner therefore pray ye...","type":"string"}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["editionId","book","chapter","verse","text"],"properties":{"editionId":{"example":"getbible:kjv","type":"string"},"book":{"example":"MAT","type":"string"},"chapter":{"example":6,"type":"number"},"verse":{"example":9,"type":"number"},"text":{"example":"After this manner therefore pray ye...","type":"string"}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["editionId","book","chapter","verse","text"],"properties":{"editionId":{"example":"getbible:kjv","type":"string"},"book":{"example":"MAT","type":"string"},"chapter":{"example":6,"type":"number"},"verse":{"example":9,"type":"number"},"text":{"example":"After this manner therefore pray ye...","type":"string"}}}}},"required":["status","data"]}}}},"404":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1ScriptureEditionsByEditionIdByBookByChapter","summary":"Get a chapter of a scripture edition","tags":["Religion"]}},"/v1/scripture/search":{"get":{"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":128},"in":"query","name":"q","required":true},{"schema":{"minimum":1,"maximum":100,"default":25,"anyOf":[{"format":"integer","default":0,"type":"string"},{"minimum":1,"maximum":100,"default":25,"type":"integer"}]},"in":"query","name":"limit","required":false}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["editionId","book","chapter","verse","text"],"properties":{"editionId":{"example":"getbible:kjv","type":"string"},"book":{"example":"MAT","type":"string"},"chapter":{"example":6,"type":"number"},"verse":{"example":9,"type":"number"},"text":{"example":"After this manner therefore pray ye...","type":"string"}}}}},"required":["status","data"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["editionId","book","chapter","verse","text"],"properties":{"editionId":{"example":"getbible:kjv","type":"string"},"book":{"example":"MAT","type":"string"},"chapter":{"example":6,"type":"number"},"verse":{"example":9,"type":"number"},"text":{"example":"After this manner therefore pray ye...","type":"string"}}}}},"required":["status","data"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"success","type":"string"},"count":{"description":"Total records returned in data payload","type":"number"},"lang":{"description":"Resolved language code of the localized data","type":"string"},"nextCursor":{"description":"Pass as ?cursor= to retrieve the next page; absent on the last page","type":"string"},"data":{"type":"array","items":{"type":"object","required":["editionId","book","chapter","verse","text"],"properties":{"editionId":{"example":"getbible:kjv","type":"string"},"book":{"example":"MAT","type":"string"},"chapter":{"example":6,"type":"number"},"verse":{"example":9,"type":"number"},"text":{"example":"After this manner therefore pray ye...","type":"string"}}}}},"required":["status","data"]}}}},"400":{"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"multipart/form-data":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}},"text/plain":{"schema":{"type":"object","properties":{"status":{"const":"error","type":"string"},"code":{"description":"Machine-readable error identifier","type":"string"},"message":{"description":"Human-readable error explanation","type":"string"}},"required":["status","code","message"]}}}}},"operationId":"getV1ScriptureSearch","summary":"Full-text search across ingested scripture","tags":["Religion"]}}},"components":{"schemas":{}}}