Skip to main content

​
Authentication

​
BearerAuth

HTTP: BearerAuth Authentication to the API is performed via Bearer Token Authentication. Provide your API key as the bearer token in the Authorization header. All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail. HTTP Authorization Scheme: bearer

​
Making Authenticated Requests

Include your API key as a Bearer token in the Authorization header: 
curl -X POST https://api.rightfoot.com/v1/balance_requests \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "authorizers": [...]
  }'

​
Error Responses

If authentication fails, you’ll receive a 401 response: 
{
  "status": "error",
  "status_code": 401,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid API key provided.",
    "timestamp": "2024-09-16T12:01:00Z",
    "suggestion": "Please check your API key."
  },
  "batch_id": null,
  "documentation_url": "https://api.rightfoot.com/docs"
}
⌘I