---
title: "aggregatorCredentials"
method: GET
path: "/v2/aggregatorCredentials"
tags: ["Bank Connection"]
---

# aggregatorCredentials

`GET /v2/aggregatorCredentials`

Request a new aggregator URL to launch an aggregator widget with a unique token.

This will allow users to link their bank account.

<details>
<summary><strong>Error Glossary</strong> (click to expand)</summary>

| Code | HTTP Status | Message |
|------|-------------|-------------|
| `AP101` | 401 | No authenticated user |
| `AP407` | 200 | Bank linking disabled on account |
| `AP408` | 200 | Unknown aggregator |
| `AP409` | 200 | Invalid redirectURI |

</details>

## Query parameters

- `aggregator` 'aerosync', required

## Headers

- `Content-Type` string, required
- `authorization` string, required

## Response `200`

Success or Business Logic Error

- union
  - AggregatorCredentialsResponse
    - `fastlinkURL` string
    - `token` string
    - `username` string
  - 200failure
    - `error` object
      - `code` string
      - `message` string
      - `help` string — Support contact information

## Other responses

- `400` — Bad Request - Validation Errors

---

[API](https://skmtc.net/aero/apis/aeropay-v2-api.md) · [All operations](https://skmtc.net/aero/apis/aeropay-v2-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aero/aeropay-v2-api/revisions/4700c4ceeaad/schema)