# Active Documentation for /v1 API

> Active Documentation for /v1 API on Apizie: 15 endpoints (Account balance, List of account charges in JSON, List of account charges in CSV, Mobile number validation, …) returned as clean JSON through one API key. 15 endpoints are live now. Call it over REST at https://apizie.tech/v1/communication:idtbeyond/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `communication:idtbeyond`
- Category: Communication
- Status: live
- Source: https://idtbeyond.com
- Page: https://apizie.tech/api/communication/idtbeyond
- OpenAPI: https://apizie.tech/api/communication/idtbeyond/openapi.json

Our active docs provide the ability to test out your account and to see the responses to your queries. The services are RESTful, and are accessed using standard HTTP methods over a secure HTTPS channel. Requests and…

## Endpoints

### Account balance
`GET https://apizie.tech/v1/communication:idtbeyond/get-iatu-balance`

| Parameter | Type | Required | Description |
|---|---|---|---|
| x-idt-beyond-app-id | string | yes | Application ID you would like to use |
| x-idt-beyond-app-key | string | yes | Application KEY you would like to use |

### List of account charges in JSON
`GET https://apizie.tech/v1/communication:idtbeyond/get-iatu-charges-reports-all`

| Parameter | Type | Required | Description |
|---|---|---|---|
| x-idt-beyond-app-id | string | yes | Application ID you would like to use |
| x-idt-beyond-app-key | string | yes | Application KEY you would like to use |
| date_from | string | yes | The beginning date of the search IN YYYY-MM-DD format (America/New_York timezone). '2016-01-28' |
| date_to | string | yes | The ending date of the search IN YYYY-MM-DD format (America/New_York timezone). '2016-01-28' |

### List of account charges in CSV
`GET https://apizie.tech/v1/communication:idtbeyond/get-iatu-charges-reports-all-csv`

| Parameter | Type | Required | Description |
|---|---|---|---|
| x-idt-beyond-app-id | string | yes | Application ID you would like to use |
| x-idt-beyond-app-key | string | yes | Application KEY you would like to use |
| date_from | string | yes | The beginning date of the search IN YYYY-MM-DD format (America/New_York timezone). '2016-01-28' |
| date_to | string | yes | The ending date of the search IN YYYY-MM-DD format (America/New_York timezone). '2016-01-28' |

### Mobile number validation
`GET https://apizie.tech/v1/communication:idtbeyond/get-iatu-number-validator`

| Parameter | Type | Required | Description |
|---|---|---|---|
| x-idt-beyond-app-id | string | yes | Application ID you would like to use |
| x-idt-beyond-app-key | string | yes | Application KEY you would like to use |
| country_code | string | yes | 2-digit code of the country in ISO 3166 format. 'BR' |
| mobile_number | string | yes | The mobile number you would like to validate. '5521983115555' |

### Current promotions
`GET https://apizie.tech/v1/communication:idtbeyond/get-iatu-products-promotions`

| Parameter | Type | Required | Description |
|---|---|---|---|
| x-idt-beyond-app-id | string | yes | Application ID you would like to use |
| x-idt-beyond-app-key | string | yes | Application KEY you would like to use |

### Get a list of products in JSON format
`GET https://apizie.tech/v1/communication:idtbeyond/get-iatu-products-reports-all`

| Parameter | Type | Required | Description |
|---|---|---|---|
| x-idt-beyond-app-id | string | yes | Application ID you would like to use |
| x-idt-beyond-app-key | string | yes | Application KEY you would like to use |

### Get a list of products in CSV format
`GET https://apizie.tech/v1/communication:idtbeyond/get-iatu-products-reports-all-csv`

| Parameter | Type | Required | Description |
|---|---|---|---|
| x-idt-beyond-app-id | string | yes | Application ID you would like to use |
| x-idt-beyond-app-key | string | yes | Application KEY you would like to use |

### Get the estimated Local Value of a product
`GET https://apizie.tech/v1/communication:idtbeyond/get-iatu-products-reports-local-value`

| Parameter | Type | Required | Description |
|---|---|---|---|
| x-idt-beyond-app-id | string | yes | Application ID you would like to use |
| x-idt-beyond-app-key | string | yes | Application KEY you would like to use |
| country_code | string | yes | 2-digit code of the country in ISO 3166 format. 'GT' |
| carrier_code | string | yes | Name of the mobile carrier. 'Claro' |
| amount | integer | yes | This is the amount, in cents, of the product you are purchasing. '500' = $5.00 |
| currency_code | string | yes | The currency code (ISO 4217) on the product you are querying. 'USD' |

### Topup a mobile phone
`POST https://apizie.tech/v1/communication:idtbeyond/post-iatu-topups`

| Parameter | Type | Required | Description |
|---|---|---|---|
| x-idt-beyond-app-id | string | yes | Application ID you would like to use |
| x-idt-beyond-app-key | string | yes | Application KEY you would like to use |
| body | object | yes | JSON request body |

### Search topups transactions
`POST https://apizie.tech/v1/communication:idtbeyond/post-iatu-topups-reports`

| Parameter | Type | Required | Description |
|---|---|---|---|
| x-idt-beyond-app-id | string | yes | Application ID you would like to use |
| x-idt-beyond-app-key | string | yes | Application KEY you would like to use |
| body | object | yes | JSON request body |

### List of account topups in JSON
`GET https://apizie.tech/v1/communication:idtbeyond/get-iatu-topups-reports-all`

| Parameter | Type | Required | Description |
|---|---|---|---|
| x-idt-beyond-app-id | string | yes | Application ID you would like to use |
| x-idt-beyond-app-key | string | yes | Application KEY you would like to use |
| date_from | string | yes | The beginning date of the search IN YYYY-MM-DD format (America/New_York timezone). '2016-01-28' |
| date_to | string | yes | The ending date of the search IN YYYY-MM-DD format (America/New_York timezone). '2016-01-28' |

### List of account topups in CSV
`GET https://apizie.tech/v1/communication:idtbeyond/get-iatu-topups-reports-all-csv`

| Parameter | Type | Required | Description |
|---|---|---|---|
| x-idt-beyond-app-id | string | yes | Application ID you would like to use |
| x-idt-beyond-app-key | string | yes | Application KEY you would like to use |
| date_from | string | yes | The beginning date of the search IN YYYY-MM-DD format (America/New_York timezone). '2016-01-28' |
| date_to | string | yes | The ending date of the search IN YYYY-MM-DD format (America/New_York timezone). '2016-01-28' |

### Summary of account topups in JSON
`GET https://apizie.tech/v1/communication:idtbeyond/get-iatu-topups-reports-totals`

| Parameter | Type | Required | Description |
|---|---|---|---|
| x-idt-beyond-app-id | string | yes | Application ID you would like to use |
| x-idt-beyond-app-key | string | yes | Application KEY you would like to use |
| date_from | string | yes | The beginning date of the search IN YYYY-MM-DD format (America/New_York timezone). '2016-01-28' |
| date_to | string | yes | The ending date of the search IN YYYY-MM-DD format (America/New_York timezone). '2016-01-28' |

### Reversal of a Topup
`POST https://apizie.tech/v1/communication:idtbeyond/post-iatu-topups-reverse`

| Parameter | Type | Required | Description |
|---|---|---|---|
| x-idt-beyond-app-id | string | yes | Application ID you would like to use |
| x-idt-beyond-app-key | string | yes | Application KEY you would like to use |
| body | object | yes | JSON request body |

### Status check
`GET https://apizie.tech/v1/communication:idtbeyond/get-status`

| Parameter | Type | Required | Description |
|---|---|---|---|
| x-idt-beyond-app-id | string | yes | Application ID you would like to use |
| x-idt-beyond-app-key | string | yes | Application KEY you would like to use |

## Example
```
curl "https://apizie.tech/v1/communication:idtbeyond/get-iatu-balance" \
  -H "x-api-key: $APIZIE_KEY"
```

## FAQ

### How do I call the Active Documentation for /v1 API?
Create a free Apizie key, then send GET https://apizie.tech/v1/communication:idtbeyond/get-iatu-balance with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Active Documentation for /v1 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 Active Documentation for /v1 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 communication:idtbeyond.

### What is the status of the Active Documentation for /v1 API?
Live: works with just an Apizie key