Retrieve a company

{ "id": "<id>", "object": "company", "data": { "name": "Cutting-Edge Telecom Solutions", "pay_day_movement_setting": "inherit", "external_ref": null, "preferred_locale": null, "created_at": "2026-01-01T00:00:00.000000Z", "updated_at": "2026-01-01T00:00:00.000000Z" }, "links": { "self": "/companies/<id>" } }

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

company

string

required

Query Parameters

expand

enum<string>[]

Available options:

business_entities,

contractors,

employees,

partner

Response

200 - application/json

string

read-only

The unique identifier of the object in Nmbr.

object

string

read-only

The type of the object in Nmbr ("company").

data

Default · object

Default
With business_entities expanded
With employees expanded
With contractors expanded
With partner expanded

Hide child attributes

data.name

string

The company's name.

data.pay_day_movement_setting

enum<string>

The company-level setting for how pay dates are adjusted when they fall on a weekend or bank holiday. Inherited by Business Entities and Pay Schedules whose own setting is inherit.

Available options:

inherit,

next_business_day,

previous_business_day

data.external_ref

string | null

A reference to the object in an external system, e.g. the primary key of the object in your application's database. Nmbr doesn't use, validate, parse, or require this value to be unique - it simply stores it for your reference.

Maximum string length: 255

data.preferred_locale

enum<string> | null

The locale used for payroll communications sent to Employees and Contractors within this company. If not set, the Partner's locale is used.

Available options:

en,

fr

data.created_at

string<dateTime>

read-only

The date and time the object was created in Nmbr.

data.updated_at

string<dateTime>

read-only

The date and time the object was last updated in Nmbr.