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.
Returns
200 Your company's agencies.
Fields of the 200 answer
By name.
Fields of each item
How many of your environments deploy through one of the agency's deployment connections.
At least 1.
How many of your sites the agency manages.
The agency's name. Removed agency when the agency has been deleted; its link can still be detached.
agencypartnerWhether you may detach an agency. Owners only, and never in an archived company.
Your own company. At least 1.
Your environments that lost their repository when an agency was detached and still need a new deployment connection, oldest first.
Fields of each item
At least 1.
With its offset, such as 2026-11-03T09:16:40+00:00. Format: date-time.
At least 1.
At least 1.
If it is refused
| Status | Reason | What to do |
|---|---|---|
401 | none | Send a valid token as Authorization: Bearer <token>. |
403 | company_unavailable | Your company is unavailable. |
403 | scope_required | Use a token with the scope named in scope. |
429 | rate_limited | Wait 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"use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->get('https://manage.corefinity.com/api/company/agencies');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/company/agencies', {
method: 'GET',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
},
});
// An answer with no body (204) has nothing to parse.
const text = await res.text();
const data = text && JSON.parse(text);import os
import requests
res = requests.get(
"https://manage.corefinity.com/api/company/agencies",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"agencies": [
{
"deploys_through": 1,
"id": 1180,
"manages_sites": 0,
"name": "Northwind Digital",
"type": "agency"
}
],
"can_detach": true,
"company_id": 1204,
"repository_gaps": []
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}