Get Registered numbers


This API allows you to see all the available registered numbers that are waiting to be connected into an account (under "Step 2: Create account" API).

Once you create an account with a WhatsApp number, the number will be removed from this list. this list only shows the available registered numbers that you verified with a code, and is still waiting to be connected to an account, within the 90 days. 

Settings:

URL

https://partners.99digital.co.il/api/whatsapp/getRegisteredNumbers

Method

JSON via GET

Header

Authorization: Bearer {{access_token}}

*The access_token can be received from settings->get access token API.


Body: nothing, leave it empty.

Response:

{
    "status": "OK",
    "reason": 1
    "list": [
        {
            "whatsapp": "972501234567",
            "expiration": 1739874663,
            "onboarding_link": "https://onboarding-link.com/12345",
            "comment": "Resereved number for client A"
        },
        {
            "whatsapp": "972551122334",
            "expiration": 1739874664,
            "onboarding_link": null,
            "comment": ""
        }
    ]

}


Response-Explain:

Parameter

Description

status

OK or FAIL

"OK" means the request has been sent to Meta.

"Fail" means error.

list

array of [whatsapp, expiration]

whatsapp - the registered whatsapp number

expiration - the expiration time

onboarding_link - if there is onboarding link connected to this number, it will show. otherwise, will show 'null'

comment - the comment you wrote when registering the number.

reason

'reason' is the status explanation in case of FAIL

1

not FAIL. the status is OK

2

Wrong credentials

3

Access token does not exist or expired, please generate another one from Settings - Get access token API

13

you need to use GET method.