Skip to content
Integra Docs

API Reference

API Reference

Section titled “API Reference”

REST Endpoints

Section titled “REST Endpoints”

Attestation Queries

Section titled “Attestation Queries”

GET /attestations

Section titled “GET /attestations”

Query attestations with flexible filtering and pagination.

Parameters:

  • chainId (optional): Filter by blockchain network
  • schemaName (optional): Filter by schema type
  • recipient (optional): Filter by recipient address
  • attester (optional): Filter by attester address
  • componentId (optional): Filter by component ID
  • includeRevoked (optional): Include revoked attestations
  • limit (optional): Results per page (default: 50)
  • offset (optional): Pagination offset

GET /attestation/{uid}

Section titled “GET /attestation/{uid}”

Retrieve a specific attestation by its unique identifier.

GET /attestations/stats

Section titled “GET /attestations/stats”

Get comprehensive statistics grouped by schema and chain.

Schema Management

Section titled “Schema Management”

GET /schemas

Section titled “GET /schemas”

Retrieve all registered schemas with optional filtering.

Parameters:

  • chainId (optional): Filter by deployment chain
  • category (optional): Filter by schema category
  • schemaName (optional): Filter by specific schema

GET /schema/{name}

Section titled “GET /schema/{name}”

Get detailed information about a specific schema including deployment status.

GET /schemas/definitions

Section titled “GET /schemas/definitions”

Retrieve all static schema definitions organized by category.

Chain Information

Section titled “Chain Information”

GET /chains

Section titled “GET /chains”

List all supported blockchain networks with EAS configuration and schema counts.

GET /chains/{chainId}/schemas

Section titled “GET /chains/{chainId}/schemas”

Get all deployed schemas for a specific blockchain network.

Workflow Tracking

Section titled “Workflow Tracking”

GET /status/{workflowId}

Section titled “GET /status/{workflowId}”

Check the processing status of an attestation workflow.

tRPC Procedures

Section titled “tRPC Procedures”

The /trpc endpoint provides type-safe API access with automatic validation:

Mutations

Section titled “Mutations”
  • attest: Create single attestation
  • revoke: Revoke existing attestation
  • batchAttest: Create multiple attestations

Queries

Section titled “Queries”
  • getStatus: Check workflow status
  • getAttestation: Retrieve attestation by UID

Webhook Endpoints

Section titled “Webhook Endpoints”

POST /webhook/rpc

Section titled “POST /webhook/rpc”

Processes blockchain event notifications for attestation confirmations. Requires x-integra-signature header for authentication.