Retrieve Contact

GEThttps://api.inboxjot.com/v1/contacts/{contact_id}

Retrieves one contact with its segments and topics. Look it up by id or by address. Needs a Full key. A key limited to one domain answers 403.

GET/v1/contacts/{contact_id}

1
2

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

{
  "id": "con_06d2mfk8r9wq3zh5ka2pe",
  "email": "sukhamoy@example.com",
  "first_name": "Sukha",
  "last_name": "Moy",
  "status": "subscribed",
  "language": "en",
  "properties": {
    "plan": "pro"
  },
  "segments": [
    {
      "id": "seg_06d2mfk8r2kd7fq4mx9ab",
      "name": "Customers"
    }
  ],
  "topics": [
    {
      "id": "top_06d2mfk8r6pn2tc8yw3hd",
      "name": "Product Updates",
      "status": "subscribed",
      "subscribed": true
    }
  ],
  "created_at": "2026-10-12T09:41:07.000Z",
  "updated_at": "2026-10-15T14:02:33.000Z"
}

Returns the contact.

Path Parameters

contact_idstringrequired

A contact id, or the contact's email address.

Response

idstring

The contact id.

emailstring

The contact address.

first_namestring | null

First name.

last_namestring | null

Last name.

statusstring

One of subscribed, pending or unsubscribed.

languagestring

Language code.

propertiesobject

Property values, keyed by the property key.

segmentsobject[]

The segments the contact is in.

topicsobject[]

Every topic in the workspace, with the contact’s choice.

created_atstring

ISO 8601 time.

updated_atstring

ISO 8601 time.

Responses

{ "id": "con_06d2mfk8r9wq3zh5ka2pe", "email": "sukhamoy@example.com", "first_name": "Sukha", "last_name": "Moy", "status": "subscribed", "language": "en", "properties": { "plan": "pro" }, "segments": [ { "id": "seg_06d2mfk8r2kd7fq4mx9ab", "name": "Customers" } ], "topics": [ { "id": "top_06d2mfk8r6pn2tc8yw3hd", "name": "Product Updates", "status": "subscribed", "subscribed": true } ], "created_at": "2026-10-12T09:41:07.000Z", "updated_at": "2026-10-15T14:02:33.000Z" }