Fetch Claims
Last updated
Last updated
GET
https://app.insurehero.io/api/shield/integrations/claims/:claimId
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Query Params
Name | Type | Description |
---|---|---|
Types of responses
{
"data": {
"id": "30fa2bdf-dd3e-4301-acd8-301668ee6cce",
"package_id": "91b749df-d833-46d8-92ae-fefb7ae607c2",
"claimant_id": "93729951-ea59-4116-a9ef-266b2f690ed4",
"risk_item_id": "2140618c-522c-493c-a81d-c28ccfa9d86e",
"type": "Auto Insurance",
"status": "SUBMITTED",
"uid": "CLAIM123",
"insurer_claim_number": "INSURE123",
"internal_claim_number": 69,
"consent_date": "2024-05-02T03:00:00+00:00",
"resolution_date": null,
"assets": [],
"metadata": {
"additional_info": "Some additional info"
},
"policy_reference": {
"policy": {
"id": "eb326ade-902b-4298-b6e8-fa8f8fe7bf2a",
"uid": "package1234",
"version": 1,
"metadata": {
"policy_info": "Additional policy info"
},
"policy_number": "2245",
"total_gross_price": "1 + 1"
},
"variant": {
"id": "525f201c-516d-4780-9d08-9459d73d9f5d",
"name": "variant PROD",
"conditions": "Some conditions",
"created_at": "2024-05-10T21:00:41.277415+00:00",
"exclusions": "Some exclusions",
"insurer_id": "INSURER123",
"description": "Some description",
"gross_price": "1",
"pricing_type": "one_time",
"pricing_rules": {
"net_price": "Net price rules"
},
"coverage_limits": 0
},
"riskItem": {}
},
"claimant_data": {
"id": "93729951-ea59-4116-a9ef-266b2f690ed4",
"dob": "2024-04-11T03:00:00+00:00",
"uid": "USER123",
"name": "John Doe",
"email": "john.doe@example.com",
"phone": "1234567890",
"gender": "MALE",
"address": "123 Main Street",
"group_id": "GROUP123",
"metadata": {
"additional_info": "Some additional info"
},
"channel_id": "CHANNEL123",
"company_name": "ABC Company",
"company_role": "Employee",
"bank_accounts": [
{
"iban": "IBAN123",
"country": "US",
"currency": "USD",
"bank_name": "Bank of America",
"bic_swift": "BOFAUS3N",
"account_name": "John Doe",
"account_type": "Checking",
"bank_address": "456 Bank Street",
"account_number": "123456789",
"routing_number": "123456789",
"additional_info": "Some additional info"
}
],
"company_email": "info@abccompany.com",
"document_type": "PASSPORT",
"company_address": "456 Company Avenue",
"document_number": "ABC123",
"company_identifier": {
"type": "TAX_ID",
"value": "TAX123"
},
"company_bank_accounts": [
{
"iban": "IBAN456",
"country": "US",
"currency": "USD",
"bank_name": "Chase Bank",
"bic_swift": "CHASUS33",
"account_name": "ABC Company",
"account_type": "Savings",
"bank_address": "789 Company Boulevard",
"account_number": "987654321",
"routing_number": "987654321",
"additional_info": "Some additional info"
}
]
},
"incident": {
"date": "2025-01-19T02:06:34.539Z",
"claim_amount": null,
"description": "Iba a bicicleta y me cai."
},
"communications": [],
"created_at": "2024-05-11T17:18:36.452503+00:00",
"updated_at": "2024-05-11T17:18:36.452503+00:00",
"deleted_at": null,
"channel_id": "fc94d4a1-f834-481d-a6b2-138b823389c8",
"subject": "Me rompí una pierna24",
"incident_date": "2025-01-19T02:06:34.539+00:00",
"claim_amount": null,
"payout_amount": null,
"transaction_date": null,
"variant_id": "525f201c-516d-4780-9d08-9459d73d9f5d",
"required_documents": {},
"owner_id": null,
"asignee_id": null
}
}
GET
https://app.insurehero.io/api/shield/integrations/claims
A paginated list of all claims.
Page size cannot exceed 100 records at a time.
Types of responses
{
"data": [
{
"id": "12345678-1234-1234-1234-1234567890ab",
"communications": [],
"policy_reference": {
"policy": {
"id": "87654321-4321-4321-4321-0987654321ba",
"uid": "package5678",
"version": 1,
"metadata": {},
"policy_number": "9876",
"total_gross_price": "100 + 50"
},
"variant": {
"id": "11223344-5566-7788-99aa-bbccddeeff00",
"name": "Standard Variant",
"conditions": "Standard coverage conditions apply.",
"created_at": "2024-05-10T21:00:41.277415+00:00",
"exclusions": "Excludes pre-existing conditions.",
"insurer_id": "55667788-99aa-bbcc-ddee-ff0011223344",
"description": "Standard insurance variant.",
},
"riskItem": {}
},
"created_at": "2024-05-11T17:18:36.452503+00:00",
"updated_at": "2024-05-11T17:18:36.452503+00:00",
"deleted_at": null,
"risk_item_id": "55667788-99aa-bbcc-ddee-ff0011223344",
"claimant_id": "22334455-6677-8899-aabb-ccddeeff0011",
"channel_id": "99887766-5544-3322-1100-aabbccddeeff",
"subject": "I broke my leg",
"insurer_claim_number": null,
"internal_claim_number": 42,
"status": "SUBMITTED",
"incident_date": "2025-01-19T02:06:34.539+00:00",
"resolution_date": null,
"claim_amount": null,
"payout_amount": null,
"metadata": {},
"assets": [],
"type": "Health Insurance",
"consent_date": null,
"incident": {
"date": "2025-01-19T02:06:34.539Z",
"details": {
"description": "I was riding a bike and fell.",
"transaction": {}
},
"summary": "MEDICAL",
"additional_properties": {}
},
"package_id": "33445566-7788-99aa-bbcc-ddeeff001122",
"transaction_date": null,
"uid": null,
"variant_id": "11223344-5566-7788-99aa-bbccddeeff00",
"claimant_data": {
"id": "22334455-6677-8899-aabb-ccddeeff0011",
"dob": "1990-01-01T00:00:00+00:00",
"uid": "john.doe@example.com",
"name": "John Doe",
"email": "john.doe@example.com",
"phone": "123-456-7890",
"gender": "MALE",
"address": "123 Main St, Anytown, USA",
"group_id": "55667788-99aa-bbcc-ddee-ff0011223344",
"metadata": {
"vip": true
},
"channel_id": "99887766-5544-3322-1100-aabbccddeeff",
"company_name": "TechCorp",
"company_role": "Developer",
"bank_accounts": [
{
"iban": "DE89370400440532013000",
"country": "Germany",
"currency": "EUR",
"bank_name": "Deutsche Bank",
"bic_swift": "DEUTDEDBFRA",
"account_name": "John Doe",
"account_type": "checking",
"bank_address": "Taunusanlage 12, 60325 Frankfurt am Main, Germany",
"account_number": "0123456789",
"routing_number": "10010010",
"additional_info": "Primary account"
},
{
"iban": "GB33BUKB20201555555555",
"country": "UK",
"currency": "GBP",
"bank_name": "Barclays",
"bic_swift": "BUKBGB22",
"account_name": "John Doe",
"account_type": "savings",
"bank_address": "1 Churchill Place, London, E14 5HP, UK",
"account_number": "987654321",
"routing_number": "202015",
"additional_info": "Savings account"
}
],
"company_email": "john.doe@techcorp.com",
"document_type": "passport",
"company_address": "456 Corporate Ave, Metropolis, USA",
"document_number": "A1234567",
"company_identifier": {
"type": "TIN",
"value": "123-45-6789"
},
"company_bank_accounts": [
{
"iban": "FR7630006000011234567890189",
"country": "France",
"currency": "EUR",
"bank_name": "BNP Paribas",
"bic_swift": "BNPAFRPP",
"account_name": "TechCorp",
"account_type": "business",
"bank_address": "16 Boulevard des Italiens, 75009 Paris, France",
"account_number": "12345678901",
"routing_number": "30004",
"additional_info": "Corporate account"
}
]
},
"required_documents": {},
"owner_id": null,
"asignee_id": null
}
]
}
To access these resources, please remember to visit the Links and Resources section of the documentation.
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Authorization*
string
Bearer access token
claimId*
string
Claim identifier
comm_info
boolean
Communication information for that claim
policy_ref
boolean
The policy detail for that claim
general
boolean
The details of the claim
Authorization*
string
Bearer access token
from*
string
Starting record index
to*
string
Ending record index
comm_info
boolean
Communication information for that claim
policy_ref
boolean
The policy detail for that claim
general
boolean
The details of the claim