> ## 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.

# Search by EVSE id

> Chargers (EVSEs) by the id printed on them, ignoring case, `*` and spaces: the exact matches first, then those that start with it. At most 10.



## OpenAPI

````yaml api-reference/map/map-v1.openapi.json GET /search
openapi: 3.1.0
info:
  title: Plugchoice Map API
  version: '1'
  description: >-
    Where Plugchoice's charge cards charge: the public locations of Plugchoice's
    roaming partners and Plugchoice's own, with their live status, prices and
    how busy they usually are. Public and read-only: no key, any origin.
servers:
  - url: https://roaming.plugchoice.com/map/v1
security: []
tags:
  - name: Map
paths:
  /search:
    get:
      tags:
        - Map
      summary: Search by EVSE id
      description: >-
        Chargers (EVSEs) by the id printed on them, ignoring case, `*` and
        spaces: the exact matches first, then those that start with it. At most
        10.
      operationId: search
      parameters:
        - name: q
          in: query
          required: true
          description: >-
            An EVSE id or its start, 3 to 64 characters not counting `*` and
            spaces.
          schema:
            type: string
          example: NL*GFX*EACE0673532
        - $ref: '#/components/parameters/IfNoneMatch'
      responses:
        '200':
          description: The matches.
          headers:
            ETag:
              $ref: '#/components/headers/ETag'
            Cache-Control:
              $ref: '#/components/headers/CacheControl'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SearchResults'
        '304':
          $ref: '#/components/responses/NotModified'
        '422':
          description: '`q` is too short or too long.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: q is 3 to 64 characters of an EVSE id
        '429':
          $ref: '#/components/responses/RateLimited'
components:
  parameters:
    IfNoneMatch:
      name: If-None-Match
      in: header
      description: >-
        The `ETag` of the answer you have. When it's still the same, the answer
        is an empty 304.
      schema:
        type: string
  headers:
    ETag:
      description: A tag of this answer, for `If-None-Match`.
      schema:
        type: string
      example: W/"9f2c1b7a4e6d0c38"
    CacheControl:
      description: 'Always `no-cache`: keep the answer, but ask again each time.'
      schema:
        type: string
        const: no-cache
  schemas:
    SearchResults:
      type: object
      required:
        - results
      additionalProperties: false
      properties:
        results:
          type: array
          maxItems: 10
          items:
            type: object
            required:
              - location_id
              - evse_id
              - name
              - lat
              - lng
            additionalProperties: false
            properties:
              location_id:
                type: string
                description: For `GET /locations/{id}`.
              evse_id:
                type: string
              name:
                type:
                  - string
                  - 'null'
                description: The location's name.
              lat:
                type: number
              lng:
                type: number
      example:
        results:
          - location_id: remote-12
            evse_id: NL*GFX*EACE0673532*1
            name: Station
            lat: 52.37403
            lng: 4.88969
    Error:
      type: object
      required:
        - error
      additionalProperties: false
      properties:
        error:
          type: string
  responses:
    NotModified:
      description: The answer is the same as your `If-None-Match`. No body.
    RateLimited:
      description: >-
        Too many requests from your IP address. No body; try again after
        `Retry-After`.
      headers:
        Retry-After:
          description: Seconds to wait.
          schema:
            type: integer
          example: 1

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.