List Number

This API is used to list the business numbers on the Truecaller Portal

Replace the {{BaseURL}} with the one mentioned here

The maximum limit to list is 10,000 numbers per feature set.

POST{{BaseURL}}/clients/{clientAccountId}/number_management/feature_sets/{featureSetId}/numbers/publish

{clientAccountId} : This can be taken directly from the self serve portal under the Manage API Keys Page

{featureSetId}: This can be taken directly from the feature set configuration page on the self serve portal

For Authorization Token kindly refer the Authentication section followed by Generate Access Token API

Headers

Name	Value
Content-Type	Required application/json
Authorization	Required Bearer <token>

Body

Name	Type	Validations	Description
phone_numbers	string	NA	Additionally, there’s a separate maximum limit associated with the client account ID.numbers to be added to feature set

Request

JSON

{
  "phone_numbers": [
    "911234567891"
  ]
}

Response

200 OK

{
    "client_account_id": "91c173bb-28d8-4030-9722-8663ff9589f3",
    "created_by_email": "[e-mail]",
    "phone_type": "verified",
    "new_numbers": [
        "911234567891"
    ],
    "other_phonetype_numbers": [],
    "existing_numbers": [],
    "others_numbers": [],
    "invalid_numbers": [],
    "other_feature_set_numbers": [],
    "status": "pending",
    "migrated_numbers": [],
    "delisted_numbers": [],
    "updated_numbers": []
}

403 Forbidden

{
    "slug": "forbidden-error",
    "message": "not authorized. please contact your admin."
}