Retrieves a single place record from the CMS API v2.1 based on the supplied parameters.
Method | URL |
---|---|
GET |
v2/places/{id} |
Response format | JSON |
Paginated? | No |
Rate Limited? | Yes (more information) |
This API endpoint supports the following request parameters:
Parameter | Description | Notes |
---|---|---|
api_id | The API_ID is given to you with your access credentials. |
Required |
data | The URL encoded JSON data string of search parameters. | Required |
sig | The HMAC signature for this request. | Required |
fields |
A URL encoded JSON string of fields that should be included with the response. If fields are not included then the CMS API v2.1 will use a default set of fields. For example: { "place" : [ "name", "national_reference", "diocesan_reference" ], "building" : [ "address_line1", "address_line2", "town", "postcode" ], "place_type" : [ "name" ] } To retrieve a list of available place fields the CMS API v2.1 supports, please refer to the following API endpoint: |
https://cmsapi.cofeportal.org/v2/places/{id}?api_id={api_id}&data={data}&sig={sig}&fields={fields}
For more details, please see the section on request parameters.
The following search parameters can be used as part of the JSON data string:
Name | Type | Notes |
---|---|---|
diocese_id | Integer | Required field |
places | Array | This is a list of place id’s to refine the results for. Submit the values as an array. |
place_type | Array | This is optional and is a list of id’s specifying which place types to return. Current place types are listed below. |
sort_order | String | Options are:
|
The following lists details the id's and description for all the place types currently supported within the CMS.
ID | Description |
---|---|
1 | Archdeaconry |
2 | Benefice |
3 | Church |
4 | Deanery |
5 | Diocese |
6 | Extra Parochial |
7 | NonParochial |
8 | Parish |
9 | School |
10 | District |
12 | Office |
13 | Clergy Residence |
14 | Group |
15 | Hall |
16 | Department |
23 | Episcopal Area |
24 | Team Ministry |
25 | Burial Ground/Cemetery |
26 | Churchyard |
27 | Chapel of Ease |
A JSON object containing none or more CMS places or an error response. The fields return will either be the default set of fields available for the CMS API v2.1 or a limited set fields based on the field list supplied with the request.
If no fields are specified as part of the request, the following default fields will be return with the response:
Name | Type | Notes |
---|---|---|
id | Integer | ID of the place. |
parent_id | Integer | ID of the parent place. |
place_type_id | Integer | The ID of the place type. |
building_id | Integer | The ID of the building, if building data has been associated to this place. |
name | String | |
alternative_name | String | |
national_reference | String | |
diocesan_reference | String | |
other_reference | String | |
charity_commission_reference | String | |
website | String | |
comments | Text | |
plurality | String | |
patron | String | |
population | String | |
electoral_roll | String | |
created_at | Timestamp | The date and time the record was created. |
updated_at | Timestamp | The date and time the record was last updated. |
deleted_at | Timestamp | The date and time the record was deleted. |
redundant_at | Timestamp | The date and time the record was made redundant. |
Places can optionally have building data associated to them, so in addition to the place fields, the returned data shall also include the following building fields.
Name | Type | Notes |
---|---|---|
longitude | String | |
latitude | String | |
address_line1 | String | |
address_line2 | String | |
address_line3 | String | |
town | String | |
county | String | |
postcode | String | |
country | String | |
phone | String | |
fax | String | |
email_address | String | |
acny_id | String | The ID for the place on the third party website A Church Near You. |
chr_asset_id | String | The ID for the place on the third party website Church Heritage Record. |
notes | Text | |
opening_times | String |
Each place has been assigned a specific a place type. In addition to the place_type_id included as part of the place fields, the returned data will also include the following place type fields. A list of possible place types can be found above.
Name | Type | Notes |
---|---|---|
name | String |