Following on from the announcement of the four new API endpoints that have been added to the National Chargepoint Registry’s public API, an additional three API endpoints have been added in the form of ‘addedsince’, ‘updatedsince’ and ‘location’ as well as a new parameter for the retrieve endpoint named ‘basic’.
Each new endpoint uses the GET request method and is listed below with a brief description and route of the endpoint:
location
Returns device records that are within the postcode or post town specified. This endpoint accepts a full or partial postcode, or a post town as valid parameters.
Route: http://chargepoints.dft.gov.uk/api/retrieve/registry/location/{posttown/postcode}/
addedsince
Returns device records that have been added to the NCR since the specified date supplied in the YYYY-MM-DD date format as the parameter.
Route: http://chargepoints.dft.gov.uk/api/retrieve/registry/addedsince/{YYYY-MM-DD}/
updatedsince
Returns device records that have been updated in the NCR since the specified date supplied in the YYYY-MM-DD date format as the parameter.
Route: http://chargepoints.dft.gov.uk/api/retrieve/registry/updatedsince/{YYYY-MM-DD}/
basic
Returns only the basic details of a specified record or records, including the charge device id, latitude, longitude and details of the connectors belonging to the device.
Route: http://chargepoints.dft.gov.uk/api/retrieve/basic/
{ “ChargeDeviceId”: “cfeedcdd5e287bef4b583158a12363f1”, “Address”: { “Latitude”: “51.431454”, “Longitude”: “0.031175” }, “Connector”: [ { “ConnectorId”: “1”, “ConnectorType”: “3-pin Type G (BS1363)”, “RatedOutputkW”: “3.7”, “RatedOutputVoltage”: “230”, “RatedOutputCurrent”: “16”, “ChargeMethod”: “Single Phase AC”, “ChargeMode”: “1”, “ChargePointStatus”: “In service”, “TetheredCable”: “0”, “Information”: “x 3-pin square (BS 1363) - Standard (up to 3.7kW, 13-16A)”, “Validated”: “0” }, { “ConnectorId”: “2”, “ConnectorType”: “Type 2 Mennekes (IEC62196)”, “RatedOutputkW”: “7.0”, “RatedOutputVoltage”: “230”, “RatedOutputCurrent”: “32”, “ChargeMethod”: “Single Phase AC”, “ChargeMode”: “3”, “ChargePointStatus”: “In service”, “TetheredCable”: “0”, “Information”: “x 7-pin ‘Smart’ eg Mennekes (IEC 62196) - Fast (7kW, 32A)”, “Validated”: “0” } ] }
Detailed information about the existing and new API endpoints will shortly be added to existing API documentation found at: http://chargepoints.dft.gov.uk/api/help
For more information contact the NCR by phone on or email [email protected].