Api root https://api.neightbourhoodcolab.com
GET /houses
Returns all houses and their owners
Example endpoint: GET https://api.neightbourhoodcolab.com/houses?api_key=my_key
Query options:
Query | Description | Additional info |
---|---|---|
api_key | api key for authenticating access | required to access API |
limit | limits the number of results | default: 50. If 0, will return all houses |
Response
{
"houses": [
{
"owner": {
"id": number unique id,
"name": string,
"age": number,
"number_of_occupants": number,
}
"house": {
"id": number unique id,
"house_number": number,
"house_name": string,
"address_line_1": string,
"address_line_2": string or null,
"address_line_3": string or null,
"county": string,
"postcode": string,
}
},
// ...
]
}
GET /houses/search
Returns and array of houses based on search query parametres.
By default returns all houses and owners.
Example endpoint: GET https://api.neightbourhoodcolab.com/houses/search?api_key=my_key&postcode=np255py
Query options:
Query | Description | Additional info |
---|---|---|
api_key | Api key for authenticating access | Required to access API |
limit | Limits the number of results | Default: 50. If 0, will return all houses |
postcode | Query based on postcode | |
house_name | Query based on house name | |
house_number | Query based on house number |
our data is stored in a relational database and the structure is outlined below.
id | name | age | number_of_occupants |
---|---|---|---|
number | string | number | number or null |
owner_id | house_id |
---|---|
number | number |
id | house_number | house_name | address_line_1 | address_line_2 | address_line_3 | county | postcode |
---|---|---|---|---|---|---|---|
number | number or null | string or null | string | string or null | string or null | string | string |