GET /api-keys
Returns a paginated list of API keys belonging to the authenticated account.
Base URL: https://api.geocerta.io
Sandbox URL: https://api-staging.geocerta.io
Authentication required. Include your API key in the
api-keyheader. See Authentication.
Endpoint
GET /api-keysQuery Parameters
| Field | Type | Required | Description |
|---|---|---|---|
page | number | No | Page number. Default: 1. |
per_page | number | No | Results per page. Default: 20, max 500. |
status | string | No | Filter by key status: active or revoked. |
name | string | No | Filter by key name (partial match). |
Response
200 OK — returns a paginated list of API keys.
API key fields
| Field | Type | Description |
|---|---|---|
_id | string | Unique key identifier |
name | string | Label given to this key |
owner.id | string | ID of the owning account |
owner.name | string | Name of the owning account |
status | string | active or revoked |
last_4 | string | Last 4 characters of the raw key |
created_at | string | ISO 8601 creation timestamp |
updated_at | string | ISO 8601 last-updated timestamp |
Errors
| Status | Message | Cause |
|---|---|---|
400 | Bad Request | Invalid query parameters |
401 | Unauthorized | Missing or invalid API key |
Example
curl "https://api.geocerta.io/api-keys?status=active" \
-H "api-key: YOUR_API_KEY"