Skip to main content
GET
Poll batch protein lookup job status

Path Parameters

job_id
string
required

Response

Successful Response

Status of an async batch protein lookup job.

Status meanings:

  • pending: job submitted; poll poll_url for updates.
  • completed: download_url provides a time-limited URL for the result zip.
  • cancelled: caller cancelled the job via DELETE before it completed.
  • failed / expired: the job did not complete successfully, or its results are no longer available for download.
status
enum<string>
required

Job state. See description above for the meaning of each value.

Available options:
pending,
completed,
cancelled,
failed,
expired
job_id
string | null

Server-assigned id for this async job.

poll_url
string | null

URL to poll for job status updates.

download_url
string | null

Time-limited URL for the result zip. Populated only when status is completed.

created_at
string | null

ISO 8601 timestamp of job submission.

completed_count
integer | null

Number of proteins processed so far.

total_count
integer | null

Total number of proteins in the job.