POST /account/consent
Create consent
Starts a new account consent request. Depending on account information provider additional data will be inquired if needed to gather all needed data to facilitate the account access.
Query Parameters
Desired language (if supported). See supported languages for more information.
Request Body required
Initiates a new account consent request
- Array [
- ]
Unique consent provider (bank) id
OTP (One Time Password) to provided via SMS or email to initiate consent
Mobile phone number
Email address
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.
unique key of internally stored data. For instance basked_id, customer_id ...
value of internally stored data.
- 201
- 400
- 401
Newly initiated account consent
Schema
- Array [
- Array [
- ]
- ]
- Array [
- ]
Consent inquiry id
Unique consent id
Possible values: [initiated, started, received, rejected, partially_authorised, valid, revoked_by_psu, expired, terminated_by_tpp, failed]
Consent status.
RFC 3339 date time format (2007-11-06T16:34:41.000Z)
RFC 3339 date time format (2007-11-06T16:34:41.000Z)
Possible values: [all, accounts, balances, transactions]
Consent scopes for account information access.
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
Possible values: [redirect, otp, iban, password, select, username, status]
Label to display to the user to enter or select listed data
Display additional data to the user
properties object[]
Value of additional data, as it was entered by the user
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 of additional data to be entered. Additional context (not necessary provided)
Unique consent provider (bank) id
Short info of the account consent intent. Will be visible int the customers consent list.
Simple description of why account access is being used.
owner object
Mobile phone number
Email address
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.
unique key of internally stored data. For instance basked_id, customer_id ...
value of internally stored data.
Two letter ISO 639-1 language/locale code.
{
"inquiryId": "string",
"consentId": "123",
"status": "initiated",
"created": "2025-10-30T15:47:48.698Z",
"modified": "2025-10-30T15:47:48.698Z",
"scope": "all",
"validUntil": "2025-10-30T15:47:48.698Z",
"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"
}
Invalid parameter, can't fulfill request
Schema
Description of error
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}
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}
Link to documentation if available, typically https://documentation.fliqa.io/api/errors/{errorCode}
Unique request id
Unique resource id
{
"errorMessage": "string",
"errorCode": "unauthorized",
"errorSubCode": "phone_or_email_not_registered",
"documentationUrl": "string",
"requestId": "554099e7d0b648d7b96bc31c148425b8",
"resourceId": "a683072aeeb746d58aa34dd5537c4aae"
}
{
"errorCode": "invalid_parameter",
"errorMessage": "Missing consent 'provider'!",
"documentationUrl": "https://documentation.fliqa.io/api/errors/invalid_parameter"
}
Unauthorized
Schema
Description of error
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}
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}
Link to documentation if available, typically https://documentation.fliqa.io/api/errors/{errorCode}
Unique request id
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"
}