Light mode version of Land Your Home
V1Transactions

Get Transaction Stages

GET
/v1/transactions/{transactionId}/stages

Happy path: the transaction's stages, most recently updated first (deleted stages are excluded). assignedToYou is true for stages the user owns.

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/stages"
{  "data": [    {      "id": "fb51d33e-847b-4c02-9036-1b6dbdbbcea2",      "transactionId": "b939a7de-a264-4855-b37d-d9721cea8797",      "title": "Mortgage Offer",      "description": "Formal mortgage offer received from lender",      "progress": "Not Started",      "progressNote": null,      "expectedUpdate": "2026-11-06T00:00:00+00:00",      "expectedCompletion": "2026-11-13T00:00:00+00:00",      "assignedToYou": false,      "assigned": false,      "dependsOnStageId": "ac590289-8f53-4deb-ad08-295ef2c0c233",      "createdAt": "2026-10-02T08:36:26.074778+00:00",      "updatedAt": "2026-10-02T08:36:26.074778+00:00"    }  ],  "nextCursor": "eyJ1IjoiMjAyNi0xMC0wMlQwODozNjoyNi4wNzQ3NzgrMDA6MDAiLCJpIjoiYzMxMmY1ZDAtYTcxNy00MWNmLTkxNmEtYjI4MWQzNzcwMjYzIn0"}

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.

Post Transaction Stage

Creates a stage on a transaction the user is an active party on. Only title is required; progress is Not Started (default), In Progress, Blocked or Completed; expectedUpdate/expectedCompletion are ISO 8601 timestamps. dependsOnStageId makes it depend on another stage of the same transaction.