List 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
    }
  ]
}

GET

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
    }
  ]
}

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

string

required

A valid PARTNER scope key for the partner whose keys you want to list.

Response

array

Show entry properties

string

UUID of the key record. Pass to Revoke API Key to revoke.

string

Human-readable label supplied at creation.

string

Scope granted to the key. Always "PARTNER" for partner-minted keys.

string

"active" or "revoked".

string

Partner wallet that signed the challenge when the key was minted.

string | null

ISO-8601 timestamp of the most recent request authenticated with this key, or null if the key has never been used.

string

ISO-8601 timestamp of key creation.

string | null

ISO-8601 timestamp of revocation, or null if the key is still active.

Errors

HTTP	`error`	When
401	`unauthorized`	Missing 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
    }
  ]
}

Create API Key Revoke API Key

API Reference

General

Authentication

Partner

Users

Denominations

Trades

Redemptions

Overview

Headers

Response

Errors

​Overview

​Headers

​Response

​Errors

Overview

Headers

Response

Errors