> ## Documentation Index
> Fetch the complete documentation index at: https://developers.fastdrop.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Run Diagnostics

> Analyze video technical metadata without classification

Get codec, resolution, FPS, VFR detection, duration, health score, and container format. No classification is performed.

**Cost:** 1 credit

<ParamField body="video_url" type="string" required>
  Public HTTP/HTTPS URL of the video.
</ParamField>

<ParamField body="webhook_url" type="string">
  Optional HTTPS URL to receive a POST when processing completes.
</ParamField>

### Response (202 Accepted)

Returns a job submission with `job_id`. Get the result from [Get Job Status](/api-reference/get-job-status) with `?wait=N`, or subscribe to `job.completed` via a [webhook](/guides/webhooks).

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.fastdrop.io/api/v1/diagnostics \
    -H "Content-Type: application/json" \
    -H "X-API-Key: fd_live_your_key_here" \
    -d '{"video_url": "https://example.com/video.mp4"}'
  ```
</RequestExample>

<ResponseExample>
  ```json 202 theme={null}
  {
    "job_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
    "status": "queued",
    "credits_charged": 1,
    "estimated_seconds": 60,
    "poll_url": "/api/v1/classify/a1b2c3d4-5678-90ab-cdef-1234567890ab",
    "created_at": "2026-03-05T12:00:00Z"
  }
  ```
</ResponseExample>

### Result format

When the job completes, the `results` field contains:

```json theme={null}
{
  "diagnostics": {
    "codec": "h264",
    "resolution": "1920x1080",
    "fps": 30.0,
    "is_vfr": false,
    "duration_seconds": 47.2,
    "health_score": 95,
    "container": "mp4"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.