v50

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-2148120293.6 KB

Organization

Company

Read basic company data

get/employer/company

entity_idsstring[]

The entity IDs to specify which entities' data to access. Provide exactly one entity ID per request; a maximum of one is accepted.

[
  "550e8400-e29b-41d4-a716-446655440000"
]

Finch-API-Versionstring date required

Header used to specify the version for a given API request. Current version is 2020-09-17.

Basic company data

idstring uuid required

A stable Finch id (UUID v4) for the company.

legal_namestring nullable required

The legal name of the company.

primary_emailstring email nullable required

The email of the main administrator on the account.

primary_phone_numberstring nullable required

The phone number of the main administrator on the account. Format: E.164, with extension where applicable, e.g. +NNNNNNNNNNN xExtension

einstring nullable required

The employer identification number.

All 48 operations