List sponsored buyers

GET /api/v2/storefront/sponsored-buyers Returns the sponsored buyer accounts your organization owns — the accounts created when buying organizations joined through your join links — with each buyer’s status, posture, and resolved name.

Request

curl https://api.interchange.io/api/v2/storefront/sponsored-buyers \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

Parameters

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

Response

200 OK with a SponsoredBuyerList:

{
  "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.
`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 for the full error contract.

Approve sponsored buyer

Admit a pending buyer

Suspend sponsored buyer

Pause an active buyer

Errors

Shared error contract

Approve sponsored buyer Reactivate sponsored buyer

⌘I

Getting Started

Operating Your Storefront

Inventory Sources

Real-Time Targeting (TMP)

Approvals & Reviews

Buyer Onboarding

Demand & Signals

Proposals & Agents

Buyer Routing

Analytics & Activity

Billing

Account

Request

Parameters

Response

Response fields

Errors

Sponsored-buyer tasks

Approve sponsored buyer

Suspend sponsored buyer

Errors

​Request

​Parameters

​Response

​Response fields

​Errors

​Related

Sponsored-buyer tasks

Approve sponsored buyer

Suspend sponsored buyer

Errors

Request

Parameters

Response

Response fields

Errors

Related