# API Errors

API errors occur when communicating with your WooCommerce server. These errors are prefixed with `API` and are organized into the following categories:

## Categories[​](#categories "Direct link to Categories")

| Category                                    | Code Range | Description                                  |
| ------------------------------------------- | ---------- | -------------------------------------------- |
| [Connection](#connection-errors)            | API01xxx   | Network and connectivity issues              |
| [Authentication](#authentication-errors)    | API02xxx   | Login, tokens, and permission issues         |
| [Request](#request-errors)                  | API03xxx   | Problems with outgoing requests              |
| [Response](#response-errors)                | API04xxx   | Problems with server responses               |
| [Plugin/WordPress](#pluginwordpress-errors) | API05xxx   | Issues with WordPress or WooCommerce plugins |
| [Configuration](#configuration-errors)      | API06xxx   | Setup and configuration problems             |

***

## Connection Errors[​](#connection-errors "Direct link to Connection Errors")

Network and connectivity issues between the POS and your server.

| Code                                 | Name                  | Description                                  |
| ------------------------------------ | --------------------- | -------------------------------------------- |
| [API01001](/error-codes/API01001.md) | Connection Timeout    | The server took too long to respond          |
| [API01002](/error-codes/API01002.md) | Connection Refused    | The server refused the connection            |
| [API01003](/error-codes/API01003.md) | Connection Reset      | The connection was unexpectedly closed       |
| [API01004](/error-codes/API01004.md) | DNS Resolution Failed | Could not resolve the server address         |
| [API01005](/error-codes/API01005.md) | SSL Certificate Error | Problem with the site's security certificate |
| [API01006](/error-codes/API01006.md) | Network Unreachable   | Cannot reach the network                     |
| [API01007](/error-codes/API01007.md) | Device Offline        | Your device is not connected to the internet |
| [API01008](/error-codes/API01008.md) | Website Unavailable   | The website is not responding                |

## Authentication Errors[​](#authentication-errors "Direct link to Authentication Errors")

Issues with login, sessions, and permissions.

| Code                                 | Name                     | Description                                      |
| ------------------------------------ | ------------------------ | ------------------------------------------------ |
| [API02001](/error-codes/API02001.md) | Invalid Credentials      | Username or password is incorrect                |
| [API02002](/error-codes/API02002.md) | Token Expired            | Your session has expired                         |
| [API02003](/error-codes/API02003.md) | Token Invalid            | The authentication token is not valid            |
| [API02004](/error-codes/API02004.md) | User Not Authorized      | You don't have permission to perform this action |
| [API02005](/error-codes/API02005.md) | Insufficient Permissions | Your user role lacks required permissions        |
| [API02006](/error-codes/API02006.md) | API Key Invalid          | The WooCommerce API key is not valid             |
| [API02007](/error-codes/API02007.md) | Token Refresh Failed     | Could not refresh your session                   |
| [API02008](/error-codes/API02008.md) | Refresh Token Invalid    | The refresh token is not valid                   |
| [API02009](/error-codes/API02009.md) | Refresh Token Expired    | The refresh token has expired                    |
| [API02010](/error-codes/API02010.md) | Auth Required            | Authentication is required for this action       |

## Request Errors[​](#request-errors "Direct link to Request Errors")

Problems with the requests sent to the server.

| Code                                 | Name                        | Description                               |
| ------------------------------------ | --------------------------- | ----------------------------------------- |
| [API03001](/error-codes/API03001.md) | Invalid Request Format      | The request format is not correct         |
| [API03002](/error-codes/API03002.md) | Missing Required Parameters | Required data is missing from the request |
| [API03003](/error-codes/API03003.md) | Invalid Parameter Value     | A parameter has an invalid value          |
| [API03004](/error-codes/API03004.md) | Request Too Large           | The request exceeds size limits           |
| [API03005](/error-codes/API03005.md) | Rate Limit Exceeded         | Too many requests in a short time         |
| [API03006](/error-codes/API03006.md) | Unsupported Method          | The HTTP method is not supported          |
| [API03007](/error-codes/API03007.md) | Request Queue Full          | Too many pending requests                 |

## Response Errors[​](#response-errors "Direct link to Response Errors")

Problems with the responses received from the server.

| Code                                 | Name                     | Description                                 |
| ------------------------------------ | ------------------------ | ------------------------------------------- |
| [API04001](/error-codes/API04001.md) | Invalid Response Format  | The server response format is not valid     |
| [API04002](/error-codes/API04002.md) | Unexpected Response Code | Received an unexpected HTTP status code     |
| [API04003](/error-codes/API04003.md) | Malformed JSON Response  | The JSON response is corrupted or invalid   |
| [API04004](/error-codes/API04004.md) | Missing Response Data    | Expected data is missing from the response  |
| [API04005](/error-codes/API04005.md) | JSON Recovery Attempted  | Attempted to recover from malformed JSON    |
| [API04006](/error-codes/API04006.md) | Resource Not Found       | The requested resource does not exist (404) |

## Plugin/WordPress Errors[​](#pluginwordpress-errors "Direct link to Plugin/WordPress Errors")

Issues with WordPress, WooCommerce, or the WCPOS plugin.

| Code                                 | Name                     | Description                          |
| ------------------------------------ | ------------------------ | ------------------------------------ |
| [API05001](/error-codes/API05001.md) | WooCommerce API Disabled | The WooCommerce REST API is disabled |
| [API05002](/error-codes/API05002.md) | WCPOS Plugin Not Found   | The WCPOS plugin is not installed    |
| [API05003](/error-codes/API05003.md) | WCPOS Plugin Outdated    | The WCPOS plugin needs updating      |
| [API05004](/error-codes/API05004.md) | WordPress API Disabled   | The WordPress REST API is disabled   |
| [API05005](/error-codes/API05005.md) | Plugin Not Found         | A required plugin is not installed   |

## Configuration Errors[​](#configuration-errors "Direct link to Configuration Errors")

Setup and configuration problems.

| Code                                 | Name                       | Description                         |
| ------------------------------------ | -------------------------- | ----------------------------------- |
| [API06001](/error-codes/API06001.md) | Invalid URL Format         | The URL format is not valid         |
| [API06002](/error-codes/API06002.md) | Missing API URL            | No API URL has been configured      |
| [API06003](/error-codes/API06003.md) | Invalid Site Configuration | The site configuration is incorrect |