Authentication
API Key
All requests require an API key passed in the X-API-Key header:
curl -X POST https://rd-gap-agent-64739540958.us-east1.run.app/a2a/gap-agent \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '...'
Obtain your API key from the Reach Dog dashboard.
Rate Limits
Each API key is assigned a tier that determines the monthly query limit:
| Tier | Queries per Month | Description |
|---|---|---|
| Explorer | 50 | Free tier for evaluation |
| Professional | 500 | Standard production use |
| Enterprise | 5,000 | High-volume with custom options |
Rate limits reset on the first day of each calendar month.
Rate Limit Headers
Every response includes rate limit headers:
| Header | Description |
|---|---|
X-RateLimit-Limit |
Maximum queries allowed this month |
X-RateLimit-Remaining |
Queries remaining this month |
X-RateLimit-Reset |
Date when the limit resets (first of next month) |
Rate Limit Exceeded
When your monthly limit is reached, the API returns a JSON-RPC error with a message indicating your current usage and reset date. No further queries are processed until the limit resets.