---
updatedAt: 2026-08-19T02:39:44.000Z
agentTools:
  projectIndex: https://docs.delivr.ai/llms.txt
---

# List exports

Returns the exports in a project under the API key's organization.

# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "Exports",
    "description": "Create a scheduled export that delivers audience or event data to a saved integration (S3, DelivrDSP, email, Slack, HubSpot, or Salesforce).\n\nOne call creates the export and its destination together, so you never end up with an export that has nowhere to deliver. The export `query` selects what to send; the `destination` says where and in what shape, and references a saved integration by id (manage those under **Integrations**).\n\nAn export can deliver to up to 5 destinations. Add more at create time with `additional_destinations`, or add one to an existing export later with `POST /api/v1/exports/{id}/destinations`, and change one with `PUT /api/v1/exports/{id}/destinations/{destinationId}`. Each run is billed once for the data it produces, no matter how many destinations receive it; when an export's destinations use different products, the run is billed at the highest-priced one, for the largest record count any billable destination received. DelivrDSP deliveries are not billed as data.\n\n**Authentication:** organization API key (`X-Api-Key` + `X-Api-Secret`).\n\n**Base URL:** `https://api.delivr.ai`\n",
    "version": "1.0",
    "contact": {
      "name": "Delivr.ai Support",
      "url": "https://delivr.ai"
    }
  },
  "servers": [
    {
      "url": "https://api.delivr.ai",
      "description": "Production"
    }
  ],
  "security": [
    {
      "ApiKeyAuth": [],
      "ApiSecretAuth": []
    }
  ],
  "tags": [
    {
      "name": "Exports",
      "description": "Create, list, read, update, and delete exports. Create and update compose the export and its delivery destination together."
    }
  ],
  "paths": {
    "/api/v1/exports": {
      "get": {
        "operationId": "listExports",
        "tags": [
          "Exports"
        ],
        "summary": "List exports",
        "description": "Returns the exports in a project under the API key's organization.",
        "parameters": [
          {
            "name": "project_id",
            "in": "query",
            "description": "Filter by project (UUID). Preferred scope.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "organization_id",
            "in": "query",
            "description": "Filter by organization (UUID). Used when `project_id` is absent.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The matching exports.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Export"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing `project_id`/`organization_id`, or an invalid UUID.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key / secret."
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Api-Key",
        "description": "Organization API key (`dlvr_` prefixed), created in the dashboard at `https://app.delivr.ai/{org_id}/settings/api-keys`. Must be paired with the `X-Api-Secret` header."
      },
      "ApiSecretAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Api-Secret",
        "description": "Secret half of the organization API key, paired with `X-Api-Key`. Both headers are required on every request."
      }
    },
    "schemas": {
      "Export": {
        "type": "object",
        "required": [
          "id",
          "organization_id",
          "project_id",
          "name",
          "query",
          "status",
          "enabled",
          "created_at",
          "updated_at"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "organization_id": {
            "type": "string",
            "format": "uuid"
          },
          "project_id": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "query": {
            "type": "object",
            "description": "The stored query, including the resolved `destination`."
          },
          "schedule": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "enabled": {
            "type": "boolean"
          },
          "last_run_at": {
            "type": "string",
            "description": "Most recent run time (UTC, RFC3339)."
          },
          "last_run_status": {
            "type": "string"
          },
          "end_date": {
            "type": "string",
            "description": "`YYYY-MM-DD` (UTC)."
          },
          "run_time": {
            "type": "string",
            "description": "`HH:MM` in `run_timezone`."
          },
          "run_day_of_week": {
            "type": "integer",
            "minimum": 0,
            "maximum": 6
          },
          "run_timezone": {
            "type": "string",
            "description": "IANA time zone the schedule is local to. Absent for a schedule stored in UTC."
          },
          "archived_at": {
            "type": "string"
          },
          "auto_disabled_reason": {
            "type": "string",
            "description": "Why the system paused the export, e.g. `integration_connection_failed`."
          },
          "created_at": {
            "type": "string",
            "description": "Creation timestamp (UTC, RFC3339)."
          },
          "updated_at": {
            "type": "string",
            "description": "Last-update timestamp (UTC, RFC3339)."
          }
        }
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "string",
            "description": "Error message."
          }
        }
      }
    }
  }
}
```