B4TON
GET

/api/status/:id

Check baton status without side effects.

Parameters

id
string · required

The baton ID.

Example

Code
curl https://b4ton.sh/api/status/abc-123 \
  -H "Authorization: Bearer baton_abc123..."

Response

Code
{
  "baton_id": "abc-123",
  "status": "pending",
  "created_at": "2026-03-17T12:00:00Z",
  "expires_at": "2026-03-18T12:00:00Z"
}

Note

Unlike /api/catch/:id, this endpoint is read-only. It does not change the baton's status. Use it for polling or monitoring.