V1Transactions
Get Transaction Parties
Happy path: the active parties. Name, email, phone and company are masked according to each person's sharing settings; isYou marks the caller.
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
- userToken
- transactionId (set by
chains/Get Chain)
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
Path Parameters
transactionId*string
Query Parameters
limit?string
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/transactions/string/parties"{ "data": [ { "id": "3eba14ee-4422-41b4-accb-0b41f25d56d6", "isYou": false, "role": "Seller", "representing": "Seller", "name": "Mr Charlotte Davies", "email": "user6@landyourhome.co.uk", "phone": "+441234567896", "company": null, "companyWebsite": null, "permissions": { "chainNode": { "canView": true, "canEdit": true, "canDelete": true }, "propertyDetails": { "canView": true, "canEdit": true, "canDelete": true }, "transactionDetails": { "canView": true, "canEdit": true, "canDelete": true }, "transactionParty": { "canView": true, "canEdit": true, "canDelete": true }, "listingDetails": { "canView": true, "canEdit": true, "canDelete": true } } }, { "id": "e74dd2cc-887c-4960-908a-4abd82fca95a", "isYou": true, "role": "Buyer", "representing": "Buyer", "name": "Mr M. Hardwick", "email": "user1@landyourhome.co.uk", "phone": "+447387633408", "company": null, "companyWebsite": null, "permissions": { "chainNode": { "canView": true, "canEdit": true, "canDelete": true }, "propertyDetails": { "canView": true, "canEdit": true, "canDelete": true }, "transactionDetails": { "canView": true, "canEdit": true, "canDelete": true }, "transactionParty": { "canView": true, "canEdit": true, "canDelete": true }, "listingDetails": { "canView": true, "canEdit": true, "canDelete": true } } } ], "nextCursor": null}