List read receipts

Returns read receipts for a chat.

GET /v1/receipts

List read receipts

cURL

curl --request GET \
  --url https://api.messages.dev/v1/receipts \
  --header 'Authorization: Bearer <token>'

200

{
  "data": [
    {
      "id": "<string>",
      "chat_id": "<string>",
      "handle": "<string>",
      "last_read_at": 123,
      "synced_at": 123
    }
  ],
  "has_more": true,
  "next_cursor": "<string>",
  "request_id": "<string>"
}

Authorizations

Authorization · string · header · required

Use an API key as a bearer token: Authorization: Bearer sk_live_...

Each key has a set of scopes that gate which endpoints it can call: messages:read, messages:write, chats:read, lines:read, reactions:read, reactions:write, typing:read, typing:write, receipts:read, receipts:write, webhooks:read, webhooks:write, outbox:read, files:read, files:write. Keys can also be restricted to a subset of lines.

Query Parameters

from · string · required

Line handle (phone number or Apple ID)

Example:

"[phone]"

to · string · required

Chat identifier (phone number, Apple ID, or chat ID)

Example:

"[phone]"

Response

200

application/json

List of read receipts

data · object[]

Show child attributes

has_more · boolean

Whether more items exist beyond this page

next_cursor · string | null

Cursor to pass as cursor query parameter for the next page

request_id · string