List Companies (Accounts)

Returns every SEOmonitor company (account) the authenticated user has access to, across all account memberships tied to the user behind the API token.

Use this endpoint as the cross-account discovery entry point before calling /dashboard/v3.0/campaigns/tracked. The campaigns list endpoint is scoped to one company at a time — pass the company_id returned here as a query parameter to retrieve that company's campaigns.

Typical flow for a multi-account user:

Call /dashboard/v3.0/companies to enumerate accessible companies.

Let the user pick a company (or auto-select if only one is returned).

Call /dashboard/v3.0/campaigns/tracked?company_id=<id> to load
that company's campaigns.

Each entry includes the company's display name, the user's access role for that company (admin or member), and the company's subscription state. Companies with subscription_details.status = "expired" are still returned; downstream endpoints may reject calls against expired companies.

Responses

🟢200OK

application/json

Bodyapplication/json

Examples

Success ExampleSuccess ExampleSuccess Example

{
    "company_id": 19527,
    "company_name": "Team-Testing",
    "access_type": "admin",
    "subscription_details": {
        "status": "active",
        "type": "trial",
        "expiration_date": "2026-06-12 19:42:50"
    }
}

Request

Request Code Samples

Responses