CorefinityCorefinityDocs
Open the Control PanelControl Panel
Organisations · 1 of 1

List your companies

Answers every company the token's user can reach: their own, and for an agency each client it manages. The list is not paged, and a company's people are not part of it.

GET/api/companies

Returns

200 The companies.

Fields of the 200 answer
companiesarray of objectsRequired
Fields of each item
addressstring or nullRequired
countrystring or nullRequired

The company's country, as it is stored on the company.

idstringRequired

The company's id, as a string of digits.

namestringRequired
phonestring or nullRequired

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403scope_requiredUse a token with the scope named in scope.
429rate_limitedWait for the seconds in Retry-After.

Reasons are listed by name in Errors and refusals.

The same task elsewhere

curl https://manage.corefinity.com/api/companies \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
{
  "companies": [
    {
      "address": "1 Example Street, Anytown, AB1 2CD",
      "country": "GB",
      "id": "1180",
      "name": "Northwind Digital",
      "phone": "+44 20 7946 0118"
    },
    {
      "address": "14 Quay Street, Anytown, AB1 2CD",
      "country": "GB",
      "id": "1204",
      "name": "Harbour & Finch",
      "phone": "+44 20 7946 0142"
    }
  ]
}
Try it
Held in this tab's memory only. Never stored or sent to us.

Use a token with only the read scope. How to make one

Was this helpful?
Open in ClaudeOpen in ChatGPT