WhatsApp Gateway
API referenceAdmin

Get the current or latest session backfill job (super_admin)

GET
/api/v1/admin/sessions/{session}/backfill

Get the active backfill job for a session, or the most recent completed/failed one if none is running.

Backfill state is in-memory, so restarts clear job history.

Requires platform super_admin login JWT.

Errors: forbidden (403) and not_found (404) if session missing or no job exists.

Authorization

AuthorizationBearer <token>

Send Authorization: Bearer <token>. The token can be a login JWT from the frontend or an api-key for a script. JWT access comes from the person's organization role. Api-key access comes from the permissions saved on the key.

In: header

Path Parameters

session*string

Session ID. As super_admin this may belong to any organization.

Example"01HZX9Q2K7"

Response Body

application/json

application/json

curl -X GET "https://example.com/api/v1/admin/sessions/01HZX9Q2K7/backfill"
{  "contacts": 128,  "error": "session not connected",  "finishedAt": 1719662460000,  "groupMembers": 342,  "groups": 14,  "id": "01J9...",  "organizationId": "org_01J9ABC...",  "sessionId": "01J9ZX8K2QHV0M3T6R7P4N5W8C",  "startedAt": 1719662400000,  "status": "succeeded"}
{  "error": {    "code": "not_found",    "details": {      "property1": null,      "property2": null    },    "message": "session not found"  }}