---
title: "Create an activity data job"
method: POST
path: "/activity-data-jobs"
tags: ["Activity Data"]
---

# Create an activity data job

`POST /activity-data-jobs`

Exports your organization's activity data for a time range.

The job runs asynchronously — poll
`GET /activity-data-jobs/{jobId}`
until `status` is `success`, then use the returned download URLs.

Note this endpoint lives on the **accounts host**, not on your regional API
base URL, and there is no `/v3` in the path.

Requires the **Admin** or **Superadmin** role.

## Request body

- object
  - `categories` string[], required — Which data to export. No duplicates.
  - `format` 'csv' | 'parquet', required
  - `startTime` string, required — Start of the range. Must be after your account was created.
  - `endTime` string, required — End of the range. Must be after `startTime`, and can't be in the future or cover data that isn't ready yet. The range must be under 60 days.

## Response `201`

The job was created.

- object
  - `id` string

## Other responses

- `400` — The request is malformed or a parameter failed validation.
- `401` — The token is missing, malformed or expired.
- `403` — You aren't an admin, or activity data isn't available for your account.

---

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