Claims API

Manage verifiable claims and evaluation workflows

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 Structure

• Claim identifier
• Claim type
• Subject DID
• Issuer DID
• Claim content
• Evidence attachments
• Status tracking

Verification Process

• Automated checks
• Manual verification
• Multi-party consensus
• Oracle integration
• Status updates

Payment Integration

• 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

Impact Claims

• Environmental impact
• Social impact
• Economic impact
• SDG alignment

Verification Claims

• Identity verification
• Document verification
• Asset verification
• Location verification

Payment Claims

• Service delivery
• Asset transfer
• Token distribution
• Reward claims

Verification Methods

Automated Verification

• AI/ML models
• Data validation
• Pattern matching
• Rule engines

Manual Verification

• Expert review
• Document inspection
• Physical verification
• Multi-party consensus

Oracle Verification

• IoT data
• External APIs
• Market data
• Location data

Error Handling

Validation Errors

• Invalid claim format
• Missing evidence
• Unauthorized access
• Duplicate claims

Processing Errors

• Verification failure
• Payment failure
• Network issues
• Timeout errors

Best Practices

Security

• DID authentication
• Evidence validation
• Access control
• Audit logging

Performance

• Batch processing
• Caching
• Rate limiting
• Async operations

Integration

• 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.