CorefinityCorefinityDocs
Open the Control PanelControl Panel
Agencies and clients · 1 of 6

List your company's agencies

Every agency your own company is a client of, by name, with how many of your sites it manages and how many of your environments deploy through its deployment connections. repository_gaps lists your environments that lost their repository when an agency was detached and still need a new deployment connection.

GET/api/company/agencies

Returns

200 Your company's agencies.

Fields of the 200 answer
agenciesarray of objectsRequired

By name.

Fields of each item
deploys_throughintegerRequired

How many of your environments deploy through one of the agency's deployment connections.

idintegerRequired

At least 1.

manages_sitesintegerRequired

How many of your sites the agency manages.

namestringRequired

The agency's name. Removed agency when the agency has been deleted; its link can still be detached.

typestringRequired
agencypartner
can_detachbooleanRequired

Whether you may detach an agency. Owners only, and never in an archived company.

company_idintegerRequired

Your own company. At least 1.

repository_gapsarray of objectsRequired

Your environments that lost their repository when an agency was detached and still need a new deployment connection, oldest first.

Fields of each item
agency_idintegerRequired

At least 1.

agency_namestringRequired
detached_atstringRequired

With its offset, such as 2026-11-03T09:16:40+00:00. Format: date-time.

environment_idintegerRequired

At least 1.

environment_namestringRequired
website_idintegerRequired

At least 1.

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403company_unavailableYour company is unavailable.
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/company/agencies \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
{
  "agencies": [
    {
      "deploys_through": 1,
      "id": 1180,
      "manages_sites": 0,
      "name": "Northwind Digital",
      "type": "agency"
    }
  ],
  "can_detach": true,
  "company_id": 1204,
  "repository_gaps": []
}
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