# Callerapi

CallerAPI provides a white-label caller identification API that enhances customer trust, stops spam, fraud, and robocalls by offering branded caller ID solutions.

- **Category:** phone & sms
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 7
- **Triggers:** 0
- **Slug:** `CALLERAPI`
- **Version:** 20260217_00

## Tools

### Dispatch Reports Manually

**Slug:** `CALLERAPI_DISPATCH_REPORTS_MANUALLY`

Tool to manually trigger today's spam reports webhook delivery for enterprise clients. Use when an immediate webhook dispatch of spam complaint reports is needed. This endpoint is restricted to enterprise accounts only.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Phone Number Information

**Slug:** `CALLERAPI_GET_PHONE_NUMBER_INFORMATION`

Tool to retrieve detailed information about a specific phone number, including reputation, business and carrier details, and FTC complaints. Use when the number is in E.164 format and set hlr=true to include HLR data (adds 1-3 seconds to response).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `hlr` | boolean | No | Include HLR (Home Location Register) data; adds 1-3 seconds to response but incurs no extra cost. |
| `phone` | string | Yes | The phone number in E.164 format, e.g., '+16502530000'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Information

**Slug:** `CALLERAPI_GET_USER_INFORMATION`

Tool to retrieve information about the authenticated user, including email and credit usage details. Use after authentication to fetch current credits spent, monthly allocation, and credits left.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Webhook Subscriptions

**Slug:** `CALLERAPI_LIST_WEBHOOK_SUBSCRIPTIONS`

Tool to list all webhook subscriptions for daily spam reports. Enterprise clients only. Use to retrieve all configured webhook endpoints that receive spam complaint notifications.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Subscribe to Daily Spam Reports

**Slug:** `CALLERAPI_SUBSCRIBE_DAILY_REPORTS`

Tool to subscribe to daily spam report webhooks for enterprise clients. Instead of polling, receive webhook deliveries with spam complaint data daily. Use when you want to set up automated daily reports for spam complaints.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | Webhook URL where daily spam report data will be delivered. Must be a valid HTTPS URL accessible from CallerAPI servers. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Test Webhook

**Slug:** `CALLERAPI_TEST_WEBHOOK`

Tool to send a sample webhook payload to test your webhook endpoint integration. Use to validate webhook signature verification and endpoint configuration. Enterprise clients only.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | Webhook URL to send test payload to for validation. Must be a valid HTTPS URL. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Unsubscribe from Daily Reports

**Slug:** `CALLERAPI_UNSUBSCRIBE_DAILY_REPORTS`

Tool to unsubscribe from daily spam report webhooks. Use when you need to stop receiving daily reports at a specific webhook URL. Enterprise clients only.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | Webhook URL to unsubscribe from daily spam reports. Must be a valid URL. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |