# Number details

{% hint style="success" %}
Replace the `{{BaseURL}}` with the one mentioned [here ](https://docs.truecaller.com/truecaller-for-business/verified-business-api-documentation/getting-started)
{% endhint %}

<mark style="color:green;">`GET`</mark>`{{BaseURL}}/clients/{clientAccountId}/number_management/numbers`

{% hint style="success" %}
{clientAccountId} : This can be taken directly from the self serve portal under the Manage API Keys Page&#x20;
{% endhint %}

#### Query Parameters

| Name             | Value                                        | Type    |
| ---------------- | -------------------------------------------- | ------- |
| department\_id   | optional, to filter by department            | string  |
| operation\_id    | optional, to filter by operation             | string  |
| process\_id      | optional, to filter by process or subprocess | string  |
| feature\_set\_id | optional, to filter by feature set           | string  |
| limit            | optional, Limit per page                     | integer |
| page             | optional, Current page number                | integer |

<figure><img src="https://1257250529-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpyyDYzpD4A2zU6fYohHS%2Fuploads%2FUWJlji0GBLG69UyGDTE5%2FNumberdetails.gif?alt=media&#x26;token=2cf7e17d-2888-4f23-a32a-f04a79074ac5" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
For Authorization Token kindly refer the[ Authentication](https://docs.truecaller.com/truecaller-for-business/verified-business-api-documentation/getting-started/authentication) section followed by [Generate Access Token](https://docs.truecaller.com/truecaller-for-business/verified-business-api-documentation/getting-started/generate-access-token) API
{% endhint %}

#### Header

| Name          | Value                                                           |
| ------------- | --------------------------------------------------------------- |
| Authorization | <p><code>Required</code></p><p><code>Bearer \<token></code></p> |

**Response**

{% tabs %}
{% tab title="200 OK" %}

```json
{
    "numbers": [
        {
            "phone_number": "918848628575230",
            "phone_type": "verified",
            "status": "listed",
            "client_account_id": "91c173bb-28d8-4030-9722-8663ff9589f3",
            "created_by_email": "navaneeth.panakkada+v2prod3@truecaller.com",
            "department": "TestingSanity",
            "operation": "Collections",
            "process": "SanityProcess",
            "subprocess": "",
            "feature_set_name": "New Feature set",
            "call_me_back": "enabled",
            "created_at": "2025-07-28T09:25:19.557139Z",
            "updated_at": "2025-07-28T09:25:23.644159Z",
            "label_name": "testLabel from fs page"
        },
        {
            "phone_number": "918735783247237",
            "phone_type": "verified",
            "status": "listed",
            "client_account_id": "91c173bb-28d8-4030-9722-8663ff9589f3",
            "created_by_email": "navaneeth.panakkada+v2prod3@truecaller.com",
            "department": "TestingSanity",
            "operation": "Collections",
            "process": "SanityProcess",
            "subprocess": "",
            "feature_set_name": "New Feature set",
            "call_me_back": "enabled",
            "created_at": "2025-07-28T09:25:19.557139Z",
            "updated_at": "2025-07-28T09:25:23.671083Z",
            "label_name": "testLabel from fs page"
        }
    ],
    "pagination_information": {
        "total_page_count": 8
    }
}
```

{% endtab %}

{% tab title="400 Bad Request" %}

```json
{
    "client_account_id": "91c173bb-28d8-4030-9722-8663ff9589f3",
    "phone_type": "",
    "processing_numbers": [],
    "new_numbers": [
        "911234567891"
    ],
    "other_phonetype_numbers": [],
    "existing_numbers": [],
    "others_numbers": [],
    "invalid_numbers": [],
    "other_feature_set_numbers": [],
    "status": "failed"
}
```

{% endtab %}
{% endtabs %}