---
title: "Get External Account Link Access"
method: POST
path: "/getExternalAccountLinkAccess"
tags: ["External Account Links"]
---

# Get External Account Link Access

`POST /getExternalAccountLinkAccess`

## Request

- Base URL: `{corename}.payment-hub.{env}.gpsrv.com/payment-hub/1.0`
- URL: `{corename}.payment-hub.{env}.gpsrv.com/payment-hub/1.0/getExternalAccountLinkAccess`
- Auth: none declared. Required headers: `Authorization`

Use the Get External Account Link Access endpoint to initiate a secure, user-facing session for linking an external account. This endpoint generates a temporary link for the user to securely provide their credentials to a third-party partner like Finicity.

## Headers

- `Authorization` string, required

## Request body

- object
  - `accountNo` string, nullable: The <<glossary:PRN>> for which to generate the secure linking session. Required for GALILEO_CARD_CAPTURE integration. Pattern: PRN Example: 074103447228
  - `integration` 'FINICITY' | 'GALILEO_CARD_CAPTURE', required: Third-party partner to use for the secure account-linking session. Example: FINICITY

## Response `200`

Successful Response

- object
  - `token` object, required
    - `type` 'JWT' | 'FINICITY_TOKEN', required: Type of token returned. Example: JWT
    - `value` string, required: Token used to authenticate the secure session. For JWT: JSON Web Token for GALILEO_CARD_CAPTURE integration. For FINICITY_TOKEN: Finicity application token for API authentication. Pattern: Token string Example: fqnu103294.g4234g234f.42g2345gteg
    - `appKey` string, nullable: Application key for API authentication. Only provided for FINICITY integration. Pattern: Alphanumeric string Example: abc123def456
  - `expirationTimestamp` string, required: ISO 8601 timestamp when the access token expires. Pattern: ISO 8601 format Example: `"2025-06-11T09:49:20.055367-06:00"`
  - `expirationDate` string, required: Deprecated: Use expirationTimestamp instead. ISO 8601 timestamp when the access token expires. Pattern: ISO 8601 format Example: `"2025-06-11T09:49:20.055367-06:00"`

## Other responses

- `400`: Bad Request
- `401`: No valid API credentials provided.
- `403`: The provided API credential does not allow this operation.
- `404`: Not Found
- `409`: Conflict
- `422`: Validation Error
- `429`: Too many requests.
- `500`: Internal Server Error
- `502`: Bad Gateway.
- `503`: Service Unavailable.

---

[API](https://skmtc.dev/galileo-ft/apis/payment-hub-api-2-0.md) - [All operations](https://skmtc.dev/galileo-ft/apis/payment-hub-api-2-0/llms.txt) - [OpenAPI document](https://skmtc.dev/galileo-ft/apis/payment-hub-api-2-0/revisions/20e06b09d5e4?raw)