Skip to content

unauthorized

Property Value
Error Code unauthorized
HTTP Status 401 Unauthorized
Title Unauthorized

Description

The request does not include a valid API key. Either the X-Api-Key header is missing, or the provided key is invalid or has been revoked.

Example Response

{
  "type": "https://docs.payalo.com/errors/unauthorized",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Invalid API key.",
  "errorCode": "unauthorized"
}

Common Causes

Cause Description
Missing header The X-Api-Key header is not present in the request
Invalid key The API key does not match any active key in the system
Revoked key The API key has been deactivated or rotated

Resolution

  • Verify that the X-Api-Key header is included in every request.
  • Confirm the API key is correct and has not been rotated.
  • Contact your account manager if you need a new key or suspect your key has been compromised.

Note: This error is not retryable with the same credentials.