Bulk Geo Addressing

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

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.

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

Query parameters

status'scheduled' | 'running' | 'all'

Filter jobs by status. Allowed values: 'scheduled', 'running', or 'all'. If not provided, returns all jobs.

Headers

X-Request-Idstring

The X-Request-Id header is optional but incredibly useful for developers. It serves as a unique identifier for requests within our system. When you encounter any problems with your requests, providing us with the X-Request-Id will enable us to pinpoint the specific request in question without the need for extensive manual searching. This means faster and more efficient troubleshooting.

Response

List of scheduled/running jobs returned successfully

Example response

{
  "jobs": [
    {
      "jobId": "XX-1",
      "emailId": "user@example.com",
      "fileId": "file-1",
      "fileName": "name.csv",
      "status": "SCHEDULED",
      "submittedAt": "2025-11-03T09:39:17.128Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.