Skip to main content
GET
/
v1
/
inboxes
List inbox threads
curl --request GET \
  --url https://openapi.enginy.ai/v1/inboxes \
  --header 'x-api-key: <api-key>'
{
  "data": [
    {
      "contactId": 123,
      "latestConversationId": 456,
      "firstName": "Alicia",
      "lastName": "Stone",
      "fullName": "Alicia Stone",
      "email": "alicia@northstar.io",
      "companyId": 77,
      "companyName": "Northstar",
      "companyDomain": "northstar.io",
      "senderIdentityIds": [
        14
      ],
      "channels": [
        "EMAIL"
      ],
      "unreadMessagesCount": 2,
      "lastActivityAt": "2026-03-20T09:41:12.000Z",
      "summary": "Thanks, this looks interesting. Can you send pricing?",
      "tags": [
        {
          "id": 5,
          "name": "Hot lead",
          "color": "#F97316"
        }
      ]
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 25,
    "total": 1
  }
}

Authorizations

x-api-key
string
header
required

Query Parameters

page
integer

1-based page number. Defaults to 1.

Example:

1

pageSize
integer

Number of threads per page. Defaults to 25. Maximum is 100.

Required range: x <= 100
Example:

25

Free-text search across contact name, company name, email, and recent message content.

Example:

"pricing northstar"

senderIdentityId
integer

Scope the inbox to one sender identity when the same contact appears in multiple sender mailboxes.

Example:

14

archived
boolean

Return archived threads instead of active ones. Defaults to false.

Example:

false

Response

Successful response with paginated inbox threads

data
object[]
required
meta
object
required