Light mode version of Land Your Home
V1Me

Get My Licences

GET
/v1/me/licences

Licences the user holds personally plus those in the pools of teams they belong to (teamId is set on those). Billing details are never shown.

Required variables:

  • baseUrl
  • apiKey (needs licences: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

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/me/licences"
{  "data": [    {      "id": "4a90c5ef-5378-455d-9bee-fcf0143ba33b",      "type": "pro_tier",      "active": true,      "used": false,      "expiresAt": null,      "createdAt": "2026-10-03T09:00:00.000000+00:00",      "teamId": null,      "heldByYou": true    }  ],  "nextCursor": null}