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

# Get sample details

`GET /samples/{sampleID}`

## Request

- Base URL: `https://sandbox.recordedfuture.com/api/v0`
- URL: `https://sandbox.recordedfuture.com/api/v0/samples/{sampleID}`
- Auth: API key in header `Authorization`

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.dev/recordedfuture/apis/recorded-future-sandbox-api-secopsti.md) - [All operations](https://skmtc.dev/recordedfuture/apis/recorded-future-sandbox-api-secopsti/llms.txt) - [OpenAPI document](https://skmtc.dev/recordedfuture/apis/recorded-future-sandbox-api-secopsti/revisions/39ea918b1dca?raw)