Get Chargers

POST 
/v3/chargers/filter

This endpoint allows you to retrieve a custom filter for electric chargers. You can specify parameters such as latitude, longitude, distance, providers, charging status, charge types, and plug types.

Request

application/json

Body

required

lat numberrequired

Value between -90 and 90

lon numberrequired

Value between -180 and 180

distance numberrequired

Possible values: >= 10 and <= 10000

Distance in meters

providers string[]

Possible values: [chargepoint, edp, emt, endesa, gic, iberdrola, ionity, repsol, tesla, total, virta, wenea, zunder, electrify-america, monta]

Default value: ``

status string

Possible values: [available, all]

Default value: all

chargeTypes number[]

Possible values: [1, 2, 3, 4, 5]

plugTypes string[]

Possible values: [chademo, combo, domestic, tesla_destiny, type_2]

Responses

200

Ok

application/json

Schema

Schema

• Array [
_id string
idPR string
idCupr number
lat number
lon number
status boolean
plugs number
provider string
connection string
chargerDetails object[]
Array [
_id string
charger string
name string
model string
address string
town string
state string
hasRestaurant boolean
hasMall boolean
hasCarWash boolean
hasParking boolean
hasGasStation boolean
hasShop boolean
hasCoffeeShop boolean
hasWorkshop boolean
plusCode string
accessPrice number
moreInfo string
schedule string
plugs object[]
All plugs of a charger details
Array [
_id string
chargerDetails string
logicPlugId string
lastUpdate date-time
chargeSpeedId number
provider string
physicalPlugs object[]
All physical plugs of a logic plug
Array [
_id string
logicPlug string
physicalPlugId string
conectorType number
status boolean
lastUpdate date-time
chargeMode number
maxPower number
provider string
price number
]
]
provider string
bookingType number
bookingTime number
freeCancelBookingTime number
createdAt date-time
updatedAt date-time
monday string
tuesday string
wednesday string
thursday string
friday string
saturday string
sunday string
]
loc string[]
createdAt date-time
updatedAt date-time
show boolean
• ]

Example (from schema)

[
  {
    "_id": "63712f794e8aaa51a939339b",
    "idPR": "5efad9e4e82ae5",
    "idCupr": 0,
    "lat": 43.29887,
    "lon": -2.069368,
    "status": true,
    "plugs": 2,
    "provider": "Repsol",
    "connection": "direct",
    "chargerDetails": [
      {
        "_id": "648b47cfdeccbd815984736d",
        "charger": "648b47c9deccbd8159843cd4",
        "name": "Fuengirola station",
        "model": "Fuengirola station",
        "address": "DE LA ENCARNACIÓN, 29640",
        "town": "Fuengirola",
        "state": "Málaga",
        "hasRestaurant": false,
        "hasMall": false,
        "hasCarWash": true,
        "hasParking": true,
        "hasGasStation": true,
        "hasShop": true,
        "hasCoffeeShop": false,
        "hasWorkshop": false,
        "plusCode": 1234,
        "accessPrice": 0.15,
        "moreInfo": "extra info",
        "schedule": "",
        "plugs": [
          {
            "_id": "6372d0064e8aaa51a95b10cf",
            "chargerDetails": "6372d0054e8aaa51a95b10a3",
            "logicPlugId": 188,
            "lastUpdate": "2023-11-12T01:58:47.000+00:00",
            "chargeSpeedId": 3,
            "provider": "EMT",
            "physicalPlugs": [
              {
                "_id": "616b3830dca57819118cfe46",
                "logicPlug": "616a0c1bdca57819117693a9",
                "physicalPlugId": "101291f",
                "conectorType": 20,
                "status": false,
                "lastUpdate": "2021-10-16T20:41:48.000+00:00",
                "chargeMode": 1,
                "maxPower": 11,
                "provider": "EMT",
                "price": 0.15
              }
            ]
          }
        ],
        "provider": "emt",
        "bookingType": 0.25,
        "bookingTime": 1.3,
        "freeCancelBookingTime": 1.55,
        "createdAt": "2024-04-02T09:19:28.989Z",
        "updatedAt": "2024-04-02T09:19:28.990Z",
        "monday": "24h",
        "tuesday": "24h",
        "wednesday": "24h",
        "thursday": "24h",
        "friday": "24h",
        "saturday": "24h",
        "sunday": "24h"
      }
    ],
    "loc": [
      -2.1564
    ],
    "createdAt": "2024-04-02T09:19:28.990Z",
    "updatedAt": "2024-04-02T09:19:28.990Z",
    "show": true
  }
]

400

Bad request

application/json

Schema

Schema

message string
statusCode number
error string

Example (from schema)

{
  "message": "error message information",
  "statusCode": 500,
  "error": "Internal server error"
}

Example

{
  "lon": "lon is required. lon must be a number.",
  "distance": "distance is required. distance must be a number",
  "lat": " lat must be between -90 and 90",
  "providers": " Invalid provider: repppsol.",
  "status": "Invalid status: use",
  "chargeTypes": " Invalid ChargeType: 98.",
  "plugTypes": " Invalid plugType: conector."
}

401

Unauthorized

500

Internal server error

application/json

Schema

Schema

message string
statusCode number
error string

Example (from schema)

{
  "message": "error message information",
  "statusCode": 500,
  "error": "Internal server error"
}

Loading...