GET /v1/me

Call	GET /v1/me
Price	free
Scope	any valid API key
Operation id	getMe

What it does

The organization, project and key behind the calling key, and its default API version. Call it to check a key works. Free. Any valid key.

Example request

Copy it as curl. Set VERDICT_API_KEY first; uuidgen makes a fresh Idempotency-Key.

Request

curl -X GET 'https://api.askverdict.io/v1/me' \
  -H "Authorization: Bearer $VERDICT_API_KEY"

Example response

200: The calling identity.

200 response

{
  "org": {
    "id": "org_01JC3Z4Y8R9K2M5N7P1Q3S5T7V",
    "name": "Northwind Ops",
    "created_at": "2026-11-01T09:00:00Z"
  },
  "project": {
    "id": "prj_01JC3Z4Y8R9K2M5N7P1Q3S5T7V",
    "name": "outbound-ria"
  },
  "key": {
    "id": "key_01JC3Z4Y8R9K2M5N7P1Q3S5T7V",
    "project_id": "prj_01JC3Z4Y8R9K2M5N7P1Q3S5T7V",
    "name": "outbound-agent prod",
    "environment": "live",
    "prefix": "vd_live_Ab12Cd",
    "scopes": [
      "decisions:write",
      "index:read",
      "outcomes:write"
    ],
    "status": "active",
    "rate_limit_per_minute": 600,
    "daily_spend_cap_usd": 25,
    "ip_allowlist": [],
    "expires_at": null,
    "last_used_at": "2026-11-07T14:03:00Z",
    "created_at": "2026-11-01T09:00:00Z"
  },
  "api_version": "2026-11-01"
}

Parameters

Name	In	Type	Required	Description
x-verdict-version	header	string	no	API version to use, a date. Defaults to the version current when the key was created. The current version is 2026-11-01.

Response fields (200)

Schema MeResponse.

Field	Type	Required	Description
org	object	yes	The calling key’s organization.
org.id	string	yes	Organization id.
org.name	string	yes	Organization name.
org.created_at	string (date-time)	yes	When the organization was created.
project	object	yes	The calling key’s project.
project.id	string	yes	Project id.
project.name	string	yes	Project name.
key	ApiKey	yes	An API key’s metadata.
key.id	string	yes	The key id.
key.project_id	string	yes	Project the key belongs to.
key.name	string	yes	Name.
key.environment	enum: “live”, “test”	yes	live or test.
key.prefix	string	yes	The key’s first characters, to recognize it.
key.scopes	array of enum: “decisions:write”, “index:read”, “outcomes:write”, “watches:manage”, “vendors:call”, “account:read”, “account:manage”, “keys:manage”	yes	Scopes granted.
key.status	enum: “active”, “rotating”, “revoked”, “expired”	yes	Lifecycle status.
key.rate_limit_per_minute	integer	yes	Requests per minute allowed.
key.daily_spend_cap_usd	number or null	yes	Daily spend cap, or null for none. US dollars, up to 6 decimals.
key.ip_allowlist	array of string	yes	CIDR blocks the key may be used from; empty means anywhere.
key.expires_at	string or null (date-time)	yes	Expiry, or null for none.
key.last_used_at	string or null (date-time)	yes	Last successful use, or null.
key.created_at	string (date-time)	yes	When the key was created.
api_version	enum: “2026-11-01”	yes	API version this key uses by default.

Errors

Errors are RFC 9457 problem details and are never billed. Branch on type. See Errors.

Status	Meaning
400	Invalid request: malformed JSON, an unknown field, a failed constraint or a size limit (invalid_request).
401	Missing, malformed, revoked or expired API key, or a bad webhook signature (unauthorized).
403	The key lacks the scope this operation needs (forbidden_scope).
429	Rate limited (rate_limited). Wait Retry-After seconds.
500	Unexpected server error (internal). Not billed; retry with the same Idempotency-Key.

Try it

Open the interactive reference to send this request from the browser. The full document is at /openapi.json.