Request History & Usage Series
GET /v1/history lists your workspace's requests (metadata only) and GET /v1/usage/series charts them hourly or daily. Both export CSV.
Request history
GET /v1/history lists the requests your workspace made, newest first. Each record is metadata only: the history never records message content, so there is none to return.
curl -sS 'https://api.transmute.403fin.io/v1/history?limit=2&status=4xx' \
-H "Authorization: Bearer $TRANSMUTE_KEY"
{
"from": "2026-07-09T10:00:00Z",
"to": "2026-10-07T10:00:00Z",
"items": [
{
"ts": "2026-10-07T09:58:12.481Z",
"request_id": "api/kTq3ZbL2nP-000412",
"endpoint": "/v1/convert",
"operation": "convert",
"source_format": "mt940",
"target_format": "camt.053",
"bytes_in": 412,
"duration_ms": 3,
"status": 422,
"warning_count": 0,
"billable": true,
"test_env": false,
"key_id": "2b0c6f0e-6a1f-4d55-9a57-0f2b1c3d4e5f",
"key_prefix": "a1b2c3d4"
}
],
"next_cursor": "MTc5NTc5..."
}
request_id is the X-Request-Id you received on that request, so a failure your system logged can be found here.
| Parameter | Meaning |
|---|---|
from, to | RFC 3339 window. Default: the last 90 days. from is limited to the last 13 months |
status | An exact status (422) or a class (2xx, 4xx, 5xx) |
operation | convert, normalize, validate or enrich |
keyId | Only requests made with this credential |
limit | Page size: 1–200 (JSON), 1–5000 (CSV) |
cursor | The next_cursor of the previous page |
format | csv for a spreadsheet-safe CSV download (the next cursor is then in the X-Next-Cursor header) |
History needs the opt-in history:read scope: it shows what every credential of your workspace did, so grant it only to keys that need that oversight. On the portal every member sees the same records under History.
Usage series
GET /v1/usage/series counts requests per hour or per day (UTC):
curl -sS 'https://api.transmute.403fin.io/v1/usage/series?granularity=day&by=key' \
-H "Authorization: Bearer $TRANSMUTE_KEY"
Each point carries total, billable and errors (status 400 and above); empty buckets come back as zeros. by=key returns one series per credential. Hourly spans at most 7 days, daily at most 400 days; the default is the last 24 hours (hourly) or 30 days (daily). format=csv downloads it. It needs the usage:read scope, like /v1/usage.
Limits and billing
Both routes allow 30 requests per minute per workspace (rate-limited 429 beyond that). They are account management: never metered and never counted toward your quota.