# List Charger Ports

Retrieves a list of all charger ports with their current status and connector information.

This endpoint supports filtering by parameters like status and charger.

## Permissions

Requires a valid API key with read permissions for charger ports.

Endpoint: GET /charger-port
Version: v1
Security: BearerAuth

## Query parameters:

  - `charger__payment_type` (string)
    Filter by payment type (Paid or Free)
    Enum: "Paid", "Free"

  - `charger` (string)
    Filter by specific charger UUID

  - `status__in` (string)
    Filter by charger port status (comma-separated list)
    Enum: "DISABLED", "AVAILABLE", "STANDBY", "CHARGING", "OFFLINE", "FAULTED", "RESERVED", "UNAVAILABLE", "UNDEFINED", "NOT_CHARGING", "COMPLETE", "ASLEEP", "STARTING", "STOPPING", "WAITING_CHARGER", "WAITING_VEHICLE", "IN_PROGRESS", "FAILED_START", "FAILED_STOP", "NO_SESSION", "PREPARING", "SUSPENDED_EV", "SUSPENDED_EVSE", "UNPLUGGED", "UNPLUGGED_NOT_CHARGING", "UNPLUGGED_CHARGING", "PLUGGED_IN_NOT_CHARGING", "PLUGGED_IN_SUSPENDED_EV", "PLUGGED_IN_CHARGING", "CHARGING_COMPLETE", "CUSTOM_CHARGER", "CUSTOM_VEHICLE", "FINISHING"

  - `location__in` (string)
    Filter by location (comma-separated list)

  - `ordering` (string)
    Field to order results by (prefix with - for descending order)
    Enum: "created_at", "-created_at", "custom_id", "-custom_id", "status", "-status", "parking_lot", "-parking_lot", "temperature", "-temperature", "max_power", "-max_power", "current_kilowatt_hour", "-current_kilowatt_hour", "start_charging_at", "-start_charging_at", "end_charging_at", "-end_charging_at", "charger_point_id", "-charger_point_id", "location_name", "-location_name"

  - `search` (string)
    A search term.

  - `limit` (integer)
    Number of results to return per page.

  - `offset` (integer)
    The initial index from which to return the results.

## Response 200 fields (application/json):

  - `count` (integer, required)

  - `next` (string,null)

  - `previous` (string,null)

  - `results` (array, required)

  - `results.id` (string)
    Unique identifier for the charger port

  - `results.max_power` (number, required)
    Maximum power output in kW

  - `results.charging_speed` (number)
    Current charging speed

  - `results.custom_id` (string)
    Custom identifier for the port

  - `results.power` (number,null, required)
    Current power output

  - `results.manufacturer` (object)

  - `results.manufacturer.custom_id` (string)
    Manufacturer custom ID

  - `results.manufacturer.value` (string)
    Manufacturer name

  - `results.model` (object)

  - `results.model.custom_id` (string)
    Model custom ID

  - `results.model.value` (string)
    Model name

  - `results.model.port_count` (integer)
    Number of ports on this model

  - `results.status` (object)

  - `results.status.key` (string)
    Status code

  - `results.status.value` (string)
    Human-readable status

  - `results.parking_lot` (object)

  - `results.parking_lot.id` (integer)
    Unique identifier for the parking lot

  - `results.parking_lot.value` (string, required)
    Name or identifier of the parking lot

  - `results.connector_type` (string)
    Type of connector
    Enum: "J1772", "CCS", "CHADEMO", "NACS", "SHUKO", "TYPE_2"

  - `results.current_ampere` (number)
    Current in amperes

  - `results.current_kilowatt_hour` (number)
    Current in kilowatt-hours

  - `results.start_charging_at` (string,null)
    When charging started

  - `results.end_charging_at` (string,null)
    When charging ended

  - `results.charger` (string,null, required)
    Associated charger UUID