> For the complete documentation index, see [llms.txt](https://apidocs.arionbanki.is/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidocs.arionbanki.is/psd2/api-reference/api-specification/account-information-service-api.md).

# Account Information Service Api

Account Information Service (AIS) — access to account lists, details, balances and transactions.

## Read account list

> Read the identifiers of the available payment accounts together with booking balance\
> information, depending on the consent granted. It is assumed that a consent of the PSU to\
> this access is already given and stored on the ASPSP system. The addressed list of accounts\
> depends then on the PSU ID and the stored consent addressed by consentId, respectively the\
> OAuth2 access token.\
>             \
> Returns all identifiers of the accounts to which an account access has been granted through\
> the /consents endpoint by the PSU. In addition, relevant information about the accounts and\
> hyperlinks to corresponding account information resources are provided if a related consent\
> has been already granted.\
>             \
> \*\*Remark:\*\* Note that the /consents endpoint optionally offers to grant access to all available payment\
> accounts of a PSU. In this case, this endpoint will deliver the information about all\
> available payment accounts of the PSU at this ASPSP.

```json
{"openapi":"3.0.4","info":{"title":"IOBWS 3.0 Payments and accounts","version":"v1"},"tags":[{"name":"AccountInformationServiceApi","description":"Account Information Service (AIS) — access to account lists, details, balances and transactions."}],"servers":[{"url":"https://apigwsandbox.arionbanki.is/psd2","description":"PSD2 API Host - Sandbox"},{"url":"https://apigw.arionbanki.is/psd2","description":"PSD2 API Host - Production"}],"security":[{"Bearer":["ais:"],"SubscriptionKey":[]}],"components":{"securitySchemes":{"Bearer":{"type":"oauth2","description":"Send your Curity-issued opaque bearer token in the `Authorization: Bearer <token>` header. Required on every request.","flows":{"clientCredentials":{"tokenUrl":"https://curity.arionbanki.is/oauth/v2/oauth-token","scopes":{"ais:":"Account Information Service (AIS) access","pis:":"Payment Initiation Service (PIS) access"}}}}},"schemas":{"AccountList":{"required":["accounts"],"type":"object","properties":{"accounts":{"type":"array","items":{"$ref":"#/components/schemas/AccountDetails"}}},"additionalProperties":false,"description":"List of accounts with details."},"AccountDetails":{"required":["currency"],"type":"object","properties":{"resourceId":{"type":"string","description":"This shall be filled, if addressable resource are created by the ASPSP on the /accounts or /card-accounts endpoint.","nullable":true},"iban":{"pattern":"[A-Z]{2,2}[0-9]{2,2}[a-zA-Z0-9]{1,30}","type":"string","description":"IBAN of an account.","nullable":true},"bban":{"pattern":"[a-zA-Z0-9]{1,30}","type":"string","description":"Basic Bank Account Number (BBAN) Identifier. This data element can be used in the\nbody of the consent request. Message for retrieving account access consent from\nthis account. This data elements is used for payment accounts which have no IBAN.\nISO20022: Basic Bank Account Number (BBAN). Identifier used nationally by financial\ninstitutions, i.e., in individual countries, generally as part of a National Account\nNumbering Scheme(s), which uniquely identifies the account of a customer.","nullable":true},"msisdn":{"maxLength":35,"type":"string","description":"Mobile phone number.","nullable":true},"currency":{"minLength":1,"pattern":"[A-Z]{3}","type":"string","description":"ISO 4217 Alpha 3 currency code."},"name":{"maxLength":70,"type":"string","description":"Name of the account, as assigned by the ASPSP, in agreement with the account owner in order to provide an additional means of identification of the account.","nullable":true},"displayName":{"maxLength":70,"type":"string","description":"Name of the account as defined by the PSU within online channels.","nullable":true},"product":{"maxLength":35,"type":"string","description":"Product name of the bank for this account, proprietary definition.","nullable":true},"cashAccountType":{"type":"string","description":"ExternalCashAccountType1Code from ISO 20022.","nullable":true},"status":{"$ref":"#/components/schemas/AccountStatus"},"bic":{"pattern":"[A-Z]{6,6}[A-Z2-9][A-NP-Z0-9]([A-Z0-9]{3,3}){0,1}","type":"string","description":"BICFI","nullable":true},"linkedAccounts":{"maxLength":70,"type":"string","description":"Case of a set of pending card transactions, the APSP will provide the relevant cash account the card is set up on.","nullable":true},"usage":{"$ref":"#/components/schemas/UsageEnum"},"details":{"maxLength":500,"type":"string","description":"Specifications that might be provided by the ASPSP:   - characteristics of the account   - characteristics of the relevant card","nullable":true},"balances":{"type":"array","items":{"$ref":"#/components/schemas/Balance"},"description":"A list of balances regarding this account, e.g. the current balance, the last booked balance.\nThe list might be restricted to the current balance.","nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"Links to the account, which can be directly used for retrieving account information from this dedicated account.\n            \nLinks to \"balances\" and/or \"transactions\"\n            \nThese links are only supported, when the corresponding consent has been already granted.","nullable":true},"ownerName":{"maxLength":140,"type":"string","description":"Name of the legal account owner.\nIf there is more than one owner, then e.g. two names might be noted here.\n            \nFor a corporate account, the corporate name is used for this attribute.\nEven if supported by the ASPSP, the provision of this field might depend on the fact\nwhether an explicit consent to this specific additional account information has been given by the PSU.","nullable":true},"creditLimit":{"$ref":"#/components/schemas/Amount"}},"additionalProperties":false,"description":"The ASPSP shall give at least one of the account reference identifiers:\n            \n* iban\n* bban\n* maskedPan\n* msisdn\n            \nIf the account is a multicurrency account currency code in \"currency\" is set to \"XXX\"."},"AccountStatus":{"enum":["enabled","deleted","blocked"],"type":"string","description":"Account status. The value is one of the following:   - \\\"enabled\\\": account is available   - \\\"deleted\\\": account is terminated   - \\\"blocked\\\": account is blocked e.g. for legal reasons If this field is not used, than the account is available in the sense of this specification."},"UsageEnum":{"enum":["PRIV","ORGA"],"type":"string","description":"Specifies the usage of the account:   * PRIV: private personal account   * ORGA: professional account"},"Balance":{"required":["balanceAmount","balanceType"],"type":"object","properties":{"balanceAmount":{"$ref":"#/components/schemas/Amount"},"balanceType":{"$ref":"#/components/schemas/BalanceType"},"creditLimitIncluded":{"type":"boolean","description":"A flag indicating if the credit limit of the corresponding account  is included in the calculation of the balance, where applicable.","nullable":true},"lastChangeDateTime":{"type":"string","description":"This data element might be used to indicate e.g. with the expected or booked balance that no action is known  on the account, which is not yet booked.","format":"date-time","nullable":true},"referenceDate":{"type":"string","description":"Indicates the date of the balance.","format":"date-time","nullable":true},"lastCommittedTransaction":{"maxLength":35,"type":"string","description":"\\\"entryReference\\\" of the last commited transaction to support the TPP in identifying whether all  PSU transactions are already known.","nullable":true}},"additionalProperties":false,"description":"A single balance element."},"Amount":{"required":["amount","currency"],"type":"object","properties":{"currency":{"minLength":1,"pattern":"[A-Z]{3}","type":"string","description":"ISO 4217 Alpha 3 currency code."},"amount":{"minLength":1,"pattern":"-?[0-9]{1,14}(\\.[0-9]{1,3})?","type":"string","description":"The amount given with fractional digits, where fractions must be compliant to the\ncurrency definition. Up to 14 significant figures. Negative amounts are signed by\nminus. The decimal separator is a dot.\n            \n**Example:** Valid representations for EUR with up to two decimals are:\n            \n* 1056\n* 5768.2\n* -1.50\n* 5877.78"}},"additionalProperties":false,"description":""},"BalanceType":{"enum":["closingBooked","expected","openingBooked","interimAvailable","interimBooked","forwardAvailable","nonInvoiced"],"type":"string","description":"The following balance types are defined:\n            \n* **closingBooked**: Balance of the account at the end of the pre-agreed account reporting period. It is the sum of the opening booked balance at the beginning of the period and all entries booked to the account during the pre-agreed account reporting period. For card-accounts, this is composed of invoiced, but not yet paid entries.\n* **expected**: Balance composed of booked entries and pending items known at the time of calculation, which projects the end of day balance if everything is booked on the account and no other entry is posted. For card accounts, this is composed of invoiced but not yet paid entries, not yet invoiced but already booked entries and pending items (not yet booked). For card-accounts: \"money to spend with the value of a pre-approved credit limit on the card account\".\n* **openingBooked**: Book balance of the account at the beginning of the account reporting period. It always equals the closing book balance from the previous report.\n* **interimAvailable**: Available balance calculated in the course of the account servicer's business day, at the time specified, and subject to further changes during the business day. The interim balance is calculated on the basis of booked credit and debit items during the calculation time/period specified. For card-accounts, this is composed of invoiced but not yet paid entries and not yet invoiced but already booked entries.\n* **interimBooked**: Balance calculated in the course of the account servicer's business day, at the time specified, and subject to further changes during the business day. The interim balance is calculated on the basis of booked credit and debit items during the calculation time/period specified.\n* **expectedBooked**: Balance composed of booked entries and pending items known at the time of calculation, which projects the end of day balance if everything is booked on the account and no other entry is posted. For card accounts, this is composed of not yet invoiced but already booked entries and pending items (not yet booked). For card-accounts: \"money to spend with the value of a pre-approved credit limit on the card account\".\n* **forwardAvailable**: Forward available balance of money that is at the disposal of the account owner on the date specified.\n* **nonInvoiced**: Only for card accounts, to be checked yet."},"HrefType":{"type":"object","properties":{"href":{"type":"string","nullable":true}},"additionalProperties":false,"description":"Link to a resource."},"Error400NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage400AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 400."},"TppMessage400AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode400AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"TppMessageCategory":{"enum":["ERROR","WARNING"],"type":"string","description":"Category of the TPP message category."},"MessageCode400AIS":{"enum":["FORMAT_ERROR","PARAMETER_NOT_CONSISTENT","PARAMETER_NOT_SUPPORTED","SERVICE_INVALID","RESOURCE_UNKNOWN","RESOURCE_EXPIRED","RESOURCE_BLOCKED","TIMESTAMP_INVALID","PERIOD_INVALID","SCA_METHOD_UNKNOWN","SCA_INVALID","CONSENT_UNKNOWN","SESSIONS_NOT_SUPPORTED"],"type":"string","description":"Message codes defined for AIS for HTTP Error code 400 (BAD_REQUEST)."},"Error401NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage401AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 401."},"TppMessage401AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode401AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"MessageCode401AIS":{"enum":["CERTIFICATE_INVALID","ROLE_INVALID","CERTIFICATE_EXPIRED","CERTIFICATE_BLOCKED","CERTIFICATE_REVOKE","CERTIFICATE_MISSING","SIGNATURE_INVALID","SIGNATURE_MISSING","CORPORATE_ID_INVALID","PSU_CREDENTIALS_INVALID","CONSENT_INVALID","CONSENT_EXPIRED","TOKEN_UNKNOWN","TOKEN_INVALID","TOKEN_EXPIRED"],"type":"string","description":"Message codes defined for AIS for HTTP Error code 401 (UNAUTHORIZED)."},"Error403NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage403AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 403."},"TppMessage403AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode403AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"MessageCode403AIS":{"enum":["CONSENT_UNKNOWN","SERVICE_BLOCKED","RESOURCE_UNKNOWN","RESOURCE_EXPIRED","ACCOUNT_INVALID_FOR_CONSENT"],"type":"string","description":"Message codes defined for AIS for HTTP Error code 403 (FORBIDDEN)."},"Error404NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage404AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 404."},"TppMessage404AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode404AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"MessageCode404AIS":{"enum":["RESOURCE_UNKNOWN"],"type":"string","description":"Message codes defined for AIS for HTTP Error code 404 (NOT FOUND)."},"Error405NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage405AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 401."},"TppMessage405AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode405AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"MessageCode405AIS":{"enum":["SERVICE_INVALID"],"type":"string","description":"Message codes defined for AIS for HTTP Error code 405 (METHOD NOT ALLOWED)."},"Error406NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage406AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 406."},"TppMessage406AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode406AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"MessageCode406AIS":{"enum":["REQUESTED_FORMATS_INVALID"],"type":"string","description":"Message codes defined for AIS for HTTP Error code 406 (NOT ACCEPTABLE)."},"Error409NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage409AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 409."},"TppMessage409AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode409AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"MessageCode409AIS":{"enum":["STATUS_INVALID"],"type":"string","description":"Message codes defined for AIS for HTTP Error code 409 (CONFLICT)."},"Error429NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage429AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 429."},"TppMessage429AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode429AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"MessageCode429AIS":{"enum":["ACCESS_EXCEEDED"],"type":"string","description":"Message codes for HTTP Error code 429 (TOO MANY REQUESTS)."}}},"paths":{"/api/v1/accounts":{"get":{"tags":["AccountInformationServiceApi"],"summary":"Read account list","description":"Read the identifiers of the available payment accounts together with booking balance\ninformation, depending on the consent granted. It is assumed that a consent of the PSU to\nthis access is already given and stored on the ASPSP system. The addressed list of accounts\ndepends then on the PSU ID and the stored consent addressed by consentId, respectively the\nOAuth2 access token.\n            \nReturns all identifiers of the accounts to which an account access has been granted through\nthe /consents endpoint by the PSU. In addition, relevant information about the accounts and\nhyperlinks to corresponding account information resources are provided if a related consent\nhas been already granted.\n            \n**Remark:** Note that the /consents endpoint optionally offers to grant access to all available payment\naccounts of a PSU. In this case, this endpoint will deliver the information about all\navailable payment accounts of the PSU at this ASPSP.","operationId":"GetAccountList","parameters":[{"name":"X-Request-ID","in":"header","description":"ID of the request, unique to the call, as determined by the initiating party.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Consent-ID","in":"header","description":"This data element may be contained, if the payment initiation transaction is part of a session, i.e. combined AIS/PIS service. This then contains the consentId of the related AIS consent, which was performed prior to this payment initiation.","required":true,"schema":{"type":"string"}},{"name":"withBalance","in":"query","description":"If contained, this function reads the list of accessible payment accounts including the booking balance,  if granted by the PSU in the related consent and available by the ASPSP.  This parameter might be ignored by the ASPSP.","schema":{"type":"boolean"}},{"name":"withCreditLimit","in":"query","description":"If contained, this function reads the list of accessible payment accounts including the credit limit, if granted by the PSU in the related consent and available by the ASPSP. This parameter might be ignored by the ASPSP.","schema":{"type":"boolean"}},{"name":"Digest","in":"header","description":"Is contained if and only if the \\\"Signature\\\" element is contained in the header of the request.","schema":{"type":"string"}},{"name":"Signature","in":"header","description":"A signature of the request by the TPP on application level. This might be mandated by ASPSP.","schema":{"type":"string"}},{"name":"TPP-Signature-Certificate","in":"header","description":"The certificate used for signing the request, in base64 encoding.  Must be contained if a signature is contained.","schema":{"type":"string"}},{"name":"PSU-IP-Address","in":"header","description":"The forwarded IP Address header field consists of the corresponding HTTP request  IP Address field between PSU and TPP.  It shall be contained if and only if this request was actively initiated by the PSU.","schema":{"type":"string"}},{"name":"PSU-IP-Port","in":"header","description":"The forwarded IP Port header field consists of the corresponding HTTP request IP Port field between PSU and TPP, if available.","schema":{"type":"string"}},{"name":"PSU-Accept","in":"header","description":"The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.","schema":{"type":"string"}},{"name":"PSU-Accept-Charset","in":"header","description":"The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.","schema":{"type":"string"}},{"name":"PSU-Accept-Encoding","in":"header","description":"The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.","schema":{"type":"string"}},{"name":"PSU-Accept-Language","in":"header","description":"Language that the SCA page will be presented in. Possible options are:\n            \n* \"is\" - Icelandic\n* \"en\" - English\n            \nIf parameter is empty, the default language will be English.","schema":{"type":"string"}},{"name":"PSU-User-Agent","in":"header","description":"The forwarded Agent header field of the HTTP request between PSU and TPP, if available.","schema":{"type":"string"}},{"name":"PSU-Http-Method","in":"header","description":"HTTP method used at the PSU → TPP interface, if available. Valid values: GET, POST, PUT, PATCH, DELETE.","schema":{"type":"string"}},{"name":"PSU-Device-ID","in":"header","description":"UUID (Universally Unique Identifier) for a device, which is used by the PSU, if available. UUID identifies either a device or a device dependant application installation. In case of an installation identification this ID needs to be unaltered until removal from device.","schema":{"type":"string","format":"uuid"}},{"name":"PSU-Geo-Location","in":"header","description":"The forwarded Geo Location of the corresponding http request between PSU and TPP if available.","schema":{"pattern":"GEO:-?[0-9]{1,2}\\.[0-9]{6};-?[0-9]{1,3}\\.[0-9]{6}","type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountList"}},"application/xml":{"schema":{"$ref":"#/components/schemas/AccountList"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error400NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error400NGAIS"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error401NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error401NGAIS"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error403NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error403NGAIS"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error404NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error404NGAIS"}}}},"405":{"description":"Method Not Allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error405NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error405NGAIS"}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error406NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error406NGAIS"}}}},"408":{"description":"Request Timeout"},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error409NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error409NGAIS"}}}},"415":{"description":"Unsupported Media Type"},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error429NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error429NGAIS"}}}},"500":{"description":"Internal Server Error"},"503":{"description":"Service Unavailable"}}}}}}
```

## Read account details

> Reads details about an account, with balances where required. It is assumed that a consent of\
> the PSU to this access is already given and stored on the ASPSP system. The addressed details\
> of this account depend then on the stored consent addressed by consentId, respectively the\
> OAuth2 access token.\
> &#x20;           \
> \*\*NOTE:\*\* The account-id can represent a multicurrency account. In this case the currency code\
> is set to \\"XXX\\".\
> &#x20;           \
> Gives detailed information about the addressed account, together with balance information.

```json
{"openapi":"3.0.4","info":{"title":"IOBWS 3.0 Payments and accounts","version":"v1"},"tags":[{"name":"AccountInformationServiceApi","description":"Account Information Service (AIS) — access to account lists, details, balances and transactions."}],"servers":[{"url":"https://apigwsandbox.arionbanki.is/psd2","description":"PSD2 API Host - Sandbox"},{"url":"https://apigw.arionbanki.is/psd2","description":"PSD2 API Host - Production"}],"security":[{"Bearer":["ais:"],"SubscriptionKey":[]}],"components":{"securitySchemes":{"Bearer":{"type":"oauth2","description":"Send your Curity-issued opaque bearer token in the `Authorization: Bearer <token>` header. Required on every request.","flows":{"clientCredentials":{"tokenUrl":"https://curity.arionbanki.is/oauth/v2/oauth-token","scopes":{"ais:":"Account Information Service (AIS) access","pis:":"Payment Initiation Service (PIS) access"}}}}},"schemas":{"InlineResponse2003":{"required":["account"],"type":"object","properties":{"account":{"$ref":"#/components/schemas/AccountDetails"}},"additionalProperties":false,"description":""},"AccountDetails":{"required":["currency"],"type":"object","properties":{"resourceId":{"type":"string","description":"This shall be filled, if addressable resource are created by the ASPSP on the /accounts or /card-accounts endpoint.","nullable":true},"iban":{"pattern":"[A-Z]{2,2}[0-9]{2,2}[a-zA-Z0-9]{1,30}","type":"string","description":"IBAN of an account.","nullable":true},"bban":{"pattern":"[a-zA-Z0-9]{1,30}","type":"string","description":"Basic Bank Account Number (BBAN) Identifier. This data element can be used in the\nbody of the consent request. Message for retrieving account access consent from\nthis account. This data elements is used for payment accounts which have no IBAN.\nISO20022: Basic Bank Account Number (BBAN). Identifier used nationally by financial\ninstitutions, i.e., in individual countries, generally as part of a National Account\nNumbering Scheme(s), which uniquely identifies the account of a customer.","nullable":true},"msisdn":{"maxLength":35,"type":"string","description":"Mobile phone number.","nullable":true},"currency":{"minLength":1,"pattern":"[A-Z]{3}","type":"string","description":"ISO 4217 Alpha 3 currency code."},"name":{"maxLength":70,"type":"string","description":"Name of the account, as assigned by the ASPSP, in agreement with the account owner in order to provide an additional means of identification of the account.","nullable":true},"displayName":{"maxLength":70,"type":"string","description":"Name of the account as defined by the PSU within online channels.","nullable":true},"product":{"maxLength":35,"type":"string","description":"Product name of the bank for this account, proprietary definition.","nullable":true},"cashAccountType":{"type":"string","description":"ExternalCashAccountType1Code from ISO 20022.","nullable":true},"status":{"$ref":"#/components/schemas/AccountStatus"},"bic":{"pattern":"[A-Z]{6,6}[A-Z2-9][A-NP-Z0-9]([A-Z0-9]{3,3}){0,1}","type":"string","description":"BICFI","nullable":true},"linkedAccounts":{"maxLength":70,"type":"string","description":"Case of a set of pending card transactions, the APSP will provide the relevant cash account the card is set up on.","nullable":true},"usage":{"$ref":"#/components/schemas/UsageEnum"},"details":{"maxLength":500,"type":"string","description":"Specifications that might be provided by the ASPSP:   - characteristics of the account   - characteristics of the relevant card","nullable":true},"balances":{"type":"array","items":{"$ref":"#/components/schemas/Balance"},"description":"A list of balances regarding this account, e.g. the current balance, the last booked balance.\nThe list might be restricted to the current balance.","nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"Links to the account, which can be directly used for retrieving account information from this dedicated account.\n            \nLinks to \"balances\" and/or \"transactions\"\n            \nThese links are only supported, when the corresponding consent has been already granted.","nullable":true},"ownerName":{"maxLength":140,"type":"string","description":"Name of the legal account owner.\nIf there is more than one owner, then e.g. two names might be noted here.\n            \nFor a corporate account, the corporate name is used for this attribute.\nEven if supported by the ASPSP, the provision of this field might depend on the fact\nwhether an explicit consent to this specific additional account information has been given by the PSU.","nullable":true},"creditLimit":{"$ref":"#/components/schemas/Amount"}},"additionalProperties":false,"description":"The ASPSP shall give at least one of the account reference identifiers:\n            \n* iban\n* bban\n* maskedPan\n* msisdn\n            \nIf the account is a multicurrency account currency code in \"currency\" is set to \"XXX\"."},"AccountStatus":{"enum":["enabled","deleted","blocked"],"type":"string","description":"Account status. The value is one of the following:   - \\\"enabled\\\": account is available   - \\\"deleted\\\": account is terminated   - \\\"blocked\\\": account is blocked e.g. for legal reasons If this field is not used, than the account is available in the sense of this specification."},"UsageEnum":{"enum":["PRIV","ORGA"],"type":"string","description":"Specifies the usage of the account:   * PRIV: private personal account   * ORGA: professional account"},"Balance":{"required":["balanceAmount","balanceType"],"type":"object","properties":{"balanceAmount":{"$ref":"#/components/schemas/Amount"},"balanceType":{"$ref":"#/components/schemas/BalanceType"},"creditLimitIncluded":{"type":"boolean","description":"A flag indicating if the credit limit of the corresponding account  is included in the calculation of the balance, where applicable.","nullable":true},"lastChangeDateTime":{"type":"string","description":"This data element might be used to indicate e.g. with the expected or booked balance that no action is known  on the account, which is not yet booked.","format":"date-time","nullable":true},"referenceDate":{"type":"string","description":"Indicates the date of the balance.","format":"date-time","nullable":true},"lastCommittedTransaction":{"maxLength":35,"type":"string","description":"\\\"entryReference\\\" of the last commited transaction to support the TPP in identifying whether all  PSU transactions are already known.","nullable":true}},"additionalProperties":false,"description":"A single balance element."},"Amount":{"required":["amount","currency"],"type":"object","properties":{"currency":{"minLength":1,"pattern":"[A-Z]{3}","type":"string","description":"ISO 4217 Alpha 3 currency code."},"amount":{"minLength":1,"pattern":"-?[0-9]{1,14}(\\.[0-9]{1,3})?","type":"string","description":"The amount given with fractional digits, where fractions must be compliant to the\ncurrency definition. Up to 14 significant figures. Negative amounts are signed by\nminus. The decimal separator is a dot.\n            \n**Example:** Valid representations for EUR with up to two decimals are:\n            \n* 1056\n* 5768.2\n* -1.50\n* 5877.78"}},"additionalProperties":false,"description":""},"BalanceType":{"enum":["closingBooked","expected","openingBooked","interimAvailable","interimBooked","forwardAvailable","nonInvoiced"],"type":"string","description":"The following balance types are defined:\n            \n* **closingBooked**: Balance of the account at the end of the pre-agreed account reporting period. It is the sum of the opening booked balance at the beginning of the period and all entries booked to the account during the pre-agreed account reporting period. For card-accounts, this is composed of invoiced, but not yet paid entries.\n* **expected**: Balance composed of booked entries and pending items known at the time of calculation, which projects the end of day balance if everything is booked on the account and no other entry is posted. For card accounts, this is composed of invoiced but not yet paid entries, not yet invoiced but already booked entries and pending items (not yet booked). For card-accounts: \"money to spend with the value of a pre-approved credit limit on the card account\".\n* **openingBooked**: Book balance of the account at the beginning of the account reporting period. It always equals the closing book balance from the previous report.\n* **interimAvailable**: Available balance calculated in the course of the account servicer's business day, at the time specified, and subject to further changes during the business day. The interim balance is calculated on the basis of booked credit and debit items during the calculation time/period specified. For card-accounts, this is composed of invoiced but not yet paid entries and not yet invoiced but already booked entries.\n* **interimBooked**: Balance calculated in the course of the account servicer's business day, at the time specified, and subject to further changes during the business day. The interim balance is calculated on the basis of booked credit and debit items during the calculation time/period specified.\n* **expectedBooked**: Balance composed of booked entries and pending items known at the time of calculation, which projects the end of day balance if everything is booked on the account and no other entry is posted. For card accounts, this is composed of not yet invoiced but already booked entries and pending items (not yet booked). For card-accounts: \"money to spend with the value of a pre-approved credit limit on the card account\".\n* **forwardAvailable**: Forward available balance of money that is at the disposal of the account owner on the date specified.\n* **nonInvoiced**: Only for card accounts, to be checked yet."},"HrefType":{"type":"object","properties":{"href":{"type":"string","nullable":true}},"additionalProperties":false,"description":"Link to a resource."},"Error400NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage400AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 400."},"TppMessage400AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode400AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"TppMessageCategory":{"enum":["ERROR","WARNING"],"type":"string","description":"Category of the TPP message category."},"MessageCode400AIS":{"enum":["FORMAT_ERROR","PARAMETER_NOT_CONSISTENT","PARAMETER_NOT_SUPPORTED","SERVICE_INVALID","RESOURCE_UNKNOWN","RESOURCE_EXPIRED","RESOURCE_BLOCKED","TIMESTAMP_INVALID","PERIOD_INVALID","SCA_METHOD_UNKNOWN","SCA_INVALID","CONSENT_UNKNOWN","SESSIONS_NOT_SUPPORTED"],"type":"string","description":"Message codes defined for AIS for HTTP Error code 400 (BAD_REQUEST)."},"Error401NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage401AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 401."},"TppMessage401AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode401AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"MessageCode401AIS":{"enum":["CERTIFICATE_INVALID","ROLE_INVALID","CERTIFICATE_EXPIRED","CERTIFICATE_BLOCKED","CERTIFICATE_REVOKE","CERTIFICATE_MISSING","SIGNATURE_INVALID","SIGNATURE_MISSING","CORPORATE_ID_INVALID","PSU_CREDENTIALS_INVALID","CONSENT_INVALID","CONSENT_EXPIRED","TOKEN_UNKNOWN","TOKEN_INVALID","TOKEN_EXPIRED"],"type":"string","description":"Message codes defined for AIS for HTTP Error code 401 (UNAUTHORIZED)."},"Error403NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage403AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 403."},"TppMessage403AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode403AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"MessageCode403AIS":{"enum":["CONSENT_UNKNOWN","SERVICE_BLOCKED","RESOURCE_UNKNOWN","RESOURCE_EXPIRED","ACCOUNT_INVALID_FOR_CONSENT"],"type":"string","description":"Message codes defined for AIS for HTTP Error code 403 (FORBIDDEN)."},"Error404NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage404AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 404."},"TppMessage404AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode404AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"MessageCode404AIS":{"enum":["RESOURCE_UNKNOWN"],"type":"string","description":"Message codes defined for AIS for HTTP Error code 404 (NOT FOUND)."},"Error405NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage405AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 401."},"TppMessage405AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode405AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"MessageCode405AIS":{"enum":["SERVICE_INVALID"],"type":"string","description":"Message codes defined for AIS for HTTP Error code 405 (METHOD NOT ALLOWED)."},"Error406NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage406AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 406."},"TppMessage406AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode406AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"MessageCode406AIS":{"enum":["REQUESTED_FORMATS_INVALID"],"type":"string","description":"Message codes defined for AIS for HTTP Error code 406 (NOT ACCEPTABLE)."},"Error409NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage409AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 409."},"TppMessage409AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode409AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"MessageCode409AIS":{"enum":["STATUS_INVALID"],"type":"string","description":"Message codes defined for AIS for HTTP Error code 409 (CONFLICT)."},"Error429NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage429AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 429."},"TppMessage429AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode429AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"MessageCode429AIS":{"enum":["ACCESS_EXCEEDED"],"type":"string","description":"Message codes for HTTP Error code 429 (TOO MANY REQUESTS)."}}},"paths":{"/api/v1/accounts/{account-id}":{"get":{"tags":["AccountInformationServiceApi"],"summary":"Read account details","description":"Reads details about an account, with balances where required. It is assumed that a consent of\nthe PSU to this access is already given and stored on the ASPSP system. The addressed details\nof this account depend then on the stored consent addressed by consentId, respectively the\nOAuth2 access token.\n            \n**NOTE:** The account-id can represent a multicurrency account. In this case the currency code\nis set to \\\"XXX\\\".\n            \nGives detailed information about the addressed account, together with balance information.","operationId":"ReadAccountDetails","parameters":[{"name":"account-id","in":"path","description":"This identification is denoting the addressed (card) account.  The account-id is retrieved by using a \\\"Read Account List\\\" or \\\"Read Card Account list\\\" call.  The account-id is the \\\"resourceId\\\" attribute of the account structure.  Its value is constant at least throughout the lifecycle of a given consent.","required":true,"schema":{"type":"string"}},{"name":"X-Request-ID","in":"header","description":"ID of the request, unique to the call, as determined by the initiating party.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Consent-ID","in":"header","description":"This data element may be contained, if the payment initiation transaction is part of a session, i.e. combined AIS/PIS service. This then contains the consentId of the related AIS consent, which was performed prior to this payment initiation.","required":true,"schema":{"type":"string"}},{"name":"withBalance","in":"query","description":"If contained, this function reads the list of accessible payment accounts including the booking balance,  if granted by the PSU in the related consent and available by the ASPSP.  This parameter might be ignored by the ASPSP.","schema":{"type":"boolean"}},{"name":"withCreditLimit","in":"query","description":"If contained, this function reads the list of accessible payment accounts including the credit limit, if granted by the PSU in the related consent and available by the ASPSP. This parameter might be ignored by the ASPSP.","schema":{"type":"boolean"}},{"name":"Digest","in":"header","description":"Is contained if and only if the \\\"Signature\\\" element is contained in the header of the request.","schema":{"type":"string"}},{"name":"Signature","in":"header","description":"A signature of the request by the TPP on application level. This might be mandated by ASPSP.","schema":{"type":"string"}},{"name":"TPP-Signature-Certificate","in":"header","description":"The certificate used for signing the request, in base64 encoding.  Must be contained if a signature is contained.","schema":{"type":"string"}},{"name":"PSU-IP-Address","in":"header","description":"The forwarded IP Address header field consists of the corresponding HTTP request  IP Address field between PSU and TPP.  It shall be contained if and only if this request was actively initiated by the PSU.","schema":{"type":"string"}},{"name":"PSU-IP-Port","in":"header","description":"The forwarded IP Port header field consists of the corresponding HTTP request IP Port field between PSU and TPP, if available.","schema":{"type":"string"}},{"name":"PSU-Accept","in":"header","description":"The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.","schema":{"type":"string"}},{"name":"PSU-Accept-Charset","in":"header","description":"The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.","schema":{"type":"string"}},{"name":"PSU-Accept-Encoding","in":"header","description":"The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.","schema":{"type":"string"}},{"name":"PSU-Accept-Language","in":"header","description":"Language that the SCA page will be presented in. Possible options are:\n            \n* \"is\" - Icelandic\n* \"en\" - English\n            \nIf parameter is empty, the default language will be English.","schema":{"type":"string"}},{"name":"PSU-User-Agent","in":"header","description":"The forwarded Agent header field of the HTTP request between PSU and TPP, if available.","schema":{"type":"string"}},{"name":"PSU-Http-Method","in":"header","description":"HTTP method used at the PSU → TPP interface, if available. Valid values: GET, POST, PUT, PATCH, DELETE.","schema":{"type":"string"}},{"name":"PSU-Device-ID","in":"header","description":"UUID (Universally Unique Identifier) for a device, which is used by the PSU, if available. UUID identifies either a device or a device dependant application installation. In case of an installation identification this ID needs to be unaltered until removal from device.","schema":{"type":"string","format":"uuid"}},{"name":"PSU-Geo-Location","in":"header","description":"The forwarded Geo Location of the corresponding http request between PSU and TPP if available.","schema":{"pattern":"GEO:-?[0-9]{1,2}\\.[0-9]{6};-?[0-9]{1,3}\\.[0-9]{6}","type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InlineResponse2003"}},"application/xml":{"schema":{"$ref":"#/components/schemas/InlineResponse2003"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error400NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error400NGAIS"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error401NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error401NGAIS"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error403NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error403NGAIS"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error404NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error404NGAIS"}}}},"405":{"description":"Method Not Allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error405NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error405NGAIS"}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error406NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error406NGAIS"}}}},"408":{"description":"Request Timeout"},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error409NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error409NGAIS"}}}},"415":{"description":"Unsupported Media Type"},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error429NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error429NGAIS"}}}},"500":{"description":"Internal Server Error"},"503":{"description":"Service Unavailable"}}}}}}
```

## Read balance

> Reads account data from a given account addressed by \\"account-id\\".\
> &#x20;           \
> \*\*Remark:\*\* This account-id can be a tokenised identification due to data protection reasons,\
> since the path information might be logged on intermediary servers within the ASPSP sphere.\
> This account-id can then be retrieved by the \\"Get account list\\" call. The account-id\
> is constant at least throughout the lifecycle of a given consent.

```json
{"openapi":"3.0.4","info":{"title":"IOBWS 3.0 Payments and accounts","version":"v1"},"tags":[{"name":"AccountInformationServiceApi","description":"Account Information Service (AIS) — access to account lists, details, balances and transactions."}],"servers":[{"url":"https://apigwsandbox.arionbanki.is/psd2","description":"PSD2 API Host - Sandbox"},{"url":"https://apigw.arionbanki.is/psd2","description":"PSD2 API Host - Production"}],"security":[{"Bearer":["ais:"],"SubscriptionKey":[]}],"components":{"securitySchemes":{"Bearer":{"type":"oauth2","description":"Send your Curity-issued opaque bearer token in the `Authorization: Bearer <token>` header. Required on every request.","flows":{"clientCredentials":{"tokenUrl":"https://curity.arionbanki.is/oauth/v2/oauth-token","scopes":{"ais:":"Account Information Service (AIS) access","pis:":"Payment Initiation Service (PIS) access"}}}}},"schemas":{"ReadAccountBalanceResponse200":{"required":["balances"],"type":"object","properties":{"account":{"$ref":"#/components/schemas/AccountReference"},"balances":{"type":"array","items":{"$ref":"#/components/schemas/Balance"},"description":"A list of balances regarding this account, e.g. the current balance, the last booked balance. The list might be restricted to the current balance."}},"additionalProperties":false,"description":"Body of the response for a successful read balance for an account request."},"AccountReference":{"type":"object","properties":{"iban":{"pattern":"[A-Z]{2,2}[0-9]{2,2}[a-zA-Z0-9]{1,30}","type":"string","description":"IBAN of an account.","nullable":true},"bban":{"pattern":"[a-zA-Z0-9]{1,30}","type":"string","description":"Basic Bank Account Number (BBAN) Identifier. This data element can be used in the\nbody of the consent request. Message for retrieving account access consent from\nthis account. This data elements is used for payment accounts which have no IBAN.\nISO20022: Basic Bank Account Number (BBAN). Identifier used nationally by financial\ninstitutions, i.e., in individual countries, generally as part of a National Account\nNumbering Scheme(s), which uniquely identifies the account of a customer.","nullable":true},"maskedPan":{"maxLength":35,"type":"string","description":"Masked Primary Account Number in the format 123456******1234. The first 6 and\nlast 4 digits of the card number are visible, with the middle digits masked\nusing asterisks (*).","nullable":true},"msisdn":{"maxLength":35,"type":"string","description":"Mobile phone number.","nullable":true},"currency":{"pattern":"[A-Z]{3}","type":"string","description":"ISO 4217 Alpha 3 currency code.","nullable":true},"cashAccountType":{"type":"string","description":"ExternalCashAccountType1Code from ISO 20022.","nullable":true}},"additionalProperties":false,"description":"Reference to an account by either:\n            \n* IBAN, of a payment accounts, or\n* BBAN, for payment accounts if there is no IBAN, or\n* the Masked Primary Account Number (maskedPan) of a card in the format 123456******1234, or\n* an alias to access a payment account via a registered mobile phone number (MSISDN)."},"Balance":{"required":["balanceAmount","balanceType"],"type":"object","properties":{"balanceAmount":{"$ref":"#/components/schemas/Amount"},"balanceType":{"$ref":"#/components/schemas/BalanceType"},"creditLimitIncluded":{"type":"boolean","description":"A flag indicating if the credit limit of the corresponding account  is included in the calculation of the balance, where applicable.","nullable":true},"lastChangeDateTime":{"type":"string","description":"This data element might be used to indicate e.g. with the expected or booked balance that no action is known  on the account, which is not yet booked.","format":"date-time","nullable":true},"referenceDate":{"type":"string","description":"Indicates the date of the balance.","format":"date-time","nullable":true},"lastCommittedTransaction":{"maxLength":35,"type":"string","description":"\\\"entryReference\\\" of the last commited transaction to support the TPP in identifying whether all  PSU transactions are already known.","nullable":true}},"additionalProperties":false,"description":"A single balance element."},"Amount":{"required":["amount","currency"],"type":"object","properties":{"currency":{"minLength":1,"pattern":"[A-Z]{3}","type":"string","description":"ISO 4217 Alpha 3 currency code."},"amount":{"minLength":1,"pattern":"-?[0-9]{1,14}(\\.[0-9]{1,3})?","type":"string","description":"The amount given with fractional digits, where fractions must be compliant to the\ncurrency definition. Up to 14 significant figures. Negative amounts are signed by\nminus. The decimal separator is a dot.\n            \n**Example:** Valid representations for EUR with up to two decimals are:\n            \n* 1056\n* 5768.2\n* -1.50\n* 5877.78"}},"additionalProperties":false,"description":""},"BalanceType":{"enum":["closingBooked","expected","openingBooked","interimAvailable","interimBooked","forwardAvailable","nonInvoiced"],"type":"string","description":"The following balance types are defined:\n            \n* **closingBooked**: Balance of the account at the end of the pre-agreed account reporting period. It is the sum of the opening booked balance at the beginning of the period and all entries booked to the account during the pre-agreed account reporting period. For card-accounts, this is composed of invoiced, but not yet paid entries.\n* **expected**: Balance composed of booked entries and pending items known at the time of calculation, which projects the end of day balance if everything is booked on the account and no other entry is posted. For card accounts, this is composed of invoiced but not yet paid entries, not yet invoiced but already booked entries and pending items (not yet booked). For card-accounts: \"money to spend with the value of a pre-approved credit limit on the card account\".\n* **openingBooked**: Book balance of the account at the beginning of the account reporting period. It always equals the closing book balance from the previous report.\n* **interimAvailable**: Available balance calculated in the course of the account servicer's business day, at the time specified, and subject to further changes during the business day. The interim balance is calculated on the basis of booked credit and debit items during the calculation time/period specified. For card-accounts, this is composed of invoiced but not yet paid entries and not yet invoiced but already booked entries.\n* **interimBooked**: Balance calculated in the course of the account servicer's business day, at the time specified, and subject to further changes during the business day. The interim balance is calculated on the basis of booked credit and debit items during the calculation time/period specified.\n* **expectedBooked**: Balance composed of booked entries and pending items known at the time of calculation, which projects the end of day balance if everything is booked on the account and no other entry is posted. For card accounts, this is composed of not yet invoiced but already booked entries and pending items (not yet booked). For card-accounts: \"money to spend with the value of a pre-approved credit limit on the card account\".\n* **forwardAvailable**: Forward available balance of money that is at the disposal of the account owner on the date specified.\n* **nonInvoiced**: Only for card accounts, to be checked yet."},"Error400NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage400AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 400."},"TppMessage400AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode400AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"TppMessageCategory":{"enum":["ERROR","WARNING"],"type":"string","description":"Category of the TPP message category."},"MessageCode400AIS":{"enum":["FORMAT_ERROR","PARAMETER_NOT_CONSISTENT","PARAMETER_NOT_SUPPORTED","SERVICE_INVALID","RESOURCE_UNKNOWN","RESOURCE_EXPIRED","RESOURCE_BLOCKED","TIMESTAMP_INVALID","PERIOD_INVALID","SCA_METHOD_UNKNOWN","SCA_INVALID","CONSENT_UNKNOWN","SESSIONS_NOT_SUPPORTED"],"type":"string","description":"Message codes defined for AIS for HTTP Error code 400 (BAD_REQUEST)."},"HrefType":{"type":"object","properties":{"href":{"type":"string","nullable":true}},"additionalProperties":false,"description":"Link to a resource."},"Error401NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage401AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 401."},"TppMessage401AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode401AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"MessageCode401AIS":{"enum":["CERTIFICATE_INVALID","ROLE_INVALID","CERTIFICATE_EXPIRED","CERTIFICATE_BLOCKED","CERTIFICATE_REVOKE","CERTIFICATE_MISSING","SIGNATURE_INVALID","SIGNATURE_MISSING","CORPORATE_ID_INVALID","PSU_CREDENTIALS_INVALID","CONSENT_INVALID","CONSENT_EXPIRED","TOKEN_UNKNOWN","TOKEN_INVALID","TOKEN_EXPIRED"],"type":"string","description":"Message codes defined for AIS for HTTP Error code 401 (UNAUTHORIZED)."},"Error403NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage403AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 403."},"TppMessage403AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode403AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"MessageCode403AIS":{"enum":["CONSENT_UNKNOWN","SERVICE_BLOCKED","RESOURCE_UNKNOWN","RESOURCE_EXPIRED","ACCOUNT_INVALID_FOR_CONSENT"],"type":"string","description":"Message codes defined for AIS for HTTP Error code 403 (FORBIDDEN)."},"Error404NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage404AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 404."},"TppMessage404AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode404AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"MessageCode404AIS":{"enum":["RESOURCE_UNKNOWN"],"type":"string","description":"Message codes defined for AIS for HTTP Error code 404 (NOT FOUND)."},"Error405NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage405AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 401."},"TppMessage405AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode405AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"MessageCode405AIS":{"enum":["SERVICE_INVALID"],"type":"string","description":"Message codes defined for AIS for HTTP Error code 405 (METHOD NOT ALLOWED)."},"Error406NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage406AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 406."},"TppMessage406AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode406AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"MessageCode406AIS":{"enum":["REQUESTED_FORMATS_INVALID"],"type":"string","description":"Message codes defined for AIS for HTTP Error code 406 (NOT ACCEPTABLE)."},"Error409NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage409AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 409."},"TppMessage409AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode409AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"MessageCode409AIS":{"enum":["STATUS_INVALID"],"type":"string","description":"Message codes defined for AIS for HTTP Error code 409 (CONFLICT)."},"Error429NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage429AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 429."},"TppMessage429AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode429AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"MessageCode429AIS":{"enum":["ACCESS_EXCEEDED"],"type":"string","description":"Message codes for HTTP Error code 429 (TOO MANY REQUESTS)."}}},"paths":{"/api/v1/accounts/{account-id}/balances":{"get":{"tags":["AccountInformationServiceApi"],"summary":"Read balance","description":"Reads account data from a given account addressed by \\\"account-id\\\".\n            \n**Remark:** This account-id can be a tokenised identification due to data protection reasons,\nsince the path information might be logged on intermediary servers within the ASPSP sphere.\nThis account-id can then be retrieved by the \\\"Get account list\\\" call. The account-id\nis constant at least throughout the lifecycle of a given consent.","operationId":"GetBalances","parameters":[{"name":"account-id","in":"path","description":"This identification is denoting the addressed (card) account.  The account-id is retrieved by using a \\\"Read Account List\\\" or \\\"Read Card Account list\\\" call.  The account-id is the \\\"resourceId\\\" attribute of the account structure.  Its value is constant at least throughout the lifecycle of a given consent.","required":true,"schema":{"type":"string"}},{"name":"X-Request-ID","in":"header","description":"ID of the request, unique to the call, as determined by the initiating party.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Consent-ID","in":"header","description":"This data element may be contained, if the payment initiation transaction is part of a session, i.e. combined AIS/PIS service. This then contains the consentId of the related AIS consent, which was performed prior to this payment initiation.","required":true,"schema":{"type":"string"}},{"name":"Digest","in":"header","description":"Is contained if and only if the \\\"Signature\\\" element is contained in the header of the request.","schema":{"type":"string"}},{"name":"Signature","in":"header","description":"A signature of the request by the TPP on application level. This might be mandated by ASPSP.","schema":{"type":"string"}},{"name":"TPP-Signature-Certificate","in":"header","description":"The certificate used for signing the request, in base64 encoding.  Must be contained if a signature is contained.","schema":{"type":"string"}},{"name":"PSU-IP-Address","in":"header","description":"The forwarded IP Address header field consists of the corresponding HTTP request  IP Address field between PSU and TPP.  It shall be contained if and only if this request was actively initiated by the PSU.","schema":{"type":"string"}},{"name":"PSU-IP-Port","in":"header","description":"The forwarded IP Port header field consists of the corresponding HTTP request IP Port field between PSU and TPP, if available.","schema":{"type":"string"}},{"name":"PSU-Accept","in":"header","description":"The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.","schema":{"type":"string"}},{"name":"PSU-Accept-Charset","in":"header","description":"The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.","schema":{"type":"string"}},{"name":"PSU-Accept-Encoding","in":"header","description":"The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.","schema":{"type":"string"}},{"name":"PSU-Accept-Language","in":"header","description":"Language that the SCA page will be presented in. Possible options are:\n            \n* \"is\" - Icelandic\n* \"en\" - English\n            \nIf parameter is empty, the default language will be English.","schema":{"type":"string"}},{"name":"PSU-User-Agent","in":"header","description":"The forwarded Agent header field of the HTTP request between PSU and TPP, if available.","schema":{"type":"string"}},{"name":"PSU-Http-Method","in":"header","description":"HTTP method used at the PSU → TPP interface, if available. Valid values: GET, POST, PUT, PATCH, DELETE.","schema":{"type":"string"}},{"name":"PSU-Device-ID","in":"header","description":"UUID (Universally Unique Identifier) for a device, which is used by the PSU, if available. UUID identifies either a device or a device dependant application installation. In case of an installation identification this ID needs to be unaltered until removal from device.","schema":{"type":"string","format":"uuid"}},{"name":"PSU-Geo-Location","in":"header","description":"The forwarded Geo Location of the corresponding http request between PSU and TPP if available.","schema":{"pattern":"GEO:-?[0-9]{1,2}\\.[0-9]{6};-?[0-9]{1,3}\\.[0-9]{6}","type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadAccountBalanceResponse200"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ReadAccountBalanceResponse200"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error400NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error400NGAIS"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error401NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error401NGAIS"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error403NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error403NGAIS"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error404NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error404NGAIS"}}}},"405":{"description":"Method Not Allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error405NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error405NGAIS"}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error406NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error406NGAIS"}}}},"408":{"description":"Request Timeout"},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error409NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error409NGAIS"}}}},"415":{"description":"Unsupported Media Type"},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error429NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error429NGAIS"}}}},"500":{"description":"Internal Server Error"},"503":{"description":"Service Unavailable"}}}}}}
```

## Read transaction list of an account

> Read transaction reports or transaction lists of a given account addressed by\
> \\"account-id\\", depending on the steering parameter \\"bookingStatus\\", together\
> with balances. \
> \
> For a given account, additional parameters are e.g. the attributes\
> \\"dateFrom\\" and \\"dateTo\\". The ASPSP might \
> add balance information, if transaction lists without balances are not supported.

```json
{"openapi":"3.0.4","info":{"title":"IOBWS 3.0 Payments and accounts","version":"v1"},"tags":[{"name":"AccountInformationServiceApi","description":"Account Information Service (AIS) — access to account lists, details, balances and transactions."}],"servers":[{"url":"https://apigwsandbox.arionbanki.is/psd2","description":"PSD2 API Host - Sandbox"},{"url":"https://apigw.arionbanki.is/psd2","description":"PSD2 API Host - Production"}],"security":[{"Bearer":["ais:"],"SubscriptionKey":[]}],"components":{"securitySchemes":{"Bearer":{"type":"oauth2","description":"Send your Curity-issued opaque bearer token in the `Authorization: Bearer <token>` header. Required on every request.","flows":{"clientCredentials":{"tokenUrl":"https://curity.arionbanki.is/oauth/v2/oauth-token","scopes":{"ais:":"Account Information Service (AIS) access","pis:":"Payment Initiation Service (PIS) access"}}}}},"schemas":{"TransactionsResponse200Json":{"type":"object","properties":{"account":{"$ref":"#/components/schemas/AccountReference"},"transactions":{"$ref":"#/components/schemas/AccountReport"},"balances":{"type":"array","items":{"$ref":"#/components/schemas/Balance"},"description":"A list of balances regarding this account, e.g. the current balance, the last booked balance. The list might be restricted to the current balance.","nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A list of hyperlinks to be recognised by the TPP.  Type of links admitted in this response:   - \\\"download\\\": a link to a resource, where the transaction report might be downloaded from in    case where transaction reports have a huge size.  Remark: This feature shall only be used where camt-data is requested which has a huge size.","nullable":true}},"additionalProperties":false,"description":"Body of the JSON response for a successful read transaction list request. This account report contains transactions resulting from the query parameters."},"AccountReference":{"type":"object","properties":{"iban":{"pattern":"[A-Z]{2,2}[0-9]{2,2}[a-zA-Z0-9]{1,30}","type":"string","description":"IBAN of an account.","nullable":true},"bban":{"pattern":"[a-zA-Z0-9]{1,30}","type":"string","description":"Basic Bank Account Number (BBAN) Identifier. This data element can be used in the\nbody of the consent request. Message for retrieving account access consent from\nthis account. This data elements is used for payment accounts which have no IBAN.\nISO20022: Basic Bank Account Number (BBAN). Identifier used nationally by financial\ninstitutions, i.e., in individual countries, generally as part of a National Account\nNumbering Scheme(s), which uniquely identifies the account of a customer.","nullable":true},"maskedPan":{"maxLength":35,"type":"string","description":"Masked Primary Account Number in the format 123456******1234. The first 6 and\nlast 4 digits of the card number are visible, with the middle digits masked\nusing asterisks (*).","nullable":true},"msisdn":{"maxLength":35,"type":"string","description":"Mobile phone number.","nullable":true},"currency":{"pattern":"[A-Z]{3}","type":"string","description":"ISO 4217 Alpha 3 currency code.","nullable":true},"cashAccountType":{"type":"string","description":"ExternalCashAccountType1Code from ISO 20022.","nullable":true}},"additionalProperties":false,"description":"Reference to an account by either:\n            \n* IBAN, of a payment accounts, or\n* BBAN, for payment accounts if there is no IBAN, or\n* the Masked Primary Account Number (maskedPan) of a card in the format 123456******1234, or\n* an alias to access a payment account via a registered mobile phone number (MSISDN)."},"AccountReport":{"required":["_links"],"type":"object","properties":{"booked":{"type":"array","items":{"$ref":"#/components/schemas/Transactions"},"description":"Shall be contained if bookingStatus parameter is set to \"booked\" or \"both\".","nullable":true},"pending":{"type":"array","items":{"$ref":"#/components/schemas/Transactions"},"description":"Not contained if the bookingStatus parameter is set to \"booked\" or \"information\".","nullable":true},"information":{"type":"array","items":{"$ref":"#/components/schemas/Transactions"},"description":"Only contained if the bookingStatus is set to \"information\" and if supported by ASPSP.","nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":""}},"additionalProperties":false,"description":"JSON based account report. This account report contains transactions resulting from the query parameters.\n            \n* 'booked' shall be contained if bookingStatus parameter is set to \"booked\" or \"both\".\n* 'pending' is not contained if the bookingStatus parameter is set to \"booked\" or \"information\".\n* 'information' Only contained if the bookingStatus is set to \"information\" and if supported by ASPSP."},"Transactions":{"required":["transactionAmount"],"type":"object","properties":{"transactionId":{"type":"string","description":"This identification is given by the attribute transactionId of the corresponding entry of a transaction list.","nullable":true},"entryReference":{"maxLength":35,"type":"string","description":"Is the identification of the transaction as used e.g. for reference for deltafunction on application level.\nThe same identification as for example used within camt.05x messages.","nullable":true},"endToEndId":{"maxLength":35,"type":"string","description":"Unique end to end identity.","nullable":true},"batchIndicator":{"type":"boolean","description":"If this indicator equals true, then the related entry is a batch entry.","nullable":true},"batchNumberOfTransactions":{"type":"integer","description":"Shall be used if and only if the batchIndicator is contained and equals true.","format":"int32","nullable":true},"mandateId":{"maxLength":35,"type":"string","description":"Identification of Mandates, e.g. a SEPA Mandate ID.","nullable":true},"checkId":{"maxLength":35,"type":"string","description":"Identification of a Cheque.","nullable":true},"creditorId":{"maxLength":35,"type":"string","description":"Identification of Creditors, e.g. a SEPA Creditor ID.","nullable":true},"bookingDate":{"type":"string","description":"The date when an entry is posted to an account on the ASPSPs books.","format":"date-time","nullable":true},"valueDate":{"type":"string","description":"The Date at which assets become available to the account owner in case of a credit.","format":"date-time","nullable":true},"transactionAmount":{"$ref":"#/components/schemas/Amount"},"currencyExchange":{"type":"array","items":{"$ref":"#/components/schemas/ReportExchangeRate"},"description":"Array of exchange rates.","nullable":true},"creditorName":{"maxLength":70,"type":"string","description":"Creditor name.","nullable":true},"creditorAccount":{"$ref":"#/components/schemas/AccountReference"},"creditorAgent":{"pattern":"[A-Z]{6,6}[A-Z2-9][A-NP-Z0-9]([A-Z0-9]{3,3}){0,1}","type":"string","description":"BICFI","nullable":true},"ultimateCreditor":{"maxLength":70,"type":"string","description":"Ultimate creditor.","nullable":true},"debtorName":{"maxLength":70,"type":"string","description":"Debtor name.","nullable":true},"debtorAccount":{"$ref":"#/components/schemas/AccountReference"},"debtorAgent":{"pattern":"[A-Z]{6,6}[A-Z2-9][A-NP-Z0-9]([A-Z0-9]{3,3}){0,1}","type":"string","description":"BICFI","nullable":true},"ultimateDebtor":{"maxLength":70,"type":"string","description":"Ultimate debtor.","nullable":true},"remittanceInformationUnstructured":{"maxLength":140,"type":"string","description":"Unstructured remittance information.","nullable":true},"remittanceInformationUnstructuredArray":{"type":"array","items":{"type":"string"},"description":"Array of unstructured remittance information.","nullable":true},"remittanceInformationStructured":{"maxLength":140,"type":"string","description":"Structured remittance information.","nullable":true},"remittanceInformationStructuredArray":{"type":"array","items":{"$ref":"#/components/schemas/RemittanceInformationStructured"},"description":"Array of structured remittance information.","nullable":true},"entryDetails":{"type":"array","items":{"$ref":"#/components/schemas/EntryDetailsElement"},"description":"Might be used by the ASPSP to transport details about transactions within a batch.","nullable":true},"additionalInformation":{"maxLength":500,"type":"string","description":"Might be used by the ASPSP to transport additional transaction related information to the PSU.","nullable":true},"additionalInformationStructured":{"$ref":"#/components/schemas/AdditionalInformationStructured"},"purposeCode":{"$ref":"#/components/schemas/PurposeCode"},"bankTransactionCode":{"type":"string","description":"Bank transaction code as used by the ASPSP and using the sub elements of this structured code defined by ISO 20022.\nThis code type is concatenating the three ISO20022 Codes Domain Code, Family Code, and SubFamily Code by hyphens,\nresulting in 'DomainCode'-'FamilyCode'-'SubFamilyCode'.","nullable":true},"proprietaryBankTransactionCode":{"maxLength":35,"type":"string","description":"Proprietary bank transaction code as used within a community or within an ASPSP e.g. for MT94x based transaction reports.","nullable":true},"balanceAfterTransaction":{"$ref":"#/components/schemas/Balance"},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"","nullable":true},"transactionTimestamp":{"type":"string","description":"Execution datetime of the record","format":"date-time","nullable":true},"ultimateCreditorId":{"maxLength":35,"type":"string","description":"Ultimate Creditor Id.","nullable":true},"debtorId":{"maxLength":35,"type":"string","description":"Debtor Id.","nullable":true},"ultimateDebtorId":{"maxLength":35,"type":"string","description":"Ultimate Debtor Id.","nullable":true},"icelandicPurpose":{"$ref":"#/components/schemas/IcelandicPurpose"}},"additionalProperties":false,"description":"Transaction details."},"Amount":{"required":["amount","currency"],"type":"object","properties":{"currency":{"minLength":1,"pattern":"[A-Z]{3}","type":"string","description":"ISO 4217 Alpha 3 currency code."},"amount":{"minLength":1,"pattern":"-?[0-9]{1,14}(\\.[0-9]{1,3})?","type":"string","description":"The amount given with fractional digits, where fractions must be compliant to the\ncurrency definition. Up to 14 significant figures. Negative amounts are signed by\nminus. The decimal separator is a dot.\n            \n**Example:** Valid representations for EUR with up to two decimals are:\n            \n* 1056\n* 5768.2\n* -1.50\n* 5877.78"}},"additionalProperties":false,"description":""},"ReportExchangeRate":{"required":["exchangeRate","quotationDate","sourceCurrency","targetCurrency","unitCurrency"],"type":"object","properties":{"sourceCurrency":{"minLength":1,"pattern":"[A-Z]{3}","type":"string","description":"ISO 4217 Alpha 3 currency code."},"exchangeRate":{"minLength":1,"type":"string"},"unitCurrency":{"minLength":1,"type":"string"},"targetCurrency":{"minLength":1,"pattern":"[A-Z]{3}","type":"string","description":"ISO 4217 Alpha 3 currency code."},"quotationDate":{"type":"string","format":"date-time"},"contractIdentification":{"type":"string","nullable":true}},"additionalProperties":false,"description":"Exchange Rate."},"RemittanceInformationStructured":{"required":["reference"],"type":"object","properties":{"reference":{"maxLength":35,"minLength":1,"type":"string"},"referenceType":{"maxLength":35,"type":"string","nullable":true},"referenceIssuer":{"maxLength":35,"type":"string","nullable":true}},"additionalProperties":false,"description":"Structured remittance information."},"EntryDetailsElement":{"required":["transactionAmount"],"type":"object","properties":{"endToEndId":{"maxLength":35,"type":"string","description":"Unique end to end identity.","nullable":true},"mandateId":{"maxLength":35,"type":"string","description":"Identification of Mandates, e.g. a SEPA Mandate ID.","nullable":true},"checkId":{"maxLength":35,"type":"string","description":"Identification of a Cheque.","nullable":true},"creditorId":{"maxLength":35,"type":"string","description":"Identification of Creditors, e.g. a SEPA Creditor ID.","nullable":true},"transactionAmount":{"$ref":"#/components/schemas/Amount"},"currencyExchange":{"type":"array","items":{"$ref":"#/components/schemas/ReportExchangeRate"},"description":"Array of exchange rates.","nullable":true},"creditorName":{"maxLength":70,"type":"string","description":"Creditor name.","nullable":true},"creditorAccount":{"$ref":"#/components/schemas/AccountReference"},"creditorAgent":{"pattern":"[A-Z]{6,6}[A-Z2-9][A-NP-Z0-9]([A-Z0-9]{3,3}){0,1}","type":"string","description":"BICFI","nullable":true},"ultimateCreditor":{"maxLength":70,"type":"string","description":"Ultimate creditor.","nullable":true},"debtorName":{"maxLength":70,"type":"string","description":"Debtor name.","nullable":true},"debtorAccount":{"$ref":"#/components/schemas/AccountReference"},"debtorAgent":{"pattern":"[A-Z]{6,6}[A-Z2-9][A-NP-Z0-9]([A-Z0-9]{3,3}){0,1}","type":"string","description":"BICFI","nullable":true},"ultimateDebtor":{"maxLength":70,"type":"string","description":"Ultimate debtor.","nullable":true},"remittanceInformationUnstructured":{"maxLength":140,"type":"string","description":"Unstructured remittance information.","nullable":true},"remittanceInformationUnstructuredArray":{"type":"array","items":{"type":"string"},"description":"Array of unstructured remittance information.","nullable":true},"remittanceInformationStructured":{"$ref":"#/components/schemas/RemittanceInformationStructured"},"remittanceInformationStructuredArray":{"type":"array","items":{"$ref":"#/components/schemas/RemittanceInformationStructured"},"description":"Array of structured remittance information.","nullable":true},"purposeCode":{"$ref":"#/components/schemas/PurposeCode"}},"additionalProperties":false,"description":""},"PurposeCode":{"enum":["BKDF","BKFE","BKFM","BKIP","BKPP","CBLK","CDCB","CDCD","CDCS","CDDP","CDOC","CDQC","ETUP","FCOL","MTUP","ACCT","CASH","COLL","CSDB","DEPT","INTC","LIMA","NETT","BFWD","CCIR","CCPC","CCPM","CCSM","CRDS","CRPR","CRSP","CRTL","EQPT","EQUS","EXPT","EXTD","FIXI","FWBC","FWCC","FWSB","FWSC","MARG","MBSB","MBSC","MGCC","MGSC","OCCC","OPBC","OPCC","OPSB","OPSC","OPTN","OTCD","REPO","RPBC","RPCC","RPSB","RPSC","RVPO","SBSC","SCIE","SCIR","SCRP","SHBC","SHCC","SHSL","SLEB","SLOA","SWBC","SWCC","SWPT","SWSB","SWSC","TBAS","TBBC","TBCC","TRCP","AGRT","AREN","BEXP","BOCE","COMC","CPYR","GDDS","GDSV","GSCB","LICF","MP2B","POPE","ROYA","SCVE","SERV","SUBS","SUPP","TRAD","CHAR","COMT","MP2P","ECPG","ECPR","ECPU","EPAY","CLPR","COMP","DBTC","GOVI","HLRP","HLST","INPC","INPR","INSC","INSU","INTE","LBRI","LIFI","LOAN","LOAR","PENO","PPTI","RELG","RINP","TRFD","FORW","FXNT","ADMG","ADVA","BCDM","BCFG","BLDM","BNET","CBFF","CBFR","CCRD","CDBL","CFEE","CGDD","CORT","COST","CPKC","DCRD","DSMT","DVPM","EDUC","FACT","FAND","FCPM","FEES","GOVT","ICCP","IDCP","IHRP","INSM","IVPT","MCDM","MCFG","MSVC","NOWS","OCDM","OCFG","OFEE","OTHR","PADD","PTSP","RCKE","RCPT","REBT","REFU","RENT","REOD","RIMB","RPNT","RRBN","RVPM","SLPI","SPLT","STDY","TBAN","TBIL","TCSC","TELI","TMPG","TPRI","TPRP","TRNC","TRVC","WEBI","ANNI","CAFI","CFDI","CMDT","DERI","DIVD","FREX","HEDG","INVS","PRME","SAVG","SECU","SEPI","TREA","UNIT","FNET","FUTR","ANTS","CVCF","DMEQ","DNTS","HLTC","HLTI","HSPC","ICRF","LTCF","MAFC","MARF","MDCS","VIEW","CDEP","SWFP","SWPP","SWRS","SWUF","ADCS","AEMP","ALLW","ALMY","BBSC","BECH","BENE","BONU","CCHD","COMM","CSLP","GFRP","GVEA","GVEB","GVEC","GVED","GWLT","HREC","PAYR","PEFC","PENS","PRCP","RHBS","SALA","SSBE","LBIN","LCOL","LFEE","LMEQ","LMFI","LMRK","LREB","LREV","LSFL","ESTX","FWLV","GSTX","HSTX","INTX","NITX","PTXP","RDTX","TAXS","VATX","WHLD","TAXR","B112","BR12","TLRF","TLRR","AIRB","BUSB","FERB","RLWY","TRPT","CBTV","ELEC","ENRG","GASB","NWCH","NWCM","OTLC","PHON","UBIL","WTER"],"type":"string","description":"ExternalPurpose1Code from ISO 20022.  Values from ISO 20022 External Code List ExternalCodeSets_1Q2018 June 2018."},"AdditionalInformationStructured":{"required":["standingOrderDetails"],"type":"object","properties":{"standingOrderDetails":{"$ref":"#/components/schemas/StandingOrderDetails"}},"additionalProperties":false,"description":"Is used if and only if the bookingStatus entry equals \"information\". Every active standing order related to the dedicated payment account result into one entry."},"StandingOrderDetails":{"required":["frequency","startDate"],"type":"object","properties":{"startDate":{"type":"string","format":"date-time"},"frequency":{"$ref":"#/components/schemas/FrequencyCode"},"endDate":{"type":"string","format":"date-time","nullable":true},"executionRule":{"$ref":"#/components/schemas/ExecutionRule"},"withinAMonthFlag":{"type":"boolean","description":"This element is only used in case of frequency equals \\\"Monthly\\\".  If this element equals false it has no effect. If this element equals true, then the execution rule is overruled if the day of execution would fall into a different month using the execution rule.  Example: executionRule equals \\\"preceding\\\", dayOfExecution equals \\\"02\\\" and the second of a month is a Sunday.  In this case, the transaction date would be on the last day of the month before.  This would be overruled if withinAMonthFlag equals true and the payment is processed on Monday the third of the Month. Remark: This attribute is rarely supported in the market.","nullable":true},"monthsOfExecution":{"type":"array","items":{"type":"string"},"description":"The format is following the regular expression \\\\d{1,2}.  The array is restricted to 11 entries.  The values contained in the array entries shall all be different and the maximum value of one entry is 12. This attribute is contained if and only if the frequency equals \\\"MonthlyVariable\\\". Example: An execution on January, April and October each year is addressed by [\\\"1\\\", \\\"4\\\", \\\"10\\\"].","nullable":true},"multiplicator":{"type":"integer","description":"This is multiplying the given frequency resulting the exact frequency, e.g. Frequency=weekly and multiplicator=3 means every 3 weeks. Remark: This attribute is rarely supported in the market.","format":"int32","nullable":true},"dayOfExecution":{"$ref":"#/components/schemas/DayOfExecution"},"limitAmount":{"$ref":"#/components/schemas/Amount"}},"additionalProperties":false,"description":"Details of underlying standing orders."},"FrequencyCode":{"enum":["Daily","Weekly","EveryTwoWeeks","Monthly","EveryTwoMonths","Quarterly","SemiAnnual","Annual"],"type":"string","description":"The following codes from the \\\"EventFrequency7Code\\\" of ISO 20022 are supported: - \\\"Daily\\\" - \\\"Weekly\\\" - \\\"EveryTwoWeeks\\\" - \\\"Monthly\\\" - \\\"EveryTwoMonths\\\" - \\\"Quarterly\\\" - \\\"SemiAnnual\\\" - \\\"Annual\\\""},"ExecutionRule":{"enum":["following","preceding"],"type":"string","description":"\\\"following\\\" or \\\"preceding\\\" supported as values.  This data attribute defines the behaviour when recurring payment dates falls on a weekend or bank holiday.  The payment is then executed either the \\\"preceding\\\" or \\\"following\\\" working day. ASPSP might reject the request due to the communicated value, if rules in Online-Banking are not supporting  this execution rule."},"DayOfExecution":{"enum":["1","2","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30","31"],"type":"string","description":"Day of execution as string.  This string consists of up two characters. Leading zeroes are not allowed.  31 is ultimo of the month."},"Balance":{"required":["balanceAmount","balanceType"],"type":"object","properties":{"balanceAmount":{"$ref":"#/components/schemas/Amount"},"balanceType":{"$ref":"#/components/schemas/BalanceType"},"creditLimitIncluded":{"type":"boolean","description":"A flag indicating if the credit limit of the corresponding account  is included in the calculation of the balance, where applicable.","nullable":true},"lastChangeDateTime":{"type":"string","description":"This data element might be used to indicate e.g. with the expected or booked balance that no action is known  on the account, which is not yet booked.","format":"date-time","nullable":true},"referenceDate":{"type":"string","description":"Indicates the date of the balance.","format":"date-time","nullable":true},"lastCommittedTransaction":{"maxLength":35,"type":"string","description":"\\\"entryReference\\\" of the last commited transaction to support the TPP in identifying whether all  PSU transactions are already known.","nullable":true}},"additionalProperties":false,"description":"A single balance element."},"BalanceType":{"enum":["closingBooked","expected","openingBooked","interimAvailable","interimBooked","forwardAvailable","nonInvoiced"],"type":"string","description":"The following balance types are defined:\n            \n* **closingBooked**: Balance of the account at the end of the pre-agreed account reporting period. It is the sum of the opening booked balance at the beginning of the period and all entries booked to the account during the pre-agreed account reporting period. For card-accounts, this is composed of invoiced, but not yet paid entries.\n* **expected**: Balance composed of booked entries and pending items known at the time of calculation, which projects the end of day balance if everything is booked on the account and no other entry is posted. For card accounts, this is composed of invoiced but not yet paid entries, not yet invoiced but already booked entries and pending items (not yet booked). For card-accounts: \"money to spend with the value of a pre-approved credit limit on the card account\".\n* **openingBooked**: Book balance of the account at the beginning of the account reporting period. It always equals the closing book balance from the previous report.\n* **interimAvailable**: Available balance calculated in the course of the account servicer's business day, at the time specified, and subject to further changes during the business day. The interim balance is calculated on the basis of booked credit and debit items during the calculation time/period specified. For card-accounts, this is composed of invoiced but not yet paid entries and not yet invoiced but already booked entries.\n* **interimBooked**: Balance calculated in the course of the account servicer's business day, at the time specified, and subject to further changes during the business day. The interim balance is calculated on the basis of booked credit and debit items during the calculation time/period specified.\n* **expectedBooked**: Balance composed of booked entries and pending items known at the time of calculation, which projects the end of day balance if everything is booked on the account and no other entry is posted. For card accounts, this is composed of not yet invoiced but already booked entries and pending items (not yet booked). For card-accounts: \"money to spend with the value of a pre-approved credit limit on the card account\".\n* **forwardAvailable**: Forward available balance of money that is at the disposal of the account owner on the date specified.\n* **nonInvoiced**: Only for card accounts, to be checked yet."},"HrefType":{"type":"object","properties":{"href":{"type":"string","nullable":true}},"additionalProperties":false,"description":"Link to a resource."},"IcelandicPurpose":{"type":"object","properties":{"code":{"maxLength":2,"type":"string","nullable":true},"description":{"maxLength":150,"type":"string","nullable":true}},"additionalProperties":false,"description":"Standardised definition of icelandic purpose code and description used in transactions"},"Error400NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage400AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 400."},"TppMessage400AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode400AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"TppMessageCategory":{"enum":["ERROR","WARNING"],"type":"string","description":"Category of the TPP message category."},"MessageCode400AIS":{"enum":["FORMAT_ERROR","PARAMETER_NOT_CONSISTENT","PARAMETER_NOT_SUPPORTED","SERVICE_INVALID","RESOURCE_UNKNOWN","RESOURCE_EXPIRED","RESOURCE_BLOCKED","TIMESTAMP_INVALID","PERIOD_INVALID","SCA_METHOD_UNKNOWN","SCA_INVALID","CONSENT_UNKNOWN","SESSIONS_NOT_SUPPORTED"],"type":"string","description":"Message codes defined for AIS for HTTP Error code 400 (BAD_REQUEST)."},"Error401NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage401AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 401."},"TppMessage401AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode401AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"MessageCode401AIS":{"enum":["CERTIFICATE_INVALID","ROLE_INVALID","CERTIFICATE_EXPIRED","CERTIFICATE_BLOCKED","CERTIFICATE_REVOKE","CERTIFICATE_MISSING","SIGNATURE_INVALID","SIGNATURE_MISSING","CORPORATE_ID_INVALID","PSU_CREDENTIALS_INVALID","CONSENT_INVALID","CONSENT_EXPIRED","TOKEN_UNKNOWN","TOKEN_INVALID","TOKEN_EXPIRED"],"type":"string","description":"Message codes defined for AIS for HTTP Error code 401 (UNAUTHORIZED)."},"Error403NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage403AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 403."},"TppMessage403AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode403AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"MessageCode403AIS":{"enum":["CONSENT_UNKNOWN","SERVICE_BLOCKED","RESOURCE_UNKNOWN","RESOURCE_EXPIRED","ACCOUNT_INVALID_FOR_CONSENT"],"type":"string","description":"Message codes defined for AIS for HTTP Error code 403 (FORBIDDEN)."},"Error404NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage404AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 404."},"TppMessage404AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode404AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"MessageCode404AIS":{"enum":["RESOURCE_UNKNOWN"],"type":"string","description":"Message codes defined for AIS for HTTP Error code 404 (NOT FOUND)."},"Error405NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage405AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 401."},"TppMessage405AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode405AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"MessageCode405AIS":{"enum":["SERVICE_INVALID"],"type":"string","description":"Message codes defined for AIS for HTTP Error code 405 (METHOD NOT ALLOWED)."},"Error406NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage406AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 406."},"TppMessage406AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode406AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"MessageCode406AIS":{"enum":["REQUESTED_FORMATS_INVALID"],"type":"string","description":"Message codes defined for AIS for HTTP Error code 406 (NOT ACCEPTABLE)."},"Error409NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage409AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 409."},"TppMessage409AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode409AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"MessageCode409AIS":{"enum":["STATUS_INVALID"],"type":"string","description":"Message codes defined for AIS for HTTP Error code 409 (CONFLICT)."},"Error429NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage429AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 429."},"TppMessage429AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode429AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"MessageCode429AIS":{"enum":["ACCESS_EXCEEDED"],"type":"string","description":"Message codes for HTTP Error code 429 (TOO MANY REQUESTS)."}}},"paths":{"/api/v1/accounts/{account-id}/transactions":{"get":{"tags":["AccountInformationServiceApi"],"summary":"Read transaction list of an account","description":"Read transaction reports or transaction lists of a given account addressed by\n\\\"account-id\\\", depending on the steering parameter \\\"bookingStatus\\\", together\nwith balances. \n\nFor a given account, additional parameters are e.g. the attributes\n\\\"dateFrom\\\" and \\\"dateTo\\\". The ASPSP might \nadd balance information, if transaction lists without balances are not supported.","operationId":"GetTransactionList","parameters":[{"name":"account-id","in":"path","description":"This identification is denoting the addressed (card) account.  The account-id is retrieved by using a \\\"Read Account List\\\" or \\\"Read Card Account list\\\" call.  The account-id is the \\\"resourceId\\\" attribute of the account structure.  Its value is constant at least throughout the lifecycle of a given consent.","required":true,"schema":{"type":"string"}},{"name":"bookingStatus","in":"query","description":"Permitted codes are    * \\\"information\\\",   * \\\"booked\\\",   * \\\"pending\\\", and    * \\\"both\\\" \\\"booked\\\" shall be supported by the ASPSP. To support the \\\"pending\\\" and \\\"both\\\" feature is optional for the ASPSP,  Error code if not supported in the online banking frontend","required":true,"schema":{"type":"string"}},{"name":"X-Request-ID","in":"header","description":"ID of the request, unique to the call, as determined by the initiating party.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Consent-ID","in":"header","description":"This data element may be contained, if the payment initiation transaction is part of a session, i.e. combined AIS/PIS service. This then contains the consentId of the related AIS consent, which was performed prior to this payment initiation.","required":true,"schema":{"type":"string"}},{"name":"dateFrom","in":"query","description":"Conditional: Starting date (inclusive the date dateFrom) of the transaction list, mandated if no delta access is required and if bookingStatus does not equal \\\"information\\\".  For booked transactions, the relevant date is the booking date.   For pending transactions, the relevant date is the entry date, which may not be transparent  neither in this API nor other channels of the ASPSP.","schema":{"type":"string","format":"date-time"}},{"name":"dateTo","in":"query","description":"End date (inclusive the data dateTo) of the transaction list, default is \\\"now\\\" if not given.   Might be ignored if a delta function is used.  For booked transactions, the relevant date is the booking date.   For pending transactions, the relevant date is the entry date, which may not be transparent  neither in this API nor other channels of the ASPSP.","schema":{"type":"string","format":"date-time"}},{"name":"entryReferenceFrom","in":"query","description":"This data attribute is indicating that the AISP is in favour to get all transactions after  the transaction with identification entryReferenceFrom alternatively to the above defined period.  This is a implementation of a delta access.  If this data element is contained, the entries \\\"dateFrom\\\" and \\\"dateTo\\\" might be ignored by the ASPSP  if a delta report is supported.  Optional if supported by API provider.","schema":{"type":"string"}},{"name":"deltaList","in":"query","description":"This data attribute is indicating that the AISP is in favour to get all transactions after the last report access for this PSU on the addressed account. This is another implementation of a delta access-report. This delta indicator might be rejected by the ASPSP if this function is not supported. Optional if supported by API provider","schema":{"type":"boolean"}},{"name":"withBalance","in":"query","description":"If contained, this function reads the list of accessible payment accounts including the booking balance,  if granted by the PSU in the related consent and available by the ASPSP.  This parameter might be ignored by the ASPSP.","schema":{"type":"boolean"}},{"name":"pageNumber","in":"query","description":"","schema":{"type":"integer","format":"int32"}},{"name":"Digest","in":"header","description":"Is contained if and only if the \\\"Signature\\\" element is contained in the header of the request.","schema":{"type":"string"}},{"name":"Signature","in":"header","description":"A signature of the request by the TPP on application level. This might be mandated by ASPSP.","schema":{"type":"string"}},{"name":"TPP-Signature-Certificate","in":"header","description":"The certificate used for signing the request, in base64 encoding.  Must be contained if a signature is contained.","schema":{"type":"string"}},{"name":"PSU-IP-Address","in":"header","description":"The forwarded IP Address header field consists of the corresponding HTTP request  IP Address field between PSU and TPP.  It shall be contained if and only if this request was actively initiated by the PSU.","schema":{"type":"string"}},{"name":"PSU-IP-Port","in":"header","description":"The forwarded IP Port header field consists of the corresponding HTTP request IP Port field between PSU and TPP, if available.","schema":{"type":"string"}},{"name":"PSU-Accept","in":"header","description":"The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.","schema":{"type":"string"}},{"name":"PSU-Accept-Charset","in":"header","description":"The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.","schema":{"type":"string"}},{"name":"PSU-Accept-Encoding","in":"header","description":"The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.","schema":{"type":"string"}},{"name":"PSU-Accept-Language","in":"header","description":"Language that the SCA page will be presented in. Possible options are:\n            \n* \"is\" - Icelandic\n* \"en\" - English\n            \nIf parameter is empty, the default language will be English.","schema":{"type":"string"}},{"name":"PSU-User-Agent","in":"header","description":"The forwarded Agent header field of the HTTP request between PSU and TPP, if available.","schema":{"type":"string"}},{"name":"PSU-Http-Method","in":"header","description":"HTTP method used at the PSU → TPP interface, if available. Valid values: GET, POST, PUT, PATCH, DELETE.","schema":{"type":"string"}},{"name":"PSU-Device-ID","in":"header","description":"UUID (Universally Unique Identifier) for a device, which is used by the PSU, if available. UUID identifies either a device or a device dependant application installation. In case of an installation identification this ID needs to be unaltered until removal from device.","schema":{"type":"string","format":"uuid"}},{"name":"PSU-Geo-Location","in":"header","description":"The forwarded Geo Location of the corresponding http request between PSU and TPP if available.","schema":{"pattern":"GEO:-?[0-9]{1,2}\\.[0-9]{6};-?[0-9]{1,3}\\.[0-9]{6}","type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransactionsResponse200Json"}},"application/xml":{"schema":{"$ref":"#/components/schemas/TransactionsResponse200Json"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error400NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error400NGAIS"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error401NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error401NGAIS"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error403NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error403NGAIS"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error404NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error404NGAIS"}}}},"405":{"description":"Method Not Allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error405NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error405NGAIS"}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error406NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error406NGAIS"}}}},"408":{"description":"Request Timeout"},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error409NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error409NGAIS"}}}},"415":{"description":"Unsupported Media Type"},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error429NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error429NGAIS"}}}},"500":{"description":"Internal Server Error"},"503":{"description":"Service Unavailable"}}}}}}
```

## Read transaction details

> Reads transaction details from a given transaction addressed by \\"transactionId\\" on a\
> given account addressed by \\"account-id\\". This call is only available on transactions\
> as reported in a JSON format.\
> &#x20;           \
> \*\*Remark:\*\* Please note that the PATH might already be given in detail by the corresponding\
> entry of the response of the \\"Read Transaction List\\" call within the \`\_links\` subfield.

```json
{"openapi":"3.0.4","info":{"title":"IOBWS 3.0 Payments and accounts","version":"v1"},"tags":[{"name":"AccountInformationServiceApi","description":"Account Information Service (AIS) — access to account lists, details, balances and transactions."}],"servers":[{"url":"https://apigwsandbox.arionbanki.is/psd2","description":"PSD2 API Host - Sandbox"},{"url":"https://apigw.arionbanki.is/psd2","description":"PSD2 API Host - Production"}],"security":[{"Bearer":["ais:"],"SubscriptionKey":[]}],"components":{"securitySchemes":{"Bearer":{"type":"oauth2","description":"Send your Curity-issued opaque bearer token in the `Authorization: Bearer <token>` header. Required on every request.","flows":{"clientCredentials":{"tokenUrl":"https://curity.arionbanki.is/oauth/v2/oauth-token","scopes":{"ais:":"Account Information Service (AIS) access","pis:":"Payment Initiation Service (PIS) access"}}}}},"schemas":{"InlineResponse2006":{"required":["transactionsDetails"],"type":"object","properties":{"transactionsDetails":{"$ref":"#/components/schemas/TransactionDetailsBody"}},"additionalProperties":false,"description":""},"TransactionDetailsBody":{"required":["transactionDetails"],"type":"object","properties":{"transactionDetails":{"$ref":"#/components/schemas/Transactions"}},"additionalProperties":false,"description":"Transaction details."},"Transactions":{"required":["transactionAmount"],"type":"object","properties":{"transactionId":{"type":"string","description":"This identification is given by the attribute transactionId of the corresponding entry of a transaction list.","nullable":true},"entryReference":{"maxLength":35,"type":"string","description":"Is the identification of the transaction as used e.g. for reference for deltafunction on application level.\nThe same identification as for example used within camt.05x messages.","nullable":true},"endToEndId":{"maxLength":35,"type":"string","description":"Unique end to end identity.","nullable":true},"batchIndicator":{"type":"boolean","description":"If this indicator equals true, then the related entry is a batch entry.","nullable":true},"batchNumberOfTransactions":{"type":"integer","description":"Shall be used if and only if the batchIndicator is contained and equals true.","format":"int32","nullable":true},"mandateId":{"maxLength":35,"type":"string","description":"Identification of Mandates, e.g. a SEPA Mandate ID.","nullable":true},"checkId":{"maxLength":35,"type":"string","description":"Identification of a Cheque.","nullable":true},"creditorId":{"maxLength":35,"type":"string","description":"Identification of Creditors, e.g. a SEPA Creditor ID.","nullable":true},"bookingDate":{"type":"string","description":"The date when an entry is posted to an account on the ASPSPs books.","format":"date-time","nullable":true},"valueDate":{"type":"string","description":"The Date at which assets become available to the account owner in case of a credit.","format":"date-time","nullable":true},"transactionAmount":{"$ref":"#/components/schemas/Amount"},"currencyExchange":{"type":"array","items":{"$ref":"#/components/schemas/ReportExchangeRate"},"description":"Array of exchange rates.","nullable":true},"creditorName":{"maxLength":70,"type":"string","description":"Creditor name.","nullable":true},"creditorAccount":{"$ref":"#/components/schemas/AccountReference"},"creditorAgent":{"pattern":"[A-Z]{6,6}[A-Z2-9][A-NP-Z0-9]([A-Z0-9]{3,3}){0,1}","type":"string","description":"BICFI","nullable":true},"ultimateCreditor":{"maxLength":70,"type":"string","description":"Ultimate creditor.","nullable":true},"debtorName":{"maxLength":70,"type":"string","description":"Debtor name.","nullable":true},"debtorAccount":{"$ref":"#/components/schemas/AccountReference"},"debtorAgent":{"pattern":"[A-Z]{6,6}[A-Z2-9][A-NP-Z0-9]([A-Z0-9]{3,3}){0,1}","type":"string","description":"BICFI","nullable":true},"ultimateDebtor":{"maxLength":70,"type":"string","description":"Ultimate debtor.","nullable":true},"remittanceInformationUnstructured":{"maxLength":140,"type":"string","description":"Unstructured remittance information.","nullable":true},"remittanceInformationUnstructuredArray":{"type":"array","items":{"type":"string"},"description":"Array of unstructured remittance information.","nullable":true},"remittanceInformationStructured":{"maxLength":140,"type":"string","description":"Structured remittance information.","nullable":true},"remittanceInformationStructuredArray":{"type":"array","items":{"$ref":"#/components/schemas/RemittanceInformationStructured"},"description":"Array of structured remittance information.","nullable":true},"entryDetails":{"type":"array","items":{"$ref":"#/components/schemas/EntryDetailsElement"},"description":"Might be used by the ASPSP to transport details about transactions within a batch.","nullable":true},"additionalInformation":{"maxLength":500,"type":"string","description":"Might be used by the ASPSP to transport additional transaction related information to the PSU.","nullable":true},"additionalInformationStructured":{"$ref":"#/components/schemas/AdditionalInformationStructured"},"purposeCode":{"$ref":"#/components/schemas/PurposeCode"},"bankTransactionCode":{"type":"string","description":"Bank transaction code as used by the ASPSP and using the sub elements of this structured code defined by ISO 20022.\nThis code type is concatenating the three ISO20022 Codes Domain Code, Family Code, and SubFamily Code by hyphens,\nresulting in 'DomainCode'-'FamilyCode'-'SubFamilyCode'.","nullable":true},"proprietaryBankTransactionCode":{"maxLength":35,"type":"string","description":"Proprietary bank transaction code as used within a community or within an ASPSP e.g. for MT94x based transaction reports.","nullable":true},"balanceAfterTransaction":{"$ref":"#/components/schemas/Balance"},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"","nullable":true},"transactionTimestamp":{"type":"string","description":"Execution datetime of the record","format":"date-time","nullable":true},"ultimateCreditorId":{"maxLength":35,"type":"string","description":"Ultimate Creditor Id.","nullable":true},"debtorId":{"maxLength":35,"type":"string","description":"Debtor Id.","nullable":true},"ultimateDebtorId":{"maxLength":35,"type":"string","description":"Ultimate Debtor Id.","nullable":true},"icelandicPurpose":{"$ref":"#/components/schemas/IcelandicPurpose"}},"additionalProperties":false,"description":"Transaction details."},"Amount":{"required":["amount","currency"],"type":"object","properties":{"currency":{"minLength":1,"pattern":"[A-Z]{3}","type":"string","description":"ISO 4217 Alpha 3 currency code."},"amount":{"minLength":1,"pattern":"-?[0-9]{1,14}(\\.[0-9]{1,3})?","type":"string","description":"The amount given with fractional digits, where fractions must be compliant to the\ncurrency definition. Up to 14 significant figures. Negative amounts are signed by\nminus. The decimal separator is a dot.\n            \n**Example:** Valid representations for EUR with up to two decimals are:\n            \n* 1056\n* 5768.2\n* -1.50\n* 5877.78"}},"additionalProperties":false,"description":""},"ReportExchangeRate":{"required":["exchangeRate","quotationDate","sourceCurrency","targetCurrency","unitCurrency"],"type":"object","properties":{"sourceCurrency":{"minLength":1,"pattern":"[A-Z]{3}","type":"string","description":"ISO 4217 Alpha 3 currency code."},"exchangeRate":{"minLength":1,"type":"string"},"unitCurrency":{"minLength":1,"type":"string"},"targetCurrency":{"minLength":1,"pattern":"[A-Z]{3}","type":"string","description":"ISO 4217 Alpha 3 currency code."},"quotationDate":{"type":"string","format":"date-time"},"contractIdentification":{"type":"string","nullable":true}},"additionalProperties":false,"description":"Exchange Rate."},"AccountReference":{"type":"object","properties":{"iban":{"pattern":"[A-Z]{2,2}[0-9]{2,2}[a-zA-Z0-9]{1,30}","type":"string","description":"IBAN of an account.","nullable":true},"bban":{"pattern":"[a-zA-Z0-9]{1,30}","type":"string","description":"Basic Bank Account Number (BBAN) Identifier. This data element can be used in the\nbody of the consent request. Message for retrieving account access consent from\nthis account. This data elements is used for payment accounts which have no IBAN.\nISO20022: Basic Bank Account Number (BBAN). Identifier used nationally by financial\ninstitutions, i.e., in individual countries, generally as part of a National Account\nNumbering Scheme(s), which uniquely identifies the account of a customer.","nullable":true},"maskedPan":{"maxLength":35,"type":"string","description":"Masked Primary Account Number in the format 123456******1234. The first 6 and\nlast 4 digits of the card number are visible, with the middle digits masked\nusing asterisks (*).","nullable":true},"msisdn":{"maxLength":35,"type":"string","description":"Mobile phone number.","nullable":true},"currency":{"pattern":"[A-Z]{3}","type":"string","description":"ISO 4217 Alpha 3 currency code.","nullable":true},"cashAccountType":{"type":"string","description":"ExternalCashAccountType1Code from ISO 20022.","nullable":true}},"additionalProperties":false,"description":"Reference to an account by either:\n            \n* IBAN, of a payment accounts, or\n* BBAN, for payment accounts if there is no IBAN, or\n* the Masked Primary Account Number (maskedPan) of a card in the format 123456******1234, or\n* an alias to access a payment account via a registered mobile phone number (MSISDN)."},"RemittanceInformationStructured":{"required":["reference"],"type":"object","properties":{"reference":{"maxLength":35,"minLength":1,"type":"string"},"referenceType":{"maxLength":35,"type":"string","nullable":true},"referenceIssuer":{"maxLength":35,"type":"string","nullable":true}},"additionalProperties":false,"description":"Structured remittance information."},"EntryDetailsElement":{"required":["transactionAmount"],"type":"object","properties":{"endToEndId":{"maxLength":35,"type":"string","description":"Unique end to end identity.","nullable":true},"mandateId":{"maxLength":35,"type":"string","description":"Identification of Mandates, e.g. a SEPA Mandate ID.","nullable":true},"checkId":{"maxLength":35,"type":"string","description":"Identification of a Cheque.","nullable":true},"creditorId":{"maxLength":35,"type":"string","description":"Identification of Creditors, e.g. a SEPA Creditor ID.","nullable":true},"transactionAmount":{"$ref":"#/components/schemas/Amount"},"currencyExchange":{"type":"array","items":{"$ref":"#/components/schemas/ReportExchangeRate"},"description":"Array of exchange rates.","nullable":true},"creditorName":{"maxLength":70,"type":"string","description":"Creditor name.","nullable":true},"creditorAccount":{"$ref":"#/components/schemas/AccountReference"},"creditorAgent":{"pattern":"[A-Z]{6,6}[A-Z2-9][A-NP-Z0-9]([A-Z0-9]{3,3}){0,1}","type":"string","description":"BICFI","nullable":true},"ultimateCreditor":{"maxLength":70,"type":"string","description":"Ultimate creditor.","nullable":true},"debtorName":{"maxLength":70,"type":"string","description":"Debtor name.","nullable":true},"debtorAccount":{"$ref":"#/components/schemas/AccountReference"},"debtorAgent":{"pattern":"[A-Z]{6,6}[A-Z2-9][A-NP-Z0-9]([A-Z0-9]{3,3}){0,1}","type":"string","description":"BICFI","nullable":true},"ultimateDebtor":{"maxLength":70,"type":"string","description":"Ultimate debtor.","nullable":true},"remittanceInformationUnstructured":{"maxLength":140,"type":"string","description":"Unstructured remittance information.","nullable":true},"remittanceInformationUnstructuredArray":{"type":"array","items":{"type":"string"},"description":"Array of unstructured remittance information.","nullable":true},"remittanceInformationStructured":{"$ref":"#/components/schemas/RemittanceInformationStructured"},"remittanceInformationStructuredArray":{"type":"array","items":{"$ref":"#/components/schemas/RemittanceInformationStructured"},"description":"Array of structured remittance information.","nullable":true},"purposeCode":{"$ref":"#/components/schemas/PurposeCode"}},"additionalProperties":false,"description":""},"PurposeCode":{"enum":["BKDF","BKFE","BKFM","BKIP","BKPP","CBLK","CDCB","CDCD","CDCS","CDDP","CDOC","CDQC","ETUP","FCOL","MTUP","ACCT","CASH","COLL","CSDB","DEPT","INTC","LIMA","NETT","BFWD","CCIR","CCPC","CCPM","CCSM","CRDS","CRPR","CRSP","CRTL","EQPT","EQUS","EXPT","EXTD","FIXI","FWBC","FWCC","FWSB","FWSC","MARG","MBSB","MBSC","MGCC","MGSC","OCCC","OPBC","OPCC","OPSB","OPSC","OPTN","OTCD","REPO","RPBC","RPCC","RPSB","RPSC","RVPO","SBSC","SCIE","SCIR","SCRP","SHBC","SHCC","SHSL","SLEB","SLOA","SWBC","SWCC","SWPT","SWSB","SWSC","TBAS","TBBC","TBCC","TRCP","AGRT","AREN","BEXP","BOCE","COMC","CPYR","GDDS","GDSV","GSCB","LICF","MP2B","POPE","ROYA","SCVE","SERV","SUBS","SUPP","TRAD","CHAR","COMT","MP2P","ECPG","ECPR","ECPU","EPAY","CLPR","COMP","DBTC","GOVI","HLRP","HLST","INPC","INPR","INSC","INSU","INTE","LBRI","LIFI","LOAN","LOAR","PENO","PPTI","RELG","RINP","TRFD","FORW","FXNT","ADMG","ADVA","BCDM","BCFG","BLDM","BNET","CBFF","CBFR","CCRD","CDBL","CFEE","CGDD","CORT","COST","CPKC","DCRD","DSMT","DVPM","EDUC","FACT","FAND","FCPM","FEES","GOVT","ICCP","IDCP","IHRP","INSM","IVPT","MCDM","MCFG","MSVC","NOWS","OCDM","OCFG","OFEE","OTHR","PADD","PTSP","RCKE","RCPT","REBT","REFU","RENT","REOD","RIMB","RPNT","RRBN","RVPM","SLPI","SPLT","STDY","TBAN","TBIL","TCSC","TELI","TMPG","TPRI","TPRP","TRNC","TRVC","WEBI","ANNI","CAFI","CFDI","CMDT","DERI","DIVD","FREX","HEDG","INVS","PRME","SAVG","SECU","SEPI","TREA","UNIT","FNET","FUTR","ANTS","CVCF","DMEQ","DNTS","HLTC","HLTI","HSPC","ICRF","LTCF","MAFC","MARF","MDCS","VIEW","CDEP","SWFP","SWPP","SWRS","SWUF","ADCS","AEMP","ALLW","ALMY","BBSC","BECH","BENE","BONU","CCHD","COMM","CSLP","GFRP","GVEA","GVEB","GVEC","GVED","GWLT","HREC","PAYR","PEFC","PENS","PRCP","RHBS","SALA","SSBE","LBIN","LCOL","LFEE","LMEQ","LMFI","LMRK","LREB","LREV","LSFL","ESTX","FWLV","GSTX","HSTX","INTX","NITX","PTXP","RDTX","TAXS","VATX","WHLD","TAXR","B112","BR12","TLRF","TLRR","AIRB","BUSB","FERB","RLWY","TRPT","CBTV","ELEC","ENRG","GASB","NWCH","NWCM","OTLC","PHON","UBIL","WTER"],"type":"string","description":"ExternalPurpose1Code from ISO 20022.  Values from ISO 20022 External Code List ExternalCodeSets_1Q2018 June 2018."},"AdditionalInformationStructured":{"required":["standingOrderDetails"],"type":"object","properties":{"standingOrderDetails":{"$ref":"#/components/schemas/StandingOrderDetails"}},"additionalProperties":false,"description":"Is used if and only if the bookingStatus entry equals \"information\". Every active standing order related to the dedicated payment account result into one entry."},"StandingOrderDetails":{"required":["frequency","startDate"],"type":"object","properties":{"startDate":{"type":"string","format":"date-time"},"frequency":{"$ref":"#/components/schemas/FrequencyCode"},"endDate":{"type":"string","format":"date-time","nullable":true},"executionRule":{"$ref":"#/components/schemas/ExecutionRule"},"withinAMonthFlag":{"type":"boolean","description":"This element is only used in case of frequency equals \\\"Monthly\\\".  If this element equals false it has no effect. If this element equals true, then the execution rule is overruled if the day of execution would fall into a different month using the execution rule.  Example: executionRule equals \\\"preceding\\\", dayOfExecution equals \\\"02\\\" and the second of a month is a Sunday.  In this case, the transaction date would be on the last day of the month before.  This would be overruled if withinAMonthFlag equals true and the payment is processed on Monday the third of the Month. Remark: This attribute is rarely supported in the market.","nullable":true},"monthsOfExecution":{"type":"array","items":{"type":"string"},"description":"The format is following the regular expression \\\\d{1,2}.  The array is restricted to 11 entries.  The values contained in the array entries shall all be different and the maximum value of one entry is 12. This attribute is contained if and only if the frequency equals \\\"MonthlyVariable\\\". Example: An execution on January, April and October each year is addressed by [\\\"1\\\", \\\"4\\\", \\\"10\\\"].","nullable":true},"multiplicator":{"type":"integer","description":"This is multiplying the given frequency resulting the exact frequency, e.g. Frequency=weekly and multiplicator=3 means every 3 weeks. Remark: This attribute is rarely supported in the market.","format":"int32","nullable":true},"dayOfExecution":{"$ref":"#/components/schemas/DayOfExecution"},"limitAmount":{"$ref":"#/components/schemas/Amount"}},"additionalProperties":false,"description":"Details of underlying standing orders."},"FrequencyCode":{"enum":["Daily","Weekly","EveryTwoWeeks","Monthly","EveryTwoMonths","Quarterly","SemiAnnual","Annual"],"type":"string","description":"The following codes from the \\\"EventFrequency7Code\\\" of ISO 20022 are supported: - \\\"Daily\\\" - \\\"Weekly\\\" - \\\"EveryTwoWeeks\\\" - \\\"Monthly\\\" - \\\"EveryTwoMonths\\\" - \\\"Quarterly\\\" - \\\"SemiAnnual\\\" - \\\"Annual\\\""},"ExecutionRule":{"enum":["following","preceding"],"type":"string","description":"\\\"following\\\" or \\\"preceding\\\" supported as values.  This data attribute defines the behaviour when recurring payment dates falls on a weekend or bank holiday.  The payment is then executed either the \\\"preceding\\\" or \\\"following\\\" working day. ASPSP might reject the request due to the communicated value, if rules in Online-Banking are not supporting  this execution rule."},"DayOfExecution":{"enum":["1","2","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30","31"],"type":"string","description":"Day of execution as string.  This string consists of up two characters. Leading zeroes are not allowed.  31 is ultimo of the month."},"Balance":{"required":["balanceAmount","balanceType"],"type":"object","properties":{"balanceAmount":{"$ref":"#/components/schemas/Amount"},"balanceType":{"$ref":"#/components/schemas/BalanceType"},"creditLimitIncluded":{"type":"boolean","description":"A flag indicating if the credit limit of the corresponding account  is included in the calculation of the balance, where applicable.","nullable":true},"lastChangeDateTime":{"type":"string","description":"This data element might be used to indicate e.g. with the expected or booked balance that no action is known  on the account, which is not yet booked.","format":"date-time","nullable":true},"referenceDate":{"type":"string","description":"Indicates the date of the balance.","format":"date-time","nullable":true},"lastCommittedTransaction":{"maxLength":35,"type":"string","description":"\\\"entryReference\\\" of the last commited transaction to support the TPP in identifying whether all  PSU transactions are already known.","nullable":true}},"additionalProperties":false,"description":"A single balance element."},"BalanceType":{"enum":["closingBooked","expected","openingBooked","interimAvailable","interimBooked","forwardAvailable","nonInvoiced"],"type":"string","description":"The following balance types are defined:\n            \n* **closingBooked**: Balance of the account at the end of the pre-agreed account reporting period. It is the sum of the opening booked balance at the beginning of the period and all entries booked to the account during the pre-agreed account reporting period. For card-accounts, this is composed of invoiced, but not yet paid entries.\n* **expected**: Balance composed of booked entries and pending items known at the time of calculation, which projects the end of day balance if everything is booked on the account and no other entry is posted. For card accounts, this is composed of invoiced but not yet paid entries, not yet invoiced but already booked entries and pending items (not yet booked). For card-accounts: \"money to spend with the value of a pre-approved credit limit on the card account\".\n* **openingBooked**: Book balance of the account at the beginning of the account reporting period. It always equals the closing book balance from the previous report.\n* **interimAvailable**: Available balance calculated in the course of the account servicer's business day, at the time specified, and subject to further changes during the business day. The interim balance is calculated on the basis of booked credit and debit items during the calculation time/period specified. For card-accounts, this is composed of invoiced but not yet paid entries and not yet invoiced but already booked entries.\n* **interimBooked**: Balance calculated in the course of the account servicer's business day, at the time specified, and subject to further changes during the business day. The interim balance is calculated on the basis of booked credit and debit items during the calculation time/period specified.\n* **expectedBooked**: Balance composed of booked entries and pending items known at the time of calculation, which projects the end of day balance if everything is booked on the account and no other entry is posted. For card accounts, this is composed of not yet invoiced but already booked entries and pending items (not yet booked). For card-accounts: \"money to spend with the value of a pre-approved credit limit on the card account\".\n* **forwardAvailable**: Forward available balance of money that is at the disposal of the account owner on the date specified.\n* **nonInvoiced**: Only for card accounts, to be checked yet."},"HrefType":{"type":"object","properties":{"href":{"type":"string","nullable":true}},"additionalProperties":false,"description":"Link to a resource."},"IcelandicPurpose":{"type":"object","properties":{"code":{"maxLength":2,"type":"string","nullable":true},"description":{"maxLength":150,"type":"string","nullable":true}},"additionalProperties":false,"description":"Standardised definition of icelandic purpose code and description used in transactions"},"Error400NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage400AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 400."},"TppMessage400AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode400AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"TppMessageCategory":{"enum":["ERROR","WARNING"],"type":"string","description":"Category of the TPP message category."},"MessageCode400AIS":{"enum":["FORMAT_ERROR","PARAMETER_NOT_CONSISTENT","PARAMETER_NOT_SUPPORTED","SERVICE_INVALID","RESOURCE_UNKNOWN","RESOURCE_EXPIRED","RESOURCE_BLOCKED","TIMESTAMP_INVALID","PERIOD_INVALID","SCA_METHOD_UNKNOWN","SCA_INVALID","CONSENT_UNKNOWN","SESSIONS_NOT_SUPPORTED"],"type":"string","description":"Message codes defined for AIS for HTTP Error code 400 (BAD_REQUEST)."},"Error401NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage401AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 401."},"TppMessage401AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode401AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"MessageCode401AIS":{"enum":["CERTIFICATE_INVALID","ROLE_INVALID","CERTIFICATE_EXPIRED","CERTIFICATE_BLOCKED","CERTIFICATE_REVOKE","CERTIFICATE_MISSING","SIGNATURE_INVALID","SIGNATURE_MISSING","CORPORATE_ID_INVALID","PSU_CREDENTIALS_INVALID","CONSENT_INVALID","CONSENT_EXPIRED","TOKEN_UNKNOWN","TOKEN_INVALID","TOKEN_EXPIRED"],"type":"string","description":"Message codes defined for AIS for HTTP Error code 401 (UNAUTHORIZED)."},"Error403NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage403AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 403."},"TppMessage403AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode403AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"MessageCode403AIS":{"enum":["CONSENT_UNKNOWN","SERVICE_BLOCKED","RESOURCE_UNKNOWN","RESOURCE_EXPIRED","ACCOUNT_INVALID_FOR_CONSENT"],"type":"string","description":"Message codes defined for AIS for HTTP Error code 403 (FORBIDDEN)."},"Error404NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage404AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 404."},"TppMessage404AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode404AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"MessageCode404AIS":{"enum":["RESOURCE_UNKNOWN"],"type":"string","description":"Message codes defined for AIS for HTTP Error code 404 (NOT FOUND)."},"Error405NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage405AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 401."},"TppMessage405AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode405AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"MessageCode405AIS":{"enum":["SERVICE_INVALID"],"type":"string","description":"Message codes defined for AIS for HTTP Error code 405 (METHOD NOT ALLOWED)."},"Error406NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage406AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 406."},"TppMessage406AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode406AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"MessageCode406AIS":{"enum":["REQUESTED_FORMATS_INVALID"],"type":"string","description":"Message codes defined for AIS for HTTP Error code 406 (NOT ACCEPTABLE)."},"Error409NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage409AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 409."},"TppMessage409AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode409AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"MessageCode409AIS":{"enum":["STATUS_INVALID"],"type":"string","description":"Message codes defined for AIS for HTTP Error code 409 (CONFLICT)."},"Error429NGAIS":{"type":"object","properties":{"tppMessages":{"type":"array","items":{"$ref":"#/components/schemas/TppMessage429AIS"},"nullable":true},"_links":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HrefType"},"description":"A _link object with all available link types.","nullable":true}},"additionalProperties":false,"description":"NextGenPSD2 specific definition of reporting error information in case of a HTTP error code 429."},"TppMessage429AIS":{"required":["category","code"],"type":"object","properties":{"category":{"$ref":"#/components/schemas/TppMessageCategory"},"code":{"$ref":"#/components/schemas/MessageCode429AIS"},"path":{"type":"string","nullable":true},"text":{"maxLength":500,"type":"string","nullable":true}},"additionalProperties":false,"description":""},"MessageCode429AIS":{"enum":["ACCESS_EXCEEDED"],"type":"string","description":"Message codes for HTTP Error code 429 (TOO MANY REQUESTS)."}}},"paths":{"/api/v1/accounts/{account-id}/transactions/{transactionId}":{"get":{"tags":["AccountInformationServiceApi"],"summary":"Read transaction details","description":"Reads transaction details from a given transaction addressed by \\\"transactionId\\\" on a\ngiven account addressed by \\\"account-id\\\". This call is only available on transactions\nas reported in a JSON format.\n            \n**Remark:** Please note that the PATH might already be given in detail by the corresponding\nentry of the response of the \\\"Read Transaction List\\\" call within the `_links` subfield.","operationId":"GetTransactionDetails","parameters":[{"name":"account-id","in":"path","description":"This identification is denoting the addressed (card) account.  The account-id is retrieved by using a \\\"Read Account List\\\" or \\\"Read Card Account list\\\" call.  The account-id is the \\\"resourceId\\\" attribute of the account structure.  Its value is constant at least throughout the lifecycle of a given consent.","required":true,"schema":{"type":"string"}},{"name":"transactionId","in":"path","description":"This identification is given by the attribute transactionId of the corresponding entry of a transaction list.","required":true,"schema":{"type":"string"}},{"name":"X-Request-ID","in":"header","description":"ID of the request, unique to the call, as determined by the initiating party.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Consent-ID","in":"header","description":"This data element may be contained, if the payment initiation transaction is part of a session, i.e. combined AIS/PIS service. This then contains the consentId of the related AIS consent, which was performed prior to this payment initiation.","required":true,"schema":{"type":"string"}},{"name":"Digest","in":"header","description":"Is contained if and only if the \\\"Signature\\\" element is contained in the header of the request.","schema":{"type":"string"}},{"name":"Signature","in":"header","description":"A signature of the request by the TPP on application level. This might be mandated by ASPSP.","schema":{"type":"string"}},{"name":"TPP-Signature-Certificate","in":"header","description":"The certificate used for signing the request, in base64 encoding.  Must be contained if a signature is contained.","schema":{"type":"string"}},{"name":"PSU-IP-Address","in":"header","description":"The forwarded IP Address header field consists of the corresponding HTTP request  IP Address field between PSU and TPP.  It shall be contained if and only if this request was actively initiated by the PSU.","schema":{"type":"string"}},{"name":"PSU-IP-Port","in":"header","description":"The forwarded IP Port header field consists of the corresponding HTTP request IP Port field between PSU and TPP, if available.","schema":{"type":"string"}},{"name":"PSU-Accept","in":"header","description":"The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.","schema":{"type":"string"}},{"name":"PSU-Accept-Charset","in":"header","description":"The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.","schema":{"type":"string"}},{"name":"PSU-Accept-Encoding","in":"header","description":"The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.","schema":{"type":"string"}},{"name":"PSU-Accept-Language","in":"header","description":"Language that the SCA page will be presented in. Possible options are:\n            \n* \"is\" - Icelandic\n* \"en\" - English\n            \nIf parameter is empty, the default language will be English.","schema":{"type":"string"}},{"name":"PSU-User-Agent","in":"header","description":"The forwarded Agent header field of the HTTP request between PSU and TPP, if available.","schema":{"type":"string"}},{"name":"PSU-Http-Method","in":"header","description":"HTTP method used at the PSU → TPP interface, if available. Valid values: GET, POST, PUT, PATCH, DELETE.","schema":{"type":"string"}},{"name":"PSU-Device-ID","in":"header","description":"UUID (Universally Unique Identifier) for a device, which is used by the PSU, if available. UUID identifies either a device or a device dependant application installation. In case of an installation identification this ID needs to be unaltered until removal from device.","schema":{"type":"string","format":"uuid"}},{"name":"PSU-Geo-Location","in":"header","description":"The forwarded Geo Location of the corresponding http request between PSU and TPP if available.","schema":{"pattern":"GEO:-?[0-9]{1,2}\\.[0-9]{6};-?[0-9]{1,3}\\.[0-9]{6}","type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InlineResponse2006"}},"application/xml":{"schema":{"$ref":"#/components/schemas/InlineResponse2006"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error400NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error400NGAIS"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error401NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error401NGAIS"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error403NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error403NGAIS"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error404NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error404NGAIS"}}}},"405":{"description":"Method Not Allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error405NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error405NGAIS"}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error406NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error406NGAIS"}}}},"408":{"description":"Request Timeout"},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error409NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error409NGAIS"}}}},"415":{"description":"Unsupported Media Type"},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error429NGAIS"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Error429NGAIS"}}}},"500":{"description":"Internal Server Error"},"503":{"description":"Service Unavailable"}}}}}}
```