---
title: "Retrieve POI list (sites)"
method: GET
path: "/poi"
---

# Retrieve POI list (sites)

`GET /poi`

Used to fetch a list of POIs (sites) within a geographic boundary or near a specific latitude/longitude. This is the primary method for most applications and services to consume data from Open Charge Map.

## Query parameters

- `output` string
- `client` string
- `maxresults` integer
- `countrycode` string
- `countryid` string[]
- `latitude` integer
- `longitude` number
- `distance` number
- `distanceunit` string
- `operatorid` unknown[]
  - unknown
- `connectiontypeid` unknown[]
  - unknown
- `levelid` unknown[]
  - unknown
- `usagetypeid` unknown[]
  - unknown
- `statustypeid` unknown[]
  - unknown
- `dataproviderid` unknown[]
  - unknown
- `opendata` boolean
- `includecomments` boolean
- `verbose` boolean
- `compact` boolean
- `camelcase` boolean
- `chargepointid` string
- `boundingbox` unknown[]
  - unknown
- `polygon` string
- `polyline` string
- `sortby` string
- `modifiedsince` string
- `greaterthanid` string

## Response `200`

List of POIs (sites) with associated equipment summary information.

- POI[]
  - `ID` integer — The OCM reference ID for this POI (Point of Interest).
  - `UUID` string, uuid — A universally unique identifier used as surrogate key. ID and UUID must be preserved when submitting POI update information.
  - `UserComments` UserComment[] — A list of user comments or check-ins for this site
    - `ID` string
    - `ChargePointID` integer
    - `CommentTypeID` integer
    - `CommentType` UserCommentType — Category for a user comment, e.g. General Comment, Fault Report (Notice To Users And Operator)
      - `ID` integer
      - `Title` string
    - `UserName` string
    - `Comment` string
    - `RelatedURL` string
    - `DateCreated` string, date-time
    - `User` UserInfo — Short public summary profile for a specific Open Charge Map user
      - `ID` integer
      - `Username` string
      - `ReputationPoints` integer
      - `ProfileImageURL` string
    - `CheckinStatusTypeID` integer
    - `CheckinStatusType` CheckinStatusType — Classification for the users comment or experience using a specific charging location.
      - `ID` integer, required
      - `Title` string
      - `IsAutomatedCheckin` boolean, required — If true, checkin or comment was provided by an automated system.
      - `IsPositive` boolean — If true, this type of checkin/comment is considered positive.
  - `MediaItems` MediaItem[] — A list of user submitted photos for this site
    - `ID` string
    - `ChargePointID` string
    - `ItemURL` string
    - `ItemThumbnailURL` string
    - `Comment` string
    - `IsEnabled` boolean
    - `IsVideo` boolean
    - `IsFeaturedItem` boolean
    - `IsExternalResource` boolean
    - `User` UserInfo — Short public summary profile for a specific Open Charge Map user
      - `ID` integer
      - `Username` string
      - `ReputationPoints` integer
      - `ProfileImageURL` string
    - `DateCreated` string
  - `IsRecentlyVerified` boolean — A dynamically computed value indicating of any recently confirmation activity has taken place for this site (positive check-ins etc)
  - `DateLastVerified` string, date-time — A dynamically computed value, the date and time (UTC, ISO 8601) this POI was last confirmed by a user edit or related user comment
  - `ParentChargePointID` integer — If present, this data in this POI supercedes information in another POI. Generally not relevant to consumers.
  - `DataProviderID` integer — The reference ID for the Data Provider of this POI
  - `DataProvidersReference` string — If present, this is the Data Providers own key for this POI within their source data set
  - `OperatorID` integer — The reference ID of the equipment network operator or owner
  - `OperatorsReference` string — The network operators own reference for this site (may be a site reference or a single equipment reference)
  - `UsageTypeID` integer — The reference ID for the site Usage Type, 0 == Unknown
  - `UsageCost` string — Free text description of likely usage costs associated with this site. Generally relates to parking charges whether network operates this site as Free
  - `AddressInfo` AddressInfo — Geographic position for site and (nearest) address component information.
    - `ID` integer, required — ID
    - `AddressLine1` string — First line of nearby street address
    - `AddressLine2` string — Second line of nearby street address
    - `Town` string — Town or City
    - `StateOrProvince` string — State or Province
    - `Postcode` string — Postal code or Zipcode
    - `CountryID` integer, required — The reference ID for the Country
    - `Country` Country — Country details
      - `ID` integer, required — The Id Schema
      - `ISOCode` string, required — The Isocode Schema
      - `ContinentCode` string, required — The Continentcode Schema
      - `Title` string — The Title Schema
    - `Latitude` number, required — Site latitude coordinate in decimal degrees
    - `Longitude` number, required — Site longitude coordinate in decimal degrees
    - `ContactTelephone1` string — Primary contact number
    - `ContactTelephone2` string — Secondary contact number
    - `ContactEmail` string — Primary contact email
    - `AccessComments` string — Guidance for users to use or find the equipment
    - `RelatedURL` string — Optional website for more information
    - `Distance` number — Distance from search location, if search is around a point
    - `DistanceUnit` integer — Unit used for distance, 1= Miles, 2 = KM
    - `Title` string — General title for this location to aid user
  - `Connections` ConnectionInfo[] — List of equipment summary information for this site
    - `ID` integer
    - `ConnectionTypeID` integer
    - `ConnectionType` ConnectionType — The type of end-user connection an EVSE supports.
      - `FormalName` string — Formal (standard) name for this connection type
      - `IsDiscontinued` boolean — If true, this is an discontinued but used connection type
      - `IsObsolete` boolean — If true, this is an obsolete connection type and is unlikely top be present in modern infrastructure
      - `ID` integer
      - `Title` string
    - `Reference` string — Optional operators reference for this connection/port
    - `StatusTypeID` integer — Status Type reference ID. 0 = Unknown
    - `StatusType` StatusType — The Status Type of a site or equipment item indicates whether it is generally operational.
      - `IsOperational` boolean, required
      - `IsUserSelectable` boolean, required
      - `ID` integer, required
      - `Title` string
    - `LevelID` integer — A general category for power capability. Depreceated in favour of documenting specific equipment power in kW.
    - `Level` LevelType — A general category for equipment power capability. Deprecated for general use. Currently computed automatically based on equipment power.
      - `ID` integer, required
      - `Title` string
      - `Comments` string, required
      - `IsFastChargeCapable` boolean, required — If true, this level is considered 'fast' charging, relative to other levels.
    - `Amps` integer — EVSE supply max current in Amps
    - `Voltage` number — EVSE supply voltage
    - `PowerKW` number — Peak available power in kW
    - `CurrentTypeID` integer — The supply type reference ID (e.g. DC etc)
    - `CurrentType` SupplyType — Indicates the EVSE power supply type e.g. DC (Direct Current), AC (Single Phase), AC (3 Phase).
      - `ID` integer, required
      - `Title` string
    - `Quantity` integer — Optional summary number of equipment items available with this specification
    - `Comments` string
  - `NumberOfPoints` integer — The number of bays or discreet stations available overall at this site. This indicates the limiting for number of simultaneous site users.
  - `GeneralComments` string — General additional factual information for the POI. Users are discouraged from using this field for opinions on site quality etc.
  - `DatePlanned` string, date-time — The date and time (UTC, ISO 8601) this POI is or was planned for commissioning. In general planned POIs should not be presented to end users until confirmed operational.
  - `DateLastConfirmed` string, date-time — The date and time (UTC, ISO 8601) this POI was last confirmed according to the data provider or a user. See DateLastVerified for a dynamically computed date based on multiple signals.
  - `StatusTypeID` integer — The overall operational status type reference ID for this POI (i.e. Operational etc). 0 == Unknown
  - `DateLastStatusUpdate` string, date-time — The date and time (UTC, ISO 8601) this POI or directly related child properties were updated.
  - `MetadataValues` unknown[] — Optional array of metadata values. Generally used to indicate data attribution but is also intended for future use to indicate surrounding amenties, links or foreign key values into other data sets.
    - unknown
  - `DataQualityLevel` integer — A metric applied during imports to indicate a quality level based on available information detail (5 == best). Largely unused currently.
  - `DateCreated` string, date-time — The date and time (UTC, ISO 8601) this POI was added to the Open Charge Map database
  - `SubmissionStatusTypeID` integer — The reference ID for the submission status type which applied to this POI.
  - `DataProvider` DataProvider — A Data Provider is the controller of the source data set used to construct the details for this POI. Data has been transformed and interpreted from it's original form. Each Data Provider provides data either by an explicit license or agreement.
    - `WebsiteURL` string — Website URL for this data provider
    - `Comments` string — General public comments with information about this Data Provider.
    - `DataProviderStatusType` object — Status object describing whether this data provider is currently enabled and the type of source (manual entry, imported etc)
      - `IsProviderEnabled` boolean, required — If false, results from this data provider are not currently enabled
      - `ID` integer, required — The reference ID for this provider status type
      - `description` string — The Title of this status type
    - `IsRestrictedEdit` boolean, required — Currently not implemented. Indicates a potential editing restriction.
    - `IsOpenDataLicensed` boolean — If true, data provider uses an Open Data license
    - `IsApprovedImport` boolean — If false, data may not be imported for this provider.
    - `License` string — Summary of the licensing which applies for this Data Provider. Each Data Provider has one specific license or agreement. Usage of the data requires acceptance of the given license.
    - `DateLastImported` string, date-time — Date and time (UTC) the last import was performed for this data provider (if an import).
    - `ID` integer, required — The reference ID for this Data Provider
    - `Title` string — The Title for this Data Provider
  - `OperatorInfo` OperatorInfo — An Operator is the public organisation which controls a network of charging points.
    - `WebsiteURL` string — Website for more information about this network
    - `Comments` string
    - `PhonePrimaryContact` string — Primary contact number for network users
    - `PhoneSecondaryContact` string — Secondary contact number
    - `IsPrivateIndividual` boolean — If true, this operator represents a private individual
    - `AddressInfo` AddressInfo — Geographic position for site and (nearest) address component information.
      - `ID` integer, required — ID
      - `AddressLine1` string — First line of nearby street address
      - `AddressLine2` string — Second line of nearby street address
      - `Town` string — Town or City
      - `StateOrProvince` string — State or Province
      - `Postcode` string — Postal code or Zipcode
      - `CountryID` integer, required — The reference ID for the Country
      - `Country` Country — Country details
        - `ID` integer, required — The Id Schema
        - `ISOCode` string, required — The Isocode Schema
        - `ContinentCode` string, required — The Continentcode Schema
        - `Title` string — The Title Schema
      - `Latitude` number, required — Site latitude coordinate in decimal degrees
      - `Longitude` number, required — Site longitude coordinate in decimal degrees
      - `ContactTelephone1` string — Primary contact number
      - `ContactTelephone2` string — Secondary contact number
      - `ContactEmail` string — Primary contact email
      - `AccessComments` string — Guidance for users to use or find the equipment
      - `RelatedURL` string — Optional website for more information
      - `Distance` number — Distance from search location, if search is around a point
      - `DistanceUnit` integer — Unit used for distance, 1= Miles, 2 = KM
      - `Title` string — General title for this location to aid user
    - `BookingURL` string
    - `ContactEmail` string
    - `FaultReportEmail` string — Used to send automated notification to network operator if a user submits a fault report comment/check-in
    - `IsRestrictedEdit` boolean — If true, this network restricts community edits for OCM data
    - `ID` integer, required — Id
    - `Title` string — Title
  - `UsageType` UsageType — The Usage Type of a site indicates the general restrictions on usage.
    - `IsPayAtLocation` boolean, required — If true, usage requires paying at location
    - `IsMembershipRequired` boolean, required — If true, this usage type requires registration or membership with a service.
    - `IsAccessKeyRequired` boolean, required — If true this usage required a physical access key
    - `ID` integer, required
    - `Title` string
  - `StatusType` StatusType — The Status Type of a site or equipment item indicates whether it is generally operational.
    - `IsOperational` boolean, required
    - `IsUserSelectable` boolean, required
    - `ID` integer, required
    - `Title` string
  - `SubmissionStatus` SubmissionStatusType — Submission Status object, detailing the POI listing status
    - `ID` integer, required — Submission Status Type reference ID
    - `Title` string
    - `IsLive` boolean, required — If true, POI listing is live (not draft or de-listed)

---

[API](https://skmtc.dev/n-a-andreibesleaga/apis/open-charge-map-api.md) · [All operations](https://skmtc.dev/n-a-andreibesleaga/apis/open-charge-map-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/n-a-andreibesleaga/open-charge-map-api/revisions/b8a18cb73e98/schema)