CallGauge AI API Documentation

1Getting Started

Use the Dev Portal in your CallGauge AI dashboard to create API credentials, review API usage and manage access to supported resources. Before making your first request, create an API key with the permissions required by your application.

1. Open the Dev Portal from your CallGauge AI dashboard.
2. Select the API Keys section.
3. Click the Create button.
4. Enter a name for the key and select the resources your application needs.
5. Create the key and securely copy the generated credential.

2Create and Manage API Keys

API keys provide secure programmatic access to CallGauge AI resources. Each key can be assigned a descriptive name, specific read-only resource permissions and an optional expiration period.

Available read-only resources

3Authentication

Include your API key as a Bearer token in the Authorization header of every request. The key must have permission to access the requested resource.

Authorization: Bearer YOUR_API_KEY

curl -X GET "https://app.callgauge.ai/api/v1/calls" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

4Available Resources

When creating an API key, select the resources your application needs to access. CallGauge AI currently provides read-only access to Calls, Voicemails, Numbers, Campaigns, Messages and Reports.

5Example Request

The following example shows how to send an authenticated request to the Calls resource. Replace YOUR_API_KEY with the live API key generated from your Dev Portal.

curl -X GET "https://app.callgauge.ai/api/v1/calls" \
                        -H "Authorization: Bearer YOUR_API_KEY" \
                        -H "Accept: application/json"

Request requirements

6Response Format

Successful API requests return data in JSON format. The exact properties included in the response depend on the resource being requested and the data available in your CallGauge AI workspace.

{
  "success": true,
  "data": [
    {
      "id": "resource_id",
      "created_at": "2026-07-20T10:30:00Z"
    }
  ]
}

Working with responses

7Error Codes

CallGauge AI uses standard HTTP status codes to indicate whether an API request was successful. When a request fails, review the returned status code and error details before retrying it.

{
  "success": false,
  "error": {
    "code": "unauthorized",
    "message": "A valid API key is required."
  }
}

8Rate Limits

API requests are subject to usage limits that help protect service reliability and prevent excessive traffic. You can review your current API usage and daily request allowance from the Dev Portal.

9Webhooks

Webhooks allow CallGauge AI to send event data to an external endpoint when supported activity occurs. Use the Webhooks section in the Dev Portal to review endpoints, monitor deliveries and identify failed events.

Recommended webhook workflow

10API Best Practices

Follow these recommendations to keep your CallGauge AI integration secure, reliable and easy to maintain.

Recommended security checklist

11Technical Support

Contact the CallGauge AI support team when you need help with API authentication, resource permissions, request failures, usage limits or webhook delivery issues.