# Voice API API

> Voice API API on Apizie: 9 endpoints (Get details of your calls, Create an outbound call, Get detail of a specific call, Modify an in progress call, …) 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://apizie.tech/v1/open-data:nexmo-voice/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `open-data:nexmo-voice`
- Category: Open Data
- Status: byok
- Source: https://developer.nexmo.com/
- Page: https://apizie.tech/api/open-data/nexmo-voice
- OpenAPI: https://apizie.tech/api/open-data/nexmo-voice/openapi.json

The Voice API lets you create outbound calls, control in-progress calls and get information about historical calls. More information about the Voice API can be found at .

## Endpoints

### Get details of your calls
`GET https://apizie.tech/v1/open-data:nexmo-voice/get-calls` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| status | string | no | Filter by call status |
| date_start | string | no | Return the records that occurred after this point in time |
| date_end | string | no | Return the records that occurred before this point in time |
| page_size | integer | no | Return this amount of records in the response |
| record_index | integer | no | Return calls from this index in the response |
| order | string | no | Either ascending or descending order. |
| conversation_uuid | string | no | Return all the records associated with a specific conversation. |

### Create an outbound call
`POST https://apizie.tech/v1/open-data:nexmo-voice/create-call` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Get detail of a specific call
`GET https://apizie.tech/v1/open-data:nexmo-voice/get-call` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| uuid | string | yes | UUID of the Call |

### Modify an in progress call
`POST https://apizie.tech/v1/open-data:nexmo-voice/update-call` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| uuid | string | yes | UUID of the Call |
| body | object | yes | JSON request body |

### Play DTMF tones into a call
`POST https://apizie.tech/v1/open-data:nexmo-voice/start-dtmf` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| uuid | string | yes | UUID of the Call Leg |
| body | object | yes | JSON request body |

### Play an audio file into a call
`POST https://apizie.tech/v1/open-data:nexmo-voice/start-stream` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| uuid | string | yes | UUID of the Call Leg |
| body | object | yes | JSON request body |

### Stop playing an audio file into a call
`POST https://apizie.tech/v1/open-data:nexmo-voice/stop-stream` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| uuid | string | yes | UUID of the Call Leg |

### Play text to speech into a call
`POST https://apizie.tech/v1/open-data:nexmo-voice/start-talk` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| uuid | string | yes | UUID of the Call Leg |
| body | object | no | JSON request body |

### Stop text to speech in a call
`POST https://apizie.tech/v1/open-data:nexmo-voice/stop-talk` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| uuid | string | yes | UUID of the Call Leg |

## Example
```
curl "https://apizie.tech/v1/open-data:nexmo-voice/get-calls" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Voice API API?
Create a free Apizie key, then send GET https://apizie.tech/v1/open-data:nexmo-voice/get-calls with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

### Can AI agents use the Voice API API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key open-data:nexmo-voice.

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