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

# List sponsored buyers

> List the buyer accounts your organization sponsors on its storefronts

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

Returns the sponsored buyer accounts your organization owns — each with
their current status, posture, and resolved name.

## Request

<CodeGroup>
  ```bash curl theme={null}
  curl https://api.apostra.com/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": "credit",
      "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 | Seller-selected billing path: `prepay` is consolidated billing; `credit` is seller direct-billed. |
| `createdAt` | string | ISO-8601 timestamp of when the sponsorship was created. |

## 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>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.