---
title: "One charging site: connectors, power, price, access, network and position"
method: GET
path: "/v1/sites/{publicID}"
---

# One charging site: connectors, power, price, access, network and position

`GET /v1/sites/{publicID}`

## Request

- Base URL: `https://api.chargealong.io`
- URL: `https://api.chargealong.io/v1/sites/{publicID}`
- Auth: none required

The public id is the last segment of a site's slug in its page URL, eight characters.

## Path parameters

- `publicID` string, required

## Response `200`

The site, its connectors, its sources and nearby alternatives. A site gone from every source still answers, with site.status removed; the page on chargealong.io answers 410 for it.

- SiteResponse: The answer, in the envelope every read shares.
  - `data` SitePage, required: One charging site in full.
    - `country` Country, required: A country with charging sites.
      - `iso2` string, required: ISO 3166-1 alpha-2 code.
      - `slug` string, required: The country in URLs: australia, new-zealand.
      - `name` string, required: The country's English name.
      - `site_count` integer, required: Charging sites listed in the country, active and unavailable.
    - `region` Region, required: A state, territory or region within a country.
      - `slug` string, required: The region in URLs: victoria.
      - `code` string: The region's short code where it has one: VIC. Absent where it has none.
      - `name` string, required: The region's name.
      - `site_count` integer, required: Charging sites listed in the region.
    - `locality` Locality, required: A suburb or town.
      - `slug` string, required: The locality in URLs, unique within its region.
      - `name` string, required: The locality's name.
      - `postcode` string: Its postcode, where the country has them and it is known.
      - `time_zone` string: IANA time zone, where known: Australia/Melbourne.
      - `site_count` integer, required: Charging sites listed in the locality.
      - `region` string: The region's slug, present on lists that cross regions, such as a country's busiest places.
    - `site` SiteDetail, required: A site in full: everything a list shows, plus who runs it, who may use it and what it costs.
      - `public_id` string, required: The site's permanent id: eight characters, never reused.
      - `name` string, required: The site's name.
      - `network` string, required: The charging network's slug: chargefox, evie-networks, tesla. independent when there is none.
      - `network_name` string: The network's display name.
      - `address` string: The street address as the source gives it.
      - `status` 'active' | 'unavailable' | 'planned' | 'removed', required: active: in service. unavailable: listed but reported out of service. planned: announced, not yet open. removed: gone from every source; the record stays so an old link still answers, and the page on the site answers 410.
      - `speed` 'ac' | 'fast' | 'ultra-fast', required: The site's fastest connector as a tier. ac: under 50 kW, usually AC destination charging. fast: 50 kW to under 150 kW DC. ultra-fast: 150 kW and over.
      - `max_kw` number, nullable, required: The fastest connector's power in kW. Null when no source states a power.
      - `plugs` integer, required: How many connectors the site has, across every standard.
      - `standards` string[], required: Connector standards at the site, as slugs: ccs2, chademo, type-2, nacs, ccs1, type-1, gbt.
      - `cost_kind` 'free' | 'paid' | 'unknown', required: free: no charge. paid: a price applies; see the site's cost. unknown: the sources do not say.
      - `lat` number, required: Latitude, WGS 84.
      - `lng` number, required: Longitude, WGS 84.
      - `path` string, required: The page on https://chargealong.io this record is shown on, as a path: prefix it with https://chargealong.io.
      - `distance_km` number: Kilometres from the point the list is measured from, on lists measured from a point.
      - `operator` string: Who operates the site, where it differs from or adds to the network.
      - `usage` string, required: Who may charge: public, or a restriction as the source words it, such as customers or members.
      - `access_text` string: Access notes from the source: opening hours, where to find it.
      - `cost` Cost, required: What charging costs, as far as the sources say.
        - `kind` 'free' | 'paid' | 'unknown', required: free: no charge. paid: a price applies; see the site's cost. unknown: the sources do not say.
        - `currency` string: ISO 4217 code for the prices below: AUD.
        - `per_kwh_min` number: Lowest price per kWh.
        - `per_kwh_max` number: Highest price per kWh.
        - `per_minute` number: Price per minute connected.
        - `per_hour` number: Price per hour connected.
        - `has_conditions` boolean, required: Whether the price has conditions the figures cannot express, such as a membership or a time of day.
        - `text` string: The price as the source words it.
      - `last_verified_at` string, date-time: When a source last verified the record, where one says.
      - `updated_at` string, date-time, required: When this record last changed here.
    - `connectors` Connector[], required: Its connectors.
      - `standard` 'ccs2' | 'chademo' | 'type-2' | 'nacs' | 'ccs1' | 'type-1' | 'gbt' | 'other', required: The standard's slug, or other for a socket outside the known standards.
      - `label` string: The source's own name for it, where that says more than the standard.
      - `current` 'ac' | 'dc', required: ac or dc.
      - `power_kw` number, nullable, required: Power in kW. Null when no source states it.
      - `quantity` integer, required: How many of this connector the site has.
    - `sources` Source[], required: Where its record came from. Credit these where you show the site.
      - `key` string, required: The source's key: ocm, nswev, qldev, tesla and others.
      - `external_id` string, required: The record's id in that source.
      - `provider` string: Who publishes the source, for the credit line.
      - `licence` string, required: The licence the record is under: CC BY 4.0. Attribution is a condition of use.
      - `last_seen_at` string, date-time, required: When the source last listed the record.
    - `alternatives` Site[], required: Nearby sites, nearest first, with distance_km.
      - `public_id` string, required: The site's permanent id: eight characters, never reused.
      - `name` string, required: The site's name.
      - `network` string, required: The charging network's slug: chargefox, evie-networks, tesla. independent when there is none.
      - `network_name` string: The network's display name.
      - `address` string: The street address as the source gives it.
      - `status` 'active' | 'unavailable' | 'planned' | 'removed', required: active: in service. unavailable: listed but reported out of service. planned: announced, not yet open. removed: gone from every source; the record stays so an old link still answers, and the page on the site answers 410.
      - `speed` 'ac' | 'fast' | 'ultra-fast', required: The site's fastest connector as a tier. ac: under 50 kW, usually AC destination charging. fast: 50 kW to under 150 kW DC. ultra-fast: 150 kW and over.
      - `max_kw` number, nullable, required: The fastest connector's power in kW. Null when no source states a power.
      - `plugs` integer, required: How many connectors the site has, across every standard.
      - `standards` string[], required: Connector standards at the site, as slugs: ccs2, chademo, type-2, nacs, ccs1, type-1, gbt.
      - `cost_kind` 'free' | 'paid' | 'unknown', required: free: no charge. paid: a price applies; see the site's cost. unknown: the sources do not say.
      - `lat` number, required: Latitude, WGS 84.
      - `lng` number, required: Longitude, WGS 84.
      - `path` string, required: The page on https://chargealong.io this record is shown on, as a path: prefix it with https://chargealong.io.
      - `distance_km` number: Kilometres from the point the list is measured from, on lists measured from a point.
    - `faster` Site: A charging site as a list shows it.
      - `public_id` string, required: The site's permanent id: eight characters, never reused.
      - `name` string, required: The site's name.
      - `network` string, required: The charging network's slug: chargefox, evie-networks, tesla. independent when there is none.
      - `network_name` string: The network's display name.
      - `address` string: The street address as the source gives it.
      - `status` 'active' | 'unavailable' | 'planned' | 'removed', required: active: in service. unavailable: listed but reported out of service. planned: announced, not yet open. removed: gone from every source; the record stays so an old link still answers, and the page on the site answers 410.
      - `speed` 'ac' | 'fast' | 'ultra-fast', required: The site's fastest connector as a tier. ac: under 50 kW, usually AC destination charging. fast: 50 kW to under 150 kW DC. ultra-fast: 150 kW and over.
      - `max_kw` number, nullable, required: The fastest connector's power in kW. Null when no source states a power.
      - `plugs` integer, required: How many connectors the site has, across every standard.
      - `standards` string[], required: Connector standards at the site, as slugs: ccs2, chademo, type-2, nacs, ccs1, type-1, gbt.
      - `cost_kind` 'free' | 'paid' | 'unknown', required: free: no charge. paid: a price applies; see the site's cost. unknown: the sources do not say.
      - `lat` number, required: Latitude, WGS 84.
      - `lng` number, required: Longitude, WGS 84.
      - `path` string, required: The page on https://chargealong.io this record is shown on, as a path: prefix it with https://chargealong.io.
      - `distance_km` number: Kilometres from the point the list is measured from, on lists measured from a point.
    - `reviews` Reviews, required: A site's reviews: the summary and the newest visible ones.
      - `summary` ReviewSummary, required: What visitors said about a site, summed over visible reviews.
        - `count` integer, required: Visible reviews with a rating.
        - `average` number, nullable, required: Average rating out of five. Null with no ratings.
        - `last_worked_at` string, date-time, nullable, required: The newest visible report of a successful charge.
        - `last_checked_at` string, date-time, nullable, required: The newest visible confirmation that the rest of the page is right.
      - `recent` Review[], required: The newest visible reviews, newest first.
        - `id` integer, required: The review's id.
        - `name` string, required: The name the reviewer chose, or the random one they were given.
        - `worked` 'charged' | 'failed' | 'no_try', required: charged: it worked. failed: it did not. no_try: they did not try to charge.
        - `rating` integer, nullable, required: Rating out of five, or null when they gave none.
        - `body` string: What they wrote, when they wrote something.
        - `created_at` string, date-time, required: When it was written.
    - `photos` Photo[], required: Approved photos, newest first.
      - `id` string, required: The photo's id. Served at https://chargealong.io/media/{id}.
      - `licence` string, required: The licence it was given under: CC BY 4.0, credited to its contributor.
      - `width` integer, required: Width in pixels.
      - `height` integer, required: Height in pixels.
      - `created_at` string, date-time, required: When it was added.
  - `next_cursor` string: Present only on a paged list: pass it back to read the next page. No public read is paged today.
  - `generated_at` string, date-time, required: When this answer was generated, UTC. Answers are cached, so it can be up to an hour old.

## Other responses

- `404`: No such site
- `503`: The database is unavailable

---

[API](https://skmtc.dev/chargealong/apis/chargealong-api.md) · [All operations](https://skmtc.dev/chargealong/apis/chargealong-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chargealong/apis/chargealong-api/revisions/f7968808e434?raw)