Developer reference · v1

Read the record.

A small public API for permitted profiles and contribution receipts.

Public responses include only published, complete receipts. Private or unavailable receipts return 404. No universal reputation score is provided.

Public endpoints

Profile and latest public receipts
GET /api/v1/profiles/:handle
Single published receipt
GET /api/v1/receipts/:id
Name availability on this deployment’s network
GET /api/v1/handles/:handle

Amounts are integer luna strings: 100,000 luna = 1 NIM. Responses carry a network field. Dates use ISO 8601. The profile response is capped at 50 latest public receipts, including historical withdrawals.

const response = await fetch(appOrigin + "/api/v1/profiles/" + encodeURIComponent(handle));
const data = await response.json();
if (!response.ok) throw new Error(data.error?.message || "Request failed");
for (const receipt of data.receipts) {
  // Inspect provenance, network and withdrawal status.
  console.log(receipt.statement, receipt.amountLuna);
}

Public reads support cross-origin GET and OPTIONS without credentials. Authenticated writes require a same-origin wallet session. A successful response describes checks stored by Dotneet, not proof of contribution quality.

See the included Data and API specification for complete contracts, error codes, authentication and the payment lifecycle. External integration code is provided in examples/.