---
title: "Get sample details"
method: GET
path: "/samples/{sampleID}"
---

# Get sample details

`GET /samples/{sampleID}`

Retrieve a sample's analysis tasks and current processing status.

## Path parameters

- `sampleID` string, required

## Response `200`

Sample details.

- SampleDetail — Detailed sample status including individual analysis tasks.
  - `id` string — Sample ID
  - `status` 'pending' | 'running' | 'static_analysis' | 'reported' | 'failed' — Overall sample processing status
  - `kind` 'file' | 'url' — Submission type
  - `filename` string — Original filename (file submissions only)
  - `url` string — Submitted URL (URL submissions only)
  - `private` boolean — Whether this sample is private to the submitting organization
  - `submitted` string, date-time — ISO 8601 submission timestamp
  - `completed` string, date-time — ISO 8601 completion timestamp (only present when done)
  - `sha256` string — SHA-256 hash (file submissions only)
  - `tasks` object[] — Individual analysis tasks and their statuses.
    - `id` string — Task ID (e.g., static1, behavioral1, urlscan1)
    - `status` 'pending' | 'running' | 'static_analysis' | 'reported' | 'failed' — Task processing status
    - `target` string — Target file or URL being analyzed by this task
    - `pick` string — Archive path of the selected file for this task

## Other responses

- `404` — Sample not found.

---

[API](https://skmtc.net/recordedfuture/apis/alert-api.md) · [All operations](https://skmtc.net/recordedfuture/apis/alert-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/recordedfuture/alert-api/versions/c8c2f68d8b60/schema)
