Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API 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. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Geo-Parity Keys API
version: 1.0.0
description: 'Free, key-less JSON APIs behind geo-parity.com: purchasing power parity, fair global salaries, Schengen 90/180 compliance, cross-timezone meetings, contractor economics, freelance rates, tax-residency day counts, country comparison, cloud region latency, and a digital-nomad visa directory. All GET responses are cacheable; errors return { ok:false, code, message, example }. No key is required: anonymous callers get 1,500 requests/month per IP plus a 30/minute burst cap. An optional API key (Authorization: Bearer gp_live_..., created at /account) only raises those ceilings — responses are identical either way, and a key is metered per account rather than per key. Every response carries X-RateLimit-Limit / -Remaining / -Reset (the minute window) and X-Quota-Limit / -Remaining / -Reset (the calendar month, resetting on the 1st UTC); exceeding either returns 429 with Retry-After and code RATE_LIMITED (slow down) or QUOTA_EXCEEDED (allowance spent — retrying will not help). Figures are informational estimates, not financial/tax/legal advice. Machine discovery: /llms.txt and /.well-known/mcp.json; the same tools are also registered with the browser''s WebMCP ModelContext on every page, executing through /api/mcp.'
contact:
url: https://geo-parity.com
servers:
- url: https://geo-parity.com
security:
- {}
- bearerAuth: []
- apiKeyQuery: []
tags:
- name: Keys
paths:
/api/keys:
get:
operationId: listApiKeys
summary: List your API keys (browser session required; prefixes only, never the key)
responses:
'200':
description: '{ ok: true, keys: [{ id, prefix, label, createdAt, lastUsedAt }] }'
'401':
description: Not signed in.
tags:
- Keys
post:
operationId: createApiKey
summary: Create an API key (browser session required; the raw key is returned exactly…
responses:
'201':
description: '{ ok: true, id, key, prefix } — store `key` now; it is never shown again.'
'401':
description: Not signed in.
'422':
description: TOO_MANY_KEYS — revoke one first (max 5).
tags:
- Keys
delete:
operationId: revokeApiKey
summary: Revoke an API key by id (browser session required)
parameters:
- name: id
in: query
required: true
schema:
type: string
responses:
'200':
description: '{ ok: true }'
'401':
description: Not signed in.
'404':
description: No such key for this account.
tags:
- Keys
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: Optional Geo-Parity API key (gp_live_...), created at /account. Raises the monthly quota and per-minute burst; never changes a response. Metered per account, so extra keys do not add allowance.
apiKeyQuery:
type: apiKey
in: query
name: key
description: The same key, for clients that cannot set headers.
externalDocs:
description: 'Developer guide: quota ladder, error codes, API keys and MCP setup'
url: https://geo-parity.com/developers/