Skip to main content
GET
/
v1
/
links
/
{link_id}
/
insurance
/
report
/
home
Retrieve an home insurance report
curl --request GET \
  --url https://prod.truv.com/v1/links/{link_id}/insurance/report/home/ \
  --header 'X-Access-Client-Id: <api-key>' \
  --header 'X-Access-Secret: <api-key>'
{
  "id": "24d7e80942ce4ad58a93f70ce4115f5c",
  "status": "new",
  "access_token": "48427a36d43c4d5aa6324bc06c692456",
  "tracking_info": "user123456",
  "insurance": {
    "policies": [
      {
        "carrier_name": "progressive",
        "id": "53c5ce0d-fb79-4f1c-bc27-32181b368fc7",
        "name": "AUTO AU192837",
        "description": "Effective 11/03/2021 - 11/03/2022",
        "carrier_policy_number": "HO132654",
        "effective_date": "2021-11-03T00:00:00.000Z",
        "expiry_date": "2021-11-03T00:00:00.000Z",
        "renewal_date": "2021-11-03T00:00:00.000Z",
        "canceled_date": "2021-11-03T00:00:00.000Z",
        "total_premium_cents": 150319,
        "deductible_cents": 123,
        "status": "ACTIVE",
        "paid_in_full": true,
        "commercial_named_insureds": [
          {
            "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "is_primary": true,
            "name": "Sample Business LLC",
            "gl_code": "10010",
            "sic_code": "6411",
            "naics_code": "524210",
            "fein": "123456789",
            "ssn": "123456789",
            "address": {
              "id": "a497f96b-94be-443e-88bb-c8289085c922",
              "country": "US",
              "street": "344 Clinton St, Apartment 3D",
              "city": "Brooklyn",
              "state": "NY",
              "zip": "11231"
            }
          }
        ],
        "named_insureds": [
          {
            "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "first_name": "<string>",
            "middle_name": "<string>",
            "last_name": "<string>",
            "full_name": "<string>",
            "is_primary": true
          }
        ],
        "claims": [
          {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "dwelling_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "vehicle_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "driver_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "carrier_claim_identifier": "<string>",
            "date_occurred": "2023-11-07T05:31:56Z",
            "date_closed": "2022-05-03T00:00:00.000Z",
            "payout_cents": 180111,
            "representative_name": "<string>",
            "representative_phone": "<string>",
            "representative_email": "<string>",
            "address": {
              "id": "a497f96b-94be-443e-88bb-c8289085c922",
              "country": "US",
              "street": "344 Clinton St, Apartment 3D",
              "city": "Brooklyn",
              "state": "NY",
              "zip": "11231"
            }
          }
        ],
        "loss_events": [
          {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "date_of_occurrence": "2022-05-03T00:00:00.000Z",
            "amount_paid_cents": 123323,
            "is_subrogation": true,
            "is_claim_open": true,
            "date_of_claim": "2022-05-03T00:00:00.000Z",
            "amount_reserved_cents": 123
          }
        ],
        "documents": [
          {
            "id": "55ad7bb6-f5a3-4ebf-91fb-2802391eb261",
            "title": "11-03-2021 - Auto - Automobile Policy Renewal Declarations",
            "date_added": "2022-05-03T00:00:00.000Z",
            "file": "https://truv-statements.s3.amazonaws.com/insurance/example_file"
          }
        ],
        "dwellings": [
          {
            "id": "b7a53a67-7266-42b6-a20e-97e8fc723bbc",
            "address": {
              "id": "a497f96b-94be-443e-88bb-c8289085c922",
              "country": "US",
              "street": "344 Clinton St, Apartment 3D",
              "city": "Brooklyn",
              "state": "NY",
              "zip": "11231"
            },
            "replacement_cost_cents": 2600,
            "cash_value_cents": 2600,
            "coverages": [
              {
                "id": "b9087b71-c1b1-482d-be9f-92a2cf81fbb3",
                "premium_cents": 18514,
                "is_declined": true,
                "name": "PERSONAL_PROPERTY",
                "per_person_limit_cents": 123,
                "per_incident_limit_cents": 123,
                "deductible_cents": 50000
              }
            ],
            "mortgagees": [
              {
                "id": "26a4ce3a-0b9f-4c3d-96c0-1c76529e3b52",
                "name": "<string>",
                "loan_number": "<string>",
                "address": {
                  "id": "a497f96b-94be-443e-88bb-c8289085c922",
                  "country": "US",
                  "street": "344 Clinton St, Apartment 3D",
                  "city": "Brooklyn",
                  "state": "NY",
                  "zip": "11231"
                }
              }
            ]
          }
        ]
      }
    ],
    "addresses": [
      {
        "id": "a497f96b-94be-443e-88bb-c8289085c922",
        "country": "US",
        "street": "344 Clinton St, Apartment 3D",
        "city": "Brooklyn",
        "state": "NY",
        "zip": "11231"
      }
    ],
    "agents": [
      {
        "id": "da9d46ad-8ddb-4b4b-bc7e-7a381a738f7d",
        "agency_name": "<string>",
        "agent_full_name": "<string>",
        "phone_number": "<string>",
        "email": "john.doe@example.com",
        "policy_ids": [
          "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        ],
        "address": {
          "id": "a497f96b-94be-443e-88bb-c8289085c922",
          "country": "US",
          "street": "344 Clinton St, Apartment 3D",
          "city": "Brooklyn",
          "state": "NY",
          "zip": "11231"
        }
      }
    ]
  },
  "provider": "progressive",
  "identity": {
    "first_name": "John",
    "last_name": "Doe",
    "home_address": {
      "street": "1 Morgan Ave",
      "city": "Los Angeles",
      "state": "CA",
      "zip": "90210",
      "country": "US"
    },
    "id": "48427a36d43c4d5aa6324bc06c692456",
    "created_at": "2022-06-07T15:00:00.000Z",
    "updated_at": "2022-06-30T15:00:00.000Z",
    "full_name": "John Doe",
    "middle_initials": "K",
    "email": "john.doe@example.com",
    "ssn": "123456789",
    "date_of_birth": "1992-03-03T00:00:00.000Z"
  },
  "finished_at": "2021-04-06T11:30:00.000Z",
  "is_suspicious": true,
  "pdf_report": "https://cdn.truv.com/report.pdf"
}

Authorizations

​
X-Access-Client-Id
string
header
required

Client ID

​
X-Access-Secret
string
header
required

Client Access Key

Path Parameters

​
link_id
string
required

Response

Data for the insurance report

​
id
string
required

Unique ID

Example:

"24d7e80942ce4ad58a93f70ce4115f5c"

​
status
string
required

Request status

Example:

"new"

​
access_token
string
required

Access token for a Link to payroll provider

Example:

"48427a36d43c4d5aa6324bc06c692456"

​
tracking_info
string
required

Any information passed to the Truv Bridge from a partner

Example:

"user123456"

​
insurance
Insurance · object
required
​
provider
string
required

Insurance Provider ID

Example:

"progressive"

​
identity
object
required

Person's identity information

​
finished_at
string

Time when report was finished

Example:

"2021-04-06T11:30:00.000Z"

​
is_suspicious
boolean

Flag to indicate if the data from the source is suspicious. E.g. fraud detected in uploaded documents or SSN of the user does not match with the data

​
pdf_report
string<uri>

Insurance report in PDF format

Example:

"https://cdn.truv.com/report.pdf"