GuidesAPI Reference
API Reference

Register consent

post
https://xs2a-sandbox.triodos.com/xs2a-bg//v1/consents

Creates an account information consent resource at the ASPSP regarding access to accounts specified in this request.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
enum
required

Branch of the request.

Allowed:
Body Params

Consent request.

access
object
required

Requested access services.

boolean
required

"true", if the consent is for recurring access to the account data. "false", if the consent is for one access to the account data.

date
required

This parameter is requesting a valid until date for the requested consent. The content is the local ASPSP date in ISODate Format, e.g. 2017-10-30. If a maximal available date is requested, a date in far future is to be used: "9999-12-31". The consent object to be retrieved by the GET Consent.

int32
required

This field indicates the requested maximum frequency for an access per day. For a one-off access, this attribute is set to "1".

boolean
required

Sessions are not supported. Should be to "false".

Headers
string
required

ID of the request, unique to the call, as determined by the initiating party.

string
required

A signature of the request by the TPP on application level.

string
required

Digest contains a Hash of the message body, used for authentication of the request. The only hash algorithms that may be used to calculate the Digest within the context of this specification are SHA-256 and SHA-512.

string
required

The forwarded IP Address header field consists of the corresponding HTTP request IP Address field between PSU and TPP.

string
required

URI of the TPP, where the transaction flow shall be redirected to after a Redirect.

string
required
Responses

Updated 7 months ago

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 7 months ago