> ## Documentation Index > Fetch the complete documentation index at: https://docs.kallima.bio/llms.txt > Use this file to discover all available pages before exploring further. # Get Job > Fetch a job + its results. Frontend polls this while the job is running. ## OpenAPI ````yaml /api-reference/openapi.json get /jobs/{job_id} openapi: 3.1.0 info: title: Kallima API description: >- Antibody design API — humanization, structure, stability, immunogenicity, complex prediction, and codon optimization. version: 0.1.0 servers: [] security: [] tags: - name: identity description: >- Caller identity and credit balance — use ``GET /v1/me`` to inspect the resolved org, plan, and compute budget before submitting jobs. - name: projects description: >- Projects — top-level containers for source antibodies and therapeutic candidates. - name: source-antibodies description: Source (parental) antibody sequences registered under a project. - name: variants description: >- Variants descended from a therapeutic candidate — the unit of work for pipelines. - name: jobs description: >- Long-running pipeline jobs: humanization, structure, stability, immunogenicity. Submit and poll. Deprecated in favor of resource-per-job-type endpoints (``humanizations`` and the other Phase 3 resources); scheduled for removal in ``/v2``. - name: humanizations description: >- Humanization pipeline runs — typed submit body and typed per-strategy results. First of the Phase 3 resource-per-job-type endpoints; the generic ``/v1/jobs`` shape is deprecated in favor of this. - name: structure-predictions description: >- ImmuneBuilder structure predictions — typed submit body and typed PDB / pLDDT / CDR results. Phase 3 resource-per-job-type endpoint. - name: stability-analyses description: >- Stability analyses — typed submit body and typed thermostability / aggregation / developability scorecard. Phase 3 resource-per-job-type endpoint. - name: immunogenicity-analyses description: >- Immunogenicity analyses — typed submit body and typed MHC-I / MHC-II / B-cell epitope + risk-score results. Phase 3 resource-per-job-type endpoint. - name: uploads description: >- Presigned Supabase Storage slots for caller-supplied files (e.g. antigen PDBs for complex prediction). The API never proxies bytes — clients PUT directly to the returned URL. - name: antigens description: >- Target protein sequences scoped to a project — the docking partner in a complex prediction. Register once, reference by ``antigen_id`` at submit time. - name: complex-predictions description: >- Boltz-2 antibody-antigen complex predictions — typed submit body and typed docked-PDB / iptm / interface-residues results. Phase 3 resource-per-job-type endpoint. Complex runs are long-running (~20–40 min on GPU); always poll, never hold the connection. - name: therapeutic-candidates description: >- Therapeutic candidates — the top-of-lineage object under a project. Creating one auto-creates a baseline variant (``v1``) and its chain rows atomically; pipelines submit against the variant. Junction endpoints manage many-to-many links to source antibodies and antigens. - name: adc-designs description: >- ADC (antibody-drug conjugate) designs — catalog records attaching a linker + payload + conjugation method to a therapeutic candidate. Run the rule-based developability analysis via ``POST /v1/adc-designs/{id}/analysis``; pass ``structure_job_id`` to include SASA-based conjugation-site accessibility. - name: codon-exports description: >- Codon optimization exports — submit a batch of jobs (one per variant), poll until ``variable_cds`` is populated, then download the assembled CDS as FASTA, CSV, or GenBank+ZIP. Requires the Structure plan or above. - name: webhooks description: >- Webhook endpoint registration — register HTTPS URLs to receive signed event deliveries when jobs complete or fail. Signing uses HMAC-SHA256; see ``POST /v1/webhooks`` for verification details. - name: webhook-deliveries description: >- Webhook delivery log — inspect past delivery attempts and manually retry failed ones via ``POST /v1/webhook_deliveries/{id}/retry``. paths: /jobs/{job_id}: get: tags: - jobs summary: Get Job description: Fetch a job + its results. Frontend polls this while the job is running. operationId: get_job_jobs__job_id__get parameters: - name: job_id in: path required: true schema: type: string format: uuid title: Job Id responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/JobDetail' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - HTTPBearer: [] - HTTPBearer: [] components: schemas: JobDetail: properties: job: $ref: '#/components/schemas/Job' results: items: $ref: '#/components/schemas/HumanizationResultRow' type: array title: Results structure_result: anyOf: - $ref: '#/components/schemas/StructureResultRow' - type: 'null' stability_result: anyOf: - $ref: '#/components/schemas/StabilityResultRow' - type: 'null' immunogenicity_result: anyOf: - $ref: '#/components/schemas/ImmunogenicityResultRow' - type: 'null' complex_result: anyOf: - $ref: '#/components/schemas/ComplexResultRow' - type: 'null' type: object required: - job - results title: JobDetail description: Job + results, returned by GET /jobs/{id}. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError Job: properties: id: type: string format: uuid title: Id variant_id: type: string format: uuid title: Variant Id job_type: type: string enum: - humanization - structure - stability - immunogenicity - complex - codon_export title: Job Type status: type: string enum: - pending - running - completed - failed - canceled title: Status error_message: anyOf: - type: string - type: 'null' title: Error Message submitted_by: anyOf: - type: string format: uuid - type: 'null' title: Submitted By created_at: type: string format: date-time title: Created At started_at: anyOf: - type: string format: date-time - type: 'null' title: Started At completed_at: anyOf: - type: string format: date-time - type: 'null' title: Completed At canceled_at: anyOf: - type: string format: date-time - type: 'null' title: Canceled At type: object required: - id - variant_id - job_type - status - error_message - created_at - started_at - completed_at title: Job description: A job as returned by the API. HumanizationResultRow: properties: id: type: string format: uuid title: Id job_id: type: string format: uuid title: Job Id strategy: type: string title: Strategy humanized_vh: type: string title: Humanized Vh humanized_vl: anyOf: - type: string - type: 'null' title: Humanized Vl oasis_score: anyOf: - additionalProperties: true type: object - type: 'null' title: Oasis Score mutations: anyOf: - additionalProperties: true type: object - type: 'null' title: Mutations liabilities: anyOf: - additionalProperties: true type: object - type: 'null' title: Liabilities numbering: anyOf: - additionalProperties: true type: object - type: 'null' title: Numbering vhh_analysis: anyOf: - additionalProperties: true type: object - type: 'null' title: Vhh Analysis scfv_analysis: anyOf: - additionalProperties: true type: object - type: 'null' title: Scfv Analysis fc_analysis: anyOf: - additionalProperties: true type: object - type: 'null' title: Fc Analysis created_at: type: string format: date-time title: Created At type: object required: - id - job_id - strategy - humanized_vh - humanized_vl - oasis_score - mutations - liabilities - created_at title: HumanizationResultRow description: One strategy's worth of humanization output. StructureResultRow: properties: id: type: string format: uuid title: Id job_id: type: string format: uuid title: Job Id pdb_storage_path: anyOf: - type: string - type: 'null' title: Pdb Storage Path model_used: type: string title: Model Used confidence_score: anyOf: - type: number - type: 'null' title: Confidence Score per_residue_plddt: anyOf: - additionalProperties: true type: object - type: 'null' title: Per Residue Plddt cdr_analysis: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Cdr Analysis humanization_result_id: anyOf: - type: string format: uuid - type: 'null' title: Humanization Result Id created_at: type: string format: date-time title: Created At type: object required: - id - job_id - pdb_storage_path - model_used - confidence_score - per_residue_plddt - cdr_analysis - created_at title: StructureResultRow description: Structure prediction output for a single job. StabilityResultRow: properties: id: type: string format: uuid title: Id job_id: type: string format: uuid title: Job Id variant_id: type: string format: uuid title: Variant Id ddg_matrix: anyOf: - additionalProperties: true type: object - type: 'null' title: Ddg Matrix solubility_score: anyOf: - type: number - type: 'null' title: Solubility Score aggregation_score: anyOf: - type: number - type: 'null' title: Aggregation Score thermostability_score: anyOf: - type: number - type: 'null' title: Thermostability Score melting_temp_predicted: anyOf: - type: number - type: 'null' title: Melting Temp Predicted developability_score: anyOf: - type: number - type: 'null' title: Developability Score stabilizing_mutations: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Stabilizing Mutations model_versions: anyOf: - additionalProperties: type: string type: object - type: 'null' title: Model Versions structure_result_id: anyOf: - type: string format: uuid - type: 'null' title: Structure Result Id created_at: type: string format: date-time title: Created At type: object required: - id - job_id - variant_id - created_at title: StabilityResultRow description: Stability analysis output for a single job. ImmunogenicityResultRow: properties: id: type: string format: uuid title: Id job_id: type: string format: uuid title: Job Id variant_id: type: string format: uuid title: Variant Id mhc1_epitopes: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Mhc1 Epitopes mhc2_epitopes: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Mhc2 Epitopes bcell_epitopes: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Bcell Epitopes deimmunization_suggestions: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Deimmunization Suggestions risk_score: anyOf: - type: number - type: 'null' title: Risk Score mhc1_risk: anyOf: - type: number - type: 'null' title: Mhc1 Risk mhc2_risk: anyOf: - type: number - type: 'null' title: Mhc2 Risk bcell_risk: anyOf: - type: number - type: 'null' title: Bcell Risk model_versions: anyOf: - additionalProperties: type: string type: object - type: 'null' title: Model Versions created_at: type: string format: date-time title: Created At type: object required: - id - job_id - variant_id - created_at title: ImmunogenicityResultRow description: Immunogenicity analysis output for a single job. ComplexResultRow: properties: id: type: string format: uuid title: Id job_id: type: string format: uuid title: Job Id variant_id: type: string format: uuid title: Variant Id antigen_id: type: string format: uuid title: Antigen Id pdb_storage_path: anyOf: - type: string - type: 'null' title: Pdb Storage Path confidence_score: anyOf: - type: number - type: 'null' title: Confidence Score iptm: anyOf: - type: number - type: 'null' title: Iptm per_chain_plddt: anyOf: - additionalProperties: true type: object - type: 'null' title: Per Chain Plddt interface_residues: anyOf: - additionalProperties: true type: object - type: 'null' title: Interface Residues model_used: type: string title: Model Used created_at: type: string format: date-time title: Created At type: object required: - id - job_id - variant_id - antigen_id - model_used - created_at title: ComplexResultRow description: Antibody-antigen complex prediction result (Boltz-2). ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: HTTPBearer: type: http scheme: bearer ````