---
title: "List data exports"
method: GET
path: "/data-exports"
tags: ["dataexports"]
---

# List data exports

`GET /data-exports`

## Query parameters

- `export_type` 'audit-log' | 'company-feature-usage' | 'event'
- `status` 'failure' | 'pending' | 'success'
- `limit` integer — Page limit (default 100)
- `offset` integer — Page offset (default 0)

## 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' | 'event', 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[] — Schematic feature IDs (starting with 'feat_') to include as usage columns; empty means no usage columns
        - `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
        - `sort_order_column` string, nullable — Column to sort the exported rows by (e.g. name, created_at, plan); defaults to name
        - `sort_order_direction` 'asc' | 'desc', nullable — Direction to sort the exported rows by; defaults to asc
        - `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
        - `visible_columns` string[], nullable — Company columns to include, mirroring the companies list; omit to include the plan column only
        - `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
      - object
        - `company_id` string, nullable — Restrict the export to events for this company ID (starting with 'comp_')
        - `end_time` string, date-time, nullable — Restrict the export to events captured at or before this time
        - `event_subtype` string, nullable — Restrict the export to track events with this subtype
        - `event_types` string[], nullable — Restrict the export to these event types (e.g. "track", "identify"); defaults to track, identify and inference events. Flag check events are only exported when requested here explicitly, and require a flag_id.
        - `export_type` 'event', required — Discriminator: always "event" for this variant
        - `flag_id` string, nullable — Restrict the export to flag-check events for this flag ID (starting with 'flag_')
        - `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
        - `start_time` string, date-time, nullable — Restrict the export to events captured at or after this time
        - `user_id` string, nullable — Restrict the export to events for this user ID (starting with 'user_')
    - `output_file_type` 'csv' | 'csv.gz', required
    - `status` 'failure' | 'pending' | 'success', required
    - `updated_at` string, date-time, required
  - `params` object, required — Input parameters
    - `export_type` 'audit-log' | 'company-feature-usage' | 'event'
    - `limit` integer — Page limit (default 100)
    - `offset` integer — Page offset (default 0)
    - `status` 'failure' | 'pending' | 'success'

## Other responses

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

---

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