> For the complete documentation index, see [llms.txt](https://docs.insurehero.io/shield-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.insurehero.io/shield-api/claims/claims-management/claim-creation-examples.md).

# Claim Creation Examples

### Claim to a cargo risk item

In this example we will make a claim to a risk item that covered cargo damage and theft. 

Important! We recommend use v2 claim integration

**/claims** body payload:

{% tabs %}
{% tab title="v1" %}

```json
{
    "risk_item_id": "123e4567-e89b-12d3-a456-426614174000",
    "subject": "Cargo Theft Incident",
    "variant_id": "525f201c-516d-4780-9d08-9459d73d9f5d",
    "incident": {
        "date": "2024-03-20T15:00:00.000Z",
        "details": {
            "transaction": {},
            "description": "The cargo was stolen during a scheduled delivery stop. The incident occurred while the cargo was en route to its next destination."
        },
        "additional_properties": {
            "claim_type": "ROBO",
            "incident_coords": "-0.180653, -78.467838",
            "fast_track": true
        }
    },
    "metadata": {}
}
```

{% endtab %}

{% tab title="v2" %}

```json
{
  "risk_item_uid": "risk_item_uid",
  "variant_uid": "cargo_theft_2000",
  "claimant_email": "example@email.com",
  "incident": {
    "date": "2025-01-19T02:06:34.539Z",
    "subject": "Cargo Theft Incident",
    "description": "The cargo was stolen during a scheduled delivery stop. The incident occurred while the cargo was en route to its next destination"
  }
}
```

{% endtab %}
{% endtabs %}

### Claim to a personal accident risk item

In this example, we will make a claim to a risk item that covered medical expenses due to an accident or accidental death. 

**/claims** body payload:

{% tabs %}
{% tab title="v1" %}

```json
{
    "risk_item_id": "123e4567-e89b-12d3-a456-426614174000",
    "subject": "Personal Accident Claim",
    "variant_id": "525f201c-516d-4780-9d08-9459d73d9f5d",
    "incident": {
        "date": "2024-03-20T15:00:00.000Z",
        "details": {
            "transaction": {},
            "description": "While I was playing sports, a player tackled me and my right ankle twisted."
        },
        "additional_properties": {
            "incident_coords": "-0.180653, -78.467838",
        }
    },
    "metadata": {}
}
```

{% endtab %}

{% tab title="v2" %}

```json
{
  "risk_item_uid": "risk_item_uid",
  "variant_uid": "personal_accident",
  "claimant_email": "example@email.com",
  "incident": {
    "date": "2025-01-19T02:06:34.539Z",
    "subject": "Personal Accident Claim",
    "description": "While I was playing sports, a player tackled me and my right ankle twisted.",
    "claim_amount": 500
  }
}
```

{% endtab %}
{% endtabs %}

A claim will be returned if the endpoint call succeeds.

### Claim event example

In this example, we will create an event for a claim. 

**/claims/:claimId/events** body payload:

```json
{
  "metadata": {
    
  },
  "event_data": {
    "start_date": "2024-03-15T00:00:00.000Z",
    "end_date": "2024-06-15T00:00:00.000Z",
    "amountPaid": 500,
    "eventType": "PAYMENT_RECEIVED"
  }
}
```