CompaniesGet Single Company

Get Single Company

Retrieve a specific Company identified by its unique ID.

curl -X GET "https://api.getkini.com/companies/1/" \
  -H "Content-Type: application/json" \
  -H "Company-Id: 1" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "id": 1,
  "name": "Example Company GmbH",
  "slug": "example-company-gmbh",
  "ats": "personio",
  "ats_name": "Personio",
  "partner": 1,
  "partner_company_id": "EXT-COMPANY-001",
  "website": "https://www.example.com",
  "logo": "https://www.example.com/logo.png",
  "primary_color": "#1F3A93",
  "street": "Example Street 1",
  "city": "Berlin",
  "country": "Germany",
  "postcode": "10115",
  "job_sync_active": true,
  "candidate_sync_active": true,
  "contact_name": "Jane Doe",
  "contact_email": "jane.doe@example.com",
  "contact_phone": "+49 30 1234567",
  "jobs_last_synced_at": "2026-08-06T04:12:07.118934Z",
  "status": "active",
  "is_test": false,
  "magic_link": "https://app.getkini.com/magic/EXAMPLEmagiclinktoken12345x/",
  "created_at": "2025-11-18T09:24:31.664829Z",
  "updated_at": "2026-07-29T14:03:55.812446Z"
}
GET
/companies/{id}/
GET
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

Authenticate every request with an API key from the Kini Partner App, sent as Authorization: Bearer <your_api_key>.

Authenticate every request with an API key from the Kini Partner App, sent as Authorization: Bearer <your_api_key>.
path
idinteger
Required

Unique Kini ID of the company

header
Company-Idinteger
Required

Kini ID of the company the key is associated with

Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. Authenticate every request with an API key from the Kini Partner App, sent as Authorization: Bearer \<your_api_key\>.

Path Parameters

idinteger
Required

Unique Kini ID of the company

Example:
1

Headers

Company-Idinteger
Required

Kini ID of the company the key is associated with

Example:
1

Responses

idinteger

Unique Kini ID of the company

namestring

Display name of the company

slugstring

URL-friendly slug of the company

atsstring

Slug of the ATS integration the company is linked to. Retrieve the full list of available slugs from List Integrations.

ats_namestring

Human-readable name of the linked ATS

partnerinteger

Kini ID of the owning partner

partner_company_idstring

External identifier of the company in the partner's system

websitestring

Company website URL

logostring

URL of the company logo

primary_colorstring

Hex color used to brand the company's job board

streetstring
citystring
countrystring
postcodestring
job_sync_activeboolean

Whether job synchronisation from the ATS is active for the company. Derived from the company's entitlements, not a stored flag — it cannot be set through this API.

candidate_sync_activeboolean

Whether candidate synchronisation to the ATS is active for the company. Derived from the company's entitlements, not a stored flag — it cannot be set through this API.

contact_namestring
contact_emailstring
contact_phonestring
jobs_last_synced_atstring

Timestamp of the last successful job sync

statusstring

Lifecycle status of the company

Allowed values:invitedrequestedactivefailingdeactivateddeleted
is_testboolean

Whether the company is marked as a test record

magic_linkstring

URL of the active magic link for the company, if any

created_atstring

Timestamp of when the company was first created

updated_atstring

Timestamp of when the company was last updated