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.


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.


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.


Element Description
href Url to a resource.
verb Http verb to use.


  "transactions": {
    "_links": {
      "next": {
        "href": "",
        "verb": "get"