Damage API

The Damage API processes vehicle inspection media captured by customers using their own applications. Customers upload photos or videos to the API, which then analyzes the media and generates a structured JSON response. This response is automatically delivered to the customer through their configured webhook.

It supports two input methods:

• Direct file uploads via multipart/form-data.
• Remote media links via JSON URLs.

Once the media is uploaded, the system validates, stores, and queues it for processing. Clients may optionally provide a callback URL to receive the results asynchronously.

Authentication

• Requires JWT token in Authorization: Bearer <token> header.
• The Bearer token and session ID are both generated via the Damage Authentication API.

Click the buttons below to download the Postman collections for the API one for file upload and another for URL upload.

Request Types

1. Form-data (File Upload)

Headers

Authorization: Bearer <jwt_token>
Content-Type: multipart/form-data

Parameters

Rules

• Max 99 images per request.
• Files must be .jpg, .jpeg, .png, .jfif, .heic, .mp4, .webm, .mov, .mkv, .avi.
• Videos must be larger than 1 MB and less than 100 MB.
• Cannot mix images and videos in one request.

2. JSON (URL Upload)

Headers

Authorization: Bearer <jwt_token>
Content-Type: application/json

Parameters

Rules

• Same limits as file upload.
• Videos must be > 1 MB.
• Cannot mix images and videos in the same batch.
• For url_pairs, each pair must have exactly 2 images.
• Payload may include urls, url_pairs, or both.

Error message and status code

File Upload

curl -X POST https://reports.inspektlabs.com/api/upload \
  -H "Authorization: Bearer <token>" \
  -F "type=file" \
  -F "session=ins123" \
  -F "case_id=case_001" \
  -F "files=@image1.jpg" \
  -F "files=@image2.png" \
  -F "email_id=test@example.com"

URL Upload

curl -X POST https://reports.inspektlabs.com/api/upload \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "session": "ins123",
    "case_id": "case_001",
    "urls": [
      "https://example.com/img1.jpg",
      "https://example.com/img2.jpg"
    ],
    "type":"urls",
    "url_pairs": [
      ["https://example.com/img.jpg", "https://example.com/img2.jpg"],
      ["https://example.com/img1.jpg", "https://example.com/img2.jpg"]
    ],
    "original_pair_Id": ["back","front"],
    "original_Id": ["side","front_back"],
    "callback_url": "https://client.com/callback",
    "inputMetaData": {
      "customerPhoneNumber": "9999999999",
      "customerName": "John Doe",
      "model": "Toyota Corolla"
    }
  }'

Replace the Fields with your actual values. Use only the appropriate keys and mandatory fields as per your use case.

Responses

{
"status": "success",
"id": "ins123",
"message": "",
"case_id": "case_001"
}

On this page

• Damage API
• Authentication
• Request Types
• 1. Form-data (File Upload)
• Parameters
• Rules
• 2. JSON (URL Upload)
• Parameters
• Rules
• Error message and status code
• File Upload
• URL Upload
• Responses