# Extension API API

> Extension API API on Apizie: 2 endpoints (Get account extensions data by account ID, Get extension data by account ID and extension number) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/open-data:vonage-extension/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `open-data:vonage-extension`
- Category: Open Data
- Status: byok
- Source: https://businesssupport.vonage.com/contactus
- Page: https://zieapi.vercel.app/api/open-data/vonage-extension
- OpenAPI: https://zieapi.vercel.app/api/open-data/vonage-extension/openapi.json

The Vonage Business Cloud Extension API enables you to retrieve information about extensions. Your application must subscribe to the Provisioning API suite to use this API.

## Endpoints

### Get account extensions data by account ID
`GET https://zieapi.vercel.app/v1/open-data:vonage-extension/extension-ctrl-get-account-extensions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| account_id | string | yes | The Vonage Business Cloud account ID |
| page_size | number | no | Number of records per page |
| page | number | no | Current page number |
| location_id | number | no | Filter by location id |
| phone_number | string | no | Filter by phone number |
| login_name | string | no | Filter by login name |
| email | string | no | Filter by email address |

### Get extension data by account ID and extension number
`GET https://zieapi.vercel.app/v1/open-data:vonage-extension/extension-ctrl-get-account-extension-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| account_id | string | yes | The Vonage Business Cloud account ID |
| extension_number | number | yes | The extension number |

## Example
```
curl "https://zieapi.vercel.app/v1/open-data:vonage-extension/extension-ctrl-get-account-extensions" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Extension API API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/open-data:vonage-extension/extension-ctrl-get-account-extensions with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Extension API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Extension API itself also needs your own key from vonage.com.

### Can AI agents use the Extension API API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key open-data:vonage-extension.

### What is the status of the Extension API API?
Needs your own provider key (bring your own key)