Skip to content
Land Insights Land Insights

Authentication

The REST API authenticates with an API key you create in the Land Insights app.

API keys

Section titled “API keys”

Create and manage keys under Settings → API keys:

  • Keys start with lipk_.
  • The full key is shown once, when you create it. Store it securely; if you lose it, revoke it and create a new one.
  • Keys don’t expire on a schedule — revoke one at any time from the same screen.

Send your key on every request in the Authorization header:

Terminal window
curl "https://app-api.landinsights.co/api/public/v1/usage/" \
  -H "Authorization: Bearer lipk_your_key_here"

A missing or invalid key returns a 401 error.

Plans and access

Section titled “Plans and access”

The API is available to Pro subscribers. Within a Pro subscription, an API add-on controls which surfaces you can use:

  • Free API add-on (included with every Pro subscription) — covers the MCP server.
  • Starter API add-on or above — adds full REST API access.

Without a Pro subscription, requests return 402 subscription_required. With Pro but only the Free add-on, REST requests return 402 tier_upgrade_required (the MCP server still works). See Errors for the full list.