---
title: "Submit bulk topic file or list"
method: POST
path: "/bulk"
---

# Submit bulk topic file or list

`POST /bulk`

Submit a list of `topic_ids` via JSON or upload a CSV file.

**S3 member delivery:**
- JSON requests: set `deliver_to_s3: true` in the body.
- CSV uploads: optionally pass `?deliver_to_s3=true` as a query parameter.

Delivery occurs only if your organization has a valid S3 destination configured.

## Query parameters

- `deliver_to_s3` boolean

## Request body

- object
  - `topic_ids` string[], required
  - `callback_url` string, uri
  - `deliver_to_s3` boolean — Per-request S3 delivery toggle. If true, results are copied to your org's configured S3 under `outgoing/apis/market_pulse/<process_id>/...`. This ORs with the org-level setting.

## Response `202`

Accepted

- BulkSubmitAccepted — Acknowledgement of a submitted bulk job.
  - `process_id` string, uuid, required
  - `status_url` string, uri — Poll this endpoint for status.
  - `state` 'QUEUED' | 'RUNNING' | 'COMPLETE' | 'FAILED'

---

[API](https://skmtc.dev/5x5coop/apis/data-api.md) · [All operations](https://skmtc.dev/5x5coop/apis/data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/5x5coop/data-api/revisions/cc624a5c28fd/schema)