---
updatedAt: 2025-06-10T00:04:29.000Z
agentTools:
  projectIndex: https://evy.readme.io/llms.txt
---

# Errors

Evy uses conventional HTTP response codes to indicate the success or failure of an API request.

In general: Codes in the `2xx` range indicate success. Codes in the `4xx` range indicate an error that failed given the information provided (e.g., a required parameter was omitted, product creation failed etc.). Codes in the `5xx` range indicate an error with Evy's servers (these are rare).

Some `4xx` errors that could be handled programmatically (e.g., resource already exists) include an [error code](https://evy.readme.io/reference/error-codes) that briefly explains the error reported.

## Attributes

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th>

      </th>

      <th>

      </th>

      <th>

      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        **code** 
      </td>

      <td>
        string
      </td>

      <td>
        For some errors that could be handled programmatically, a short string indicating the error code reported.
      </td>
    </tr>

    <tr>
      <td>
        **message** 
      </td>

      <td>
        string
      </td>

      <td>
        A human-readable message providing more details about the error.
      </td>
    </tr>
  </tbody>
</Table>

## HTTP Status Code Summary

<Table align={["left","left"]}>
  <thead>
    <tr>
      <th>

      </th>

      <th>

      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        **200 - OK** 
      </td>

      <td>
        Everything worked as expected.
      </td>
    </tr>

    <tr>
      <td>
        **400 - Bad Request** 
      </td>

      <td>
        The request was unacceptable, often due to missing a required parameter.
      </td>
    </tr>

    <tr>
      <td>
        **401 - Unauthorized** 
      </td>

      <td>
        No valid API key provided.
      </td>
    </tr>

    <tr>
      <td>
        **403 - Forbidden** 
      </td>

      <td>
        The API key doesn't have permissions to perform the request.
      </td>
    </tr>

    <tr>
      <td>
        **404 - Not Found** 
      </td>

      <td>
        The requested resource doesn't exist.
      </td>
    </tr>

    <tr>
      <td>
        **409 - Conflict**
      </td>

      <td>
        The request conflicts with the current state of the target resource.
      </td>
    </tr>

    <tr>
      <td>
        **422 - Unprocessable Entity**
      </td>

      <td>
        The server understands the content type of the request entity, and the syntax of the request entity is correct but was unable to process the contained instructions.
      </td>
    </tr>
  </tbody>
</Table>