---
title: "GET /api/v1/jobs/{job_id}"
description: Get job details
full: true
---

**Auth:** required. Send an `ivy_` API key (`Authorization: Bearer ivy_…` or `X-Ivy-Api-Key`), a Clerk session JWT (`Authorization: Bearer …`) or the Clerk `__session` cookie (browser sessions). See [Authentication](/docs/api/authentication).

Return the full record for one job you can access: status, progress, parameters, results and output artifact references.

## Request

#### Path parameters

- `job_id` (string (uuid)) —

## Responses

### `200` OK

Job details retrieved successfully

Response shape:

- `id` (string (uuid)) —

- `task_id` (string | null) —

- `job_title` (string | null) —

- `job_type` (enum ("esmfold" | "diffdock" | "blast" | "reinvent" | "biotite_fetch" | "deepsol" | "aizynthfinder" | "frogs" | "graphsol" | "zinc" | "deeppurpose" | "fragment_library" | "fragment_growing" | "pubchem" | "xtalnet_csp" | "xtalnet_polymorph" | "validation_monitor" | "admet_ai" | "rdkit_full" | "genomics" | "genomics_de" | "genomics_intervals" | "pathology" | "pathology_tiles" | "pathology_tissue" | "pathology_features" | "bayesian" | "bayesian_fit" | "bayesian_pkpd" | "scanpy" | "scvi" | "scvi_tools" | "esm3" | "esm3_generate" | "esm3_inverse_fold" | "esm3_embeddings" | "deepchem" | "deepchem_gnn_predict" | "deepchem_gnn_train" | "transformers" | "chemberta_embed" | "protbert_embed" | "scibert_analyze" | "cross_modal_similarity" | "proteomics" | "proteomics_process" | "proteomics_match" | "proteomics_qc" | "data_processing" | "data_transform" | "data_aggregate" | "data_convert" | "data_join" | "data_partition" | "actions" | "pdb2pqr" | "p2rank" | "mmgbsa" | "opxrd" | "pywpem" | "genmol" | "reaction_classifier" | "rxnfp" | "rxnfp_fingerprint" | "rxnfp_similarity" | "l1000" | "l1000_signature" | "l1000_connectivity" | "l1000_pathway_enrichment" | "l1000_immune_score" | "l1000_deconvolution" | "l1000_tf_activity" | "l1000_diff_expression" | "l1000_synergy" | "depmap" | "depmap_mutation_sensitivity" | "depmap_resistance_profile" | "depmap_panel_select" | "depmap_dose_response" | "depmap_tissue_selectivity" | "depmap_compare_compounds" | "depmap_synthetic_lethality" | "depmap_metabolic_vulnerability" | "safety" | "safety_antitarget" | "safety_classify" | "safety_sall4" | "safety_ddi" | "safety_selectivity" | "target_validation" | "target_score" | "target_neosubstrate" | "target_degron" | "target_coessentiality" | "target_druggability" | "target_expression" | "clinical" | "clinical_indication_map" | "clinical_population" | "clinical_tcga_stratify" | "clinical_trial_benchmark" | "clinical_endpoint_benchmark" | "biostat" | "biostat_dose_response" | "biostat_survival" | "biostat_enrichment" | "network_biology" | "network_ppi" | "network_crosstalk" | "pk" | "pk_nca" | "boltz2" | "proteinmpnn" | "rfdiffusion" | "immunebuilder" | "antifold" | "anarci" | "biophi" | "antibody_developability" | "binding_ddg" | "rfantibody" | "rfpeptides" | "thermompnn" | "gnina" | "colabdock" | "openmm_md" | "igblast" | "humatch" | "paragraph" | "oas_search" | "esm_scan" | "ligandmpnn" | "solublempnn" | "foldseek" | "boltzgen" | "chai" | "prs" | "acmg" | "ancestry" | "imputation" | "deepvariant" | "vep" | "bulk_rnaseq" | "cnv" | "neoantigen" | "crispr" | "crispr_screen" | "spatial_omics_extended" | "precision_oncology" | "pgx" | "clinical_nlp" | "medical_imaging" | "epigenomics" | "methylation" | "metabolomics_compute" | "cytometry" | "flowsom" | "imc" | "metagenomics" | "microbiome" | "homer" | "meirlop" | "mepp" | "hic" | "riboseq" | "mirna" | "systems_biology" | "cart" | "nk_car" | "protac" | "aav" | "hrd" | "liquid_biopsy" | "tmb_msi" | "digital_twin" | "glyco" | "fc_engineering" | "mhc" | "tumor_fraction" | "causal_genomics" | "opentrons" | "adaptyv" | "pylabrobot" | "cellrank" | "pertpy" | "scirpy" | "octave" | "latex_compile" | "sci_viz" | "ukbiobank" | "gnomad" | "gnomad_variant_lookup" | "gnomad_region_query" | "gnomad_gene_variants" | "gnomad_frequency_filter" | "gnomad_constraint_lookup" | "gnomad_batch_annotate" | "fep_estimate" | "trial_outcome_predict" | "trial_design_optimize" | "aging_hallmarks_score" | "aging_sasp_score" | "aging_clock_estimate" | "aging_senescence_markers")) —

- `status` (enum ("PENDING" | "STARTED" | "PROCESSING" | "PROGRESS" | "SUCCESS" | "FAILURE" | "COMPLETED" | "CANCELLED" | "ARCHIVED" | "IMPORTED")) —

- `created_at` (string (date-time)) —

- `completed_at` (string (date-time) | null) —

- `source` (string | null) —

- `result` (object | null) —

- `result_url` (string | null) —

- `presigned_url` (string | null) —
Time-limited S3 download URL for result artifacts, generated on-demand for completed jobs. Previously computed in `read_job` but silently dropped because this field was undeclared.

- `parameters` (object | null) —

- `result_summary` (object | null) —

- `comments` (string | null) —

- `metadata` (object | null) —
Rich metadata for Mol* viewer

- `error_message` (string | null) —
Error message if job failed

- `enhanced_output` (object | null) —
Enhanced analytical output with 5-10x more actionable data

### `401` Unauthorized

Authentication required

### `404` Not Found

Job not found or not authorized

### `422` Unprocessable Entity

Validation Error

Response shape: `object`

**curl**

```bash
curl -X GET 'https://ivybiosciences.com/api/v1/jobs/{job_id}' \
  -H "Authorization: Bearer $IVY_API_KEY"
```

**JavaScript**

```js
const res = await fetch('https://ivybiosciences.com/api/v1/jobs/{job_id}', {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${process.env.IVY_API_KEY}`,
  },
});
const data = await res.json();
```

**Python**

```python
import os, requests

res = requests.get(
    "https://ivybiosciences.com/api/v1/jobs/{job_id}",
    headers={"Authorization": f"Bearer {os.environ['IVY_API_KEY']}"},
)
data = res.json()
```