---
title: "Get a pre-audit run"
method: GET
path: "/audit/runs/{jobId}"
tags: ["Audit"]
---

# Get a pre-audit run

`GET /audit/runs/{jobId}`

## Request

- Base URL: `https://api.tarifflo.com/api/v2`
- URL: `https://api.tarifflo.com/api/v2/audit/runs/{jobId}`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

The run's status; once complete, `data` is the `pre_audit.completed` webhook's `data`.

Requires the API key scope `audit`.

## Path parameters

- `jobId` string, required

## Response `200`

Successful response

- union
  - object
    - `jobId` string, required
    - `credits` object, required: What the job has reserved, used and refunded so far, in credits.
      - `action` 'rate_lookup' | 'adcvd_screen' | 'pga_applicability' | 'code_classified' | 'export_control' | 'origin_determination' | 'entry_filed' | 'entry_prepared' | 'document_ocr' | 'document_extract' | 'document_sort' | 'product_enrich' | 'entry_review' | 'rationale_document' | 'audit_parse' | 'data_export', nullable, required
      - `reserved` number, required
      - `used` number, required
      - `refunded` number, required
    - `status` 'failed', required
    - `error` object, required
      - `code` 'RUN_FAILED', required
      - `message` string, required
  - object
    - `jobId` string, required
    - `credits` object, required: What the job has reserved, used and refunded so far, in credits.
      - `action` 'rate_lookup' | 'adcvd_screen' | 'pga_applicability' | 'code_classified' | 'export_control' | 'origin_determination' | 'entry_filed' | 'entry_prepared' | 'document_ocr' | 'document_extract' | 'document_sort' | 'product_enrich' | 'entry_review' | 'rationale_document' | 'audit_parse' | 'data_export', nullable, required
      - `reserved` number, required
      - `used` number, required
      - `refunded` number, required
    - `status` 'queued' | 'processing' | 'blocked', required
    - `stagesComplete` number, required
    - `stagesTotal` number, required
    - `creditsNeeded` number: Credits the run waits for (`blocked` only).
    - `purchaseUrl` string: Where to add credits (`blocked` only).
  - object
    - `jobId` string, required
    - `credits` object, required: What the job has reserved, used and refunded so far, in credits.
      - `action` 'rate_lookup' | 'adcvd_screen' | 'pga_applicability' | 'code_classified' | 'export_control' | 'origin_determination' | 'entry_filed' | 'entry_prepared' | 'document_ocr' | 'document_extract' | 'document_sort' | 'product_enrich' | 'entry_review' | 'rationale_document' | 'audit_parse' | 'data_export', nullable, required
      - `reserved` number, required
      - `used` number, required
      - `refunded` number, required
    - `status` 'complete', required
    - `event` string, required: The webhook event that delivered the same `data`.
    - `data` union, required
      - string
      - number
      - boolean
      - Schema2[]
      - object

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `404`: Not found
- `500`: Internal server error

---

[API](https://skmtc.dev/tarifflo/apis/tarifflo-api.md) - [All operations](https://skmtc.dev/tarifflo/apis/tarifflo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tarifflo/apis/tarifflo-api/revisions/f048ebac1ac5?raw)