# Pricing API API

> Pricing API API on Apizie: 3 endpoints (Retrieve outbound pricing for all countries., Retrieve outbound pricing for a specific dialing prefix., Retrieve outbound pricing for a specific country.) returned as clean JSON through one API key. 3 endpoints are live now. Call it over REST at https://zieapi.vercel.app/v1/open-data:nexmo-pricing/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `open-data:nexmo-pricing`
- Category: Open Data
- Status: live
- Source: https://developer.nexmo.com/
- Page: https://zieapi.vercel.app/api/open-data/nexmo-pricing
- OpenAPI: https://zieapi.vercel.app/api/open-data/nexmo-pricing/openapi.json

The API to retrieve pricing information. Please note the Pricing API is rate limited to one request per second.

## Endpoints

### Retrieve outbound pricing for all countries.
`GET https://zieapi.vercel.app/v1/open-data:nexmo-pricing/retrieve-pricing-all-countries`

| Parameter | Type | Required | Description |
|---|---|---|---|
| type | string | yes | The type of service you wish to retrieve data about: either `sms`, `sms-transit` or `voice`. |
| api_key | string | yes | Your Nexmo API key. |
| api_secret | string | yes | Your Nexmo API secret. |

### Retrieve outbound pricing for a specific dialing prefix.
`GET https://zieapi.vercel.app/v1/open-data:nexmo-pricing/retrieve-prefix-pricing`

| Parameter | Type | Required | Description |
|---|---|---|---|
| type | string | yes | The type of service you wish to retrieve data about: either `sms`, `sms-transit` or `voice`. |
| api_key | string | yes | Your Nexmo API key. |
| api_secret | string | yes | Your Nexmo API secret. |
| prefix | string | yes | The numerical dialing prefix to look up pricing for. Examples include 44, 1 and so on. |

### Retrieve outbound pricing for a specific country.
`GET https://zieapi.vercel.app/v1/open-data:nexmo-pricing/retrieve-pricing-country`

| Parameter | Type | Required | Description |
|---|---|---|---|
| type | string | yes | The type of service you wish to retrieve data about: either `sms`, `sms-transit` or `voice`. |
| api_key | string | yes | Your Nexmo API key. |
| api_secret | string | yes | Your Nexmo API secret. |
| country | string | yes | A two letter [country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). For example, `CA`. |

## Example
```
curl "https://zieapi.vercel.app/v1/open-data:nexmo-pricing/retrieve-pricing-all-countries" \
  -H "x-api-key: $APIZIE_KEY"
```

## FAQ

### How do I call the Pricing API API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/open-data:nexmo-pricing/retrieve-pricing-all-countries with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Pricing API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card.

### Can AI agents use the Pricing 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:nexmo-pricing.

### What is the status of the Pricing API API?
Live: works with just an Apizie key