List Contacts

GEThttps://api.inboxjot.com/v1/contacts

Lists the contacts of the workspace, newest first, with the exact total. Needs a Full key. A key limited to one domain answers 403.

Lists are paged with cursors. Read next_cursor and send it as after for the next page. A page has 50 items unless you set per_page, up to 100.

GET/v1/contacts

1
2

curl -X GET https://api.inboxjot.com/v1/contacts \
  -H "Authorization: Bearer $INBOXJOT_API_KEY"

{
  "data": [
    {
      "id": "con_06d2mfk8r9wq3zh5ka2pe",
      "email": "suhasinee@example.com",
      "first_name": "Suhasinee",
      "last_name": null,
      "properties": {
        "plan": "pro"
      },
      "status": "subscribed",
      "is_suppressed": false,
      "segments": [
        {
          "id": "seg_06d2mfk8r2kd7fq4mx9ab",
          "name": "Customers"
        }
      ],
      "last_activity": {
        "type": "opened",
        "at": "2026-10-21T09:14:40.000Z"
      },
      "created_at": "2026-09-03T14:22:10.000Z"
    }
  ],
  "prev_cursor": null,
  "next_cursor": null,
  "total": 1
}

Returns a page of contacts.

Query Parameters

querystring

Text to find in the address or name, up to 200 characters.

statusstring

subscribed, pending or unsubscribed.

segment_idstring

Keeps the contacts in this segment.

sortstring

added, contact or last_activity. Defaults to added.

directionstring

asc or desc. Defaults to desc.

per_pageinteger

How many items to return, from 1 to 100. Defaults to 50.

afterstring

A next_cursor from the last page. Returns the items after it.

beforestring

A prev_cursor from the last page. Returns the items before it. When you send both, before wins.

Response

dataobject[]

The contacts on this page.

prev_cursorstring | null

Send it as before to get the page before. null on the first page.

next_cursorstring | null

Send it as after to get the next page. null on the last page.

totalinteger

The exact number of contacts that match the filters, on all pages.

Responses

{ "data": [ { "id": "con_06d2mfk8r9wq3zh5ka2pe", "email": "suhasinee@example.com", "first_name": "Suhasinee", "last_name": null, "properties": { "plan": "pro" }, "status": "subscribed", "is_suppressed": false, "segments": [ { "id": "seg_06d2mfk8r2kd7fq4mx9ab", "name": "Customers" } ], "last_activity": { "type": "opened", "at": "2026-10-21T09:14:40.000Z" }, "created_at": "2026-09-03T14:22:10.000Z" } ], "prev_cursor": null, "next_cursor": null, "total": 1 }