--- updatedAt: 2026-08-21T18:37:58.000Z agentTools: projectIndex: https://docs.apollo.io/llms.txt --- # Export Conversations
Endpoint essentials
API key access api/v1/conversations/export or Master API key
OAuth scopes conversations_export
Credit usage 0–1 credit per conversation
This endpoint consumes 1 Apollo credit per conversation if the conversation has AI insights. Conversations without AI insights consume 0 credits. Learn more about API pricing and credits.
Conversations are prospect video meetings stored in Apollo.

Use the export conversations endpoint to export conversations within a time range. Exports are processed asynchronously and delivered as a gzipped JSON file. A notification email is sent to the specified team member when the export is ready.

To get the download URL once the export is ready, refer to get export. # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "apollo-rest-api", "summary": "Programmatic access to Apollo's sales intelligence and engagement platform — data enrichment, prospect and company search, and go-to-market workflow management.", "description": "The Apollo API provides programmatic access to [Apollo](https://www.apollo.io/), the all-in-one sales intelligence and engagement platform. Use it to enrich people and company data (individually or in bulk), search Apollo's database of over 240 million contacts and 30 million companies, and manage accounts, contacts, deals, sequences, tasks, calls, and conversations in your go-to-market workflows.\n\n## Base URL\n\nAll API requests are made to `https://api.apollo.io/api/v1`.\n\n## Authentication\n\n- **Apollo users** authenticate with an API key passed in the `x-api-key` request header. See [Create API Keys](https://docs.apollo.io/docs/create-api-key).\n- **Apollo partners** building integrations on behalf of mutual users authenticate with the [OAuth 2.0 authorization flow](https://docs.apollo.io/docs/use-oauth-20-authorization-flow-to-access-apollo-user-information-partners).\n\n## Rate limits & credits\n\nRate limits and credit consumption depend on your [Apollo pricing plan](https://docs.apollo.io/docs/api-pricing). Check your current limits and usage with the [view API usage stats and rate limits](https://docs.apollo.io/reference/view-api-usage-stats) endpoint. For more details, see [Rate Limits](https://docs.apollo.io/reference/rate-limits) and the [API FAQs](https://docs.apollo.io/docs/apollo-api-faqs).\n\nNew to the API? Start with the [Apollo API overview](https://docs.apollo.io/reference/apollo-api).", "termsOfService": "https://www.apollo.io/terms/api", "contact": { "name": "Apollo API Support", "url": "https://docs.apollo.io/" }, "version": "1.0" }, "servers": [ { "url": "https://api.apollo.io/api/v1" } ], "tags": [ { "name": "Conversations", "description": "Search, export, and retrieve recorded conversations." } ], "components": { "securitySchemes": { "apiKey": { "type": "apiKey", "in": "header", "name": "x-api-key", "description": "[Recommended] API key, passed in the `x-api-key` request header.\nSee [Create API Keys](https://docs.apollo.io/docs/create-api-key)." }, "bearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT", "description": "OAuth 2.0 access token, used by Apollo partners building integrations.\nSee the [OAuth 2.0 authorization flow](https://docs.apollo.io/docs/use-oauth-20-authorization-flow-to-access-apollo-user-information-partners)." } }, "schemas": { "ErrorDetails": { "type": "object", "description": "Machine-readable detail for an error that uses the new format, returned alongside the endpoint's existing error fields. The legacy error fields at the root level (`error`, `error_code`, `message`, etc) are removed on 2027-02-16, after which `error_details` is the only error payload. Some errors already return `error_details` on its own.", "properties": { "code": { "type": "string", "description": "Stable identifier in the form `DOMAIN.CATEGORY.REASON`. Branch on this value; the human-readable `message` can change.", "example": "AUTH.AUTHENTICATION.CREDENTIALS_MISSING" }, "message": { "type": "string", "description": "Human-readable explanation of what went wrong.", "example": "This request carried no credential Apollo could authenticate." }, "suggestions": { "type": "array", "description": "Ordered, actionable next steps. Each entry carries a `label`, and where relevant the `parameter`, `header`, or `url` it refers to.", "items": { "type": "object", "properties": { "label": { "type": "string", "example": "Send your API key in the X-Api-Key header" }, "url": { "type": "string", "example": "https://docs.apollo.io/reference/authentication" }, "parameter": { "type": "string", "example": "webhook_url" }, "parameters": { "type": "array", "description": "Several parameters, any one of which satisfies the requirement.", "items": { "type": "string" }, "example": [ "name", "domain", "website_url", "linkedin_url" ] }, "header": { "type": "string", "example": "X-Api-Key" }, "example": { "type": "string", "description": "A valid sample value for the parameter named above." }, "retry_after_seconds": { "type": "integer", "description": "On a rate-limit refusal, how long to wait before retrying.", "example": 60 } } } }, "context": { "type": "object", "description": "Values from your request that explain the refusal. Each entry is an object rather than a bare value, so read `context..value`. Absent when the error needs no context.", "additionalProperties": { "type": "object", "properties": { "value": { "type": "string" }, "description": { "type": "string" } } }, "example": { "window": { "value": "hourly", "description": "The rate-limit window your request exceeded" } } } } } } }, "security": [ { "apiKey": [] }, { "bearerAuth": [] } ], "paths": { "/conversations/export": { "post": { "summary": "Export conversations", "description": "## Endpoint essentials\n\n**API key access:** `api/v1/conversations/export` or `Master API key`\n\n**OAuth scopes:** `conversations_export`\n\n**Credit usage:** `0–1 credit per conversation`\n\nThis endpoint consumes 1 Apollo credit per conversation if the conversation has AI insights. Conversations without AI insights consume 0 credits. Learn more about [API pricing and credits](https://docs.apollo.io/docs/api-pricing).\n\nConversations are prospect video meetings stored in Apollo.

Use the export conversations endpoint to export conversations within a time range. Exports are processed asynchronously and delivered as a gzipped JSON file. A notification email is sent to the specified team member when the export is ready.

To get the download URL once the export is ready, refer to get export.", "tags": [ "Conversations" ], "operationId": "export-conversations", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "start_time", "end_time", "email" ], "properties": { "start_time": { "type": "string", "description": "Start of the export time range (ISO 8601). Apollo uses Greenwich Mean Time (GMT) for all date and time values. Must be earlier than end_time.

Example: 2024-01-01T00:00:00Z" }, "end_time": { "type": "string", "description": "End of the export time range (ISO 8601). Apollo uses Greenwich Mean Time (GMT) for all date and time values. Must be later than start_time.

Example: 2024-03-31T23:59:59Z" }, "email": { "type": "string", "description": "Email address of a valid team member to notify when the export is ready." } } }, "examples": { "Export Q1 conversations": { "value": { "start_time": "2024-01-01T00:00:00Z", "end_time": "2024-03-31T23:59:59Z", "email": "alice@example.com" } }, "Export last month": { "value": { "start_time": "2024-02-01T00:00:00Z", "end_time": "2024-02-29T23:59:59Z", "email": "bob@example.com" } } } } } }, "responses": { "200": { "description": "200", "content": { "application/json": { "schema": { "type": "object", "properties": { "export_url": { "type": "string", "example": "https://app.apollo.io/api/v1/conversations/export/6a060f34585b480015951efd" }, "export_id": { "type": "string", "example": "6a060f34585b480015951efd" } } } } } }, "404": { "description": "404", "content": { "application/json": { "examples": { "conversation_not_found": { "value": { "error": "Unable to find conversations within the given time range." } }, "notification_user_not_found": { "value": { "error": "Unable to find user to send notification email to. Please provide an address for a valid user using the email parameter." } } }, "schema": { "type": "object", "properties": { "error": { "type": "string" } } } } } }, "422": { "description": "422", "content": { "application/json": { "examples": { "Invalid start_time": { "value": { "error": "start_time is not a valid ISO-8601 date." } }, "Invalid end_time": { "value": { "error": "end_time is not a valid ISO-8601 date." } }, "Invalid time range": { "value": { "error": "start_time must be less than end_time." } }, "Insufficient credits": { "value": { "error": "Insufficient credits. Please upgrade your plan." } } }, "schema": { "type": "object", "properties": { "error_details": { "$ref": "#/components/schemas/ErrorDetails" }, "error": { "deprecated": true, "description": "Legacy error field. Removed on 2027-02-16, after which `error_details` is the only error payload.", "type": "string" } } } } } } }, "deprecated": false } } }, "x-readme": { "headers": [ { "key": "Cache-Control", "value": "no-cache" }, { "key": "Content-Type", "value": "application/json" } ], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true } ```