Get a contact

Retrieve a single contact by its ID.

GET /contacts/{id}

Get a contact

cURL

curl --request GET \
  --url https://{your-subdomain}.neetocrm.com/api/external/v1/contacts/{id} \
  --header 'X-Api-Key: <x-api-key>'

200

{
  "contact": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Eve",
    "email": "[e-mail]",
    "phone_number": "",
    "created_at": "2025-03-15T10:30:00.000Z",
    "updated_at": "2025-03-15T10:30:00.000Z",
    "owner": null,
    "tags": [],
    "company": {
      "id": null,
      "name": null
    }
  }
}

Replace {your-subdomain} with your workspace’s subdomain.
Learn how to find your subdomain in Identifying your subdomain.

Headers

X-Api-Key · string · required

X-Api-Key is used to authenticate requests using an API key. Provide your API key in this header to access protected endpoints. Refer to Authentication for more information.

Path Parameters

id · string · required

The ID of the contact to retrieve. You can get the contact id by listing all contacts using our List all contacts API.

Response

200 - application/json

Successfully retrieved the contact.

contact · object

Hide child attributes

contact. id · string

Unique identifier for the contact.

contact. name · string

Name of the contact.

contact. email · string | null

Email address of the contact.

contact. phone_number · string | null

Phone number of the contact.

contact. company_id · string | null

Unique identifier of the associated company.

contact. organization_id · string

Unique identifier of the organization.

contact. tag_ids · string[]

IDs of tags associated with the contact.

contact. owner · object

Owner of the contact.

Hide child attributes

contact.owner. id · string

Unique identifier of the owner.

contact.owner. name · string

Name of the owner.

contact.owner. email · string

Email of the owner.

contact. company · object

Associated company.

Hide child attributes

contact.company. id · string

Unique identifier of the company.

contact.company. name · string

Name of the company.

contact. field_values · object[]

Custom field values associated with the contact.

Hide child attributes

contact.field_values. id · string

Unique identifier of the field value.

contact.field_values. field_id · string

Unique identifier of the custom field.

contact.field_values. value · string

Value of the custom field.

contact. created_at · string<date-time>

Timestamp when the contact was created.

contact. updated_at · string<date-time>

Timestamp when the contact was last updated.