Get a company

Retrieve a single company by its ID.

GET /companies/{id}

Get a company

cURL

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

200

{
  "company": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Eve Corp",
    "address": "123 Main St, New York, NY",
    "source": null,
    "tags": [],
    "created_at": "2025-03-15T10:30:00.000Z",
    "updated_at": "2025-03-15T10:30:00.000Z"
  }
}

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 company to retrieve. You can get the company id by listing all companies using our List all companies API.

Response

200 - application/json

Successfully retrieved the company.

company · object

Hide child attributes

company. id · string

Unique identifier for the company.

company. name · string

Name of the company.

company. address · string | null

Address of the company.

company. source · string | null

Source of the company.

company. tags · object[]

Tags associated with the company.

Hide child attributes

company.tags. id · string

Unique identifier for the tag.

company.tags. name · string

Name of the tag.

company.tags. style · string

Style/color of the tag.

company. created_at · string<date-time>

Timestamp when the company was created.

company. updated_at · string<date-time>

Timestamp when the company was last updated.