> ## Documentation Index > Fetch the complete documentation index at: https://developers.marko.fr/llms.txt > Use this file to discover all available pages before exploring further. # Suivre un job d'import > Retourne les compteurs completed, noop, failed et conflict du job durable. Pour un import d'une operation, `operation_id` est renseigne des que la cible MARKO existe; sinon `error_code` et `error_message` decrivent l'echec. ## OpenAPI ````yaml https://partner-api.marko.fr/v1/openapi.json get /import-jobs/{job_id} openapi: 3.1.0 info: title: MARKO External Partner API version: v1 description: >- Stable external API contract for the live environment. Authentication flow for partner integrations: 1. Generate an API key from the MARKO entity admin API section. 2. Keep the raw API secret server-side and use it only to sign `POST /v1/auth/token`. 3. Build the canonical message `MARKO-EXTERNAL-API-TOKEN-V1\n{key_id}\n{timestamp}\n{nonce}`. 4. Sign that message with HMAC-SHA256 and send the hex signature with `key_id`, `timestamp` and `nonce`. 5. Use the returned short-lived bearer on business endpoints as `Authorization: Bearer `. The raw API secret must never be sent on business endpoints. This public contract intentionally excludes beta endpoints. servers: - url: https://partner-api.marko.fr/v1 security: - BearerAuth: [] externalDocs: description: Download the matching Postman collection. url: /v1/postman.json paths: /import-jobs/{job_id}: get: tags: - import-jobs summary: Suivre un job d'import description: >- Retourne les compteurs completed, noop, failed et conflict du job durable. Pour un import d'une operation, `operation_id` est renseigne des que la cible MARKO existe; sinon `error_code` et `error_message` decrivent l'echec. operationId: import-jobs_get parameters: - in: path name: job_id required: true schema: type: string format: uuid example: 88888888-8888-8888-8888-888888888888 - in: header name: X-Request-ID required: false description: >- Partner-generated correlation identifier echoed in logs and error payloads. schema: type: string example: marko-import-jobs-get responses: '200': description: Successful response content: application/json: schema: properties: job_id: format: uuid title: Job Id type: string status: title: Status type: string total_operations: title: Total Operations type: integer total_notes: title: Total Notes type: integer processed_items: title: Processed Items type: integer completed_items: title: Completed Items type: integer noop_items: title: Noop Items type: integer failed_items: title: Failed Items type: integer conflict_items: title: Conflict Items type: integer cancel_requested: title: Cancel Requested type: boolean accepted_at: anyOf: - format: date-time type: string - type: 'null' default: null title: Accepted At started_at: anyOf: - format: date-time type: string - type: 'null' default: null title: Started At completed_at: anyOf: - format: date-time type: string - type: 'null' default: null title: Completed At created_at: format: date-time title: Created At type: string updated_at: format: date-time title: Updated At type: string results_url: title: Results Url type: string operation_id: anyOf: - type: string format: uuid - type: 'null' default: null title: Operation Id error_code: anyOf: - type: string - type: 'null' default: null title: Error Code error_message: anyOf: - type: string - type: 'null' default: null title: Error Message required: - job_id - status - total_operations - total_notes - processed_items - completed_items - noop_items - failed_items - conflict_items - cancel_requested - created_at - updated_at - results_url title: ExternalImportJobResponse type: object example: job_id: 88888888-8888-8888-8888-888888888888 status: partial total_operations: 500 total_notes: 5000 processed_items: 5500 completed_items: 5497 noop_items: 1 failed_items: 1 conflict_items: 1 cancel_requested: false accepted_at: '2026-07-16T08:00:00Z' started_at: '2026-07-16T08:00:01Z' completed_at: '2026-07-16T08:04:20Z' created_at: '2026-07-16T08:00:00Z' updated_at: '2026-07-16T08:04:20Z' results_url: /v1/import-jobs/88888888-8888-8888-8888-888888888888/items operation_id: null error_code: null error_message: null '401': description: Authentication required content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' example: type: about:blank title: Unauthorized status: 401 detail: A valid bearer token is required. request_id: req_example_partner_call '403': description: Scope, route or IP restriction content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' example: type: about:blank title: Forbidden status: 403 detail: The API key does not allow this operation. request_id: req_example_partner_call '422': description: Validation failed content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' example: type: about:blank title: Unprocessable Content status: 422 detail: The request payload or parameters are invalid. request_id: req_example_partner_call '429': description: Rate limit or progressive ban headers: Retry-After: description: Cooldown in seconds before retrying the request. schema: type: string content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' example: type: about:blank title: Too Many Requests status: 429 detail: The request rate limit was exceeded. request_id: req_example_partner_call '500': description: Unexpected server error content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' example: type: about:blank title: Internal Server Error status: 500 detail: An unexpected server error occurred. request_id: req_example_partner_call deprecated: false security: - BearerAuth: [] components: schemas: ProblemDetails: type: object required: - title - status - detail properties: type: type: string default: about:blank title: type: string status: type: integer detail: type: string request_id: type: string scope: type: string route_id: type: string reason_code: type: string securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: MARKO short-lived bearer description: >- Use the `access_token` returned by `POST /v1/auth/token`. Do not send the raw API secret on business endpoints. ````