Skip to main content
GET
/
api
/
jobs
/
{id}
Get a job by ID
curl --request GET \
  --url https://api.mentionlab.io/api/jobs/{id} \
  --header 'x-project-id: <x-project-id>'
{
  "id": "01234567-89ab-cdef-0123-456789abcdef",
  "project": "01234567-89ab-cdef-0123-456789abcdef",
  "totalExecutions": 100,
  "pendingExecutions": 10,
  "retryingExecutions": 2,
  "successExecutions": 80,
  "failedExecutions": 8,
  "status": "processing",
  "createdAt": "2026-06-08T12:00:00.000Z",
  "updatedAt": "2026-06-08T12:30:00.000Z",
  "createdBy": {
    "firstName": "Jane",
    "lastName": "Doe",
    "email": "jane.doe@example.com",
    "id": "01234567-89ab-cdef-0123-456789abcdef"
  }
}

Headers

​
x-project-id
string
required

Project ID to specify the project context

Path Parameters

​
id
string<uuid>
required

The UUID of the job to retrieve.

Response

​
id
string<uuid>
required

Unique identifier of the job.

Example:

"01234567-89ab-cdef-0123-456789abcdef"

​
project
required

Project the job belongs to. Returned as the project identifier (UUID) when not populated, or as the full project object when expanded.

Example:

"01234567-89ab-cdef-0123-456789abcdef"

​
totalExecutions
number
required

Total number of executions associated with the job.

Example:

100

​
pendingExecutions
number
required

Number of executions that are still pending processing.

Example:

10

​
retryingExecutions
number
required

Number of executions currently being retried after a failure.

Example:

2

​
successExecutions
number
required

Number of executions that completed successfully.

Example:

80

​
failedExecutions
number
required

Number of executions that failed.

Example:

8

​
status
enum<string>
required

Overall status of the job, derived from the state of its executions.

Available options:
pending,
processing,
completed,
failed,
partial_failed
Example:

"processing"

​
createdAt
string<date-time>
required

Timestamp at which the job was created.

Example:

"2026-06-08T12:00:00.000Z"

​
updatedAt
string<date-time>
required

Timestamp at which the job was last updated.

Example:

"2026-06-08T12:30:00.000Z"

​
createdBy
object

User who created the job. May be null when the creator is unknown or no longer available.