> ## Documentation Index
> Fetch the complete documentation index at: https://help.hoopai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Phone System Overview

> List and manage active phone numbers and number pools for your HoopAI account using the Phone System REST API.

The Phone System API provides programmatic access to the phone numbers and number pools connected to your HoopAI account. Use it to retrieve active numbers, inspect their capabilities (voice, SMS, MMS), and list number pools configured for call routing.

## Base URL

```
https://services.leadconnectorhq.com
```

## Authentication

All endpoints require a Bearer token and an API version header.

```bash theme={null}
Authorization: Bearer <access_token>
Version: 2021-07-28
```

See [OAuth 2.0](/api-reference/oauth/authorization) to obtain an access token.

## OAuth scopes

| Scope               | Access                    |
| ------------------- | ------------------------- |
| `phonenumbers.read` | Read active phone numbers |
| `numberpools.read`  | Read number pools         |

## Quick start

List all active phone numbers for a location:

```bash theme={null}
curl -X GET "https://services.leadconnectorhq.com/phone-system/numbers/location/ve9EPM428h8vShlRW1KT"   -H "Authorization: Bearer <access_token>"   -H "Version: 2021-07-28"
```

## Endpoints

| Method | Path                                          | Description                        |
| ------ | --------------------------------------------- | ---------------------------------- |
| `GET`  | `/phone-system/number-pools`                  | List number pools                  |
| `GET`  | `/phone-system/numbers/location/{locationId}` | List active numbers for a location |

## Related

* [Voice AI API](/api-reference/voice-ai/overview) — Assign Voice AI agents to phone numbers
* [Conversations API](/api-reference/conversations/overview) — Send and receive messages on your phone numbers