POST /account/consent/:consentId

Consent data

Provide additional consent data as requested by the account information provider in order to fulfill the account consent request.

Path Parameters

consentId string required

The ID of the account consent that was initialized (created).

application/json

Request Body array required

Adds additional data needed to start the account consent process with the provider / bank

• Array [
name ConsentDataItemName required

Possible values: [redirect, otp, iban, password, select, username, status]

value string required
• ]

Responses

• 200
• 401

---

Default response

application/json

Schema

Example (from schema)

---

Schema

inquiryId ConsentInquiryId

Consent inquiry id

consentId ConsentId

Unique consent id

status ConsentStatus

Possible values: [initiated, started, received, rejected, partially_authorised, valid, revoked_by_psu, expired, terminated_by_tpp, failed]

Consent status.

created date-time

RFC 3339 date time format (2007-11-06T16:34:41.000Z)

modified date-time

RFC 3339 date time format (2007-11-06T16:34:41.000Z)

scope ConsentScope

Possible values: [all, accounts, balances, transactions]

Consent scopes for account information access.

validUntil date-time

RFC 3339 date time format (2007-11-06T16:34:41.000Z)

consentData object[]
Additional data needed to fulfill the consent request, to be provided by end user
Array [
name ConsentDataItemName required
Possible values: [redirect, otp, iban, password, select, username, status]
label string
Label to display to the user to enter or select listed data
additional_data string
Display additional data to the user
properties object[]
Array [
value string
Value of additional data, as it was entered by the user
label string
Label to display to the client in order to enter additional data. This can be IBAN account number, a one-time password or similar.
description string
Description of additional data to be entered. Additional context (not necessary provided)
]
value string
]
providerId ProviderId

Unique consent provider (bank) id

name string

Short info of the account consent intent. Will be visible int the customers consent list.

description string

Simple description of why account access is being used.

owner object

msisdn Msisdn

Mobile phone number

email Email

Email address

country CountryCode

Account information provider country code (ISO 3166 alpha-2 codes)

data object[]
Additional internal data to be stored alongside consent. This can be internal customer profile id, or any other information to link consent to an internal process.
Array [
key string
unique key of internally stored data. For instance basked_id, customer_id ...
value string
value of internally stored data.
]
locale Locale

Two letter ISO 639-1 language/locale code.

{
  "inquiryId": "string",
  "consentId": "123",
  "status": "initiated",
  "created": "2025-10-30T15:47:48.700Z",
  "modified": "2025-10-30T15:47:48.700Z",
  "scope": "all",
  "validUntil": "2025-10-30T15:47:48.700Z",
  "consentData": [
    {
      "name": "iban",
      "value": "RO66BACX0000001234567890"
    },
    {
      "name": "username",
      "value": "tester"
    }
  ],
  "providerId": "string",
  "name": "Account ownership check",
  "description": "Account ownership confirmation",
  "owner": {
    "msisdn": "string",
    "email": "string"
  },
  "country": "AT",
  "data": [
    {
      "key": "customer_id",
      "value": "external_id_1234"
    }
  ],
  "locale": "en"
}

Unauthorized

application/json

Schema

Example (from schema)

Example

---

Schema

errorMessage string required

Description of error

errorCode ErrorCode required

Possible values: [invalid_parameter, unauthorized, forbidden, not_found, not_allowed, bad_request, other]

Error code of a specific error. For more details visit https://documentation.fliqa.io/api/errors/{errorCode}

errorSubCode ErrorSubCode

Possible values: [api_key_secret_header_must_be_provided, authorization_header_must_be_provided, access_not_allowed, domain_not_allowed, access_token_expired, invalid_access_scope, not_authorized, phone_or_email_not_registered, phone_number_start_with_plus_and_country, phone_number_invalid, email_invalid, email_or_phone_number_required, invalid_pin, could_not_interpret_numbers_after_plus, supplied_string_not_phone_number, string_supplied_too_short_to_be_phone_number, string_supplied_too_long_to_be_phone_number, string_supplied_was_too_long_to_parse, unspecified]

Error sub code of a specific error. For more details visit https://documentation.fliqa.io/api/errors/{errorCode}#{errorSubCode}

documentationUrl uri

Link to documentation if available, typically https://documentation.fliqa.io/api/errors/{errorCode}

requestId RequestId

Unique request id

resourceId ResourceId

Unique resource id

{
  "errorMessage": "string",
  "errorCode": "unauthorized",
  "errorSubCode": "phone_or_email_not_registered",
  "documentationUrl": "string",
  "requestId": "554099e7d0b648d7b96bc31c148425b8",
  "resourceId": "a683072aeeb746d58aa34dd5537c4aae"
}

{
  "errorCode": "unauthorized",
  "errorMessage": "Not authorized",
  "documentationUrl": "https://documentation.fliqa.io/api/errors/unauthorized"
}

Loading...