Skip to main content
GET
/
threads
List threads
curl --request GET \
  --url https://inboxapp.com/api/v1/threads \
  --header 'Authorization: Bearer <token>'
{
  "threads": [
    {
      "id": "<string>",
      "platform": "twitter",
      "platformId": "<string>",
      "done": true,
      "assigneeId": "df6jbw4h36...",
      "lastMessageTimestamp": "2025-08-22T12:00:00.000Z",
      "computedSortTimestamp": "2025-08-22T12:00:00.000Z",
      "createdAt": "2023-11-07T05:31:56Z",
      "status": "active",
      "variant": "unencrypted",
      "accountLinkId": "<string>",
      "isSyncing": true,
      "isRequest": true,
      "typingIndicatorsEnabled": true,
      "lastMessage": {
        "id": "<string>",
        "content": "<string>",
        "authorId": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "userId": "df6jbw4h36...",
        "campaignId": "df6jbw4h36..."
      },
      "prospect": {
        "platform": "twitter",
        "platformId": "<string>",
        "externalId": "l44e15irdq4db30i77cgphhx",
        "documentId": 858224163,
        "displayName": "<string>",
        "username": "<string>",
        "handle": "<string>",
        "image": "https://pbs.twimg.com/profile_images/1954360649393295360/rwp-vVt6.jpg",
        "imageNormalized": "https://pbs.twimg.com/profile_images/1954360649393295360/rwp-vVt6.jpg",
        "bio": "Social Selling CRM Close deals faster, stay organized, and never miss an opportunity. Starting with X",
        "location": "San Francisco, CA",
        "profileUrl": "<string>",
        "websiteUrl": "https://inboxapp.com",
        "websiteDomain": "inboxapp.com",
        "verified": "none",
        "profileType": "personal",
        "isProtected": true,
        "followerCount": 123,
        "followingCount": 123,
        "postCount": 123,
        "engagementCount": 2613,
        "listedCount": 18,
        "platformCreatedAt": "2022-09-03T17:58:06.000Z",
        "firstSeenAt": "2024-07-09T14:08:49.000Z",
        "lastUpdatedAt": "2023-11-07T05:31:56Z",
        "lastEnrichedAt": "2025-11-10T18:03:16.000Z",
        "lastActiveAt": "2025-11-10T12:00:00.000Z",
        "source": "cached",
        "isFresh": true,
        "isStale": true,
        "confidence": 0.5,
        "platformData": {
          "isVerifiedBlue": true,
          "isVerifiedGold": true,
          "isVerifiedGray": true,
          "professionalCategory": "986",
          "urlEntities": [
            {
              "url": "<string>",
              "expandedUrl": "<string>",
              "displayUrl": "<string>",
              "indices": [
                123,
                123
              ]
            }
          ],
          "bannerUrl": "https://pbs.twimg.com/profile_banners/1566123362161725440/1753273968",
          "tweetsCount": 123,
          "favoritesCount": 123,
          "rawData": {}
        },
        "context": {
          "tags": [
            "<string>"
          ],
          "statusId": "df6jbw4h36...",
          "valuation": 599,
          "notes": "This prospect is a potential customer."
        }
      }
    }
  ],
  "nextCursor": {
    "timestamp": "2023-11-07T05:31:56Z",
    "id": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
accountLinkIds
string[] | null

Filter by specific account links. Omit to include all accounts, or provide an array of account link IDs to filter by specific accounts.

Pattern: ^[0-9a-z]+$
​
cursorId
string

The ID of the thread to start pagination from. Must be used together with cursorTimestamp. Cannot be combined with the cursor object parameter.

Pattern: ^[0-9a-z]+$
​
cursorTimestamp
string<date-time>

The timestamp of the thread to start pagination from. Must be used together with cursorId. Cannot be combined with the cursor object parameter.

Example:

"2025-11-10T18:03:16.000Z"

​
cursor
object

Pagination cursor using bracket notation. Omit to start from the beginning. Prefer using cursorId and cursorTimestamp instead for simpler query string encoding.

​
inbox
enum<string>

Inbox view to filter threads. 'default' shows active threads, 'no-reply' shows threads awaiting response, 'requests' shows message requests, 'archived' shows archived threads.

Available options:
default,
no-reply,
requests,
archived
Examples:

"default"

"no-reply"

"requests"

"archived"

​
filters
object

Advanced filtering options for threads. Pass null or omit to disable all filters.

​
limit
integer
default:20

Maximum number of threads to return per page. Defaults to 20, maximum 100.

Required range: 1 <= x <= 100
Example:

20

Response

200 - application/json

OK

​
threads
object[]
required
​
nextCursor
object
required