# Error Handling

- Human documentation: https://www.myrepairapp.com/api-docs/error-handling
- OpenAPI: https://www.myrepairapp.com/openapi.json
- Last updated: 2026-07-30T23:32:46.584Z

When using our API, you may encounter various error responses. This section outlines the common error codes, their meanings, and how to handle them properly.

## Common Error Responses

Our API follows standard HTTP response status codes to indicate the success or failure of a request.

### 400 Bad Request

Occurs when the request payload is invalid or improperly formatted.

**Example Response:**

```json
{
  "message": "Validation error. Please review your request payload.",
  "errors": {
    "email": "Email has incorrect format",
    "address.zipCode": "ZIP code must have 5 digits"
  }
}
```

### 401 Unauthorized

Occurs when the API key is missing or invalid.

**Example Response:**

```json
{
  "message": "Unauthorized. Please check your credentials (login or API key) to access this resource."
}
```

**Solution:** Check your API key and ensure it is valid. Refer to our [Getting Started Guide](https://myrepairapp.com/api-docs/getting-started) for details on generating a new API key.

### 403 Forbidden

Occurs when the request is valid but the user does not have sufficient permissions to access the resource.

**Example Response:**

```json
{
  "message": "Forbidden. You do not have the necessary permissions to access this resource."
}
```

**Solution:** Ensure your account has the necessary permissions to access this resource.

### 404 Not Found

Occurs when the requested resource does not exist.

**Example Response:**

```json
{
  "message": "Resource not found. The requested endpoint does not exist."
}
```

**Solution:** Check the API endpoint URL for typos or incorrect resource IDs.

### 429 Too Many Requests

Occurs when the request rate limit has been exceeded.

**Example Response:**

```json
{
  "message": "Rate limit exceeded. Please slow down your requests."
}
```

**Solution:** Implement rate-limiting mechanisms and retry after some time.

### 500 Internal Server Error

Occurs when an unexpected error happens on the server.

**Example Response:**

```json
{
  "message": "Internal server error. Please try again later."
}
```

**Solution:** This is usually a temporary issue. Retry after some time or contact support if the issue persists.

## Handling Errors Effectively

To ensure a smooth integration with our API, we recommend:

- Logging error responses for debugging purposes.
- Implementing retry mechanisms for `500` and `429` errors.
- Ensuring valid authentication credentials to avoid `401` errors.
- Checking request payloads to prevent `400` validation errors.
- Reviewing API permissions to resolve `403` errors.

For further assistance, refer to our [API Documentation](https://myrepairapp.com/api-docs/public-api) or contact our support team at **support@myrepairapp.com**.