Check Status — Authentication
Poll the result of an authentication request initiated with Authenticate from Web.
Endpoint
POST /api/organization/authenticate/checkStatus
https://sandbox-services.mobileid.dj/api/organization/authenticate/checkStatus
Headers
| Header | Required | Description |
|---|---|---|
Authorization | Yes | Bearer YOUR_JWT_TOKEN |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
ref | string | Yes | The ref token returned by Authenticate from Web |
Response
{
"status": "approved",
"message": "Authentication successful"
}
| Field | Type | Description |
|---|---|---|
status | string | Current status of the authentication request |
message | string | Human-readable status description |
Status Values
| Status | Description |
|---|---|
pending | Waiting for user action on mobile |
approved | User confirmed the authentication |
rejected | User declined the authentication |
expired | Request timed out |
Example Request
POST /api/organization/authenticate/checkStatus?ref=YOUR_REF_TOKEN HTTP/1.1
Host: sandbox-services.mobileid.dj
Authorization: Bearer YOUR_JWT_TOKEN
Notes
- Poll this endpoint every 2–3 seconds until a terminal status is received.
- The
reftoken is single-use per request session.