API Introduction

https://api.prefid.dev/v1

curl -X GET "https://api.prefid.dev/v1/preferences" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1703012400

{
  "success": true,
  "data": { ... },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2024-12-19T10:30:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or expired access token",
    "details": null
  },
  "meta": {
    "request_id": "req_abc123"
  }
}

GET /v1/preferences/atoms?limit=20&offset=0

{
  "data": [...],
  "pagination": {
    "limit": 20,
    "offset": 0,
    "total": 150,
    "has_more": true
  }
}