---
title: "Create a Retrieval"
method: POST
path: "/data-retrievals/v3.0"
tags: ["Create a Retrieval"]
---

# Create a Retrieval

`POST /data-retrievals/v3.0`

Creates a data retrieval job.

## Query parameters

- `token` string

## Request body

- object
  - `distinct_ids` string[]
  - `compliance_type` string — Select CCPA or GDPR. Default is GDPR.
  - `disclosure_type` string — Only required if compliance_type = CCPA. Can be Data, Categories, or Sources. Default is Data.

## Response `201`

Success

- JobCreated — A JSON response object containing the task_id of the retrieval/deletion job.
  - `status` string, required — The status of the response
  - `results` object, required
    - `task_id` string — The task_id of the retrieval/deletion job.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

---

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