> ## Documentation Index
> Fetch the complete documentation index at: https://docs.interchange.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List sponsored buyers

> List the advertisers your organization sponsors on its storefronts

`GET /api/v2/storefront/sponsored-buyers`

Returns the sponsored buyers your organization owns — the advertisers that joined through your [join links](/v2/storefront/join-links/overview) — with each buyer's status, posture, and resolved name.

## Request

<CodeGroup>
  ```bash curl theme={null}
  curl https://api.interchange.io/api/v2/storefront/sponsored-buyers \
    -H "Authorization: Bearer $SCOPE3_API_KEY"
  ```
</CodeGroup>

## Parameters

None. The result is scoped to your seller account context.

## Response

`200 OK` with a `SponsoredBuyerList`:

```json theme={null}
{
  "items": [
    {
      "buyerCustomerId": 90412,
      "buyerName": "Lakeside Motors",
      "storefrontId": 4012,
      "status": "pending",
      "posture": "prepay",
      "createdAt": "2026-06-14T18:40:02.118Z"
    },
    {
      "buyerCustomerId": 90377,
      "buyerName": "Corner Slice",
      "storefrontId": 4012,
      "status": "active",
      "posture": "prepay",
      "createdAt": "2026-06-12T09:15:44.901Z"
    }
  ],
  "total": 2
}
```

### Response fields

| Field             | Type           | Notes                                                                                                                       |
| ----------------- | -------------- | --------------------------------------------------------------------------------------------------------------------------- |
| `buyerCustomerId` | integer        | The buyer's account id. Use it in the approve / suspend / reactivate paths.                                                 |
| `buyerName`       | string \| null | Buyer's company/display name from their account record; `null` if not resolvable.                                           |
| `storefrontId`    | integer        | The storefront the buyer is scoped to.                                                                                      |
| `status`          | enum           | `pending`, `active`, or `suspended`. See the [status lifecycle](/v2/storefront/sponsored-buyers/overview#status-lifecycle). |
| `posture`         | enum           | `prepay` or `credit`.                                                                                                       |
| `createdAt`       | string         | ISO-8601 timestamp of when the buyer joined.                                                                                |

## Errors

* `401 UNAUTHORIZED` — missing or invalid API key.
* `403 CUSTOMER_ROLE_DENIED` — the API key is not a seller account; only sellers manage sponsored buyers.

See [Errors](/v2/reference/errors) for the full error contract.

## Related

<CardGroup cols={2}>
  <Card title="Sponsored-buyer tasks" href="/v2/storefront/sponsored-buyers/tasks" icon="list-check">
    All operations
  </Card>

  <Card title="Approve sponsored buyer" href="/v2/storefront/sponsored-buyers/tasks/approve-sponsored-buyer" icon="circle-check">
    Admit a pending buyer
  </Card>

  <Card title="Suspend sponsored buyer" href="/v2/storefront/sponsored-buyers/tasks/suspend-sponsored-buyer" icon="circle-pause">
    Pause an active buyer
  </Card>

  <Card title="Errors" href="/v2/reference/errors" icon="triangle-exclamation">
    Shared error contract
  </Card>
</CardGroup>