Companies
The Company object is used to represent a company within the HRIS / Payroll system.
Properties

idUUID
Required

remote_idString
Optional
The third-party API ID of the matching object.

created_atDateTime (ISO 8601)
Required
The datetime that this object was created by Merge.

modified_atDateTime (ISO 8601)
Required
The datetime that this object was modified by Merge.

legal_nameString
Optional
The company's legal name.

display_nameString
Optional
The company's display name.

einsArray
Optional
The company's Employer Identification Numbers.

remote_was_deletedBoolean
Required
Indicates whether or not this object has been deleted in the third party platform.

field_mappingsObject
Optional

remote_dataRemoteData[]
Optional


GET
/companies

https://api.merge.dev/api/hris/v1/companies

US
EU
APAC

Returns a list of Company objects.


Query & Path Parameters

created_afterDateTime (ISO 8601)
Optional
If provided, will only return objects created after this datetime.

created_beforeDateTime (ISO 8601)
Optional
If provided, will only return objects created before this datetime.

cursorString
Optional
The pagination cursor value.

include_deleted_dataBoolean
Optional
Whether to include data that was marked as deleted by third party webhooks.

include_remote_dataBoolean
Optional
Whether to include the original data Merge fetched from the third-party to produce these models.

modified_afterDateTime (ISO 8601)
Optional
If provided, only objects synced by Merge after this date time will be returned.

modified_beforeDateTime (ISO 8601)
Optional
If provided, only objects synced by Merge before this date time will be returned.

page_sizeInteger
Optional
Number of results to return per page.

remote_idString
Optional
The API provider's ID for the given object.

Field support by integration
See all supported fields
Use the /linked-accounts endpoint to pull platform support information
7shifts
7shifts
ADP Workforce Now
ADP Workforce Now
AlexisHR
AlexisHR
Altera Payroll
Altera Payroll
Breathe
Breathe
Charlie
Charlie
ChartHop
ChartHop
Deel
Deel
Employment Hero
Employment Hero
Gusto
Hailey HR
Hailey HR
Hibob
Hibob
HR Partner
HR Partner
Humaans
Humaans
Insperity Premier
Insperity Premier
IntelliHR
IntelliHR
JumpCloud
JumpCloud
Justworks
Justworks
Kenjo
Kenjo
Lucca
Lucca
Namely
Namely
Nmbrs
Nmbrs
Officient
Officient
Okta
Okta
OneLogin
OneLogin
OysterHR
OysterHR
PayCaptain
PayCaptain
Paychex
Paychex
Paycom
Paycom
Paycor
Paycor
PayFit
PayFit
Paylocity
Paylocity
PeopleHR
PeopleHR
Proliant
Proliant
Rippling
Rippling
SAP SuccessFactors
SAP SuccessFactors
Sesame
Sesame
TriNet
TriNet
TriNet HR Platform
TriNet HR Platform
UKG Pro
UKG Pro
UKG Ready
UKG Ready
Workday
Workday
GET
/companies/{id}

https://api.merge.dev/api/hris/v1/companies/{id}

US
EU
APAC

Returns a Company object with the given id.


Query & Path Parameters

idUUID
Required

include_remote_dataBoolean
Optional
Whether to include the original data Merge fetched from the third-party to produce these models.
Field support by integration
See all supported fields
Use the /linked-accounts endpoint to pull platform support information
7shifts
7shifts
ADP Workforce Now
ADP Workforce Now
AlexisHR
AlexisHR
Altera Payroll
Altera Payroll
Breathe
Breathe
Charlie
Charlie
ChartHop
ChartHop
Deel
Deel
Employment Hero
Employment Hero
Gusto
Hailey HR
Hailey HR
Hibob
Hibob
HR Partner
HR Partner
Humaans
Humaans
Insperity Premier
Insperity Premier
IntelliHR
IntelliHR
JumpCloud
JumpCloud
Justworks
Justworks
Kenjo
Kenjo
Lucca
Lucca
Namely
Namely
Nmbrs
Nmbrs
Officient
Officient
Okta
Okta
OneLogin
OneLogin
OysterHR
OysterHR
PayCaptain
PayCaptain
Paychex
Paychex
Paycom
Paycom
Paycor
Paycor
PayFit
PayFit
Paylocity
Paylocity
PeopleHR
PeopleHR
Proliant
Proliant
Rippling
Rippling
SAP SuccessFactors
SAP SuccessFactors
Sesame
Sesame
TriNet
TriNet
TriNet HR Platform
TriNet HR Platform
UKG Pro
UKG Pro
UKG Ready
UKG Ready
Workday
Workday