---
title: "Fetch a report by an external ID"
method: GET
path: "/v1/inspection_reports/lookup_by_external_id"
---

# Fetch a report by an external ID

`GET /v1/inspection_reports/lookup_by_external_id`

## Request

- Base URL: `https://api.gomotive.com`
- URL: `https://api.gomotive.com/v1/inspection_reports/lookup_by_external_id`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/gomotive/apis/motive/docs/v1/inspection_reports/lookup_by_external_id/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `external_id` string, required
- `integration_name` string, required

## Headers

- `X-Time-Zone` string
- `X-Metric-Units` boolean
- `X-User-Id` integer

## Response `200`

200

- object
  - `inspection_report` object
    - `id` integer
    - `log_id` integer
    - `date` string
    - `time` string
    - `odometer` unknown
    - `carrier_name` string
    - `vehicle_number` string
    - `trailer_nums` string[]
    - `location` string
    - `city` string
    - `state` string
    - `status` string
    - `mechanic_signed_at` string
    - `mechanic_signature_url` string
    - `driver_signed_at` string
    - `driver_signature_url` string
    - `reviewer_signed_at` string
    - `reviewer_signature_url` string
    - `defects` object[]
      - `defect` object
        - `id` integer
        - `area` string
        - `category` string
        - `notes` unknown
    - `vehicle` object
      - `id` integer
      - `number` string
      - `year` string
      - `make` string
      - `model` string
      - `vin` string
      - `metric_units` boolean
    - `mechanic` object
      - `id` integer
      - `first_name` string
      - `last_name` string
      - `username` unknown
      - `email` string
      - `driver_company_id` unknown
      - `status` string
      - `role` string
    - `driver` object
      - `id` integer
      - `first_name` string
      - `last_name` string
      - `username` string
      - `email` unknown
      - `driver_company_id` unknown
      - `status` string
      - `role` string
    - `reviewer` object
      - `id` integer
      - `first_name` string
      - `last_name` string
      - `username` unknown
      - `email` string
      - `driver_company_id` unknown
      - `status` string
      - `role` string
    - `external_ids` object[]
      - `external_id` string
      - `integration_name` string
    - `entries` object[]
      - `name` string
      - `value` string
      - `position` integer

## Other responses

- `404`: 404

---

[API](https://skmtc.dev/gomotive/apis/motive.md) - [All operations](https://skmtc.dev/gomotive/apis/motive/llms.txt) - [OpenAPI document](https://skmtc.dev/gomotive/apis/motive/revisions/c71780e497f5?raw)