> For the complete documentation index, see [llms.txt](https://api-docs.rightsline.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api-docs.rightsline.com/overview/errors.md).

# Errors

All exceptions are trapped and logged at the Service Level. The services are designed to always return a response, even in the event of an exception. Standard HTTP response codes will be returned where applicable, for example, unauthorized requests will typically be responded to with a HTTP 401 Unauthorized.

When applicable, additional response information will be provided, including a custom header x-ris-request-id which we can use to look up any API request made and further trouble shoot any issues. In the event that required fields are missing or incorrectly typed data was passed in a request, the validation errors will be returned along with the 400 Bad Request response code.

All error response information contains:

* An appropriate 3xx, 4xx, or 5xx HTTP status code
* Error object containing additional information if applicable

### **Response Elements**

| NAME            | DESCRIPTION                                                            |
| --------------- | ---------------------------------------------------------------------- |
| Code            | The error code is a string that uniquely identifies an error condition |
| Message         | The textual representation of the error that is more human readable    |
| x-ris-requestID | Uniquely identifies the request that resulted in error                 |

### **Handling Errors**

Our API bindings can raise exceptions for many reasons, such as invalid parameters, authentication errors, and network unavailability. We recommend always trying to gracefully handle exceptions from our API.

### **Common Error Codes**

| Error Code | Description           | How to fix                                                                                                                                                                                                      |
| ---------- | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 400        | Bad Request           | A message will be returned in the response with details on how to modify your request.                                                                                                                          |
| 401        | Unauthorized          | Verify your credentials and authorization signature is correct.                                                                                                                                                 |
| 403        | Permission Denied     | Verify you have the correct permissions enabled in Rightsline to access/create the record.                                                                                                                      |
| 404        | Not Found             | Modify the ID of the record you are attempting to read/update/delete.                                                                                                                                           |
| 429        | Too Many Requests     | The Rightsline API has daily and per-second limits. Retry the request after a 1 second delay. If error persists, you may have reached your daily limit.                                                         |
| 500        | Internal Server Error | Contact Rightsline Support.                                                                                                                                                                                     |
| 503        | Service Unavailable   | During UAT, you may receive this error when a new build is being deployed to one of the UAT environments. Simply retry the request after a few minutes.                                                         |
| 504        | Gateway Timeout       | If attempting to create/update record, try to retrieve the record. If record was not created/updated, retry the request. If attempting to retrieve temporary credentials or a record, simply retry the request. |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://api-docs.rightsline.com/overview/errors.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.