Data Export API
The Data Export API allows authenticated access to conversation and message data, enabling you to integrate this data into your own systems.
Common use cases include:
- Business Intelligence: Analyze conversation data using your preferred BI tools.
- Compliance: Retain permanent copies of conversations in your internal storage to meet compliance requirements.
- Customer Requests: Retrieve conversation data to fulfill customer requests, such as those required under GDPR.
Rate Limits
The Data Export API adheres to our global rate limits. Additionally, it has specific limits of 10 requests per second per endpoint.
Query Constraints
Page size limitations: A maximum of 10,000 records per page.
Date range limitations: A query’s end date cannot be more than 60 days after its start date.
Historical Data Access
The Data Export API provides access to data from the past 12 months.
Data Freshness
Conversation data from the Conversations endpoint is available in real time. You can query for conversations as soon as they are created or updated — there is no ingestion delay.
Message data from the Messages endpoint is still subject to a processing delay and may take 24 to 48 hours to be fully ingested. Real-time availability for messages is coming soon.
If you are querying messages, wait until the 48-hour window has passed to ensure your query captures the full range of data. For example, to retrieve message data for the period from Feb 9 00:00:00 to Feb 9 23:59:59, run the query on or after Feb 11 00:00:00.
