GET
/
oms-imports
/
{importId}
curl --request GET \
  --url https://api.fabric.inc/v3/oms-imports/{importId} \
  --header 'Authorization: Bearer <token>' \
  --header 'x-fabric-channel-id: <x-fabric-channel-id>' \
  --header 'x-fabric-tenant-id: <x-fabric-tenant-id>'
{
  "attributes": {
    "attribute": "12345"
  },
  "createdAt": "2022-08-01T18:03:28.483Z",
  "errorFileUrl": "https://example.com/tenant/import/bulk/1654680575676.csv?X-Amz-Security-Token=IQoJb3JpZ2",
  "fileName": "orderUpload.csv",
  "finishedAt": "2022-08-01T18:03:28.483Z",
  "importCount": {
    "error": 2000,
    "processed": 8000,
    "uploaded": 10000
  },
  "importId": "62ff5c0bec0aed3c86202c32",
  "module": "ORDER",
  "originalFileUrl": "https://example.com/tenant/import/bulk/1654680575676.csv?X-Amz-Security-Token=IQoJb3JpZ2",
  "statusCode": "INITIATED",
  "type": "BULK",
  "updatedAt": "2022-08-01T20:03:28.483Z"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
x-fabric-tenant-id
string
required

A header used by fabric to identify the tenant making the request. You must include tenant id in the authentication header for an API request to access any of fabric’s endpoints. You can retrieve the tenant id , which is also called account id, from Copilot. This header is required.

​
x-fabric-channel-id
string
required

x-fabric-channel-id identifies the sales channel where the API request is being made; primarily for multichannel use cases. The channel ids are 12 corresponding to US and 13 corresponding to Canada. The default channel id is 12. This field is required.

​
x-fabric-request-id
string

Unique request ID

Path Parameters

​
importId
string
required

Upload file document's unique ID

Response

200
application/json
OK

Import status response object

​
createdAt
string
required

Time of import request

Example:

"2022-08-01T18:03:28.483Z"

​
importId
string
required

Imported file's unique ID

Example:

"62ff5c0bec0aed3c86202c32"

​
attributes
object

Custom attributes. This is a placeholder for additional info in key: value pairs

Example:
{ "attribute": "12345" }
​
errorFileUrl
string

Path (including security token) the file was uploaded to

Example:

"https://example.com/tenant/import/bulk/1654680575676.csv?X-Amz-Security-Token=IQoJb3JpZ2"

​
fileName
string

The uploaded file name.

Example:

"orderUpload.csv"

​
finishedAt
string

Date and time file import was completed

Example:

"2022-08-01T18:03:28.483Z"

​
importCount
object

Import count object

​
module
enum<string>

Module name

Available options:
ALLOCATION,
ORDER,
LOCATION,
SHIPMENT,
INVENTORY,
INVOICE,
TRANSFER,
LOCATION_OUTAGE,
TRANSFER_SHIPMENT,
LOCATION_CAPACITY_OVERRIDE
Example:

"ORDER"

​
originalFileUrl
string

URL of originally uploaded file

Example:

"https://example.com/tenant/import/bulk/1654680575676.csv?X-Amz-Security-Token=IQoJb3JpZ2"

​
statusCode
enum<string>

Uploaded file's current status

Available options:
INITIATED,
PROCESSING,
COMPLETED,
SYSTEM_ERROR
Example:

"INITIATED"

​
type
enum<string>

Import type

Available options:
BULK,
OVERLAY,
ROOT
Example:

"BULK"

​
updatedAt
string

Date and time record was last modified

Example:

"2022-08-01T20:03:28.483Z"

Was this page helpful?

Get uploaded files that match specified criteriaOverview