Claim Module

post
Create a Claim

https://api.tint.ai/v2/claim/:policyId/claim
Whenever one of your customers reports you a claim, you should call this endpoint. It allows us to track the policies for which you incurred a loss in order to improve the risk prediction models.
Request
Response
Request
Path Parameters
policyId
required
string
ID of the policy you want to attach the claim to.
Body Parameters
custom_id
optional
string
Your internal ID for this claim
gross_value
optional
number
Gross value of the claim in your preferred currency.
net_value
optional
number
Net value of the claim in your preferred currency.
type
required
string
Type of reported claim. Can be for example: collision, theft, or broken window.
Response
200: OK
Returns the created claim.
{
"id": "077d6d5f-e2c6-4e6d-a2e1-8fad0716de86",
"type": "theft",
"custom_id": "9481BC",
"gross_value": 4000,
"net_value": 2500,
"created_at": "2020-12-01T09:30:44.691Z",
"updated_at": "2020-12-01T09:30:44.691Z"
}

put
Update a Claim

https://api.tint.ai/v2/policy/:policyId/claim/:claimId
If one of your claims changes over time, you can update it using this endpoint.
Request
Response
Request
Path Parameters
policyId
required
string
Policy ID where the claim is attached to
claimId
required
string
Claim ID to update
Body Parameters
custom_id
optional
string
Your internal ID for this claim
gross_value
optional
string
Gross value of the claim in your preferred currency
net_value
optional
string
Net value of the claim in your preferred currency
type
required
string
Type of reported claim. Can be for example: collision theft or broken window.
Response
200: OK
Returns the updated claim.
{
"id": "077d6d5f-e2c6-4e6d-a2e1-8fad0716de86",
"type": "theft",
"custom_id": "9481BC",
"gross_value": 4000,
"net_value": 2840,
"created_at": "2020-12-01T09:30:44.691Z",
"updated_at": "2020-12-01T09:31:44.691Z"
}

get
Get a List of Policy Claims

https://api.tint.ai/v2/policy/:policyId/claims
Returns the list of claims attached to the given policy.
Request
Response
Request
Path Parameters
policyId
required
string
Retrieve claims for this given policy ID
Response
200: OK
A list of claims attached to the given policy.
[
{
"id": "077d6d5f-e2c6-4e6d-a2e1-8fad0716de86",
"type": "theft",
"custom_id": "9481BC",
"gross_value": 4000,
"net_value": 2840,
"created_at": "2020-12-01T09:30:44.691Z",
"updated_at": "2020-12-01T09:31:44.691Z"
}
]

get
Get Claim Details

https://api.tint.ai/v2/claim/:policyId/claim/:claimId
Retrieve the details of an existing claim.
Request
Response
Request
Path Parameters
policyId
required
string
Policy ID of the claim to retrieve
claimId
required
string
Claim ID to re
Response
200: OK
Claim corresponding to the given ID.
{
"id": "077d6d5f-e2c6-4e6d-a2e1-8fad0716de86",
"type": "theft",
"custom_id": "9481BC",
"gross_value": 4000,
"net_value": 2840,
"created_at": "2020-12-01T09:30:44.691Z",
"updated_at": "2020-12-01T09:31:44.691Z"
}