Skip to main content
GET
/
v1
/
projects
/
{projectId}
/
jobs
/
{jobId}
cURL
curl --request GET \
  --url https://{deployment}.convex.site/v1/projects/{projectId}/jobs/{jobId}
{
  "jobId": "job_xyz",
  "locale": "nl-NL",
  "status": "queued",
  "totalKeys": 143,
  "keysCompleted": 30,
  "isDiff": true,
  "startedAt": 1739712000000,
  "completedAt": 1739712000000,
  "errorMessage": null
}

Path Parameters

​
projectId
string
required
Minimum string length: 1
Example:

"proj_abc123"

​
jobId
string
required
Minimum string length: 1
Example:

"job_xyz"

Response

200 - application/json

Job details retrieved

​
jobId
string
required
Example:

"job_xyz"

​
locale
string
required
Example:

"nl-NL"

​
status
enum<string>
required
Available options:
queued,
running,
complete,
failed
​
totalKeys
number
required
Example:

143

​
keysCompleted
number
required
Example:

30

​
isDiff
boolean
required
Example:

true

​
startedAt
number
required
Example:

1739712000000

​
completedAt
number | null
required
Example:

1739712000000

​
errorMessage
string | null
required
Example:

null