> ## Documentation Index
> Fetch the complete documentation index at: https://docs.veritus.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve Job

> Check the status of a job and retrieve results

Get the status of a job by its job ID. Returns job status and results if the job has completed.

## Parameters

<ParamField path="jobId" type="string" required>
  The job ID returned from job creation
</ParamField>

## Response

Returns job status and results (if completed).

<ResponseField name="status" type="string">
  Job status. Possible values:

  * `queued`: Job is queued for processing
  * `success`: Job completed successfully
  * `error`: Job failed with an error
</ResponseField>

<ResponseField name="results" type="object[]">
  Array of paper results (only present when `status` is `success`)

  <Expandable>
    <ResponseField name="abstract" type="string">
      Paper abstract text (string or null)
    </ResponseField>

    <ResponseField name="authors" type="string">
      Comma-separated list of author names
    </ResponseField>

    <ResponseField name="doi" type="string">
      Digital Object Identifier (string or null)
    </ResponseField>

    <ResponseField name="downloadable" type="boolean">
      Whether the paper PDF is downloadable
    </ResponseField>

    <ResponseField name="engine" type="string">
      Search engine used (optional)
    </ResponseField>

    <ResponseField name="fieldsOfStudy" type="string[]">
      Array of field of study categories
    </ResponseField>

    <ResponseField name="id" type="string">
      Unique paper identifier
    </ResponseField>

    <ResponseField name="impactFactor" type="object">
      Object containing citation metrics

      <Expandable>
        <ResponseField name="citationCount" type="number">
          Total number of citations
        </ResponseField>

        <ResponseField name="influentialCitationCount" type="number">
          Number of influential citations
        </ResponseField>

        <ResponseField name="referenceCount" type="number">
          Number of references
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="isOpenAccess" type="boolean">
      Whether the paper is open access (optional)
    </ResponseField>

    <ResponseField name="isPrePrint" type="boolean">
      Whether the paper is a preprint (optional)
    </ResponseField>

    <ResponseField name="journalName" type="string">
      Name of the journal (string or null)
    </ResponseField>

    <ResponseField name="link" type="string">
      URL to the paper (optional)
    </ResponseField>

    <ResponseField name="pdfLink" type="string">
      URL to the PDF (optional)
    </ResponseField>

    <ResponseField name="publicationType" type="string">
      Type of publication (string or null)
    </ResponseField>

    <ResponseField name="publishedAt" type="string">
      Publication date (string or null)
    </ResponseField>

    <ResponseField name="score" type="number">
      Relevance score (number or null)
    </ResponseField>

    <ResponseField name="semanticLink" type="string">
      Link to Semantic Scholar page (optional)
    </ResponseField>

    <ResponseField name="title" type="string">
      Paper title
    </ResponseField>

    <ResponseField name="titleLink" type="string">
      Link to paper title page (optional)
    </ResponseField>

    <ResponseField name="tldr" type="string">
      TLDR summary of the paper (string or null)
    </ResponseField>

    <ResponseField name="v_country" type="string">
      Country of publication venue (string or null)
    </ResponseField>

    <ResponseField name="v_journal_name" type="string">
      Journal name from venue data (string or null)
    </ResponseField>

    <ResponseField name="v_publisher" type="string">
      Publisher name (string or null)
    </ResponseField>

    <ResponseField name="v_quartile_ranking" type="string">
      Quartile ranking (Q1, Q2, Q3, Q4, or null)
    </ResponseField>

    <ResponseField name="year" type="number">
      Publication year (number or null)
    </ResponseField>
  </Expandable>
</ResponseField>

## Example

After creating a job, use the returned `jobId` to check status. Poll this endpoint or use a callback URL to be notified when the job completes.