Docs
BetaThe V4 API is in beta — endpoints and functionality may change.
API Keysv4

Get an API key

GET/api-keys/{apiKey}

Fetches a single API key's metadata by its value.

Blooio Apps (OAuth) only. Requires the apikeys:read scope. API-key and dashboard authentication are rejected with 403 oauth_token_required.

Path parameters

apiKeyRequiredstring

The API key value (prefixed with api_), as returned when the key was created or by the List API keys endpoint.

Headers

AuthorizationRequiredstring

Your API key, sent as a bearer token: Authorization: Bearer <api_key>. Editing this stays in sync with the API key box on the right.

Bearer

Returns

dataoptionalApiKey

An organization API key. The api_key field is the secret bearer value — it is returned in full by the create and list endpoints and must be stored securely.

api_keyoptionalstring

The secret key value (prefixed api_). Send it as Authorization: Bearer <api_key> on API requests.

nameoptionalstring | null

Human-readable label for the key.

typeoptionalstring | null

Optional key type/category tag.

created_atoptionalinteger | null

Creation time (epoch milliseconds).

valid_untiloptionalinteger

Expiry time (epoch milliseconds), or -1 when the key never expires.

blockedoptionalboolean

Whether the key is blocked (suspended).

deprecatedoptionalboolean

Whether the key has been deprecated (revoked).

Response codes

200The API key metadata.
401Your API key is missing or invalid. Pass it as a bearer token.
403Your API key isn't allowed to access this api key (blocked key or plan limit).
404No api key was found with the provided `apiKey`.

Sends a live request with your values and shows the real response below. Your key is stored only in this browser.

Request
curl -X GET https://api.blooio.com/v4/api-keys/sk_live_a1b2c3d4 \
Response objectexample
{  "data": {    "api_key": "sk_live_a1b2c3d4",    "name": "Jane Doe",    "type": "string",    "created_at": 0,    "valid_until": 0,    "blocked": false,    "deprecated": false  }}