> Documentation index: https://docs.dairo.app/llms.txt, a list of every page in this documentation.

# List share bundles

> Returns the organization's share bundles, newest first (at most 200), each with its fileCount, hasPassword, expiresAt, revoked flag and createdAt.

```text title="Endpoint"
GET https://api.dairo.app/v1/share-links/bundles
```

Returns the organization's share bundles, newest first (at most 200), each with its `fileCount`, `hasPassword`, `expiresAt`, `revoked` flag and `createdAt`. The bundle URL and token are not included — they are shown only once, at creation time. Revoke a bundle with `DELETE /v1/share-links/{bundleId}`. Requires `buckets:read`.

**Scope:** `buckets:read`. Send the API key as a bearer token; [Scopes](https://docs.dairo.app/concepts/scopes.md) lists what each one reaches.

## Request

```bash title="cURL"
curl "https://api.dairo.app/v1/share-links/bundles" \
  -H "Authorization: Bearer $DAIRO_API_KEY"
```

## Response

`200` Success. Body: `application/json`, [ShareBundleListResponse](https://docs.dairo.app/api-reference/schemas.md#sharebundlelistresponse).

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `object` | string | no |  |
| `data` | array of [ShareBundle](https://docs.dairo.app/api-reference/schemas.md#sharebundle) | no |  |

```json title="200"
{
  "object": "list",
  "data": [
    {
      "object": "share_bundle",
      "id": "string",
      "fileCount": 0,
      "hasPassword": true,
      "expiresAt": "2026-10-19T09:30:00Z",
      "revoked": true,
      "createdAt": "2026-10-19T09:30:00Z"
    }
  ]
}
```

## Errors

Every error has the same body, `{"error": {"type", "code", "message", "param"}}`; branch on `code`. [Errors](https://docs.dairo.app/concepts/errors.md) lists every code.

| Status | Meaning |
| --- | --- |
| `400` | The request is malformed or a value is invalid (`invalid_request`, `invalid_domain`, `idempotency_key_mismatch`). |
| `401` | The API key is missing or invalid. |
| `403` | The key lacks the scope this endpoint needs (`scope_missing`) or may not do this (`not_permitted`). |
| `404` | No such resource in this account (`resource_not_found`). |
| `429` | Rate limit, plan limit, budget or spend cap reached (`rate_limited`, `plan_limit_reached`, `budget_exceeded`, `spend_cap_reached`). |
| `500` | An unexpected error; retry with backoff, then contact support (`internal_error`). |

## Related topics

- [List storage buckets](https://docs.dairo.app/api-reference/dairo-api/buckets/list-buckets.md)
- [Create a storage bucket](https://docs.dairo.app/api-reference/dairo-api/buckets/create-bucket.md)
- [Retrieve a storage bucket](https://docs.dairo.app/api-reference/dairo-api/buckets/get-bucket.md)
- [Update a bucket](https://docs.dairo.app/api-reference/dairo-api/buckets/patch-bucket.md)
- [Delete a bucket](https://docs.dairo.app/api-reference/dairo-api/buckets/delete-bucket.md)
- [List objects in a bucket](https://docs.dairo.app/api-reference/dairo-api/buckets/list-bucket-objects.md)
- [Start an object upload](https://docs.dairo.app/api-reference/dairo-api/buckets/create-bucket-object.md)
- [Finalize an object upload](https://docs.dairo.app/api-reference/dairo-api/buckets/finalize-bucket-object.md)
- [Get an object download URL](https://docs.dairo.app/api-reference/dairo-api/buckets/get-bucket-object-download-url.md)
- [Delete a bucket object](https://docs.dairo.app/api-reference/dairo-api/buckets/delete-bucket-object.md)
- [List an object's share links](https://docs.dairo.app/api-reference/dairo-api/buckets/list-share-links.md)
- [Create a secure share link](https://docs.dairo.app/api-reference/dairo-api/buckets/create-share-link.md)
- [Revoke a share link](https://docs.dairo.app/api-reference/dairo-api/buckets/revoke-share-link.md)
- [List a share link's opens](https://docs.dairo.app/api-reference/dairo-api/buckets/list-share-link-opens.md)
- [Bulk-delete objects from a bucket](https://docs.dairo.app/api-reference/dairo-api/buckets/batch-delete-bucket-objects.md)
- [Create a share bundle](https://docs.dairo.app/api-reference/dairo-api/buckets/create-share-bundle.md)
- Previous: [Create a share bundle](https://docs.dairo.app/api-reference/dairo-api/buckets/create-share-bundle.md)
- Next: [List contacts](https://docs.dairo.app/api-reference/dairo-api/contacts/list-contacts.md)