Get My Sent Access Requests
Requests the user has made, newest first. ?status= filters by pending, accepted, declined or revoked.
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
requests:read) - userToken
Authorization
bearerAuth userTokenAuth Partner API key (lyh_...): identifies the calling partner, its scopes and rate limit.
In: header
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
Response Body
application/json
application/json
curl -X GET "https://example.com/v1/me/access-requests/sent"{ "data": [ { "id": "b3b6f1d2-8f0a-4c53-9b6e-6a4b1b1c0a77", "createdAt": "2026-10-02T08:30:34.119354+00:00", "updatedAt": "2026-10-02T08:30:34.119354+00:00", "status": "pending", "role": "Buyer", "transactionId": "9a5424e0-2413-4890-a5ca-6e90f4604ae9", "address": { "line1": "5 HOLLY CRESCENT", "line2": null, "city": "EDINBURGH", "region": "EDINBURGH", "postcode": "EH10 4QW", "country": "GB" }, "from": "Mr M. Hardwick" } ], "nextCursor": null}Get My Access Requests
Requests from other people to join transactions the user can edit parties on, newest first. ?status= filters by pending, accepted, declined or revoked.
Post Access Request Accept
Accepts someone's request to join a transaction, adding them as a party. The user needs transactionParty.canEdit on it and can't grant more than they hold. A request that doesn't exist is notfound; the success state is an example (the executed collection has no one else's request to accept).