Skip to content

API Reference

Resources, endpoints, errors and rate limits at a glance.

Base URL: https://api.gtalk2voip.com/v1. All requests and responses are JSON. Timestamps are ISO 8601 in UTC. The current API version is 2026-06-01, pinned per account and overridable per request with the GTalk-Version header.

Core resources

resources.txt

POST   /v1/calls               create a call
GET    /v1/calls/:id           fetch a call
POST   /v1/calls/:id/play      play audio into a call
POST   /v1/calls/:id/gather    collect DTMF or speech
POST   /v1/calls/:id/transfer  transfer a call

GET    /v1/numbers             list numbers
POST   /v1/numbers             buy a number
PATCH  /v1/numbers/:id         change routing

POST   /v1/agents              create an AI agent
GET    /v1/recordings/:id      fetch a recording
GET    /v1/transcripts/:id     fetch a transcript
POST   /v1/tokens              mint a client token

Errors

Errors use conventional status codes: 400 for invalid parameters, 401 for authentication, 402 for insufficient balance, 404 for unknown resources, 429 for rate limits. The body always contains error.type, error.message and error.doc_url.

Rate limits

  • Default: 50 requests per second per key, burst to 100.
  • 429 responses include Retry-After; official SDKs honour it automatically.
  • Call creation is additionally governed by your account's calls-per-second setting, adjustable in the console.

OpenAPI specification

The full machine-readable specification is published at https://api.gtalk2voip.com/openapi.json and versioned with every release. Generated SDK types match it exactly.