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

# Global Search

Searches across chargers and locations accessible to the authenticated user. Results can optionally be scoped to a specific team.

<ParamField query="query" type="string" required>
  The search query. Must be at least 2 characters and no more than 255 characters.
</ParamField>

<ParamField query="team_uuid" type="string">
  Filter results to a specific team by UUID.
</ParamField>

<ParamField query="limit" type="integer">
  Maximum number of results per type. Must be between 1 and 25. Defaults to `10`.
</ParamField>

## Response

<ResponseField name="chargers" type="array">
  Array of matching charger objects.

  <Expandable title="charger">
    <ResponseField name="uuid" type="string">
      The unique UUID of the charger.
    </ResponseField>

    <ResponseField name="identity" type="string">
      The charger identity string.
    </ResponseField>

    <ResponseField name="connection_status" type="string">
      The connection status (`online`, `offline`, or `never_seen`).
    </ResponseField>

    <ResponseField name="blocked" type="boolean">
      Whether the charger is blocked.
    </ResponseField>

    <ResponseField name="permissions" type="object">
      The user's permissions (`basic`, `sensitive`, `full` booleans).
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="locations" type="array">
  Array of matching location objects.

  <Expandable title="location">
    <ResponseField name="uuid" type="string">
      The unique UUID of the location.
    </ResponseField>

    <ResponseField name="name" type="string">
      The location name.
    </ResponseField>

    <ResponseField name="city" type="string">
      The city name. May be `null`.
    </ResponseField>

    <ResponseField name="permissions" type="object">
      The user's permissions (`basic`, `sensitive`, `full` booleans).
    </ResponseField>
  </Expandable>
</ResponseField>