Skip to main content
GET
/
v3
/
{customerId}
/
BankingServices
/
GetAccountsDetailAsync
/
{requestId}
Get Accounts Detail Async
curl --request GET \
  --url https://{instance}-api.private.fin.ag/v3/{customerId}/BankingServices/GetAccountsDetailAsync/{requestId} \
  --header 'Accept: <accept>' \
  --header 'Content-Type: <content-type>'
{
  "HttpStatusCode": 200,
  "Accounts": [
    {
      "Transactions": [
        {
          "Date": "2025-01-31",
          "Code": null,
          "Description": "PAYROLL - Stripe Paycheck",
          "Debit": 1000.4,
          "Credit": 1500.25,
          "Balance": 5105.6,
          "Id": "94584aed-7c98-42a4-9836-9f8557db63f5"
        },
        {
          "Date": "2025-01-30",
          "Code": null,
          "Description": "Credit Card Payment",
          "Debit": 150,
          "Credit": 100,
          "Balance": 3605,
          "Id": "c2fb949a-86aa-470f-9a76-deb10d7c2b57"
        }
      ],
      "TransitNumber": "12347",
      "InstitutionNumber": "777",
      "OverdraftLimit": 100.5,
      "Title": "Chequing Account",
      "AccountNumber": "7641238",
      "LastFourDigits": null,
      "Balance": {
        "Available": 5405.5,
        "Current": 5105.5,
        "Limit": 5105.5
      },
      "Category": "Operations",
      "Type": "Chequing",
      "Currency": "CAD",
      "Holder": {
        "Name": "Testing",
        "Address": {
          "CivicAddress": "25 york street",
          "City": "TOR",
          "Province": "ON",
          "PostalCode": "M5J 2V5",
          "POBox": null,
          "Country": "CA"
        },
        "Email": "test_user1@nomail.com",
        "PhoneNumber": "9051234567"
      },
      "AccountType": null,
      "Id": "27a9ffa0-c6b9-4cc6-9eaa-aa9efa07a889"
    }
  ],
  "InstitutionName": "FlinksCapital",
  "Login": {
    "Username": "chat_gpt",
    "IsScheduledRefresh": false,
    "LastRefresh": "2025-01-31T17:40:54.569261",
    "Type": "Personal",
    "Id": "5602459c-f6d0-4ca0-6750-08dccdcadcc0"
  },
  "InstitutionId": 14,
  "Institution": "FlinksCapital",
  "RequestId": "22178382-31ee-485c-a750-c20929b6a344"
}
/GetAccountsDetailAsync is the polling companion to /GetAccountsDetail. Call this endpoint only after receiving a 202 from /GetAccountsDetail. This is a GET request. Pass the RequestId from your /GetAccountsDetail call as a path parameter.

​
Polling for results

When /GetAccountsDetail returns a 202, poll /GetAccountsDetailAsync to check if the data has finished processing:
  1. Call /GetAccountsDetailAsync with the RequestId.
  2. If the response is 202, wait 10 seconds and call again.
  3. Repeat until you receive a 200.
  4. Set a maximum timeout of 30 minutes to avoid infinite loops.
Most requests finish processing within a few seconds.

​
200 response

The 200 response from /GetAccountsDetailAsync contains the same payload as a 200 from /GetAccountsDetail — full account details, holder information, and transaction history. For the full data retrieval flow, see Retrieve Account Data.

Headers

​
x-api-key
string

Security feature that grants access to this endpoint, but it must be enabled by Flinks. Please contact your Flinks representative to activate it.

​
Content-Type
enum<string>
default:application/json
required

Content type of the request.

Available options:
application/json
Example:

"application/json"

​
Accept
string
default:application/json
required

Acceptable response media type.

Example:

"application/json"

Path Parameters

​
customerId
string
default:43387ca6-0391-4c82-857d-70d95f087ecb
required

Key that grants access to the environment specified in the instance field. By default, the value is set to the toolbox environment key.

​
requestId
string
required

Unique identifier provided after a successful request to the /GetAccountsDetail endpoint.

Response

Result

​
HttpStatusCode
integer

HTTP status code of the response.

​
Accounts
object[]

Array containing detailed information about each linked account.

​
InstitutionName
string

Name of the financial institution.

​
Login
object

Login information.

​
InstitutionId
integer

Numeric identifier for the financial institution.

​
Institution
string

Institution name or code.

​
RequestId
string

Unique request identifier.