---
title: "Core Reference Data"
method: GET
path: "/referencedata"
---

# Core Reference Data

`GET /referencedata`

Returns the core reference data used for looking up IDs such as Connection Types, Operators, Countries etc. 

This information is useful for UIs such as editing systems or for fetching results in the lighter non-verbose mode, then hydrating POI results back into complex objects.

## Query parameters

- `countryid` unknown[]
  - unknown

## Response `200`

OK

- CoreReferenceData — Set of core reference data used for other API results and UI
  - `ChargerTypes` LevelType[]
    - `ID` integer, required
    - `Title` string
    - `Comments` string, required
    - `IsFastChargeCapable` boolean, required — If true, this level is considered 'fast' charging, relative to other levels.
  - `ConnectionTypes` ConnectionType[]
    - `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
  - `CheckinStatusTypes` CheckinStatusType[]
    - `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.
  - `Countries` Country[]
    - `ID` integer, required — The Id Schema
    - `ISOCode` string, required — The Isocode Schema
    - `ContinentCode` string, required — The Continentcode Schema
    - `Title` string — The Title Schema
  - `CurrentTypes` SupplyType[]
    - `ID` integer, required
    - `Title` string
  - `DataProviders` DataProvider[]
    - `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
  - `DataTypes` unknown
  - `MetadataGroups` string
  - `Operators` OperatorInfo[]
    - `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
  - `StatusTypes` StatusType[]
    - `IsOperational` boolean, required
    - `IsUserSelectable` boolean, required
    - `ID` integer, required
    - `Title` string
  - `SubmissionStatusTypes` SubmissionStatusType[]
    - `ID` integer, required — Submission Status Type reference ID
    - `Title` string
    - `IsLive` boolean, required — If true, POI listing is live (not draft or de-listed)
  - `UsageTypes` UsageType[]
    - `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
  - `UserCommentTypes` UserCommentType[]
    - `ID` integer
    - `Title` string

---

[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)
