Developer documentation

Authentication

All API requests require a Bearer token from your dashboard API keys. Create keys at /dashboard/developer. Keys are org-scoped and can be revoked anytime.

curl -H "Authorization: Bearer grtq_your_key" https://greetq.com/api/v1/calls

Base URL

All endpoints are relative to https://greetq.com. HTTPS is required in production.

Rate limits

Default limit is 100 requests per minute per API key. When exceeded, the API returns HTTP 429. Contact support for higher limits on Enterprise.

# Example 429 response
{ "error": "Rate limit exceeded" }

Pagination

The Calls API returns the most recent calls up to your limit (max 100). Use the created_at timestamps on returned records for cursor-style paging in your integration.

Error codes

Common HTTP statuses: 401 invalid or missing API key, 400 malformed request, 429 rate limited, 500 server error. Error bodies include an error string.

{ "error": "Invalid API key" }

Code examples

Same endpoint in JavaScript (fetch) and Python (requests):

// JavaScript
const res = await fetch("https://greetq.com/api/v1/calls?limit=10", {
  headers: { Authorization: "Bearer grtq_…" },
});
const { calls } = await res.json();

# Python
import requests
r = requests.get(
  "https://greetq.com/api/v1/calls",
  headers={"Authorization": "Bearer grtq_…"},
  params={"limit": 10},
)
calls = r.json()["calls"]