> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paypunch.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Industries

> GET /api/v1/admin/industries — list industry options used to categorize client companies.

Look up the industries used to categorize client companies (for example when
creating or editing a company). This endpoint has **optional** authentication —
it works with or without a token — so it can power public-facing dropdowns.

```http theme={null}
GET /api/v1/admin/industries
```

**Authentication:** optional. A token, if present, is read but not required.

## Query parameters

<ParamField query="active" type="string" default="true">
  Defaults to active industries only. Pass `active=false` to include inactive
  industries as well. (Any value other than the literal string `false` keeps the
  active-only filter.)
</ParamField>

<ParamField query="search" type="string">
  Case-insensitive match against industry `name` and `description`.
</ParamField>

## Response

<ResponseField name="data.industries" type="array">
  Industries ordered by `name` ascending. Each item: `id`, `name`,
  `description`, `active`, and `_count.companies` (number of companies in that
  industry).
</ResponseField>

<ResponseField name="data.total" type="integer">
  The number of industries returned.
</ResponseField>

## Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://app.paypunch.io/api/v1/admin/industries?search=construction"
  ```

  ```json Response (200) theme={null}
  {
    "success": true,
    "data": {
      "industries": [
        {
          "id": "ind_01...",
          "name": "Construction",
          "description": "General contractors and trades",
          "active": true,
          "_count": { "companies": 6 }
        }
      ],
      "total": 1
    }
  }
  ```
</CodeGroup>

<Note>
  On an unexpected error this endpoint returns `500` `Failed to fetch
      industries`. Because auth is optional, it does not return `401`.
</Note>