---
updatedAt: 2025-10-11T20:13:20.000Z
agentTools:
  projectIndex: https://docs.getgreenspark.com/llms.txt
---

# Errors

An overview of all Greenspark API errors.

The Greenspark API uses standard HTTP status codes to represent the result of your requests.\
 

## Successful responses

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th style={{ textAlign: "left" }}>
        Error Code
      </th>

      <th style={{ textAlign: "left" }}>
        Type
      </th>

      <th style={{ textAlign: "left" }}>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td style={{ textAlign: "left" }}>
        200
      </td>

      <td style={{ textAlign: "left" }}>
        OK
      </td>

      <td style={{ textAlign: "left" }}>
        The request succeeded.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        201
      </td>

      <td style={{ textAlign: "left" }}>
        Created
      </td>

      <td style={{ textAlign: "left" }}>
        The request succeeded, and a new resource was created as a result. This is typically the response sent after POST requests, or some PUT requests.
      </td>
    </tr>
  </tbody>
</Table>

 

## Client error responses

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

      <th>
        Type
      </th>

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

  <tbody>
    <tr>
      <td>
        400
      </td>

      <td>
        Bad Request
      </td>

      <td>
        The server cannot process the request due to something that is perceived to be a client error. For example: malformed request syntax, wrong parameter type.
      </td>
    </tr>

    <tr>
      <td>
        401
      </td>

      <td>
        Unauthorized
      </td>

      <td>
        Indicates a problem with your provided Greenspark API key.
      </td>
    </tr>

    <tr>
      <td>
        403
      </td>

      <td>
        Forbidden
      </td>

      <td>
        You don't have the right plan to use the Greenspark API.
      </td>
    </tr>

    <tr>
      <td>
        404
      </td>

      <td>
        Not Found
      </td>

      <td>
        The server can not find the requested resource. This means that the endpoint is valid but the resource itself does not exist.
      </td>
    </tr>
  </tbody>
</Table>

 

## Server error responses

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

      <th>
        Type
      </th>

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

  <tbody>
    <tr>
      <td>
        500
      </td>

      <td>
        Internal Server Error
      </td>

      <td>
        The server has encountered a situation it does not know how to handle.
      </td>
    </tr>
  </tbody>
</Table>