accounts

Get an account

[Protected by one of the following scopes : accounts_manage or accounts_read or transactions_read] This endpoint allows you to retrieve information about a specific account.

get/accounts/{id}

Request

  • Base URL: https://api.linxo.com/v2
  • URL: https://api.linxo.com/v2/accounts/{id}
  • Auth: OAuth (defined in the document in a form this page cannot read)

Path parameters

idstring required

Identifier of the account

Headers

Authorizationstring

Provided Bearer token following the format: 'Bearer xxxxxxxxx'

Response

Account successfully retrieved

connection_idstring required

Unique identifier of the connection providing data for this account

namestring required

Account name, built using various information (account owner, account type ... )

account_numberstring

Account number

ibanstring

IBAN when available. Some accounts do not have an IBAN. Even if an account has an IBAN, it may not be available through the API

balancenumber required

Account balance as reported during the last synchronization represented by a floating number. Balance is a signed float with the dot as separator. Example: 1000000.45

currencystring required

Currency of the account in the ISO4217 format. (3 letters. Examples : "EUR", "USD")

balance_datenumber

Date of the last balance update as UTC timestamp in seconds. This corresponds to the time when the value was read from the provider's service.

type'CHECKINGS' | 'SAVINGS' | 'LOAN' | 'CREDIT_CARD' required

Type of the account.

status'MANUAL' | 'ACTIVE' | 'ERROR' | 'NOT_FOUND' | 'CLOSED' | 'SUSPENDED' | 'PENDING_CONSENT' required

The status of the bank account during its last synchronization. The bank account status depends on the connection status

  • MANUAL - Manual bank account, belonging to a manual connection. Manual connections have status NONE. They have no channel.
  • ACTIVE - The account was synchronized successfully or we never synchronized it yet. It is linked to a SUCCESS, PARTIAL_SUCCESS or NEVER channel. In case of PARTIAL_SUCCESS, an ACTIVE account is one of the accounts synchronized successfully.
  • ERROR - Bank account is currently linked to a channel whose last synchronization ended with status FAILED, AUTH_FAILED, TOO_MANY_ATTEMPTS, TOKEN_EXPIRED, SERVICE_UNAIVALABLE, PASSWORD_CHANGE_REQUIRED, USER_ACTION_REQUIRED, CHALLENGE_REQUIRED, CHALLENGE_TIMED_OUT, CHALLENGE_FAILED, CHALLENGE_CANCELLED, or it is linked to a PARTIAL_SUCCESS channel and is one of the accounts which could not be synchronized.
  • NOT_FOUND - Bank account is currently linked to a PARTIAL_SUCCESS channel. This account could not be synchronized as it could not be found during the last synchronization.
  • CLOSED - When an account is closed, all existing data are preserved (transactions, etc), but its balance is set to 0 and no more synchronization will occur for this account. An account can be closed independently using the PUT /accounts/{id} endpoint. It can also be part of a CLOSED connection. A CLOSED connection has only CLOSED channels and CLOSED accounts. A connection can be closed using the POST /connections/{id}/close endpoint, and reopened using the POST /connections/{id}/reopen endpoint).
  • SUSPENDED - Bank account synchronization has been suspended because our system detected that it is a professional account. The account needs to be verified. For more information, read about the professional account process.
  • PENDING_CONSENT - Bank account cannot be synchronized because the PSD2 consent has not been granted. Read more about PSD2 consents.
classification'PERSONAL' | 'BUSINESS' | 'CORPORATE' | 'OTHER'

Account classification

creation_datenumber required

Date when this account first appeared as UTC timestamp in seconds.

usagestring

Owner's type: PERSONAL, PROFESSIONAL.

groupstring

Name of the user's workspace on bank website.

last_channel_definition_idstring

The unique identifier of the last channel definition associated with this account

idstring required

The unique account identifier. The value of this property corresponds to the value provided in the URL.

Changes

No recorded changes to this operation across all 1 revision of this API.