---
title: "GET api/companies"
method: GET
path: "/api/companies"
tags: ["Company"]
---

# GET api/companies

`GET /api/companies`

## Request

- Base URL: `https://app.followr.ai`
- URL: `https://app.followr.ai/api/companies`
- Auth: HTTP bearer

Return the list of companies

## Query parameters

- `include` string: additional relations to include in response, separated by semi-colon.
- `filter[id]` string: filter by id
- `filter[type]` string: filter by type (company, individual)
- `filter[name]` string: filter by name
- `filter[user_id]` string: filter by user id
- `filter[country_iso_code]` integer: filter by country iso code
- `filter[language_iso_code]` string: filter by language iso code
- `sort` string: sort by field.
- `page[number]` integer: page number.
- `page[size]` integer: items per page (default 30).

## Response `200`

- object
  - `data` object[]
    - `id` integer
    - `user_id` integer
    - `type` string
    - `name` string
    - `description` string
    - `country_iso_code` string
    - `language_iso_code` string
    - `language` string
    - `language_types` string
    - `interests` string
    - `tones` string
    - `emotions` string
    - `syntaxes` string
    - `characters` string
    - `fonts` string
    - `audience_types` string
    - `audience_ages` string
    - `audience_genders` string
    - `website` string
    - `palettes` string
    - `social_network_prompts` string
    - `ai_image_styles` string
    - `ai_preferences` string
    - `ai_keys` string
    - `webhook_secret` string
    - `webhook_posts_url` string
    - `created_at` string
    - `updated_at` string
    - `disabled_at` string
    - `user` object
      - `id` integer
      - `name` string
      - `email` string
      - `referral_code` string
      - `language` string
      - `timezone` string
      - `notification_settings` string
      - `credits` integer
      - `pm_type` string
      - `pm_last_four` string
      - `cancel_reason` string
      - `referrer_url` string
      - `land_url` string
      - `has_password` boolean
      - `created_at` string
      - `updated_at` string
      - `banned_at` string
      - `password_changed_at` string

---

[API](https://skmtc.dev/followr/apis/followr-api-documentation.md) - [All operations](https://skmtc.dev/followr/apis/followr-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/followr/apis/followr-api-documentation/revisions/df7f1bbefd95?raw)