---
title: "Search organisations (deprecated)"
method: GET
path: "/v2/organisations/search"
tags: ["Gateway GRPC"]
---

# Search organisations (deprecated)

`GET /v2/organisations/search`

## Request

- Base URL: `https://api.cautio.in` (the document declares no server; this is the origin it was published from)
- URL: `https://api.cautio.in/v2/organisations/search`
- Auth: HTTP bearer

Deprecated: use GET /v2/organisations with `include_descendants=true` and the `query` parameter instead.
This endpoint is kept for backward compatibility and internally delegates to the unified list endpoint.

## Query parameters

- `limit` number
- `page` number
- `query` string, required

## Response `200`

Search results

- SearchOrganisationsResponseDto
  - `items` OrganisationItemDto[], required
    - `id` string, required: Organisation id
    - `display_name` string, required: Display name of the organisation
    - `parent_id` string: Effective parent organisation id when accessible to the user; omitted when the physical parent exists but is inaccessible
    - `children_count` number: Number of direct child organisations visible to the user
    - `vehicle_count` number: Total number of vehicles in this organisation and its accessible sub-organisations
    - `is_setup` boolean, required: Whether first-time setup is complete for this organisation
    - `path` OrganisationDto[]: Visible ancestor chain from top-level visible ancestor to this organisation
      - `id` string, required: Organisation id
      - `display_name` string, required: Display name of the organisation
      - `parent_id` string: Effective parent organisation id when accessible to the user; omitted when the physical parent exists but is inaccessible
      - `children_count` number: Number of direct child organisations visible to the user
      - `vehicle_count` number: Total number of vehicles in this organisation and its accessible sub-organisations
      - `is_setup` boolean, required: Whether first-time setup is complete for this organisation
      - `path` OrganisationDto[]: Visible ancestor chain from top-level visible ancestor to this organisation
    - `children` object: List of child organisations
  - `pagination` PaginationResponseDto, required
    - `page` number, required: Current page number
    - `limit` number, required: Number of items per page
    - `total` number, required: Total number of items
    - `has_next` boolean, required: Whether there is a next page
    - `has_prev` boolean, required: Whether there is a previous page

---

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