# Responses

The PSD2 API returns standard HTTP status codes with [Json-Encoded](https://www.json.org/json-en.html) responses.
Some endpoints also return contextual [HATEOAS](https://en.wikipedia.org/wiki/HATEOAS) links.

Codes in the `2xx` range indicate success. Codes in the `4xx` range indicate that the information provided for the
request is invalid. Codes in the `5xx` range indicate an [error](#errors) in the PSD2 API.

## Http Status Codes

### Successful Requests (2xx)

| Status Code | Description |
|  --- | --- |
| `200 OK` | The request succeeded. |
| `201 Created` | The request succeeded, and a new resource was created as a result. |
| `202 Accepted` | The request has been received but not yet acted upon. |
| `204 No Content` | The request succeeded, but without a response body. |


## Pagination

The PSD2 API support pagination for some of its bulk `GET` fetches.
The endpoints which supports this has the following query parameters:

| Query Parameter | Description |
|  --- | --- |
| `cursor` | A pointer to a specific page of data. |


### Links

A response that supports paging will contain a `_links` object, the object can contain a number of navigation links which can be used to traverse the pages.

| Element | Description |
|  --- | --- |
| `next` | [Navigation](#Link) for retrieving the next page. |


### Link

| Element | Description |
|  --- | --- |
| `href` | Url to a resource. |
| `verb` | Http verb to use. |


### Example


```json
{
  "transactions": {
    "_links": {
      "next": {
        "href": "https://banking.aritma.io/api/accounts/1234/transactions?fromDate=2012-08-24T14:15:22Z&cursor=b7de1cbff2a140d3b380e5fc8919988c",
        "verb": "get"
      }
    }
  }
}
```