# Responses

Cryptopay API operates[ HTTP status codes](http://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml) to indicate the status of user’s requests including both successful and unsuccessful responses.

Responses will also include JSON-formatted data for further details:

* 1xx (Informational): The request is received, continuing process
* 2xx (Successful): The request is successfully received, understood, and accepted
* 3xx (Redirection): Further action needs to be taken in order to complete the request
* 4xx (Client Error): The request contains bad syntax or cannot be fulfilled
* 5xx (Server Error): The server failed to fulfil an apparently valid request

| Status code                   | Meaning                                                                                                                                                                                           |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `200 OK`                      | Standard response for successful HTTP requests                                                                                                                                                    |
| `201 Created`                 | The request has been fulfilled, resulting in the creation of a new resource                                                                                                                       |
| `202 Accepted`                | The request has been accepted for processing, but the processing has not been completed                                                                                                           |
| `204 No Content`              | The server successfully processed the request and is not returning any content                                                                                                                    |
| `304 Not Modified`            | Indicates that the resource has not been modified since the version specified by the request headers If-Modified-Since or If-None-Match                                                           |
| `400 Bad Request`             | The server cannot or will not process the request due to an apparent client error (e.g., malformed request syntax, size too large, invalid request message framing, or deceptive request routing) |
| `401 Unauthorized`            | Most likely you weren't able to construct and sign your API request correctly using HMAC                                                                                                          |
| `403 Forbidden`               | You don't have required permissions to perform requested action on the resource. Check your API key whitelist                                                                                     |
| `404 Not Found`               | We don't have the resource you've requested                                                                                                                                                       |
| `409 Conflict`                | Most likely the `custom_id` value you are trying to use had been used before                                                                                                                      |
| `422 Unprocessable Entity`    | The request was well-formed but was unable to be followed due to semantic errors                                                                                                                  |
| `429 API rate limit exceeded` | Amount API requests for api\_key exceeded 200 requests per minute                                                                                                                                 |
| `500 Internal Server Error`   | We have a problem with our server                                                                                                                                                                 |
| `503 Service Unavailable`     | We are temporarily offline for maintenance                                                                                                                                                        |


---

# Agent Instructions: 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://developers.cryptopay.me/guides/api-basics/responses.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.
