SISBAJUD error list

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

{
  "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"
}

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

Institution

Orders

Files

Monitoring

Reconciliation

Remittance and return files

LGPD requests

Security

Audit and compliance

Dev-only tools

Error handling

SISBAJUD error list

Client errors

Server errors

​Client errors

​Server errors

Client errors

Server errors