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

> List the active join links your organization owns

`GET /api/v2/storefront/join-links`

Returns the active join links owned by your organization, across all of your storefronts. Disabled (revoked) links are not included.

## Request

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

## Parameters

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

## Response

`200 OK` with a `JoinLinkList`:

```json theme={null}
{
  "items": [
    {
      "id": "5571",
      "slug": "northwind-advertisers",
      "joinPath": "/join/northwind-advertisers",
      "sellerCustomerId": 318,
      "storefrontId": 4012,
      "role": "BUYER",
      "posture": "prepay",
      "approvalPolicy": "manual_approve",
      "active": true,
      "uses": 12,
      "maxUses": 250,
      "expiresAt": "2026-12-31T23:59:59.000Z",
      "revokedAt": null,
      "createdAt": "2026-06-14T18:22:10.441Z",
      "updatedAt": "2026-06-14T18:22:10.441Z"
    }
  ],
  "total": 1
}
```

## Errors

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

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

## Related

<CardGroup cols={2}>
  <Card title="Join-link tasks" href="/v2/storefront/join-links/tasks" icon="list-check">
    All operations
  </Card>

  <Card title="Create join link" href="/v2/storefront/join-links/tasks/create-join-link" icon="plus">
    Mint a new link
  </Card>

  <Card title="Disable join link" href="/v2/storefront/join-links/tasks/disable-join-link" icon="ban">
    Soft-revoke a link
  </Card>

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