> ## Documentation Index
> Fetch the complete documentation index at: https://docs.poixe.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Token Lookup

```bash curl theme={"theme":{"light":"min-light","dark":"min-dark"}}
curl https://sys.poixe.com/api/tokens/lookup \
  -X POST \
  -H "Authorization: Bearer $POIXE_SYSTEM_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"key": "sk-xxxxxxxxxxxxxxxxxxxxxxxx"}'
```

```json response theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "id": 7,
  "timestamp": 1731337200
}
```

POST
`https://sys.poixe.com/api/tokens/lookup`

Look up a token's ID by its key value (the `sk-` string). The key must belong to the calling account.

## Request Body

**key** `string` *required*

Token key — must start with `sk-` and belong to the current account

## Response Fields

**id** `integer`

Token ID

**timestamp** `integer`

Response timestamp (Unix seconds)

## Errors

| Condition | HTTP | type |
| - | - | - |
| `key` missing or empty | 400 | `invalid_request_error` |
| `key` does not start with `sk-` | 400 | `invalid_request_error` |
| Key not found or belongs to another account | 404 | `resource_not_found_error` |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.