---
title: "Get status for a batch job"
method: GET
path: "/api/v1/jobs/{job_id}"
tags: ["Jobs"]
---

# Get status for a batch job

`GET /api/v1/jobs/{job_id}`

## Request

- Base URL: `https://slopeai.slopepay.com`
- URL: `https://slopeai.slopepay.com/api/v1/jobs/{job_id}`
- Auth: HTTP bearer

Returns the current status and per-customer results for a previously submitted batch job.

## Path parameters

- `job_id` string, required: Job identifier

## Response `200`

Job status

- Job
  - `job_id` string, required
  - `operation` 'INGEST' | 'ENRICH' | 'EVALUATE', required: The processing operation to run
  - `product` 'ATTRIBUTES' | 'SCORE' | 'ATTRIBUTES_AND_SCORE' | 'null', nullable, required: The requested product; null for INGEST and ENRICH
  - `status` 'pending' | 'running' | 'succeeded' | 'partial' | 'failed', required: Job processing status
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `items` JobItemStatus[], required: Per-customer processing status and any errors
    - `index` integer, required: Zero-based index of the entry in the original batch request
    - `customer_id` string, required
    - `status` 'pending' | 'running' | 'succeeded' | 'failed' | 'rejected', required: Per-customer item status
    - `use_case` 'ONBOARDING' | 'MONITORING' | 'null', nullable, required: The use case this customer's evaluation was metered under, set once the entry succeeds. Null for INGEST and ENRICH jobs and for entries that have not succeeded.
    - `errors` ErrorDetail[], nullable: Errors captured for this entry, if any
      - `code` string, required: Per-item error code. Known values: SCHEMA_VALIDATION, MISSING_ACCOUNT, MISSING_BALANCE_FOR_ACCOUNT, MISSING_TRANSACTION_FOR_ACCOUNT, BALANCE_OUTSIDE_TRANSACTION_SPAN, UNKNOWN_ACCOUNT, INGEST_ERROR.
      - `type` 'SCHEMA_VALIDATION' | 'BUSINESS_RULE' | 'SYSTEM', required: Error type classification
      - `message` string, required
      - `fields` string[]: Optional list of related fields for this error
      - `details` object, nullable: Optional structured details for this error
  - `metrics` JobMetrics: Optional aggregated metrics for this job
    - `customers_total` integer
    - `customers_succeeded` integer
    - `customers_failed` integer
    - `transactions_processed` integer, nullable

## Other responses

- `401`: Missing or invalid API key
- `404`: Job not found
- `500`: Unexpected server error

---

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