XnY Protocol
ConceptsDeveloper
API ReferenceDatasets

Access-grant anchors for this dataset

Newest first, by block then log index.

GET
/v1/datasets/{id}/grants
/v1/datasets/{id}/grants

Path Parameters

id
Required
string

The dataset version's 32-byte id.

Pattern: "^0[xX][0-9a-fA-F]{64}$"

Query Parameters

statusstring

Filter by grant status. Case-insensitive; empty is treated as ALL. Any other value is a 400 — unlike most filters here, it is not ignored.

Default: "ALL"Value in: "ACTIVE" | "REVOKED" | "ALL"

limitinteger

Page size. Server-configured default and ceiling (API_DEFAULT_LIMIT / API_MAX_LIMIT; 50 and 200 unless overridden). A value above the ceiling is silently clamped, not rejected — check pagination.limit in the response rather than assuming the requested value was honoured. Values below 1, or non-integers, are a 400.

Minimum: 1

cursorstring

Opaque cursor from a previous response's pagination.nextCursor. Omit for the first page. A malformed cursor is a 400.

curl -X GET "http://lineage-api.xny-staging.svc.cluster.local:8001/v1/datasets/0x807bacabedff64313f86ee41a00c566462c8b6fc807bacabedff64313f86ee41/grants?status=ACTIVE&limit=1&cursor=string"

A page of grant anchors.

{
  "items": [
    {
      "grantId": "0x807bacabedff64313f86ee41a00c566462c8b6fc807bacabedff64313f86ee41",
      "subjectDidHash": "0x807bacabedff64313f86ee41a00c566462c8b6fc807bacabedff64313f86ee41",
      "status": "ACTIVE",
      "blockNumber": 0,
      "txHash": "0x807bacabedff64313f86ee41a00c566462c8b6fc807bacabedff64313f86ee41"
    }
  ],
  "pagination": {
    "limit": 0,
    "nextCursor": "string",
    "hasMore": true
  }
}

Last updated

Previous

Contributors credited in this dataset version

Next

Live ERC-1155 ownership snapshot