Responses
The PSD2 API returns standard HTTP status codes with Json-Encoded responses. Some endpoints also return contextual 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 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 for retrieving the next page. |
Link
Element | Description |
---|---|
href |
Url to a resource. |
verb |
Http verb to use. |
Example
{
"transactions": {
"_links": {
"next": {
"href": "https://banking.aritma.io/api/accounts/1234/transactions?fromDate=2012-08-24T14:15:22Z&cursor=b7de1cbff2a140d3b380e5fc8919988c",
"verb": "get"
}
}
}
}