---
title: "Search tickets, devices, and users across accessible teams"
method: GET
path: "/api/search/global"
tags: ["search"]
---

# Search tickets, devices, and users across accessible teams

`GET /api/search/global`

## Request

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

Cross-team search limited to teams where the caller is admin/engineer.

## Query parameters

- `q` string, required
- `limit` integer: Max results per entity type

## Response `200`

Successful Response

- GlobalSearchResponse: Response for the global search endpoint, grouped client-side.
  - `query` string, required
  - `results` GlobalSearchResult[], required
    - `id` string, required
    - `entity` 'device' | 'ticket' | 'user', required: Entity kinds surfaced by the global search dialog.
    - `label` string, required
    - `reference` string, nullable
    - `context` string, nullable
    - `verified` boolean, nullable
    - `entityKey` string, required
    - `teamKey` string, required
    - `teamName` string, required

## Other responses

- `400`: Invalid input
- `401`: Not authenticated
- `403`: Forbidden
- `404`: Not found
- `405`: Method not allowed
- `409`: Conflict
- `422`: Validation Error

---

[API](https://skmtc.dev/superit/apis/super-it-api.md) - [All operations](https://skmtc.dev/superit/apis/super-it-api/llms.txt) - [OpenAPI document](https://skmtc.dev/superit/apis/super-it-api/revisions/4944d556c2bb?raw)