Skip to main content
POST
/
apps
/
etisalat
/
dncr
Check DNCR (Do Not Call Registry) status for phone numbers
curl --request POST \
  --url https://api.provident.ae/v2/apps/etisalat/dncr \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "phone": [
    "0501234567",
    "971501234567"
  ]
}
'
{
  "status": "success",
  "message": "DNCR check completed successfully",
  "data": {
    "transactionId": "etisalat-1756974822041-n5rjszfgp",
    "details": [
      {
        "accountNumber": "0509002528",
        "dncrStatus": "TRUE",
        "transactionStatus": null,
        "requestDate": "2025-09-04T11:00:02.990Z",
        "dataSource": "fresh"
      }
    ],
    "ackMessage": {
      "status": "SUCCESS"
    }
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
update
boolean

If true, bypass cache and force update from live API

Body

application/json

Request body with array of phone numbers to check

​
phone
string[]
required

Array of phone numbers to check (max 20). Accepts UAE local format (05XXXXXXXX) or international format with country code 971 (971XXXXXXXXX).

Example:
["0501234567", "971501234567"]

Response

200 - application/json

DNCR check completed successfully

​
status
string
Example:

"success"

​
message
string
Example:

"DNCR check completed successfully"

​
data
object