Authentication

Retail Mind uses API keys to authenticate all requests. Pass your key in the Authorization header:

Authorization: Bearer rm_live_xxxxxxxxxxxxxxxxxxxx

Create an API Key

curl -X POST http://localhost:8000/v1/auth/keys \
  -H "Content-Type: application/json" \
  -d '{"name": "My Integration"}'

Response:

{
  "id": "uuid",
  "name": "My Integration",
  "key": "rm_live_xxxxxxxxxxxxxxxxxxxx",
  "key_prefix": "rm_live_",
  "created_at": "2026-01-01T00:00:00Z"
}

Important: The full key is only shown once. Store it securely.

Test Keys

Prefix rm_test_ keys bypass rate limits and return mock data — ideal for local development.

Rate Limits

Plan	Requests/min
Free	60
Pro	600
Enterprise	Unlimited

Quickstart Data Sources