Skip to main content
POST
/
v3
/
phone
/
check
Check Phone Code
curl --request POST \
  --url https://verification.didit.me/v3/phone/check/ \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "phone_number": "<string>",
  "code": "<string>",
  "duplicated_phone_number_action": "NO_ACTION",
  "disposable_number_action": "NO_ACTION",
  "voip_number_action": "NO_ACTION"
}
'
{
  "request_id": "e39cb057-92fc-4b59-b84e-02fec29a0f24",
  "status": "Approved",
  "message": "The verification code is correct.",
  "phone": {
    "status": "Approved",
    "phone_number_prefix": "+1",
    "phone_number": "4155552671",
    "full_number": "+14155552671",
    "country_code": "US",
    "country_name": "United States",
    "carrier": {
      "name": "ATT",
      "type": "mobile"
    },
    "is_disposable": false,
    "is_virtual": false,
    "verification_method": "sms",
    "verification_attempts": 1,
    "verified_at": "2025-08-24T09:12:39.662232Z",
    "lifecycle": [
      {
        "type": "PHONE_VERIFICATION_MESSAGE_SENT",
        "timestamp": "2025-08-24T09:12:39.580554+00:00",
        "details": {
          "status": "Success",
          "reason": null,
          "is_retry": false
        },
        "fee": 0.1
      },
      {
        "type": "VALID_CODE_ENTERED",
        "timestamp": "2025-08-24T09:12:39.662157+00:00",
        "details": {
          "code_tried": "123456",
          "status": "Approved"
        },
        "fee": 0
      },
      {
        "type": "PHONE_VERIFICATION_APPROVED",
        "timestamp": "2025-08-24T09:12:39.684292+00:00",
        "details": null,
        "fee": 0
      }
    ],
    "warnings": []
  },
  "created_at": "2025-08-24T09:12:39.703719+00:00"
}

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
phone_number
string
required

The phone number to verify in E.164 format. e.g. +14155552671

​
code
string
required

The verification code sent to the phone number. Must be between 4 and 8 characters in length.

Required string length: 4 - 8
​
duplicated_phone_number_action
enum<string>
default:NO_ACTION

Action to take for duplicated phone numbers

Available options:
NO_ACTION,
DECLINE
​
disposable_number_action
enum<string>
default:NO_ACTION

Action to take for disposable phone numbers

Available options:
NO_ACTION,
DECLINE
​
voip_number_action
enum<string>
default:NO_ACTION

Action to take for VoIP phone numbers

Available options:
NO_ACTION,
DECLINE

Response

OK

​
request_id
string<uuid>

Unique identifier for the session/request.

​
status
string

Status of the check operation (e.g., 'Approved', 'Failed', 'Expired or Not Found').

​
message
string

A human-readable message about the check outcome.

​
phone
object
​
created_at
string<date-time>

Timestamp when the phone verification session was created.