Skip to main content
GET
/
api
/
v1
/
households
List households
curl --request GET \
  --url https://api.grainledger.com/api/v1/households \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Organization-Id: <x-organization-id>'

Documentation Index

Fetch the complete documentation index at: https://docs.grainledger.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

​
X-Organization-Id
string<uuid>
required

Organization ID for multi-tenant data access

Query Parameters

​
page
integer
default:1
​
limit
integer
default:20
​
search
string

Response

200

Paginated households