Further additions made to the public retrieve API

cogs-process

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/

example response of 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].