Your First Request

Hello-world examples for each RSA API. Replace tokens and IDs with real values.

POS API — Look up a member

curl "http://localhost:5003/pos/api/v1/members/lookup?phone=5551234567" \
  -H "X-Api-Key: rsa_live_your_key_here"

Response:

{
  "memberId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "firstName": "Jane",
  "lastName": "Smith",
  "phone": "5551234567",
  "tier": "Gold"
}

Admin API — List stores

curl "http://localhost:5002/admin/api/v1/stores?limit=10" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Response:

{
  "items": [
    { "id": "...", "name": "Store #001", "city": "Los Angeles", "state": "CA" }
  ],
  "cursor": null,
  "total": 1
}

Shopper API — Get loyalty balance

curl "http://localhost:5001/api/v1/loyalty/balance" \
  -H "Authorization: Bearer YOUR_SHOPPER_JWT"

Response:

{
  "points": 1250,
  "tier": "Silver",
  "nextTierPoints": 2500
}

Platform API — List tenants

curl "http://localhost:5004/platform/api/v1/tenants?limit=5" \
  -H "Authorization: Bearer YOUR_PLATFORM_JWT"

Response:

{
  "items": [
    { "id": "...", "name": "Cardenas Markets", "slug": "cardenas", "status": "Active" }
  ],
  "cursor": null
}

Troubleshooting

All errors return ProblemDetails RFC 9457 with a traceId extension for support.