API overview

Base URL

https://api.imarobot.ai

All endpoints are versioned under /v1/. The /health endpoint is unversioned.

Authentication

All endpoints except /health and GET /v1/verify/:token require a Bearer token:

Authorization: Bearer sk_live_YOUR_KEY

See Authentication for key types and scopes.

Rate limits

Every response includes rate limit headers:

X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4847
X-RateLimit-Reset: 1711234567

Plan	Verify endpoint	All other endpoints
Unauthenticated	100 req/min	20 req/min
Free	500 req/min	60 req/min
Developer	5,000 req/min	500 req/min
Growth	50,000 req/min	2,000 req/min
Enterprise	Custom	Custom

Exceeded limits return 429 with the standard error schema.

Error format

All errors follow a consistent schema:

{
  "error": {
    "code": "AGENT_NOT_FOUND",
    "message": "No agent found with the specified ID.",
    "request_id": "req_abc123",
    "docs_url": "https://docs.imarobot.ai/errors/AGENT_NOT_FOUND"
  }
}

See Errors for the full list of error codes.

Health check

GET /health

{
  "status": "ok",
  "version": "1.0.0",
  "timestamp": "2026-03-26T18:00:00.000Z"
}

No authentication required. Use this for uptime monitoring and receiver connectivity checks.

Overview

Agents

Verification

Log

Base URL

Authentication

Rate limits

Error format

Health check

​Base URL

​Authentication

​Rate limits

​Error format

​Health check

Base URL

Authentication

Rate limits

Error format

Health check