Return messages matching the parameters

import requests
url = "https://example.ada.support/api/v2/export/messages"
querystring = {"created_since":"created_since"}
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

{
  "items": [
    {
      "_id": "5d8a7d080afd19b55945c8ab",
      "answer_id": "6392e0f865ba38041ddd5966",
      "answer_title": "Greeting",
      "chatter_id": "6009dd3c81dfae3a4e990acb",
      "conversation_id": "5dba43ebedb828146bc871b6",
      "date_created": "2019-10-31T14:28:02.865000+00:00",
      "link_was_clicked": false,
      "message_data": {
        "_type": "greeting",
        "external_chat_id": "<uuid_v4_id>",
        "reviewable_message": false
      },
      "recipient": "ada",
      "record_last_updated": "2019-10-31T14:28:02.865000+00:00",
      "review": 0,
      "sender": "b9e51eae-5449-4a46-b6ce-aef2dcb4e067",
      "in_response_to": "6392e0f865ba38041ddd5966"
    }
  ],
  "meta": {
    "next_page_uri": "https://example.ada.support/api/v2/export/messages?created_since=2023-07-01T14%3A01%3A16.257000%2B00%3A00&created_to=2023-07-22T00%3A00%3A00%2B00%3A00"
  }
}

Returns a list of message objects along with a next_page_uri if applicable

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

created_sincestringRequiredformat: "date-time"

Return records that were created after this date. If created_to is not specified, only records within 7 days of this timestamp are returned. To retrieve data beyond that window, set created_to explicitly. Must be an ISO 8601 UTC timestamp ending with ‘Z’ (e.g., 2024-07-01T00:00:00Z); required for valid API requests.

conversation_idstring or nullOptionalformat: "id"

Return records with a conversation_id that matches this id

page_sizeintegerOptional100-10000Defaults to 10000

Number of records to return in response. The maximum and default is 10000, the minimum is 100.

created_tostring or nullOptionalformat: "date-time"

Return records that were created earlier than this date. If not specified, this value defaults to 7 days after created_since. Must be an ISO 8601 UTC timestamp ending with ‘Z’ (e.g., 2024-07-01T00:00:00Z); required for valid API requests.

Response

Ada successfully processed the request

itemslist of objects

Records returned from the query

metaobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error