Global Search

GET /v3/search

Global Search

cURL

curl --request GET \
  --url https://app.plugchoice.com/api/v3/search \
  --header 'Authorization: Bearer <token>'

200

{
  "chargers": [
    {
      "uuid": "<string>",
      "identity": "<string>",
      "connection_status": "<string>",
      "blocked": true,
      "permissions": {}
    }
  ],
  "locations": [
    {
      "uuid": "<string>",
      "name": "<string>",
      "city": "<string>",
      "permissions": {}
    }
  ]
}

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

query · string · required

The search query. Must be at least 2 characters and no more than 255 characters.

team_uuid · string

Filter results to a specific team by UUID.

limit · integer

Maximum number of results per type. Must be between 1 and 25. Defaults to 10.

Response

chargers · array

Array of matching charger objects.

Show charger

uuid · string

The unique UUID of the charger.

identity · string

The charger identity string.

connection_status · string

The connection status (online, offline, or never_seen).

blocked · boolean

Whether the charger is blocked.

permissions · object

The user’s permissions (basic, sensitive, full booleans).

locations · array

Array of matching location objects.

Show location

uuid · string

The unique UUID of the location.

name · string

The location name.

city · string

The city name. May be null.

permissions · object

The user’s permissions (basic, sensitive, full booleans).