Skip to main content
    Ivy Biosciences Docs/Call the platform/API/Reference/Reference/Jobs/GET /api/v1/jobs/{job_id}

    GET /api/v1/jobs/{job_id}

    Get job details

    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.

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

    Request

    Path parameters

    job_idstring (uuid)

    Responses

    200 OK

    Job details retrieved successfully

    Response shape:

    idstring (uuid)
    task_idstring | null
    job_titlestring | null
    job_typeenum ("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")
    statusenum ("PENDING" | "STARTED" | "PROCESSING" | "PROGRESS" | "SUCCESS" | "FAILURE" | "COMPLETED" | "CANCELLED" | "ARCHIVED" | "IMPORTED")
    created_atstring (date-time)
    completed_atstring (date-time) | null
    sourcestring | null
    resultobject | null
    result_urlstring | null
    presigned_urlstring | 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.

    parametersobject | null
    result_summaryobject | null
    commentsstring | null
    metadataobject | null

    Rich metadata for Mol* viewer

    error_messagestring | null

    Error message if job failed

    enhanced_outputobject | 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 -X GET 'https://ivybiosciences.com/api/v1/jobs/{job_id}' \
      -H "Authorization: Bearer $IVY_API_KEY"

    Was this page helpful?

    Loading...