FIfirefinancialservices
Accounts

Get details of an account (V2)

Changed on

This endpoint will return an array of information about the account. You can retrieve the details of a Fire Account by its ican. You will need to enable PERM_BUSINESS_GET_ACCOUNT to use this endpoint.

get/v2/accounts/{ican}

Request

Path parameters

icaninteger required

The ican of the account to retrieve

Response

An account information object.

icaninteger

identifier for the fire.com account (assigned by fire.com)

namestring

the name the user gives to the account to help them identify it.

currencystring

The currency of the account

balanceinteger

the balance of the account (in minor currency units - pence, cent etc. 434050 == 4,340.50 GBP for a GBP account).

status'LIVE' | 'BREXIT_MIGRATED'

Live accounts can be used as normal. Migrated accounts were used before Brexit and are read-only.

defaultAccountboolean

true if this is the default account for this currency. This will be the account that general fees are taken from (as opposed to per-transaction fees).

directDebitsAllowedboolean

Whether or not direct debits can be set up on this account.

fopOnlyboolean

Indicates that this account is for collecting Fire Open Payments only. All other payments to this account will be returned.

Example response

{
  "ican": 42,
  "name": "Main Account",
  "currency": "EUR",
  "balance": 23950,
  "accountDetails": {
    "localDetails": {
      "nsc": "232221",
      "accountNumber": "86449007",
      "bic": "CPAYIE2D",
      "iban": "IE93CPAY99119986449007"
    },
    "internationalDetails": {
      "swiftCode": "TCCLGB2BXXX",
      "iban": "GB12TCCL1234567887654321"
    }
  },
  "defaultAccount": true
}

Changes

  • v1c44f812389cbRevision changes
    • warning

      removed the optional property / from the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

  • v1e5f39bfbed1fRevision changes
    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • info

      added the optional property / to the response with the status