> ## Documentation Index > Fetch the complete documentation index at: https://docs.conversion.ai/llms.txt > Use this file to discover all available pages before exploring further. # Export Contacts > Bulk, incremental export of contacts, ordered by `updatedAt` ascending. Each contact's fields are flattened under `fields`, keyed by their label. Results are paginated with an opaque cursor returned as `pagination.nextCursor`. Pass it back as `cursor` to fetch the next page; a `null` cursor means there are no more results. Persist the last non-null cursor between syncs to resume. Passing the stored cursor on a later call yields contacts created or updated since. > **Request access.** This endpoint is not enabled by default, contact the Conversion team to request access. Calls from accounts without it return `403 export_not_enabled`. ## OpenAPI ````yaml /openapi.json post /v2/exports/contacts openapi: 3.1.0 info: title: Conversion API version: 2.0.0 description: >- The Conversion API lets you programmatically manage contacts, track custom events, and manage their associated data. servers: - url: https://pub-api.conversion.ai/api security: - apiKey: [] paths: /v2/exports/contacts: post: summary: Export Contacts description: >- Bulk, incremental export of contacts, ordered by `updatedAt` ascending. Each contact's fields are flattened under `fields`, keyed by their label. Results are paginated with an opaque cursor returned as `pagination.nextCursor`. Pass it back as `cursor` to fetch the next page; a `null` cursor means there are no more results. Persist the last non-null cursor between syncs to resume. Passing the stored cursor on a later call yields contacts created or updated since. > **Request access.** This endpoint is not enabled by default, contact the Conversion team to request access. Calls from accounts without it return `403 export_not_enabled`. operationId: exportContacts requestBody: required: false content: application/json: schema: type: object properties: cursor: type: string description: >- The opaque pagination cursor returned as `pagination.nextCursor` by a previous call. Omit (or pass an empty string) on the first call to start from the beginning. An invalid or malformed cursor returns an `invalid_cursor` error. examples: - eyJjcmVhdGVkQXQiOiIyMDI2LTAxLTE1VDEwOjMwOjAwWiJ9 limit: type: integer minimum: 1 maximum: 5000 default: 1000 description: >- The maximum number of contacts to return per page. Defaults to 1000. Values are clamped to the range [1, 5000] rather than rejected; values above 5000 return 5000 results. examples: first-page: summary: First page value: limit: 1000 next-page: summary: Resume from a cursor value: cursor: eyJjcmVhdGVkQXQiOiIyMDI2LTAxLTE1VDEwOjMwOjAwWiJ9 limit: 1000 responses: '200': description: A page of contacts retrieved successfully. content: application/json: schema: type: object properties: data: type: object required: - contacts properties: contacts: type: array description: The current page of exported contacts. items: type: object required: - id - email - subscriptionStatus - createdAt - updatedAt - fields properties: id: type: string format: uuid description: >- The Conversion contact ID. Stable primary key for warehouse upserts. sfdcLeadId: type: - string - 'null' description: >- The contact's Salesforce id when its Salesforce object type is Lead; otherwise `null`. sfdcContactId: type: - string - 'null' description: >- The contact's Salesforce id when its Salesforce object type is Contact; otherwise `null`. sfdcAccountId: type: - string - 'null' description: >- The Salesforce Account id of the contact's linked company, or `null` when the contact has no company or it isn't synced to Salesforce. email: type: string format: email subscriptionStatus: type: string description: >- The contact's email subscription status. In addition to `SUBSCRIBED`, `UNSUBSCRIBED`, and `NO_STATUS`, exported values may include system-managed statuses such as `BOUNCED` or `COMPLAINED`. examples: - SUBSCRIBED createdAt: type: string format: date-time updatedAt: type: string format: date-time fields: type: object additionalProperties: type: string description: >- Every contact field (variable schema) value, keyed by its common name (e.g. `owner_id`). pagination: type: object required: - nextCursor properties: nextCursor: type: - string - 'null' description: >- Opaque cursor for the next page, or `null` when there are no more results. This is the single source of truth for whether more results exist. examples: with-more-pages: summary: More pages available value: data: contacts: - id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 sfdcLeadId: 00Q5f000001AbCdEAE sfdcContactId: null sfdcAccountId: 0015f00000ACMExAAB email: jane@example.com subscriptionStatus: SUBSCRIBED createdAt: '2026-01-15T10:30:00Z' updatedAt: '2026-06-01T08:15:00Z' fields: first_name: Jane owner_id: 0055f000000AbCdEFG pagination: nextCursor: eyJjcmVhdGVkQXQiOiIyMDI2LTA2LTAxVDA4OjE1OjAwWiJ9 last-page: summary: Last page value: data: contacts: - id: f9e8d7c6-b5a4-3210-fedc-ba9876543210 sfdcLeadId: null sfdcContactId: null sfdcAccountId: null email: bob@example.com subscriptionStatus: UNSUBSCRIBED createdAt: '2026-02-20T12:00:00Z' updatedAt: '2026-06-02T09:00:00Z' fields: {} pagination: nextCursor: null '400': description: The request was malformed or contained invalid data. content: application/json: schema: $ref: '#/components/schemas/Error' examples: invalid-cursor: summary: Invalid cursor value: error: code: invalid_cursor message: invalid pagination cursor invalid-business: summary: Invalid business value: error: code: invalid_business message: invalid business id '401': description: Authentication failed. content: application/json: schema: $ref: '#/components/schemas/Error' examples: unauthorized: summary: Missing or invalid API key value: error: code: unauthorized message: API key is required '403': description: The export API is not enabled for this account. content: application/json: schema: $ref: '#/components/schemas/Error' examples: export-not-enabled: summary: Export not enabled value: error: code: export_not_enabled message: business is not authorized to use the export API '500': description: An unexpected server error occurred. content: application/json: schema: $ref: '#/components/schemas/Error' examples: internal: summary: Internal error value: error: code: internal_error message: failed to list contacts components: schemas: Error: type: object properties: error: type: object required: - code - message properties: code: type: string description: A machine-readable error code. examples: - invalid_email message: type: string description: A human-readable error description. examples: - 'invalid email format: not-an-email' securitySchemes: apiKey: type: apiKey in: header name: X-API-Key description: >- Your Conversion API key. Found in **Settings > Integrations** in the dashboard. Format: `sk_live__`. ````