Skip to content
/
Public Jobs Get

Public Jobs Get

Request

Fetch the status of an async ingestion job.

Path
job_idstring(Job Id)required
Headers
authorizationstring or null(Authorization)

Bearer <mrc_live_…> API key

curl -i -X GET \
  'https://docs.mercura.ai/_mock/openapi/jobs/{job_id}' \
  -H 'authorization: string'

Responses

Successful Response

Bodyapplication/json
job_idstring(Job Id)required
Example:"4242"
entitystring(Entity)required
Example:"ARTICLES"
statusstring(JobStatusValue)required

Lifecycle states for an async ingestion job.

Collapsed from the internal ImportRunStatus (which carries more granular states like PARTIALLY_COMPLETED and VALIDATION_FAILED) — see jobs/service.py:_STATUS_MAP for the translation table. The public surface gives partners the four states they actually need to branch on.

Enum:"PENDING""RUNNING""COMPLETED""FAILED"
Example:"COMPLETED"
created_atstring, (date-time)(Created At)required
Example:"2026-07-14T22:00:00Z"
updated_atstring, (date-time)(Updated At)required
Example:"2026-07-14T22:00:42Z"
total_rowsinteger(Total Rows)
Default:0
Example:12000
created_countinteger(Created Count)
Default:0
Example:320
updated_countinteger(Updated Count)
Default:0
Example:11675
skipped_countinteger(Skipped Count)
Default:0
Example:0
deleted_countinteger(Deleted Count)
Default:0
Example:0
error_countinteger(Error Count)
Default:0
Example:5
errorsArray of objects(Errors)
Example:
[
  {
    "error_message": "missing list_price",
    "identifier": "LEU-0900-18-830",
    "row_number": 137
  }
]
resultobject or null(Result)

Job-type-specific success payload; branch on entity for the shape. For REQUESTS jobs it carries {request_id, request_status, position_count} once the job completes. Other job types return null.

Response
{
  "created_at": "2026-07-14T22:00:00Z",
  "created_count": 320,
  "deleted_count": 0,
  "entity": "ARTICLES",
  "error_count": 5,
  "errors": [
    { … }
  ],
  "job_id": "4242",
  "skipped_count": 0,
  "status": "COMPLETED",
  "total_rows": 12000,
  "updated_at": "2026-07-14T22:00:42Z",
  "updated_count": 11675
}