--- title: "Returns a list of conversations." method: GET path: "/v1/conversation_export" --- # Returns a list of conversations. `GET /v1/conversation_export` ## Query parameters - `closed_after` string, date - `closed_before` string, date - `created_after` string, date - `created_before` string, date - `updated_after` string, date - `updated_before` string, date - `last_message_created_after` string, date - `last_message_created_before` string, date - `csids` integer[] ## Response `200` Array of conversations - ConversationInfo[] - `id` integer, required — Id of the conversation - `created_at` integer, required — Timestamp of when the conversation was created - `initial_channel` string, required — The channel through which the communication was established - `requester_id` string, uuid, required — Id of the enduser who requested the conversation - `requester_name` string — Name of the enduser who requested the conversation - `requester_email` string — Email of the enduser who requested the conversation - `requester_additional_emails` string[] — Additional email addresses of the enduser who requested the conversation - `requester_phone_number` string — Phone number of the enduser who requested the conversation - `requester_additional_phone_numbers` string[] — Additional phone numbers of the enduser who requested the conversation - `queued_at` number — Timestamp of when the conversation was queued - `queue_id` string, uuid — Id of the last queue where the conversation was placed - `queue_name` string — Name of the last queue where the conversation was placed - `closed_at` number — Timestamp of when the conversation was closed - `rating_score` 0 | 1 — Rating score. This field is only relevant if you have set up the thumbs up/down ratings - `rating_message` string — Rating message associated with the rating score. This field is only relevant if you have set up the thumbs up/down ratings - `ratings` Rating[] - `rating_score` integer — Rating score. Score will be 0 or 1 for thumbs up & down ratings or 1-5 for new CSAT ratings - `rating_message` string — Rating message associated with the rating score - `rating_type` string — Rating type associated with the rating score - `rating_created_timestamp` integer — Timestamp of when the CSAT was created - `rating_offered_timestamp` integer — Timestamp of when the CSAT was offered - `rating_status` string — Status associated with the rating - `rating_language` string — Language set for the conversation - `rating_modified_timestamp` integer — Timestamp of when the rating was lastly modified - `rating_rated_timestamp` integer — Timestamp of when the conversation was rated - `rating_scheduled_timestamp` integer — Timestamp of when the CSAT was scheduled - `rating_scheduled_for_timestamp` integer — Timestamp of when the CSAT was scheduled for - `rating_unscheduled_timestamp` integer — Timestamp of when the CSAT was unscheduled - `rating_cancelled_timestamp` integer — Timestamp of when the CSAT was cancelled - `direction` 'inbound' | 'outbound' — Direction of the conversation - `assigned_at` integer — Timestamp of when the conversation was assigned to an agent - `assignee_id` string, uuid — Id of the agent that the conversation was assigned to - `assignee_name` string — Name of the agent that the conversation was assigned to - `assignee_email` string — Email of the agent that the conversation was assigned to - `assignee_phone_number` string — Phone number of the agent that the conversation was assigned to - `to_provisioned_phone_number_id` string — Called phone number id (for inbound calls), which is the phone number itself - `to_provisioned_phone_number_name` string — Name of the called phone number provided - `total_duration` number — Call duration in seconds if it exists. This is a derived value `closed_at` - `created_at`. For advanced analytics, take a look at our [Analytics API](https://docs.dixa.io/openapi/dixa-api/v1/tag/Analytics/). - `handling_duration` number — Handling duration in seconds. This is a derived value `closed_at` - `assigned_at`. For advanced analytics, take a look at our [Analytics API](https://docs.dixa.io/openapi/dixa-api/v1/tag/Analytics/). - `dixa_email_integration_id` string — Id of the email integration, which is the email address itself - `dixa_email_integration_sender_name` string — Sender name of the email integration, if it exists - `forwarding_email` string — Forwarding email address - `facebook_page_id` string — Page id coming from facebook - `facebook_page_name` string — Page name coming from facebook - `widget_id` string, uuid — Id of the widget that was used - `widget_name` string — Name of the widget that was used - `tags` string[] — All tags associated with the conversation - `tags_info` string[] — All tags info associated with the conversation - `conversation_wrapup_notes` string[] — All notes associated with the conversation - `transferee_name` string — Target entity name of the transfer, which is either a queue or a user - `transfer_time` number — Timestamp of the latest transfer - `originating_country` string — Country the conversation originates from - `updated_at` number — Timestamp of when the conversation was last time updated - `last_message_created_at` number — Timestamp of when the last associated message was created - `status` 'open' | 'closed' | 'pending' | 'awaitingpending' — Status of the conversation - `transferee_number` string — Phone number of the agent to whom the conversation was transferred - `from_provisioned_phone_number_id` string — Calling phone number id (for outbound calls), which is the phone number itself - `from_provisioned_phone_number_name` string — Name of the calling phone number provided - `subject` string — Subject field (for email and contact form) - `anonymized_at` number — Timestamp of when the conversation was anonymized - `custom_fields` CustomAttribute[] - `attribute_id` string, uuid — Custom attribute UUID - `identifier` string — Custom attribute identifier - `value` string — The custom attribute value set for the conversation - `data_type` string — Custom attribute type - `archived` boolean — Whether the custom attribute has been archived - `exports_handling_duration` number — Cumulative assignment time across all agents that handled the conversation (in seconds). Can be different from `handling_duration`. This value corresponds to the handling_duration field in the "Integrations -> Export Conversations" CSV file. - `link_type` 'email_forward' | 'follow_up' | 'side' | 'related' — Type of link associated with the conversation - `linked_at` integer — Timestamp of when the conversation was linked - `linked_to` integer — ID of the conversation this conversation is linked to ## Other responses - `400` — Invalid query parameters - `401` — Invalid or missing credentials - `429` — API limit has been reached - `5XX` — Internal error --- [API](https://skmtc.dev/dixa/apis/exports-api.md) · [All operations](https://skmtc.dev/dixa/apis/exports-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dixa/exports-api/revisions/286aee55f976/schema)