Skip to content
All APIs

Indonesian mobile · Identity · 1 endpoint

Phone Normaliser

Turn every way an Indonesian mobile number gets typed into one canonical form, and name the network that issued it.

Status
Operational
Price
1 credit / request
Rate limit
300 / 60s
Cache
None
Requests
0

Endpoint

How to call it

GET/v1/id/phone

Code

Request — cURL

v1

curl https://api.diraz.co.id/v1/id/phone \
  -H "Authorization: Bearer drz_live_…"

For AI agents

Callable through the MCP server with the same key:

call_api {"endpoint":"id-phone","params":{"phone":"0812-3456-7890"}}

Parameters

phonestring · required
`0812…`, `+62812…`, `62812…`, with or without spaces and dashes.

Example response

200 OK

JSON

{
  "data": {
    "input": "0812-3456-7890",
    "valid": true,
    "e164": "+6281234567890",
    "national": "081234567890",
    "prefix": "0812",
    "carrier": "Telkomsel",
    "line_type": "mobile",
    "issues": []
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ"
  }
}
e164
`+62…`. The form to store.
national
`0812…`. The form Indonesians read.
carrier
The network that issued the block. Number portability means this is who allocated it, not necessarily who carries it today.

Errors

When something goes wrong

Every failure carries a stable machine-readable code and the same meta.request_id a success carries — quote it and we can find your request. Errors are never billed.

401 Unauthorized

JSON

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "The API key is invalid, expired, or revoked."
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ"
  }
}
UNAUTHORIZEDHTTP 401
Missing, malformed, expired, or revoked API key.
FORBIDDENHTTP 403
The key is valid but lacks the scope this product needs.
VALIDATION_ERRORHTTP 422
A query parameter is the wrong type or out of range.
RATE_LIMITEDHTTP 429
Rate limit exhausted. `Retry-After` says how long to wait.
SERVICE_UNAVAILABLEHTTP 503
No data recent enough to serve. Carries `Retry-After`, and is never billed.

Health

Is it up?

  • Phone Normaliser

1/1 passing