Skip to main content

​
GET /v1/whoami

Returns the identity resolved from your API key. Useful to confirm a key works end-to-end (authentication + rate limiting) with no other dependencies — a good first call when setting up an integration.
​
keyId
string
default:"Identifier of the API key used"
Identifier of the API key used
​
brandId
string
The brand the key belongs to 
​
scopes
array [string]
Scopes granted to the key
/v1/whoami
curl -sS https://api.storytime.io/v1/whoami \
  -H "Authorization: Bearer pk_live_xxxxxxxxxxxxxxxxxxxxxxxx"
200
{
  "ok": true,
  "keyId": "k_9f8c…",
  "brandId": "abe7e83f-e57c-4e12-babe-612eef793f3d",
  "scopes": ["campaigns:read", "campaigns:write", "analytics:read"]
}
401
{ 
    "ok": false,
    "code": "UNAUTHORIZED",
    "message": "Missing or invalid API key" 
}