---
title: "Check job status"
method: GET
path: "/v1/background_jobs/{{job_id}}"
---

# Check job status

`GET /v1/background_jobs/{{job_id}}`

## Path parameters

- `job_id` string, required

## Headers

- `Content-Type` string
- `Accept` string
- `Authorization` string, required

## Request body

- object
  - `users` object[]
    - `user_id` string
    - `company_id` string
    - `metadata` object
      - `custom_user_property` string — example: Name, Job title, etc.

## Response `200`

OK - Check job status

- object
  - `completed_rows` integer
  - `elapsed_time` integer
  - `end_time` string, style
  - `file_size` integer
  - `filename` string
  - `job_id` string, uri
  - `links` string, style
  - `start_time` string
  - `status` 'queued' | 'validating' | 'processing' | 'pending_refresh' | 'completed' | 'failed'
  - `total_rows` integer
  - `type` string

---

[API](https://skmtc.net/userpilot/apis/userpilot-api.md) · [All operations](https://skmtc.net/userpilot/apis/userpilot-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/userpilot/userpilot-api/versions/2b3a88b6a474/schema)