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

  • Claim identifier
  • Claim type
  • Subject DID
  • Issuer DID
  • Claim content
  • Evidence attachments
  • Status tracking
  • Automated checks
  • Manual verification
  • Multi-party consensus
  • Oracle integration
  • Status updates
  • Payment triggers
  • Token transfers
  • Fee calculation
  • Payment verification
  • Refund handling

​
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

  • Environmental impact
  • Social impact
  • Economic impact
  • SDG alignment
  • Identity verification
  • Document verification
  • Asset verification
  • Location verification
  • Service delivery
  • Asset transfer
  • Token distribution
  • Reward claims

​
Verification Methods

  • AI/ML models
  • Data validation
  • Pattern matching
  • Rule engines
  • Expert review
  • Document inspection
  • Physical verification
  • Multi-party consensus
  • IoT data
  • External APIs
  • Market data
  • Location data

​
Error Handling

  • Invalid claim format
  • Missing evidence
  • Unauthorized access
  • Duplicate claims
  • Verification failure
  • Payment failure
  • Network issues
  • Timeout errors

​
Best Practices

  • DID authentication
  • Evidence validation
  • Access control
  • Audit logging
  • Batch processing
  • Caching
  • Rate limiting
  • Async operations
  • Webhook support
  • Event streaming
  • State management
  • Error recovery

​
Developer Resources

SDK Reference

Claims SDK documentation

Examples

Implementation examples

Support

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