v1

latestOpenAPI 3.0.02026-07-2475182625.5 KB
Data

Retrieve a job

Returns the details of an existing job with the given job_id.

get/data/v1/jobs/{job_id}

Path parameters

job_idstring required

A unique identifier for the job.

Response

OK

idstring

Unique identifier for the job.

statusstring

Current status of the job (e.g., PENDING, PROCESSING, COMPLETE, FAILED).

namestring

Name assigned to the job.

createdstring date-time

Timestamp when the job was created.

completeDatestring date-time

Timestamp when the job was completed.

downloadUrlstring uri

URL to download the report once the job is complete.

notificationEmailsstring[]

List of emails to notify upon job completion.

Example response

{
  "id": "JOBABCDEFGHIJKLMNOPQRS1TUVWX",
  "status": "COMPLETE",
  "name": "RevenueReport",
  "created": "2025-01-01T12:11:01",
  "completeDate": "2025-01-01T12:12:35",
  "downloadUrl": "https://api.fastspring.com/data/v1/downloads/JOBABCDEFGHIJKLMNOPQRS1TUVWX",
  "notificationEmails": [
    "jane.doe@example.com"
  ]
}