Light mode version of Land Your Home
V1Transactions

Get Transaction

GET
/v1/transactions/{transactionId}

Happy path: a transaction the user is an active party on.

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

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/transactions/string"
{  "data": {    "id": "b939a7de-a264-4855-b37d-d9721cea8797",    "updatedAt": "2026-10-02T08:36:26.062403+00:00",    "chainId": "3876d6a9-bc6e-4225-b459-b4c480f982fd",    "saleState": "unknown",    "status": null,    "amount": 0,    "currency": "GBP",    "transactionDate": "2029-06-24T00:00:00+00:00",    "yourRole": "Buyer",    "yourPermissions": {      "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      }    },    "property": {      "id": "ccd9b5e2-ab83-4217-991e-95086ffbc74e",      "address": {        "line1": "62 POPLAR ROAD",        "line2": "",        "city": "CARDIFF",        "region": "CARDIFF",        "postcode": "CF14 3BL",        "country": "GB"      }    },    "listing": {      "amount": 151522,      "currency": "GBP",      "agent": "DESIGNIBL Estate Agents",      "url": null    },    "stageProgress": {      "notStarted": 9,      "inProgress": 0,      "blocked": 0,      "completed": 0    }  }}

Put Team Member Licence

Gives a member the oldest free licence of this type (protier or adaptiveqr) from the team's pool. Team admins only. 404 if the pool has none free. Sets assignedLicenceId.

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.