> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# SISBAJUD error list

> Look up a SISBAJUD error code, the HTTP status it carries, and the action that resolves it.

**Error format**

SISBAJUD returns errors with a stable `code`. An operation error uses RFC 9457 problem details with the `application/problem+json` media type:

<CodeGroup>
  ```json JSON theme={null}
  {
    "type": "https://errors.lerian.studio/v1/SBJ-0001",
    "title": "Bad Request",
    "status": 400,
    "detail": "institutionId path parameter must be a valid non-nil UUID.",
    "code": "SBJ-0001"
  }
  ```
</CodeGroup>

**Field definitions**

* **`code`** – A stable identifier for the error, in the form `SBJ-NNNN`. Branch on this value when the response carries one, and on the status otherwise.
* **`type`** – A URI that identifies the error in the Lerian error catalog. Built as `https://errors.lerian.studio/v1/<code>`.
* **`title`** – The HTTP status text (for example, `Bad Request`).
* **`status`** – The HTTP status code.
* **`detail`** – Guidance for this occurrence of the error. For `5xx` responses, the detail carries the static text `internal error`, so use `code` to branch.
* **`errors`** – Optional list of per-field validation details, each with a `message` and a `location`.

A refusal the router makes before the request reaches an operation, such as an unsupported method, answers the same `code` and `title` in a plain JSON body.

## Client errors

***

| `code`   | Description                                                                                                                                                         | Status      |
| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
| SBJ-0001 | The request has malformed syntax. Check the path identifiers, the timestamp format, and the field lengths.                                                          | 400         |
| SBJ-0003 | Authentication failed. Send a valid bearer token.                                                                                                                   | 401         |
| SBJ-0004 | The caller identity lacks permission for this resource.                                                                                                             | 403         |
| SBJ-0005 | The resource does not exist. Check the identifier in the path.                                                                                                      | 404         |
| SBJ-0007 | The request conflicts with the current state of the resource, such as a duplicate create or a request that already reached a terminal state.                        | 409         |
| SBJ-0010 | The request payload, or the file content the request asked for, is above the accepted size.                                                                         | 413         |
| SBJ-0006 | The syntax is correct, but the service cannot process the request. A value falls outside the accepted set, or the resource is in the wrong state for the operation. | 422         |
| SBJ-0011 | A client error outside the codes above, such as an unsupported HTTP method. Read the HTTP status of the response.                                                   | Other `4xx` |

## Server errors

***

| `code`   | Description                                                                                                                 | Status |
| -------- | --------------------------------------------------------------------------------------------------------------------------- | ------ |
| SBJ-0002 | The service failed unexpectedly. Send the request again, and contact support if the failure continues.                      | 500    |
| SBJ-0008 | A dependency this endpoint needs is unavailable. Contact your platform team; sending the request again does not resolve it. | 503    |