Skip to content

Overview

This is the partner API from linkcy. Here you can find our API documentation.

LinkCy API allows you to create fully embedded banking products for your own company or consumers. This API is backed by all mandatory requirements by financial authorities. To process, information provided into the API must be accurate.

Authentication

You can obtain a LinkCy Authorization Key by contacting our commercial team here.

Download OpenAPI description
Languages
Servers
Generated server url
https://api.sandbox.linkcy.cloud/
Operations
Operations
Operations
Operations
Operations

Consumer

The consumer represents the individual partner client. It must have a valid phone number and be formally identified with a KYC procedure before carrying out any operation.

Operations
Operations
Operations
Operations
Operations
Operations

Request

Get all information about a ledger using its ID.

Security
Linkcy-Auth
Path
ledgerIdstring(uuid)required
No request payload

Responses

OK

Bodyapplication/json
Any of:
idstring(uuid)required
endUserIdstring(uuid)required
friendlyNamestring
statusstringrequired
Enum"PENDING""ACTIVE""CLOSING""CLOSED""SUSPENDED""FAILED"
currencystringrequired
Enum"EUR""GBP""USD""PLN""AUD""CHF""CAD""SEK""NOK""JPY"
countrystringrequired
Enum"ESTONIA""FRANCE""BELGIUM""GREAT_BRITAIN""LITHUANIA""BULGARIA""USA"
totalAmountnumberrequired
availableAmountnumberrequired
reservedAmountnumberrequired
creationDatestring(date-time)required
updateDatestring(date-time)required
isUpgradedbooleanrequired

When inactive, no external banking information will be returned. Assign an account number to enable the fields.

ibanstring
bicOrSwiftstring
accountNumberstring
sortCodestring
routingNumberstring
suspensionsInformationArray of objectsrequired
suspensionsInformation[].​datestring(date-time)required
suspensionsInformation[].​reasonstring
suspensionsInformation[].​operatorstringrequired
Enum"END_USER""PARTNER""LINKCY"
limitsobjectrequired
limits.​ddTransactionLimitnumberrequired

Direct debit transaction limit. If null, it will take the default value defined in the partner configuration.

limits.​ddMonthlyLimitnumberrequired

Direct Debit Monthly Limit. If null, it will take the default value defined in the partner configuration.

limits.​ddMonthlyLimitUsednumberrequired
limits.​transactionLimitnumberrequired

Transaction Limit. If null, it will take the default value defined in the partner configuration.

limits.​transactionDailyLimitnumberrequired

Transaction Daily Limit. If null, it will take the default value defined in the partner configuration.

limits.​transactionDailyLimitUsednumberrequired
limits.​transactionMonthlyLimitnumberrequired

Transaction Monthly Limit. If null, it will take the default value defined in the partner configuration.

limits.​transactionMonthlyLimitUsednumberrequired
closeInformationobject
Response
application/json
{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "endUserId": "120e9d1f-8444-4b91-85e8-5b208615a3e5", "friendlyName": "string", "status": "PENDING", "currency": "EUR", "country": "ESTONIA", "totalAmount": 0, "availableAmount": 0, "reservedAmount": 0, "creationDate": "2019-08-24T14:15:22Z", "updateDate": "2019-08-24T14:15:22Z", "isUpgraded": true, "iban": "string", "bicOrSwift": "string", "accountNumber": "string", "sortCode": "string", "routingNumber": "string", "suspensionsInformation": [ {} ], "limits": { "ddTransactionLimit": 0, "ddMonthlyLimit": 0, "ddMonthlyLimitUsed": 0, "transactionLimit": 0, "transactionDailyLimit": 0, "transactionDailyLimitUsed": 0, "transactionMonthlyLimit": 0, "transactionMonthlyLimitUsed": 0 }, "closeInformation": { "date": "2019-08-24T14:15:22Z", "reason": "string", "operator": "END_USER" } }

Request

You can patch a ledger to update some information.

Security
Linkcy-Auth
Path
ledgerIdstring(uuid)required
Bodyapplication/jsonrequired
friendlyNamestring[ 1 .. 255 ] characters
parentLedgerIdstring(uuid)
limitsobject(LedgerLimitsRequestDto)
application/json
{ "friendlyName": "string", "parentLedgerId": "2588f3a1-5f2a-470b-8a33-a5d776eff4af", "limits": { "ddTransactionLimit": 0, "ddMonthlyLimit": 0, "transactionLimit": 0, "transactionDailyLimit": 0, "transactionMonthlyLimit": 0 } }

Responses

OK

Bodyapplication/json
idstring(uuid)required
Response
application/json
{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08" }

Request

Security
Linkcy-Auth
Path
ledgerIdstring(uuid)required
Query
startDatestring(date)
endDatestring(date)
No request payload

Responses

OK

Bodyapplication/json
urlstringrequired
ttlstringrequired
Example: "PT8H6M12.345S"
Response
application/json
{ "url": "string", "ttl": "PT8H6M12.345S" }
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations