ParseAPI Point API
Country, state, county, and timezone at a coordinate.
Country, state, county, and timezone at a coordinate.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/parseapi-com:parseapi-com-point-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Parse Point API
version: 1.0.0
summary: Fast APIs for developers, locate, validate, decode.
description: 'One base URL, one key, minimal JSON. Response schemas describe API 2.3.0. Paid plans include their profile detail automatically at its natural resource homes; Free returns the complete ordinary answer. There is no deep response object. When neither version header is sent, requests use the saved team default, or 1.0.0 for keyless self-lookups. Read https://parseapi.com/docs/versioning for other supported contracts. Responses that reach the organization rate check carry X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset. Optional X-RateLimit-Burst indicates continuous refill. Rate-limit 429 responses add Retry-After (seconds). See https://parseapi.com/agents and https://parseapi.com/llms.txt for agent-oriented guidance. Field-level docs: https://parseapi.com/docs Free-plan users must include a link to ParseAPI on their website, app, or project documentation. A footer, about page, credits page, or another reasonable location is fine. Paid plans do not require ParseAPI attribution. Example HTML: Data provided by ParseAPI. Details: https://parseapi.com/legal/attribution#crediting-parseapi.'
termsOfService: https://parseapi.com/legal/terms
contact:
name: ParseAPI
email: hello@parseapi.com
url: https://parseapi.com
servers:
- url: https://api.parseapi.com
description: Production
tags:
- name: Point
description: Country, state, county, and timezone at a coordinate.
externalDocs:
description: Point API docs
url: https://parseapi.com/docs/point
paths:
/point:
get:
operationId: point
tags:
- Point
summary: Place and time zone at a latitude/longitude
description: 'Locate the supplied coordinates. Core includes the point’s geography and timezone on every plan. Deep adds a compact nearest-city summary within 200 km, including city.id for /city/id/{id} and straight-line distance, or city: null when unavailable; the point’s geography is retained. In API 2.2.0, paid requests include terrain, nearest-city detail, electoral.code, electoral.name and electoral.congress automatically in the same pooled API request, with no additional unit. Electoral uses the exact point and supported US congressional boundaries for the 119th Congress. A boundary point, multiple matches, unsupported area, or unavailable boundary data returns electoral: null in the requested detail. The electoral object identifies the area for the national lower-house or sole legislative chamber. electoral.code is an opaque country-specific string in the current boundary edition, preserving letters and leading zeros; it is not a globally unique or permanent identifier. electoral.congress is the US Congress number and is null for other national legislatures. electoral.name is the official name, currently the literal Census name for the matched US district, or null when a verified name is unavailable. US electoral area codes use state FIPS plus district, with 00 for at-large and 98 for delegate districts; 99 is unsupported. The administrative county reference retains its existing meaning. Free requests omit electoral detail unless existing access and an explicit request include it. The frozen 1.0.0 contract is unchanged. Full field reference: https://parseapi.com/docs/point'
security:
- ApiKeyAuth: []
- BearerAuth: []
parameters:
- $ref: '#/components/parameters/ParseVersion'
- name: format
in: query
required: false
description: 'Optional geojson returns a Feature: exact [longitude, latitude] geometry and the same selected facts in properties. Content-Type: application/geo+json. Omit for ordinary JSON.'
schema:
type: string
enum:
- geojson
- name: lat
in: query
required: true
description: Latitude
schema:
type: number
example: 39.77
- name: lon
in: query
required: true
description: Longitude
schema:
type: number
example: -104.9
- name: lang
in: query
required: false
description: Display language as one BCP 47 tag, such as fr or zh-Hant. Changes supported display labels only; IDs, codes, native names, facts, parsing and deep access stay unchanged. Omit for the original response. Unsupported regions use the supported language base; unsupported languages or scripts use English. Missing labels retain their source value. Accept-Language is not read automatically. Available on the current API contract; frozen 1.0.0 is unchanged.
schema:
type: string
minLength: 2
maxLength: 64
example: fr
x-supported-locales:
- en
- ar
- ca
- hr
- cs
- da
- nl
- fi
- fr
- de
- el
- he
- hi
- hu
- id
- it
- ja
- ko
- ms
- nb
- pl
- pt
- ro
- ru
- zh-Hans
- sk
- es
- sv
- th
- zh-Hant
- tr
- uk
- vi
- name: deep
in: query
required: false
description: Terrain elevation, a compact nearest-city summary, and supported US electoral area code, name and Congress number. Included automatically on paid plans in API 2.2. Existing accounts retain their current profile access.
schema:
type: boolean
responses:
'200':
description: Success, minimal JSON object (shape varies by endpoint)
headers:
X-RateLimit-Limit:
description: Sustained requests per minute for your team
schema:
type: integer
X-RateLimit-Remaining:
description: Estimated requests available in the current window or token bucket
schema:
type: integer
X-RateLimit-Reset:
description: Seconds until the window resets, or until full bucket recovery with no more calls when X-RateLimit-Burst is present. On a 429 use Retry-After for the next attempt.
schema:
type: integer
X-RateLimit-Burst:
description: Optional token bucket capacity. When present, capacity replenishes continuously at X-RateLimit-Limit requests per minute.
schema:
type: integer
X-API-Version:
description: The exact response contract selected for this request.
schema:
type: string
enum:
- 1.0.0
- 2.0.0
- 2.1.0
- 2.2.0
- 2.3.0
Content-Language:
description: Languages used in selected display fields, including known English fallbacks. Unchanged native or source text does not imply a language.
schema:
type: string
example: fr
content:
application/json:
schema:
type: object
properties:
latitude:
type: number
longitude:
type: number
county:
type:
- string
- 'null'
county_name:
type:
- string
- 'null'
state:
type:
- string
- 'null'
state_name:
type:
- string
- 'null'
country:
type:
- string
- 'null'
country_name:
type:
- string
- 'null'
timezone:
type:
- string
- 'null'
city:
type:
- object
- 'null'
properties:
latitude:
type:
- number
- 'null'
longitude:
type:
- number
- 'null'
state:
type:
- string
- 'null'
state_name:
type:
- string
- 'null'
country:
type: string
country_name:
type:
- string
- 'null'
name:
type: string
name_local:
type:
- string
- 'null'
description: Native name, null when absent or exactly identical to the original source name. lang preserves this field, so it may equal the translated display name.
type:
type:
- string
- 'null'
distance:
type: number
distance_mi:
type: number
id:
type: string
required:
- name
- name_local
- type
- state
- state_name
- country
- country_name
- latitude
- longitude
- distance
- distance_mi
- id
additionalProperties: true
elevation:
type:
- number
- 'null'
elevation_ft:
type:
- number
- 'null'
electoral:
type:
- object
- 'null'
properties:
code:
type: string
name:
type:
- string
- 'null'
congress:
type:
- number
- 'null'
required:
- code
- name
- congress
additionalProperties: true
description: National lower-house or sole legislative chamber electoral area containing code, name and congress, or null without a unique supported match. The code belongs to a country-specific source and current boundary edition. Current coverage is US congressional districts for the 119th Congress. Uses the supplied exact coordinates, independently of the administrative county.
required:
- latitude
- longitude
- county
- county_name
- state
- state_name
- country
- country_name
- timezone
additionalProperties: true
application/geo+json:
schema:
type: object
required:
- type
- geometry
- properties
properties:
type:
type: string
const: Feature
geometry:
type: object
required:
- type
- coordinates
properties:
type:
type: string
const: Point
coordinates:
type: array
minItems: 2
maxItems: 2
prefixItems:
- type: number
minimum: -180
maximum: 180
- type: number
minimum: -90
maximum: 90
properties:
type: object
properties:
county:
type:
- string
- 'null'
county_name:
type:
- string
- 'null'
state:
type:
- string
- 'null'
state_name:
type:
- string
- 'null'
country:
type:
- string
- 'null'
country_name:
type:
- string
- 'null'
timezone:
type:
- string
- 'null'
city:
type:
- object
- 'null'
properties:
latitude:
type:
- number
- 'null'
longitude:
type:
- number
- 'null'
state:
type:
- string
- 'null'
state_name:
type:
- string
- 'null'
country:
type: string
country_name:
type:
- string
- 'null'
name:
type: string
name_local:
type:
- string
- 'null'
description: Native name, null when absent or exactly identical to the original source name. lang preserves this field, so it may equal the translated display name.
type:
type:
- string
- 'null'
distance:
type: number
distance_mi:
type: number
id:
type: string
required:
- name
- name_local
- type
- state
- state_name
- country
- country_name
- latitude
- longitude
- distance
- distance_mi
- id
additionalProperties: true
elevation:
type:
- number
- 'null'
elevation_ft:
type:
- number
- 'null'
electoral:
type:
- object
- 'null'
properties:
code:
type: string
name:
type:
- string
- 'null'
congress:
type:
- number
- 'null'
required:
- code
- name
- congress
additionalProperties: true
description: National lower-house or sole legislative chamber electoral area containing code, name and congress, or null without a unique supported match. The code belongs to a country-specific source and current boundary edition. Current coverage is US congressional districts for the 119th Congress. Uses the supplied exact coordinates, independently of the administrative county.
required:
- county
- county_name
- state
- state_name
- country
- country_name
- timezone
additionalProperties: true
'400':
description: invalid_request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: invalid_api_key
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: permission_denied or plan_required
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: not_found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'410':
description: api_version_retired
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: rate_limited or quota_exceeded
headers:
X-RateLimit-Limit:
description: Sustained requests per minute for your team
schema:
type: integer
X-RateLimit-Remaining:
description: Estimated requests available in the current window or token bucket
schema:
type: integer
X-RateLimit-Reset:
description: Seconds until the window resets, or until full bucket recovery with no more calls when X-RateLimit-Burst is present. On a 429 use Retry-After for the next attempt.
schema:
type: integer
X-RateLimit-Burst:
description: Optional token bucket capacity. When present, capacity replenishes continuously at X-RateLimit-Limit requests per minute.
schema:
type: integer
Retry-After:
description: Seconds to wait before retrying
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: server_error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'503':
description: service_unavailable
headers:
Retry-After:
description: Seconds to wait before retrying
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
components:
parameters:
ParseVersion:
name: X-API-Version
in: header
required: false
description: Exact response contract for this lookup. Overrides the saved team default for this request only. Legacy Parse-Version is also accepted; both headers must match if sent together. With neither header, keyed requests use that default and keyless self-lookups use 1.0.0. Invalid or unsupported values return invalid_request (400). Retired selections return api_version_retired (410). Reference/help URLs keep their documented version and do not use this selector.
schema:
type: string
enum:
- 1.0.0
- 2.0.0
- 2.1.0
- 2.2.0
- 2.3.0
example: 2.3.0
schemas:
Error:
type: object
required:
- code
- message
- docs
- request_id
properties:
code:
type: string
description: Machine-readable error code
enum:
- invalid_request
- ambiguous_time
- nonexistent_time
- invalid_api_key
- permission_denied
- plan_required
- not_found
- api_version_retired
- rate_limited
- quota_exceeded
- server_error
- service_unavailable
- dns_resolution_failed
- task_invalid
- task_not_found
- task_request_conflict
- task_budget_exceeded
- task_limit_exceeded
- task_terms_changed
- task_expired
- task_cancelled
- task_in_progress
- task_outcome_unknown
- task_unavailable
message:
type: string
docs:
type: string
format: uri
description: Link to the docs section for this error
request_id:
type: string
description: Send this if you contact support
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
description: API key from the ParseAPI dashboard
BearerAuth:
type: http
scheme: bearer
description: 'Same key as X-API-Key, via Authorization: Bearer'