---
updatedAt: 2025-06-10T23:43:59.000Z
agentTools:
  projectIndex: https://docs.supplierxm.salsify.com/llms.txt
---

# Supplier import tracking

You can track your import using this endpoint, it allows you to check that your suppliers have been successfully imported, and get error reasons in case of failure

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "supplier",
    "version": "2.1"
  },
  "servers": [
    {
      "url": "https://apis.supplierxm.salsify.com/public/v1/supplier"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "header",
        "name": "Authorization",
        "x-bearer-format": "bearer",
        "x-default": "SALSIFY_TOKEN"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/track/{tracker_id}": {
      "get": {
        "summary": "Supplier import tracking",
        "description": "You can track your import using this endpoint, it allows you to check that your suppliers have been successfully imported, and get error reasons in case of failure",
        "operationId": "supplier-import-tracking",
        "parameters": [
          {
            "name": "tracker_id",
            "in": "path",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Success": {
                    "value": "{\n  \"status\": \"SUCCESS\",\n  \"startedAt\": \"2020-04-23T09:31:17\",\n  \"message\": null,\n  \"endedAt\": \"2020-04-23T09:31:21\",\n  \"suppliers\": [\n    {\n      \"status\": \"SUCCESS\",\n      \"message\": null,\n      \"identifier\": \"Unique supplierID 1\"\n    },\n    {\n      \"status\": \"SUCCESS\",\n      \"message\": null,\n      \"identifier\": \"Unique supplierID 2\"\n    }\n  ]\n}\n"
                  },
                  "With error": {
                    "value": "{\n  \"status\": \"CONTAINS_ERROR\",\n  \"startedAt\": \"2020-04-23T09:32:19\",\n  \"message\": null,\n  \"endedAt\": \"2020-04-23T09:32:21\",\n  \"suppliers\": [\n    {\n      \"status\": \"SUCCESS\",\n      \"message\": null,\n      \"identifier\": \"Unique supplierID 1\"\n    },\n    {\n      \"status\": \"ERROR\",\n      \"message\": \"sirens expected list got <type 'int'>\",\n      \"identifier\": \"Unique supplierID 2\"\n    }\n  ]\n}\n"
                  }
                },
                "schema": {
                  "oneOf": [
                    {
                      "title": "Success",
                      "type": "object",
                      "properties": {
                        "status": {
                          "type": "string",
                          "example": "SUCCESS"
                        },
                        "startedAt": {
                          "type": "string",
                          "example": "2020-04-23T09:31:17"
                        },
                        "message": {},
                        "endedAt": {
                          "type": "string",
                          "example": "2020-04-23T09:31:21"
                        },
                        "suppliers": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "status": {
                                "type": "string",
                                "example": "SUCCESS"
                              },
                              "message": {},
                              "identifier": {
                                "type": "string",
                                "example": "Unique supplierID 1"
                              }
                            }
                          }
                        }
                      }
                    },
                    {
                      "title": "With error",
                      "type": "object",
                      "properties": {
                        "status": {
                          "type": "string",
                          "example": "CONTAINS_ERROR"
                        },
                        "startedAt": {
                          "type": "string",
                          "example": "2020-04-23T09:32:19"
                        },
                        "message": {},
                        "endedAt": {
                          "type": "string",
                          "example": "2020-04-23T09:32:21"
                        },
                        "suppliers": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "status": {
                                "type": "string",
                                "example": "SUCCESS"
                              },
                              "message": {},
                              "identifier": {
                                "type": "string",
                                "example": "Unique supplierID 1"
                              }
                            }
                          }
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```