---
updatedAt: 2025-11-03T17:27:46.000Z
agentTools:
  projectIndex: https://docs.gupshup.io/llms.txt
---

# Get Available Numbers

### API Endpoint

```
GET https://kpi.knowlarity.com/Basic/v1/account/numbers/AvailablePhoneNumbers?circle_id=1
```

### Sample Request

```
curl -X GET \
  'https://kpi.knowlarity.com/Basic/v1/account/numbers/AvailablePhoneNumbers?circle_id=<circle_id>' \
  -H 'accept: application/json' \
  -H 'authorization: <authorization-key>' \
  -H 'x-api-key: <x-api-key>'
```

### Sample Response

```
{
    "numbers": [
        {
            "number_type": "MOBILE",
            "number_rating": 0,
            "circle_id": 1,
            "number": "+9189297XXXXX",
            "provider_name": "Vodafone"
        },
        {
            "number_type": "MOBILE",
            "number_rating": 0,
            "circle_id": 1,
            "number": "+9189297XXXXX",
            "provider_name": "Vodafone"
        }
      ]
}
```