---
title: "List stablecoin provider account links"
method: GET
path: "/stablecoin-provider-accounts"
tags: ["Stablecoins"]
---

# List stablecoin provider account links

`GET /stablecoin-provider-accounts`

## Request

- Base URL: `https://api.lightspark.com/grid/2025-10-13`
- URL: `https://api.lightspark.com/grid/2025-10-13/stablecoin-provider-accounts`
- Auth: HTTP basic

Retrieve stablecoin provider account links for the authenticated platform.

## Query parameters

- `provider` 'BRALE': Stablecoin provider backing the linked account, stablecoin, or operation.
- `status` 'ACTIVE' | 'INVALID' | 'REVOKED': Status of the linked stablecoin provider account credentials.
- `limit` integer
- `cursor` string

## Response `200`

Successful operation

- StablecoinProviderAccountListResponse
  - `data` StablecoinProviderAccount[], required
    - `id` string, required: System-generated stablecoin provider account link identifier.
    - `provider` 'BRALE', required: Stablecoin provider backing the linked account, stablecoin, or operation.
    - `providerAccountId` string, required: Provider account id.
    - `providerEnvironment` 'SANDBOX' | 'PRODUCTION', required: Provider environment derived from the authenticated Grid platform mode.
    - `status` 'ACTIVE' | 'INVALID' | 'REVOKED', required: Status of the linked stablecoin provider account credentials.
    - `lastVerifiedAt` string, date-time: Timestamp of the last successful provider credential verification.
    - `createdAt` string, date-time, required: Creation timestamp.
    - `updatedAt` string, date-time, required: Last update timestamp.
  - `hasMore` boolean, required: Indicates if more results are available beyond this page.
  - `nextCursor` string: Cursor to retrieve the next page of results.
  - `totalCount` integer: Total number of stablecoin provider account links matching the criteria.

## Other responses

- `400`: Bad request - Invalid parameters
- `401`: Unauthorized
- `500`: Internal service error

## Changes

> 115 revisions in range; 2 not diffed.

- **2026-10-28** `d996ddfb9d2b`: 2 info
  - added the optional property `details/missingFields` to the response with the `400` status
  - added the optional property `details/refusalReason` to the response with the `400` status
- **2026-10-24** `715332dcb111`: 1 warning
  - added the new `EXACT_AMOUNT_UNAVAILABLE` enum value to the `code` response property for the response status `400`
- **2026-10-20** `761d1d030cb5`: 1 warning
  - added the new `CARDHOLDER_AGREEMENT_NOT_ACCEPTED` enum value to the `code` response property for the response status `400`
- **2026-10-13** `ddcb4ec73fd0`: 1 warning
  - added the new `ACCOUNTHOLDER_AGREEMENT_NOT_ACCEPTED` enum value to the `code` response property for the response status `400`
- **2026-10-05** `6d67fe99049c`: 3 info
  - removed the `INVALID_PAYREQ_RESPONSE` enum value from the `code` response property for the response status `400`
  - removed the `LOOKUP_REQUEST_FAILED` enum value from the `code` response property for the response status `400`
  - removed the `QUOTE_REQUEST_FAILED` enum value from the `code` response property for the response status `400`

[Operation history](https://skmtc.dev/lightsparkdev/apis/grid-api/changes/stablecoin-provider-accounts/get.md)

---

[API](https://skmtc.dev/lightsparkdev/apis/grid-api.md) - [All operations](https://skmtc.dev/lightsparkdev/apis/grid-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lightsparkdev/apis/grid-api/revisions/7a1db46ec552?raw)