API overview

The public API is for user-owned clients such as the SellTraces CLI, browser flows, Rebate frontends, and integrations that act on behalf of a signed-in user. The generated endpoint reference is built with zod-openapi from scripts/generate-openapi.ts, shared Zod request schemas, and the Next.js route tree under apps/web/src/app/api/**.

Base URLs

Environment	Base URL
Production	`https://app.rebates.ai`
Local development	`http://localhost:3000`

The generated OpenAPI file includes both servers.

Main surfaces

Surface	Endpoints
SellTraces CLI	`POST /api/cli/device/start`, `GET /api/cli/device/poll`, `GET /api/cli/session`, `POST /api/cli/telemetry`, `POST /api/cli/feedback`
SellTraces ingest	`POST /api/ingest`, `GET /api/ingest/jobs/{jobId}`
SellTraces traces	`GET /api/traces/{id}`, `PATCH /api/traces/{id}`, `POST /api/traces/bulk`, `GET /api/traces/{id}/download`, `POST /api/traces/known`
Rebates ads	`GET /api/ad`, `POST /api/ad/contextual`
Rebates devices	`POST /api/rebate/claim`

Internal and delegated routes such as health checks, Better Auth, and Gravity tracking proxy URLs are excluded from the public API reference.

Generated reference

Open the API Reference tab for generated operation pages. Endpoint pages use stable /api-reference/... URLs generated from the OpenAPI manifest.

Surface	Generated endpoint pages
SellTraces CLI	Start device login, poll device login, get CLI session, submit CLI feedback, submit parser diagnostics
SellTraces ingest	Queue trace ingestion, get ingest job status
SellTraces traces	Get trace sale state, update trace sale eligibility, bulk update trace sale eligibility, check known trace hashes, download scrubbed trace JSON
Rebates ads	Serve a terminal ad, serve a contextual terminal ad
Rebates devices	Claim a device

The raw OpenAPI document is available at:

https://app.rebates.ai/docs/openapi.json

Response style

Most application-owned JSON routes return an ok envelope:

{
  "ok": true
}

Errors generally return:

{
  "ok": false,
  "error": "unauthorized"
}

Some Rebates ad-delivery routes return bare error objects because their wire contract predates the shared envelope and is optimized for CLI rendering fallback.

​API overview

​Base URLs

​Main surfaces

​Generated reference

​Response style

API overview

Base URLs

Main surfaces

Generated reference

Response style