GET /devices/me/contacts/{phone}/registered

Check if a phone number is registered on WhatsApp

Path parameters

  • phone string Required

Responses

  • 200 application/json

    Registration status retrieved successfully

    Hide response attributes Show response attributes object
    • status boolean
    • code integer
    • message string
    • data object
      Hide data attributes Show data attributes object
      • phone string
      • jid string
      • is_registered boolean

        true if the phone is a valid WhatsApp account

  • 401 application/json

    Unauthorized

    Hide response attributes Show response attributes object
    • status boolean
    • code integer
    • message string
    • error string
  • 500 application/json

    Internal server error

    Hide response attributes Show response attributes object
    • status boolean
    • code integer
    • message string
    • error string
GET /devices/me/contacts/{phone}/registered
curl \
 --request GET 'http://localhost:7001/devices/me/contacts/6281234567890/registered' \
 --header "Authorization: $API_KEY"
Response examples (200)
{
  "code": 200,
  "data": {
    "jid": "6281234567890@s.whatsapp.net",
    "phone": "6281234567890",
    "is_registered": true
  },
  "status": true,
  "message": "Registration status retrieved successfully"
}
Response examples (200)
{
  "status": true,
  "code": 200,
  "message": "Registration status retrieved successfully",
  "data": {
    "phone": "6281234567890",
    "jid": "6281234567890@s.whatsapp.net",
    "is_registered": true
  }
}
Response examples (401)
{
  "code": 401,
  "error": "Invalid or expired JWT token",
  "status": false,
  "message": "Unauthorized"
}
Response examples (401)
{
  "status": false,
  "code": 401,
  "message": "Unauthorized",
  "error": "Invalid or missing authentication"
}
Response examples (500)
{
  "code": 500,
  "error": "Failed to check registration status",
  "status": false,
  "message": "Internal server error"
}
Response examples (500)
{
  "status": false,
  "code": 400,
  "message": "Bad request",
  "error": "Bad request"
}