Retrieve batch status and results

Check current status and download query results of a queued batch processing job.

get/api/batch/{batch_id}

Request

  • Base URL: https://financesec.api.caleralabs.com
  • URL: https://financesec.api.caleralabs.com/api/batch/{batch_id}
  • Auth: API key in header X-License-Key

Path parameters

batch_idstring required

Unique identifier of the submitted batch job

Response

Batch job details

batch_idstring
status'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED'
total_queriesinteger
processed_queriesinteger
queriesstring[]
created_atstring date-time
completed_atstring date-time
errorstring

Example response

{
  "batch_id": "batch_abc123",
  "status": "COMPLETED",
  "total_queries": 2,
  "processed_queries": 2,
  "queries": [
    "What is Tesla's FY22 gross margin?",
    "What is Amazon's FY23 operating margin?"
  ],
  "results": [
    {
      "query_id": "q_000181",
      "status": "VERIFIED_SUCCESS",
      "source": "LATTICE_RECALL",
      "coverage": {
        "universe_description": "Cohort0 + active watchlists",
        "universe_size": 12,
        "model_generation": 7,
        "promoted_at": "2026-07-24T15:00:00Z"
      },
      "answer": {
        "value": 1577,
        "unit": "USD",
        "formatted": "$1,577.00"
      },
      "filing_event": {
        "form_type": "8-K",
        "items": [
          "2.02",
          "9.01"
        ],
        "event_type": "earnings_release",
        "event_types": [
          "earnings_release",
          "exhibit_filing"
        ],
        "cik": "0001652044",
        "ticker": "GOOGL",
        "accession": "0001652044-26-000066",
        "filing_date": "2026-07-22",
        "next_check": "companyfacts_or_10q"
      },
      "confidence_score": 1,
      "method": "FuzzyAnswerLookup",
      "provenance": {
        "entity_id": "fin:3M_3M_2018_10K",
        "source_filing": "fin:3M_2018_10K",
        "company": "3M",
        "xbrl_concept": "us-gaap:PaymentsToAcquirePropertyPlantAndEquipment",
        "doc_period": "FY2018",
        "audit_hash": "452b9177...",
        "original_value": "¥1843388870.00 CNY",
        "original_unit": "CNY",
        "fx_rate": "1 CNY = 0.1389 USD",
        "fx_converted": true
      },
      "decomposition": {
        "steps": [
          {
            "label": "Gross Profit",
            "value": "$8,156M"
          }
        ],
        "operator": "÷",
        "result": "12.50%"
      },
      "reason": "No crystallized evidence for this query."
    }
  ],
  "created_at": "2026-07-09T23:00:00Z",
  "completed_at": "2026-07-09T23:01:00Z",
  "error": "None"
}

Changes

No recorded changes to this operation across all 1 revision of this API.