ClaimsIQ API

Developer Documentation

v1.0

ClaimsIQ API Documentation

Integrate pre-documented inventory data directly into your claims workflow

Base URL

https://api.proveniq.com/v1

Authentication

Bearer Token (OAuth 2.0)

Rate Limit

1000 requests/minute

Formats

JSON, XML (on request)

Endpoints

GET/policies/{policy_id}/inventory

Retrieve the complete inventory for a policyholder

Response Example:

{
  "policy_id": "POL-123456",
  "policyholder": {
    "name": "John Smith",
    "email": "john@example.com"
  },
  "inventory": {
    "total_items": 247,
    "total_value": 125000,
    "last_updated": "2025-12-01T10:30:00Z",
    "categories": [
      {
        "name": "Electronics",
        "items": 42,
        "value": 35000
      },
      {
        "name": "Furniture",
        "items": 28,
        "value": 22000
      }
    ]
  },
  "verification_status": "verified",
  "provenance_score": 87
}

POST/claims

Submit a new claim with pre-populated inventory data

Response Example:

{
  "claim_id": "CLM-789012",
  "status": "submitted",
  "policy_id": "POL-123456",
  "incident_date": "2025-12-05",
  "incident_type": "theft",
  "claimed_items": [
    {
      "item_id": "ITM-001",
      "name": "MacBook Pro 16\"",
      "category": "Electronics",
      "purchase_date": "2025-06-15",
      "purchase_price": 2499,
      "current_value": 1999,
      "documentation": {
        "photos": 3,
        "receipts": 1,
        "verified": true
      }
    }
  ],
  "total_claimed": 1999,
  "documentation_score": 95,
  "estimated_processing_time": "3-5 days"
}

GET/claims/{claim_id}/status

Check the status of an existing claim

Response Example:

{
  "claim_id": "CLM-789012",
  "status": "in_review",
  "status_history": [
    {
      "status": "submitted",
      "timestamp": "2025-12-05T14:30:00Z"
    },
    {
      "status": "documentation_verified",
      "timestamp": "2025-12-05T14:35:00Z"
    },
    {
      "status": "in_review",
      "timestamp": "2025-12-06T09:00:00Z"
    }
  ],
  "adjuster_notes": "All documentation verified. Awaiting approval.",
  "estimated_completion": "2025-12-08"
}

GET/items/{item_id}/valuation

Get AI-powered valuation for a specific item

Response Example:

{
  "item_id": "ITM-001",
  "name": "MacBook Pro 16\"",
  "valuation": {
    "current_market_value": 1999,
    "replacement_cost": 2499,
    "depreciated_value": 1749,
    "confidence_score": 0.94,
    "comparable_sales": [
      {
        "source": "eBay",
        "price": 1950,
        "date": "2025-11-28"
      },
      {
        "source": "Swappa",
        "price": 2050,
        "date": "2025-11-30"
      }
    ]
  },
  "provenance": {
    "purchase_verified": true,
    "ownership_duration": "18 months",
    "condition": "excellent"
  }
}

POST/webhooks

Response Example:

{
  "webhook_id": "WHK-456789",
  "url": "https://your-system.com/proveniq-webhook",
  "events": [
    "claim.submitted",
    "claim.status_changed",
    "claim.approved",
    "claim.denied"
  ],
  "secret": "whsec_xxxxxxxxxxxxx",
  "status": "active"
}

SDKs & Libraries

PythonAvailable

Version: 1.2.0

Node.jsAvailable

Version: 1.1.0

JavaComing Soon

Version: -

.NETComing Soon

Version: -

Integration Process

Request API Access

Contact our team to get your API credentials

Sandbox Testing

Test integration in our sandbox environment

Security Review

Complete security questionnaire and review

Production Access

Go live with production credentials

Security & Compliance

SOC 2 Type II

Compliant infrastructure and processes

256-bit Encryption

All data encrypted in transit and at rest

HIPAA Ready

BAA available for health-related data

Ready to Integrate?

Request API access and start building with ClaimsIQ

Request API Access

Endpoints

GET/policies/{policy_id}/inventory

Retrieve the complete inventory for a policyholder

Response Example:

{
  "policy_id": "POL-123456",
  "policyholder": {
    "name": "John Smith",
    "email": "john@example.com"
  },
  "inventory": {
    "total_items": 247,
    "total_value": 125000,
    "last_updated": "2025-12-01T10:30:00Z",
    "categories": [
      {
        "name": "Electronics",
        "items": 42,
        "value": 35000
      },
      {
        "name": "Furniture",
        "items": 28,
        "value": 22000
      }
    ]
  },
  "verification_status": "verified",
  "provenance_score": 87
}

POST/claims

Submit a new claim with pre-populated inventory data

Response Example:

{
  "claim_id": "CLM-789012",
  "status": "submitted",
  "policy_id": "POL-123456",
  "incident_date": "2025-12-05",
  "incident_type": "theft",
  "claimed_items": [
    {
      "item_id": "ITM-001",
      "name": "MacBook Pro 16\"",
      "category": "Electronics",
      "purchase_date": "2025-06-15",
      "purchase_price": 2499,
      "current_value": 1999,
      "documentation": {
        "photos": 3,
        "receipts": 1,
        "verified": true
      }
    }
  ],
  "total_claimed": 1999,
  "documentation_score": 95,
  "estimated_processing_time": "3-5 days"
}

GET/claims/{claim_id}/status

Check the status of an existing claim

Response Example:

{
  "claim_id": "CLM-789012",
  "status": "in_review",
  "status_history": [
    {
      "status": "submitted",
      "timestamp": "2025-12-05T14:30:00Z"
    },
    {
      "status": "documentation_verified",
      "timestamp": "2025-12-05T14:35:00Z"
    },
    {
      "status": "in_review",
      "timestamp": "2025-12-06T09:00:00Z"
    }
  ],
  "adjuster_notes": "All documentation verified. Awaiting approval.",
  "estimated_completion": "2025-12-08"
}

GET/items/{item_id}/valuation

Get AI-powered valuation for a specific item

Response Example:

{
  "item_id": "ITM-001",
  "name": "MacBook Pro 16\"",
  "valuation": {
    "current_market_value": 1999,
    "replacement_cost": 2499,
    "depreciated_value": 1749,
    "confidence_score": 0.94,
    "comparable_sales": [
      {
        "source": "eBay",
        "price": 1950,
        "date": "2025-11-28"
      },
      {
        "source": "Swappa",
        "price": 2050,
        "date": "2025-11-30"
      }
    ]
  },
  "provenance": {
    "purchase_verified": true,
    "ownership_duration": "18 months",
    "condition": "excellent"
  }
}

POST/webhooks

Response Example:

{
  "webhook_id": "WHK-456789",
  "url": "https://your-system.com/proveniq-webhook",
  "events": [
    "claim.submitted",
    "claim.status_changed",
    "claim.approved",
    "claim.denied"
  ],
  "secret": "whsec_xxxxxxxxxxxxx",
  "status": "active"
}