The Claims API enables the creation, verification, and management of verifiable claims within the IXO ecosystem. It supports automated verification workflows, payment processing, and dispute resolution.

Overview

Claim Creation

Submit and manage verifiable claims

Verification

Automated and manual verification workflows

Payments

Integrated payment processing

Disputes

Dispute management and resolution

Core Concepts

API Endpoints

Claim Management

POST /claims
GET /claims/{id}
PUT /claims/{id}
DELETE /claims/{id}
GET /claims/search

Verification

POST /claims/{id}/verify
GET /claims/{id}/verification-status
POST /claims/{id}/reject
POST /claims/{id}/approve

Payments

POST /claims/{id}/initiate-payment
GET /claims/{id}/payment-status
POST /claims/{id}/process-refund

Implementation Guide

  1. Create Claim

    const claim = await claimsClient.createClaim({
      type: 'ImpactClaim',
      subject: 'did:ixo:123',
      content: {
        // claim details
      },
      evidence: [
        // evidence attachments
      ]
    })
    
  2. Submit for Verification

    const verification = await claimsClient.submitForVerification(claim.id, {
      verifier: 'did:ixo:verifier',
      method: 'AutomatedCheck'
    })
    
  3. Process Payment

    const payment = await claimsClient.processPayment(claim.id, {
      amount: '100',
      denom: 'uixo',
      recipient: 'did:ixo:recipient'
    })
    
  4. Track Status

    const status = await claimsClient.getClaimStatus(claim.id)
    console.log(status.verification, status.payment)
    

Claim Types

Verification Methods

Error Handling

Best Practices

Developer Resources

For technical support or questions about the Claims API, join our Developer Community or contact our Developer Relations Team.

Was this page helpful?