v53

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-041561443.9 MB

Company info

Get company accounting profile

Gets the latest basic info for a company.

get/companies/{companyId}/data/info

Response

Success

companyNamestring nullable

Name of the linked company.

accountingPlatformRefstring nullable

Identifier or reference for the company in the accounting software.

companyLegalNamestring nullable

Registered legal name of the linked company.

ledgerLockDatestring

In Codat's data model, dates and times are represented using the <a class="external" href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO 8601 standard</a>. Date and time fields are formatted as strings; for example:

2020-10-08T22:40:50Z
2021-01-01T00:00:00

When syncing data that contains DateTime fields from Codat, make sure you support the following cases when reading time information:

Coordinated Universal Time (UTC): 2021-11-15T06:00:00Z
Unqualified local time: 2021-11-15T01:00:00
UTC time offsets: 2021-11-15T01:00:00-05:00

Time zones

Not all dates from Codat will contain information about time zones.
Where it is not available from the underlying platform, Codat will return these as times local to the business whose data has been synced.

registrationNumberstring nullable

Registration number given to the linked company by the companies authority in the country of origin. In the UK this is Companies House.

taxNumberstring nullable

Company tax number.

financialYearStartDatestring

2020-10-08T22:40:50Z
2021-01-01T00:00:00

When syncing data that contains DateTime fields from Codat, make sure you support the following cases when reading time information:

Coordinated Universal Time (UTC): 2021-11-15T06:00:00Z
Unqualified local time: 2021-11-15T01:00:00
UTC time offsets: 2021-11-15T01:00:00-05:00

Time zones

Not all dates from Codat will contain information about time zones.
Where it is not available from the underlying platform, Codat will return these as times local to the business whose data has been synced.

baseCurrencystring nullable

Currency set in the accounting software of the linked company. Used by the currency rate.

sourceUrlsobject nullable

URL addresses for the accounting source.

For example, for Xero integrations two URLs are returned. These have many potential use cases, such as deep linking.

createdDatestring

2020-10-08T22:40:50Z
2021-01-01T00:00:00

When syncing data that contains DateTime fields from Codat, make sure you support the following cases when reading time information:

Coordinated Universal Time (UTC): 2021-11-15T06:00:00Z
Unqualified local time: 2021-11-15T01:00:00
UTC time offsets: 2021-11-15T01:00:00-05:00

Time zones

Not all dates from Codat will contain information about time zones.
Where it is not available from the underlying platform, Codat will return these as times local to the business whose data has been synced.

Example response

{
  "companyName": "ACME Corporation",
  "accountingPlatformRef": "4444e827-401b-4925-92cb-d79086bf3b6b",
  "companyLegalName": "ACME Corporation Ltd.",
  "addresses": [
    {
      "type": "Billing",
      "line1": "Warner House",
      "line2": "98 Theobald's Road",
      "city": "London",
      "region": "",
      "country": "United Kingdom",
      "postalcode": "WC1X 8WB"
    },
    {
      "type": "Unknown",
      "line1": "123 Sierra Way",
      "line2": "",
      "city": "San Pablo",
      "region": "CA",
      "country": "",
      "postalCode": "87999"
    }
  ],
  "phoneNumbers": [
    {
      "number": "010 1234 5678",
      "type": "Landline"
    }
  ],
  "webLinks": [
    {
      "type": "Website",
      "url": "https://www.wbsl.com/"
    }
  ],
  "ledgerLockDate": "2019-03-04T12:08:01.881Z",
  "registrationNumber": "1234567890",
  "taxNumber": "GB 123456789",
  "financialYearStartDate": "2019-04-01T00:00:00Z",
  "baseCurrency": "USD",
  "sourceUrls": {
    "url1": "https://go.xero.com/organisationlogin/default.aspx?shortcode=!rxs0Q",
    "url2": "https://reporting.xero.com/!rxs0Q"
  },
  "createdDate": "2020-02-03T16:42:02Z"
}