XnY Protocol
ConceptsDeveloper
API ReferenceDIDs

CFs submitted by this DID, newest first

200 with an empty page for an unknown DID — never 404.

GET
/v1/dids/{did}/contributions
/v1/dids/{did}/contributions

Path Parameters

did
Required
string

Accepts did:xny:<uuid>, did:xny:<decimal>, bare <uuid> or bare <decimal>. Percent-encoded forms work too — the handler unescapes first, so did%3Axny%3A... from encodeURIComponent resolves correctly.

Query Parameters

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/dids/string/contributions?limit=1&cursor=string"

A page of contributions.

{
  "items": [
    {
      "cfId": "0x807bacabedff64313f86ee41a00c566462c8b6fc807bacabedff64313f86ee41",
      "frontierId": "0x807bacabedff64313f86ee41a00c566462c8b6fc807bacabedff64313f86ee41",
      "kind": 0,
      "parentCfId": "0x807bacabedff64313f86ee41a00c566462c8b6fc807bacabedff64313f86ee41",
      "verdict": 0,
      "qualityGrade": 0,
      "blockNumber": 0
    }
  ],
  "pagination": {
    "limit": 0,
    "nextCursor": "string",
    "hasMore": true
  }
}

Last updated

Previous

DID profile with contribution and dataset counts

Next

Non-zero dataset-share balances held by this DID's DBA