Return messages matching the parameters

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

Headers

AuthorizationstringRequired

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. 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_sizeintegerOptional>=100<=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 or null
Records returned from the query
metaobject or null

Errors