> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chargeapi.co/llms.txt
> Use this file to discover all available pages before exploring further.

# The Charging Station object

<div className="xl:hidden">
  <CodeGroup>
    ```json The Charging Station object theme={null}
    {
        "id": "chst_iMb1nAbiUhyudabADX74SMtWaNhC4Z1t",
        "object": "charging_station",
        "address": {
            "city": "Paris",
            "country": "FR",
            "line1": "10 Rue de la Paix",
            "line2": "Batiment A",
            "postal_code": "75002",
            "state": "Ile-de-France"
        },
        "availability": {
            "connectors_available": 3,
            "connectors_total": 8,
            "opening_hours": [
                {
                    "day": "mon",
                    "from": "08:00",
                    "until": "20:00"
                }
            ],
            "range": [
                {
                    "from": "2026-04-01T01:42:32.276Z",
                    "until": "2026-04-01T02:41:49.904Z"
                }
            ]
        },
        "capabilities": {
            "24_7_access": false,
            "amenities": ["cafe", "restrooms", "wifi"],
            "payment_methods": ["credit_card", "rfid"],
            "requires_membership": false,
            "reservable": true
        },
        "connectors": [
            {
                "id": "connector_a1",
                "power": 150,
                "status": "available",
                "type": "CCS"
            },
            {
                "id": "connector_a2",
                "power": 150,
                "status": "occupied",
                "type": "CCS"
            }
        ],
        "created": "2026-04-01T00:41:56.862Z",
        "location": {
            "latitude": 48.8698,
            "longitude": 2.3319
        },
        "name": "Example Station",
        "operator": "Example Operator",
        "operator_contact": "support@example.com",
        "pricing": [
            {
                "currency": "eur",
                "price": 42,
                "step_size": 1,
                "tax": "vat",
                "type": "ENERGY"
            }
        ],
        "status": "active",
        "updated": "2026-04-01T01:41:54.099Z"
    }
    ```
  </CodeGroup>
</div>

<div className="hidden xl:block">
  <ResponseExample>
    ```json The Charging Station object theme={null}
    {
        "id": "chst_iMb1nAbiUhyudabADX74SMtWaNhC4Z1t",
        "object": "charging_station",
        "address": {
            "city": "Paris",
            "country": "FR",
            "line1": "10 Rue de la Paix",
            "line2": "Batiment A",
            "postal_code": "75002",
            "state": "Ile-de-France"
        },
        "availability": {
            "connectors_available": 3,
            "connectors_total": 8,
            "opening_hours": [
                {
                    "day": "mon",
                    "from": "08:00",
                    "until": "20:00"
                }
            ],
            "range": [
                {
                    "from": "2026-04-01T01:42:32.276Z",
                    "until": "2026-04-01T02:41:49.904Z"
                }
            ]
        },
        "capabilities": {
            "24_7_access": false,
            "amenities": ["cafe", "restrooms", "wifi"],
            "payment_methods": ["credit_card", "rfid"],
            "requires_membership": false,
            "reservable": true
        },
        "connectors": [
            {
                "id": "connector_a1",
                "power": 150,
                "status": "available",
                "type": "CCS"
            },
            {
                "id": "connector_a2",
                "power": 150,
                "status": "occupied",
                "type": "CCS"
            }
        ],
        "created": "2026-04-01T00:41:56.862Z",
        "location": {
            "latitude": 48.8698,
            "longitude": 2.3319
        },
        "name": "Example Station",
        "operator": "Example Operator",
        "operator_contact": "support@example.com",
        "pricing": [
            {
                "currency": "eur",
                "price": 42,
                "step_size": 1,
                "tax": "vat",
                "type": "ENERGY"
            }
        ],
        "status": "active",
        "updated": "2026-04-01T01:41:54.099Z"
    }
    ```
  </ResponseExample>
</div>

This object represents a charging station in Charge. It includes location, connector availability, pricing, and other operational details.

## Attributes

<ResponseField name="id" type="string">
  Unique identifier for the object.
</ResponseField>

<ResponseField name="connectors" type="array of object">
  List of connectors available at the station.

  <Expandable title="properties">
    <ResponseField name="id" type="string">
      Unique identifier for the connector.
    </ResponseField>

    <ResponseField name="power" type="integer">
      Maximum power output in kW.
    </ResponseField>

    <ResponseField name="status" type="string">
      Current status of the connector.
    </ResponseField>

    <ResponseField name="type" type="string">
      Connector type supported by this connector.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="location" type="object">
  GPS coordinates of the station.

  <Expandable title="properties">
    <ResponseField name="latitude" type="number">
      Latitude of the charging station.
    </ResponseField>

    <ResponseField name="longitude" type="number">
      Longitude of the charging station.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="name" type="string | null">
  Optional user-facing name for the station.
</ResponseField>

<ResponseField name="operator" type="string">
  Name of the operator (CPO).
</ResponseField>

<ResponseField name="pricing" type="array of object">
  Pricing components for the station.

  <Expandable title="properties">
    <ResponseField name="currency" type="string">
      Currency code in ISO 4217 format.
    </ResponseField>

    <ResponseField name="price" type="integer">
      Price in the smallest currency unit.
    </ResponseField>

    <ResponseField name="step_size" type="integer">
      Billing increment step for this price component.
    </ResponseField>

    <ResponseField name="tax" type="string">
      Currency or tax label associated with the component.
    </ResponseField>

    <ResponseField name="type" type="string">
      Type of price component.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="status" type="string">
  Current status of the station.
</ResponseField>

## More attributes

<ResponseField name="object" type="string">
  String representing the object's type.
</ResponseField>

<ResponseField name="address" type="object">
  Physical location of the charging station.

  <Expandable title="properties">
    <ResponseField name="city" type="string">
      City, town, or district where the station is located.
    </ResponseField>

    <ResponseField name="country" type="string">
      Two-letter ISO country code.
    </ResponseField>

    <ResponseField name="line1" type="string">
      First line of the street address.
    </ResponseField>

    <ResponseField name="line2" type="string">
      Second line of the address.
    </ResponseField>

    <ResponseField name="postal_code" type="string">
      ZIP or postal code.
    </ResponseField>

    <ResponseField name="state" type="string">
      State, province, or administrative region.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="availability" type="object">
  Availability data for the station.

  <Expandable title="properties">
    <ResponseField name="connectors_available" type="integer">
      Number of connectors currently available for use.
    </ResponseField>

    <ResponseField name="connectors_total" type="integer">
      Total number of connectors at this station.
    </ResponseField>

    <ResponseField name="opening_hours" type="array of object">
      Weekly operating hours of the station, if not 24/7.

      <Expandable title="properties">
        <ResponseField name="day" type="string">
          Day of the week using the short lowercase weekday code.
        </ResponseField>

        <ResponseField name="from" type="string">
          Start time in 24-hour format.
        </ResponseField>

        <ResponseField name="until" type="string">
          End time in 24-hour format.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="range" type="array of object">
      Future time ranges when at least one connector will be available.

      <Expandable title="properties">
        <ResponseField name="from" type="string">
          Start of the availability window. RFC 3339 UTC timestamp with millisecond precision, e.g. `2026-03-03T14:05:23.789Z`.
        </ResponseField>

        <ResponseField name="until" type="string">
          End of the availability window. RFC 3339 UTC timestamp with millisecond precision, e.g. `2026-03-03T14:05:23.789Z`.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="capabilities" type="object">
  Capabilities and service features provided at the station.

  <Expandable title="properties">
    <ResponseField name="24_7_access" type="boolean">
      Indicates if the station is accessible 24/7.
    </ResponseField>

    <ResponseField name="amenities" type="array of string">
      List of amenities offered at the station.
    </ResponseField>

    <ResponseField name="payment_methods" type="array of string">
      Accepted payment methods.
    </ResponseField>

    <ResponseField name="requires_membership" type="boolean">
      Whether a membership is required to use this station.
    </ResponseField>

    <ResponseField name="reservable" type="boolean">
      Indicates if the station supports reservations.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="created" type="string">
  Time at which the charging station was created. RFC 3339 UTC timestamp with millisecond precision, e.g. `2026-03-03T14:05:23.789Z`.
</ResponseField>

<ResponseField name="operator_contact" type="string">
  Contact information for station support or issues.
</ResponseField>

<ResponseField name="updated" type="string">
  Time at which the station was last updated. RFC 3339 UTC timestamp with millisecond precision, e.g. `2026-03-03T14:05:23.789Z`.
</ResponseField>