Hoppa till innehållet

Menu

Keys

More ways to use this page

Read a key

GET/v1/tokens/{id}

TypeScript sendora.tokens.get(tokenId)

Python sendora.tokens.get(token_id)

Key sk_… a server key

Parameters

  • idin pathstring (uuid)required

    The key id.

Responses

200A key of this server; the value itself is shown only when it is created.

  • tokenIdstring (uuid)required
  • namestringrequired

    The name given at creation, for people to tell keys apart.

  • prefixstringrequired

    The first characters of the key, to match it with a value in hand.

  • createdAtstring (date-time)required
  • revokedAtstring (date-time) or nullrequired

Example

{
  "tokenId": "3b0c9e2f-6d4a-4e8b-8a1c-9f2d7e6c5b40",
  "name": "Invoicing system",
  "prefix": "sk_a1b2c3d4e5",
  "createdAt": "2026-09-15T12:00:00.000Z",
  "revokedAt": null
}

Errors

Every error answers error, the code, and message, a sentence for a person. A code that adds fields is shown in full below the table.

CodeStatusMeaning
unauthorized401The key is missing, malformed or revoked.
wrong_token_kind403The key is of the other kind: a server key (sk_) where an account key (ak_) is needed, or the reverse. The message names the kind the operation takes.
not_found404No such key of this server.