V1Properties
Get Properties
Happy path: properties the user owns, newest-updated first.
Pagination: limit (1-100, default 25) and cursor (an opaque
nextCursor from a previous response; null when there are no more pages).
Results are newest-updated first. Responses are { "data": [...], "nextCursor": "..." | null }.
Required variables:
- baseUrl
- apiKey (needs
properties:read) - userToken
Authorization
bearerAuth userTokenAuth AuthorizationBearer <token>
Partner API key (lyh_...): identifies the calling partner, its scopes and rate limit.
In: header
X-User-Token<token>
The user's OAuth 2.1 access token, issued by Land Your Home's OAuth server to this partner's OAuth client. Requests run as this user.
In: header
Query Parameters
limit?string
cursor?string
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/properties"{ "data": [ { "id": "1aade797-824c-4d04-961a-9e407e8e1fc4", "updatedAt": "2026-10-02T08:36:26.062403+00:00", "saleState": "for-sale-no-offers", "ownershipType": "free-hold", "address": { "line1": "78 OAK STREET", "line2": "", "city": "BIRMINGHAM", "region": "WEST MIDLANDS", "postcode": "B13 9LR", "country": "GB" }, "listing": { "amount": 630614, "currency": "GBP", "agent": "DESIGNIBL Estate Agents", "url": null }, "yourOwnership": { "since": "2006-06-15T00:00:00+00:00", "until": null, "type": null } } ], "nextCursor": null}
