Companies

Three endpoints for company data. All public.

List companies

POST /flan.companies.v1.CompaniesService/List

Returns a paginated list of companies in the index.

Parameters

| Field | Type | Default | Description | | -------- | ------- | ------- | ---------------------------------------- | | query | string | — | Match against company name. ≤ 200 chars. | | limit | integer | 25 | Page size. 1–100. | | cursor | string | — | Opaque pagination cursor. |

Example

{
  "data": [
    {
      "id": "acme",
      "name": "Acme",
      "website": "https://acme.com",
      "logoUrl": "https://logo.clearbit.com/acme.com",
      "industry": "Software",
      "employeeCountRange": "201-500",
      "foundedYear": 2014,
      "activeJobCount": 23,
      "updatedAt": "2026-06-21T08:00:00Z"
    }
  ],
  "pagination": { "nextCursor": "2026-06-21T08:00:00Z", "hasMore": true }
}

Company detail

POST /flan.companies.v1.CompaniesService/Get

id accepts either the canonical id or the slug. Both resolve to the same record.

{
  "id": "acme",
  "name": "Acme",
  "website": "https://acme.com",
  "logoUrl": "https://logo.clearbit.com/acme.com",
  "industry": "Software",
  "employeeCountRange": "201-500",
  "foundedYear": 2014,
  "activeJobCount": 23,
  "createdAt": "2025-08-12T10:00:00Z",
  "updatedAt": "2026-06-21T08:00:00Z"
}

Company detail currently does not include a description/about field. Use website to link to the company's own about page.

Company jobs

POST /flan.companies.v1.CompaniesService/ListJobs

Returns active jobs for a company. Accepts a subset of the JobsService.List filters:

| Field | Accepted | | -------------------------------------------------------------------------------------------------- | ------------------------- | | query, country, city, employmentType, remote, discoveredAfter | yes | | limit, cursor | yes | | workMode, seniority, salaryMin, salaryMax, verifiedAfter, sort, company, companyId | no (silently dropped) |

Example

curl -X POST "https://api.useflan.app/flan.companies.v1.CompaniesService/ListJobs" \
  -H "Content-Type: application/json" \
  --data '{"id":"acme","limit":5}'

{
  "data": [
    /* JobCard objects — see /developers/docs/search */
  ],
  "pagination": { "hasMore": false }
}