Get job info

GET 
/jobs/:jobId

Get job info

Request

Path Parameters

jobId stringrequired

The job ID as returned by createJob.

Responses

200

Successful response to the createJob and getJobInfo requests

application/json

Schema

Schema

jobIdjobId (string)required

Unique ID of the job.

The job ID can be used to control the job, e.g. start it, as well as identify corresponding messages in the service log file. Therefore it is highly recommended to log the job ID in the client log file.

status

object

required

codejobStatusCode (string)required

Possible values: [creating, pending, processing, completed]

messagestringrequired

A message describing the job's status in more detail. Example: "Converting 'input.pdf' to PDF/A."

Example (from schema)

{
  "jobId": "string",
  "status": {
    "code": "creating",
    "message": "string"
  }
}

application/xml

Schema

Schema

jobIdjobId (string)required

Unique ID of the job.

The job ID can be used to control the job, e.g. start it, as well as identify corresponding messages in the service log file. Therefore it is highly recommended to log the job ID in the client log file.

status

object

required

codejobStatusCode (string)required

Possible values: [creating, pending, processing, completed]

messagestringrequired

A message describing the job's status in more detail. Example: "Converting 'input.pdf' to PDF/A."

Example (from schema)

<root>
  <jobId>string</jobId>
  <status>
    <code>creating</code>
    <message>string</message>
  </status>
</root>

404

The job with the specified ID could not be found.

application/problem+json

Schema

Schema

typestring

A URI reference that identifies the problem type. Note that this URI cannot be dereferenced.

titlestringrequired

A short, human-readable summary of the problem type.

statusstringrequired

The HTTP status code.

detailstringrequired

A human-readable explanation specific to this occurrence of the problem.

Example (from schema)

{
  "type": "string",
  "title": "string",
  "status": "string",
  "detail": "string"
}

jobNotFoundJson

{
    "type": "http://www.pdf-tools.com/service/rest/errors/jobNotFound",
    "title": "Job not found.",
    "detail": "The job with ID 'job_XYZ' could not be found",
    "status": 404
}

application/problem+xml

Schema

Schema

typestring

A URI reference that identifies the problem type. Note that this URI cannot be dereferenced.

titlestringrequired

A short, human-readable summary of the problem type.

statusstringrequired

The HTTP status code.

detailstringrequired

A human-readable explanation specific to this occurrence of the problem.

Example (from schema)

<root>
  <type>string</type>
  <title>string</title>
  <status>string</status>
  <detail>string</detail>
</root>

jobNotFoundJson

<problem xmlns="urn:ietf:rfc:7807">
  <type>http://www.pdf-tools.com/service/rest/errors/jobNotFound</type>
  <title>Job not found.</title>
  <detail>The job with ID 'job_XYZ' could not be found</detail>
  <status>404</status>
</problem>