api-ninjas-com EV Charger API

openapi: 3.2.0
info:
  title: Ninjas EV Charger API
  description: 'Combined OpenAPI specification for every API Ninjas endpoint. Requests go to https://api.api-ninjas.com with an `X-Api-Key` header; get a free key at https://api-ninjas.com/register. Human-readable docs: https://api-ninjas.com/api. Index for LLMs: https://api-ninjas.com/llms.txt.'
  version: 1.0.0
  contact:
    name: API Ninjas
    url: https://api-ninjas.com
  license:
    name: Proprietary
servers:
- url: https://api.api-ninjas.com
  description: API Ninjas Production
security:
- ApiKeyAuth: []
tags:
- name: EV Charger
  description: The EV Charger API helps you find electric vehicle charging stations in nearly 100 countries around the world. Get each station's address, coordinates, active status, and connector types and counts.
paths:
  /v1/evcharger:
    get:
      summary: Find electric vehicle charging stations
      description: Get electric vehicle charging stations near a location specified by latitude and longitude coordinates.
      operationId: getEVCharger
      parameters:
      - $ref: '#/components/parameters/lat'
      - $ref: '#/components/parameters/lon'
      - $ref: '#/components/parameters/distance'
      - $ref: '#/components/parameters/level'
      - $ref: '#/components/parameters/EvChargerOpenapi_limit'
      - $ref: '#/components/parameters/EvChargerOpenapi_offset'
      responses:
        '200':
          description: A list of electric vehicle charging stations.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EVChargerResponse'
        '400':
          description: Bad Request. Invalid request parameters.
        '401':
          description: Unauthorized. API key is missing or invalid.
        '500':
          description: Internal Server Error.
      security:
      - ApiKeyAuth: []
      tags:
      - EV Charger
components:
  parameters:
    lat:
      name: lat
      in: query
      description: Latitude coordinate.
      required: true
      schema:
        type: number
        format: double
    lon:
      name: lon
      in: query
      description: Longitude coordinate.
      required: true
      schema:
        type: number
        format: double
    level:
      name: level
      in: query
      description: Charging level (1, 2, or 3). By default, all levels are returned.
      required: false
      schema:
        type: integer
        enum:
        - 1
        - 2
        - 3
    distance:
      name: distance
      in: query
      description: Search distance in kilometers. Default is 3 kilometers. Max value is 50 kilometers.
      required: false
      schema:
        type: integer
        default: 3
        minimum: 1
        maximum: 50
    EvChargerOpenapi_offset:
      name: offset
      in: query
      description: Number of results to skip. Used for pagination. Default is 0.
      required: false
      schema:
        type: integer
        default: 0
    EvChargerOpenapi_limit:
      name: limit
      in: query
      description: How many results to return. Must be between 1 and 30. Default is 3.
      required: false
      schema:
        type: integer
        default: 3
        minimum: 1
        maximum: 30
  schemas:
    EVChargerResponse:
      type: array
      items:
        type: object
        properties:
          is_active:
            type: boolean
            description: Indicates if the charging station is active.
          name:
            type: string
            description: Name of the charging station.
          address:
            type: string
            description: Address of the charging station.
          city:
            type: string
            description: City where the charging station is located.
          region:
            type: string
            description: Region where the charging station is located.
          country:
            type: string
            description: Country where the charging station is located.
          latitude:
            type: number
            format: double
            description: Latitude coordinate of the charging station.
          longitude:
            type: number
            format: double
            description: Longitude coordinate of the charging station.
          connections:
            type: array
            items:
              type: object
              properties:
                type_name:
                  type: string
                  description: Name of the connector type.
                type_official:
                  type: string
                  description: Official name of the connector type.
                level:
                  type:
                  - integer
                  - 'null'
                  description: Charging level of the connector.
                num_connectors:
                  type: integer
                  description: Number of connectors available.
            description: List of connections available at the charging station.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key
externalDocs:
  description: API Ninjas documentation
  url: https://api-ninjas.com/api