Skip to main content
GET
/
v1
/
api-keys
List API Keys
curl --request GET \
  --url https://api.example.com/v1/api-keys
{
  "object": "list",
  "data": [
    {
      "id": "key_Mc2eF6gH",
      "name": "Production Backend",
      "prefix": "sig_live_7kMn",
      "scopes": ["trademarks:read", "search:read", "portfolios:manage", "events:read"],
      "last_used_at": "2026-03-24T14:30:00Z",
      "created_at": "2025-09-10T08:00:00Z",
      "expires_at": null
    },
    {
      "id": "key_Nd3fG7hI",
      "name": "CI/CD Testing",
      "prefix": "sig_test_9pQr",
      "scopes": ["trademarks:read"],
      "last_used_at": "2026-03-20T09:15:00Z",
      "created_at": "2026-01-05T12:00:00Z",
      "expires_at": "2026-12-31T23:59:59Z"
    }
  ],
  "has_more": false,
  "pagination": {
    "cursor": null
  },
  "livemode": true,
  "request_id": "req_vO1fG7hI"
}

​
Overview

Returns all API keys for your organization, including their creation date, last used timestamp, and scope. Key secrets are partially masked for security. Use this to audit active keys, identify unused credentials, and manage key lifecycle.

​
Query Parameters

​
limit
integer
default:"20"
Items per page (max 100)
​
cursor
string
Pagination cursor from previous response

​
Response

​
data
object[]
{
  "object": "list",
  "data": [
    {
      "id": "key_Mc2eF6gH",
      "name": "Production Backend",
      "prefix": "sig_live_7kMn",
      "scopes": ["trademarks:read", "search:read", "portfolios:manage", "events:read"],
      "last_used_at": "2026-03-24T14:30:00Z",
      "created_at": "2025-09-10T08:00:00Z",
      "expires_at": null
    },
    {
      "id": "key_Nd3fG7hI",
      "name": "CI/CD Testing",
      "prefix": "sig_test_9pQr",
      "scopes": ["trademarks:read"],
      "last_used_at": "2026-03-20T09:15:00Z",
      "created_at": "2026-01-05T12:00:00Z",
      "expires_at": "2026-12-31T23:59:59Z"
    }
  ],
  "has_more": false,
  "pagination": {
    "cursor": null
  },
  "livemode": true,
  "request_id": "req_vO1fG7hI"
}

​
Code Examples

curl https://api.signa.so/v1/api-keys \
  -H "Authorization: Bearer sig_live_xxxxxxxxxxxx"

​
Errors

StatusTypeDescription
401unauthorizedMissing or invalid API key
429rate_limitedToo many requests