---
title: "Provide list of jobs that are in scheduled or running state for particular user"
method: GET
path: "/v1/bulk/jobs"
tags: ["Bulk Geo Addressing"]
deprecated: true
---

# Provide list of jobs that are in scheduled or running state for particular user

`GET /v1/bulk/jobs`

## Request

- Base URL: `https://api.cloud.precisely.com`
- URL: `https://api.cloud.precisely.com/v1/bulk/jobs`
- Auth: one of:
  - HTTP bearer
  - API key in header `Authorization`

> **Deprecated.**

This API returns a list of bulk geocode/verify jobs for the authenticated user.
You can optionally filter jobs by status (scheduled, running, or all).
Only the 'status' query parameter is accepted; any other query parameters will result in a 400 Bad Request error.

## Query parameters

- `status` 'scheduled' | 'running' | 'all'

## Headers

- `X-Request-Id` string

## Response `200`

List of scheduled/running jobs returned successfully

- QueuedJobsResponse: List of Jobs with running/scheduled status
  - `jobs` QueuedJobView[]: List of Jobs with running/scheduled status
    - `jobId` string: Unique job identifier
    - `emailId` string: Owner's email for the job
    - `fileId` string: Input file identifier
    - `fileName` string: Original file name
    - `status` string: Current status of the job
    - `submittedAt` string, EPOCH: Time when job was submitted

## Other responses

- `400`: Bad Request - Invalid query parameters. Only 'status' parameter is allowed.
- `401`: Unauthorized: Invalid token for List Bulk Job API
- `403`: Forbidden for List Bulk Job API
- `429`: Too many requests for List Bulk Job API
- `500`: Internal Server Error for List Bulk Job API

---

[API](https://skmtc.dev/precisely/apis/bulk-geo-addressing-api.md) · [All operations](https://skmtc.dev/precisely/apis/bulk-geo-addressing-api/llms.txt) · [OpenAPI document](https://skmtc.dev/precisely/apis/bulk-geo-addressing-api/revisions/aad307eeb518?raw)
