---
title: "List Bulk Sendings"
method: GET
path: "/api/v1/bulk_sends"
tags: ["Bulk Send"]
---

# List Bulk Sendings

`GET /api/v1/bulk_sends`

Returns information about the Bulk Send.

## Query parameters

- `user_email` string, email — The email address of the user that sent the Bulk Send. Must have the `admin` or `manager` role to view Bulk Sends of other users. Defaults to the user that the API key belongs to.
- `limit` integer — The number of documents to fetch. Defaults to 10, max is 50.
- `page` integer — The page number for pagination. Defaults to the first page.
- `api_application_id` string, uuid — Unique identifier for API Application settings to use. API Applications are optional and mainly used when isolating OAuth apps or for more control over embedded API settings

## Response `200`

successful

- BulkSendListResponse — List of bulk sends with pagination
  - `bulk_sends` BulkSendListItem[], required
    - `id` string, uuid, required
    - `name` string, required
    - `api_application_id` string, uuid, nullable
    - `documents_count` integer, required
    - `documents_completed` integer, required
    - `documents_not_completed` integer, required
    - `created_at` string, date-time, required
    - `user_id` string, uuid, nullable
    - `status` string, required
    - `template_ids` string[], required
  - `current_page` integer, required
  - `next_page` integer, nullable
  - `previous_page` integer, nullable
  - `total_count` integer, required
  - `total_pages` integer, required

## Other responses

- `401` — unauthorized
- `429` — rate limit exceeded

---

[API](https://skmtc.net/signwell/apis/signwell-developer-api.md) · [All operations](https://skmtc.net/signwell/apis/signwell-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/signwell/signwell-developer-api/revisions/debef5796b62/schema)