---
title: "Get data export"
method: GET
path: "/data-exports/{data_export_id}"
tags: ["dataexports"]
---

# Get data export

`GET /data-exports/{data_export_id}`

## Path parameters

- `data_export_id` string, required

## Response `200`

OK

- object
  - `data` DataExportResponseData, required
    - `account_id` string, required
    - `created_at` string, date-time, required
    - `environment_id` string, required
    - `export_type` 'audit-log' | 'company-feature-usage', required
    - `id` string, required
    - `metadata` union
      - object
        - `company_ids` string[], nullable — Restrict the export to these Schematic company IDs (starting with 'comp_')
        - `credit_type_ids` string[], nullable — Restrict the export to companies with these billing credit type IDs
        - `export_type` 'company-feature-usage', required — Discriminator: always "company-feature-usage" for this variant
        - `feature_ids` string[], required — Schematic feature IDs (starting with 'feat_') to include as usage columns; at least one is required
        - `has_scheduled_downgrade` boolean, nullable — Restrict the export to companies that do (or do not) have a scheduled downgrade
        - `monetized_subscriptions` boolean, nullable — Restrict the export to companies with (or without) a monetized subscription
        - `notification_email_recipient_email_addresses` string[] — Account member emails to notify when the export completes; empty means the artifact is only retrievable via the API
        - `plan_id` string, nullable — Restrict the export to companies on this plan ID (starting with 'plan_')
        - `plan_ids` string[], nullable — Restrict the export to companies on any of these plan IDs
        - `plan_version_id` string, nullable — Restrict the export to companies on this plan version ID
        - `q` string, nullable — Free-text search over company name and keys
        - `subscription_statuses` string[], nullable — Restrict the export to companies whose subscription has one of these statuses
        - `subscription_types` string[], nullable — Restrict the export to companies whose subscription has one of these types
        - `with_entitlement_for` string, nullable — Restrict the export to companies that have an entitlement for this feature ID
        - `with_subscription` boolean, nullable — Restrict the export to companies with a subscription
        - `without_feature_override_for` string, nullable — Restrict the export to companies without a company-level override for this feature ID
        - `without_plan` boolean, nullable — Restrict the export to companies without a plan
        - `without_subscription` boolean, nullable — Restrict the export to companies without a subscription
      - object
        - `actor_type` string, nullable — Restrict the export to audit log entries from this actor type
        - `end_time` string, date-time, nullable — Restrict the export to audit log entries that started before this time
        - `export_type` 'audit-log', required — Discriminator: always "audit-log" for this variant
        - `notification_email_recipient_email_addresses` string[] — Account member emails to notify when the export completes; empty means the artifact is only retrievable via the API
        - `q` string, nullable — Free-text search over audit log entries
        - `start_time` string, date-time, nullable — Restrict the export to audit log entries that started at or after this time
    - `output_file_type` 'csv' | 'csv.gz', required
    - `status` 'failure' | 'pending' | 'success', required
    - `updated_at` string, date-time, required
  - `params` object, required — Input parameters

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `500` — Server error

## Changes

- **2026-07-18** `6b2406b99a15` — 1 warning
  - added the new `csv.gz` enum value to the `data/output_file_type` response property for the response status `200`
- **2026-07-18** `e295980b3638` — 3 breaking, 1 info
  - the response property `data/metadata` became optional for the status `200`
  - added `#/components/schemas/CompanyFeatureUsageExportMetadata, #/components/schemas/AuditLogExportMetadata` to the `data/metadata` response property `oneOf` list for the response status `200`
  - the `data/metadata` response's property type/format changed from `string`/`` to `object`/`` for status `200`
  - added discriminator to `data/metadata` response property for the response status `200`
- **2026-07-17** `9e8517b90ffd` — 1 warning
  - added the new `audit-log` enum value to the `data/export_type` response property for the response status `200`
- **2026-07-16** `ae246bb663d6` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/schematichq/apis/schematic-api/changes/data-exports/:data_export_id/get.md)

---

[API](https://skmtc.dev/schematichq/apis/schematic-api.md) · [All operations](https://skmtc.dev/schematichq/apis/schematic-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/schematichq/schematic-api/revisions/478f08b8fada/schema)