Skip to main content

Consents API (v1)

Download OpenAPI specification:Download

Consent

Create a consent using direct providers flow

This creates a consent and will return the consent ID and provider consent URL. This endpoint is only authorized and used for customers that use the direct provider flow.

Authorizations:
bearer
Request Body schema: application/json
required

The create consent parameters

providerKey
string

The selected provider key

userId
string or null

The User ID for which to retrieve transactions

userIdGuid
string <guid>
externalUserId
string or null

The External User ID for which to retrieve transactions

redirectUrl
string

The redirect URL to redirect the user to after consent is given

syncMode
string or null

SyncMode of this consent

Responses

Request samples

Content type
application/json
{
  • "providerKey": "string",
  • "userId": "string",
  • "userIdGuid": "string",
  • "externalUserId": "string",
  • "redirectUrl": "string",
  • "syncMode": "string"
}

Response samples

Content type
application/json
{
  • "consentId": "string",
  • "consentUrl": "string"
}

Retrieve consents

Authorizations:
bearer
query Parameters
ConsentId
string or null <guid>

The consent ID for which to retrieve consents

UserId
string or null <guid>

The User ID for which to retrieve consents

ExternalUserId
string or null

The External User ID for which to retrieve consents

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Delete consent

This will completely remove and delete the consent's accounts, transactions and all associated data on our platform. Deleting a consent is a permanent and irreversible action, mainly used for GDPR and compliance purposes.

Authorizations:
bearer
path Parameters
id
required
string <guid>

Id of the consent to delete

Responses

Response samples

Content type
application/json
{
  • "type": "string",
  • "title": "string",
  • "status": 0,
  • "traceId": "string",
  • "errors": {
    }
}