---
title: "List companies"
method: GET
path: "/api/companies"
---

# List companies

`GET /api/companies`

## Request

- Base URL: `https://gstcranes.com`
- URL: `https://gstcranes.com/api/companies`
- Auth: none declared

## Query parameters

- `country` string
- `service_type` 'mobile_crane' | 'crawler_crane' | 'aerial_platform' | 'heavy_haulage'
- `capacity_min_t` number
- `bbox` string: minLon,minLat,maxLon,maxLat
- `limit` integer

## Headers

- `GST-API-Version` string

## Response `200`

List of public companies

- CompanyList
  - `items` PublicCompany[]
    - `id` integer, required
    - `slug` string, required
    - `name` string, required
    - `description` string, nullable
    - `logo_url` string, nullable
    - `cover_image_url` string, nullable
    - `website` string, nullable
    - `phone` string, nullable
    - `whatsapp` string, nullable
    - `address_line1` string, nullable
    - `address_line2` string, nullable
    - `city` string, nullable
    - `state_region` string, nullable
    - `country` string, required
    - `postal_code` string, nullable
    - `lat` number, required
    - `lon` number, required
    - `tier` 'free' | 'featured'
    - `services` string[], required
    - `fleet_highlights` FleetHighlight[], required
      - `brand` string, nullable
      - `model` string, nullable
      - `capacity_t` number, nullable
      - `boom_type` string, nullable
      - `max_height_m` number, nullable
  - `next_cursor` string, nullable

## Other responses

- `400`: Invalid request.
- `429`: Rate limit exceeded.
- `500`: Unexpected server error.
- `default`: Machine-readable API error.

---

[API](https://skmtc.dev/gstcranes/apis/gst-cranes-companies-api.md) · [All operations](https://skmtc.dev/gstcranes/apis/gst-cranes-companies-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gstcranes/apis/gst-cranes-companies-api/revisions/0248d238b736?raw)