---
title: "List partner companies"
method: GET
path: "/companies"
tags: ["Companies"]
---

# List partner companies

`GET /companies`

## Request

- Base URL: `https://api.100hires.com/v2`
- URL: `https://api.100hires.com/v2/companies`
- Auth: HTTP bearer

Returns partner-accessible companies with pagination metadata. Use for tenant discovery and management panels.

## Query parameters

- `page` integer
- `size` integer

## Response `200`

Company list

- CompanyListResponse
  - `companies` Company[], required: Array of companies.
    - `id` integer, required: Unique identifier
    - `name` string, required: Company name
    - `website` string, nullable: Company website URL
    - `url` string, nullable: Company careers page URL
    - `is_staffing_agency` boolean: Whether this company is a staffing agency
    - `logo` string, nullable: URL of the company logo image
    - `company_owner_email` string, nullable: Email of the company owner
    - `company_owner_phone` string, nullable: Phone number of the company owner
    - `company_owner_name` string, nullable: Full name of the company owner
    - `linkedin_company_id` string, nullable: Numeric LinkedIn Company ID of the company page. The company's jobs are posted to LinkedIn only when it is set.
    - `linkedin_company_url` string, nullable: LinkedIn company page URL, e.g. https://www.linkedin.com/company/acme-corp
    - `job_board_names` object: Company name shown on each job board, keyed by the board name from GET /boards. A board without an entry shows the company name. An empty object when no name is set.
  - `pagination` Pagination, required
    - `page_size` integer, required: Items per page.
    - `page_count` integer, required: Total number of pages.
    - `page` integer, required: Current page number.
    - `total_count` integer, required: Total number of items.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too many requests

---

[API](https://skmtc.dev/100hires/apis/100hires-api.md) · [All operations](https://skmtc.dev/100hires/apis/100hires-api/llms.txt) · [OpenAPI document](https://skmtc.dev/100hires/apis/100hires-api/revisions/e63e2d3115f7?raw)