Companies

Use the companies endpoints to read the companies attached to an organization. Companies are groups of your customers associated with an organization.

List companies

GET /api/v2/organizations/{organization_id}/companies

This endpoint supports limit and cursor.

Key response fields:

Name
company_id
Description
The company identifier used for the company detail endpoint.
Name
name
Description
The company name.
Name
notes
Description
Additional notes for the company.
Name
domain
Description
The company website or domain when available.
Name
address
Description
The company address when available.
Name
agent_id
Description
The assigned agent identifier when the company is linked to an agent.
Name
created_at
Description
When the company was created.

List companies

curl -G https://api.hyperrep.ai/api/v2/organizations/gAAAAABexampleOrganizationIdReturnedByApi7mN4qP2xLs9dV5kTr8cY1hJ6uW3/companies \
  -H "X-API-KEY: your-api-key" \
  --data-urlencode "limit=25"

Example response

{
  "data": [
    {
      "company_id": "gAAAAABexampleCompanyIdReturnedByApi6vT2mQ9xLs4dK7pNc1hY5uJ8rF3",
      "name": "HyperRep Consumer Group",
      "domain": "hyperrep.com",
      "notes": "Priority account",
      "address": "123 Main St, Anytown USA",
      "agent_id": "gAAAAABexampleAgentIdReturnedByApi5qN8xLm3sV6kRt2cY9hJ4uW1dF7",
      "created_at": "2026-03-10T12:00:00Z"
    }
  ],
  "pagination": {
    "limit": 25,
    "cursor": null,
    "next_cursor": null,
    "has_more": false
  }
}

Get a company

GET /api/v2/organizations/{organization_id}/companies/{company_id}

Use the company_id returned by the list endpoint.

This endpoint returns one company in the same canonical company shape used by the list endpoint.

Get one company

curl https://api.hyperrep.ai/api/v2/organizations/gAAAAABexampleOrganizationIdReturnedByApi7mN4qP2xLs9dV5kTr8cY1hJ6uW3/companies/gAAAAABexampleCompanyIdReturnedByApi6vT2mQ9xLs4dK7pNc1hY5uJ8rF3 \
  -H "X-API-KEY: your-api-key"

Example response

{
    "company_id": "gAAAAABexampleCompanyIdReturnedByApi6vT2mQ9xLs4dK7pNc1hY5uJ8rF3",
    "name": "HyperRep Consumer Group",
    "domain": "hyperrep.com",
    "notes": "Priority account",
    "address": "123 Main St, Anytown USA",
    "agent_id": "gAAAAABexampleAgentIdReturnedByApi5qN8xLm3sV6kRt2cY9hJ4uW1dF7",
    "created_at": "2026-03-10T12:00:00Z"
  }