Accounts

With Blackthorn API you can open account in one of ten available currencies: GBP, EUR, DKK, HUF, NOK, PLN, RON, USD, CHF, CZK, SEK. For each currency available different payment rails. For example: GBP - Faster Payments and SWIFT.

Create Account

You can easily manage accounts using the endpoints below.

POST /customer/accounts Create new account for enduser, including IBAN generation

Parameters: No parameters

Request body:

Example Value
Schema

{
  "holder_id": "string",
  "asset_class": "string",
  "asset_type": "string",
  "ledger_meta": {},
  "ledger_primary_use_types": [
    "string"
  ],
  "ledger_type": "string",
  "usage_type": "operational",
  "partner_product": "string"
}

{
  "holder_id": "string",
  "asset_class": "string",
  "asset_type": "string",
  "ledger_meta": {},
  "ledger_primary_use_types": [
    "string"
  ],
  "ledger_type": "string",
  "usage_type": "operational",
  "partner_product": "string"
}

Responses:

200

Example Value

Controls
Accept
Header

{
  "id": "string",
  "iban": "string"
}

400

Example Value

Controls
Accept
Header

Bad request

401

Example Value

Controls
Accept
Header

Unauthorized

Get Account

GET /customer/accounts/{account_id}

Parameters:

Name Description

account_id string

Responses:

200

Example Value

Controls
Accept
Header

{
  "id": "string",
  "currency": "string",
  "sortCode": "string",
  "label": "string",
  "ownerName": "string",
  "createdAt": "string",
  "accountNumber": "string",
  "accountStatus": "string",
  "balance": 0,
  "iban": "string",
}

400

Example Value

Controls
Accept
Header

Bad request

401

Example Value

Controls
Accept
Header

Unauthorized

Get list accounts

GET /customer/accounts/list/{enduser_id}

Parameters: No parameters

Responses:

200

Example Value

Controls
Accept
Header

[{
  "id": "string",
  "currency": "string",
  "sortCode": "string",
  "label": "string",
  "ownerName": "string",
  "createdAt": "string",
  "accountNumber": "string",
  "accountStatus": "string",
  "balance": 0,
  "iban": "string",
},{
  "id": "string",
  "currency": "string",
  "sortCode": "string",
  "label": "string",
  "ownerName": "string",
  "createdAt": "string",
  "accountNumber": "string",
  "accountStatus": "string",
  "balance": 0,
  "iban": "string",
}]

400

Example Value

Controls
Accept
Header

Bad request

401

Example Value

Controls
Accept
Header

Unauthorized