Error codes

List of error codes and their meaning to help you diagnose issues.

400 Bad Request

The request contains invalid or incomplete data.

{
  "status": "error",
  "msg": "Campo requerido: id"
}

401 Unauthorized

Authentication token is invalid or missing.

{
  "status": "error",
  "msg": "Invalid token"
}

403 Forbidden

You do not have permission to access this resource.

{
  "status": "error",
  "msg": "Scope read requerido"
}

404 Not Found

The requested resource does not exist.

{
  "status": "error",
  "msg": "Partner not found"
}

500 Internal Server Error

Internal server error. Contact support if it persists.

{
  "status": "error",
  "msg": "DB error: internal detail"
}

Notes

Item	Detail
Envelope	API v1 uses status/msg for errors, not a standalone error field
Scopes	403 errors usually come from insufficient scopes: read, write, or admin
Validation	Required fields are validated per endpoint and usually return 400 with a direct message
Resources	Station, partner, certificate, and message detail endpoints return 404 if the resource does not exist in the current site
Message IDs	Use numeric `id` for `/messages/detail` and `/messages/download`. The business `message_as2_id` is not accepted there.
Station / partner match	`{"status":"error","msg":"Station does not match partner"}` if you send a station context that does not belong to the selected partner.

If you find undocumented errors or need help: