Skip to main content
GET
/
v1
/
partner
/
api-keys
curl https://grail-stack-dev.onrender.com/v1/partner/api-keys \
  -H "x-api-key: grail_partner_<hex>"

{
  "api_keys": [
    {
      "key_id": "0c9bd7e4-6b2e-4f3a-a9a7-1f6e5d4c3b2a",
      "key_name": "integration test",
      "scope": "PARTNER",
      "status": "active",
      "wallet_address": "Fd31QxW7RRZwvMfNnhNaPvczJpMh7wyzBTWvtMA66wjN",
      "last_used_at": "2026-04-19T12:45:10.002Z",
      "created_at": "2026-04-19T12:30:45.123Z",
      "revoked_at": null
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.grail.oro.finance/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Lists all API keys (active and revoked) minted against the authenticated partner’s wallet. Only metadata is returned — raw API key values are never retrievable after creation.

​
Headers

​
x-api-key
string
required
A valid PARTNER scope key for the partner whose keys you want to list.

​
Response

​
api_keys
array

​
Errors

HTTPerrorWhen
401unauthorizedMissing or invalid x-api-key
curl https://grail-stack-dev.onrender.com/v1/partner/api-keys \
  -H "x-api-key: grail_partner_<hex>"

{
  "api_keys": [
    {
      "key_id": "0c9bd7e4-6b2e-4f3a-a9a7-1f6e5d4c3b2a",
      "key_name": "integration test",
      "scope": "PARTNER",
      "status": "active",
      "wallet_address": "Fd31QxW7RRZwvMfNnhNaPvczJpMh7wyzBTWvtMA66wjN",
      "last_used_at": "2026-04-19T12:45:10.002Z",
      "created_at": "2026-04-19T12:30:45.123Z",
      "revoked_at": null
    }
  ]
}