Get category import status

curl --request GET \
  --url https://commerceos.aiagents.fabric.inc/api/v2/categories/import/{import_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'domain: <domain>'

import requests

url = "https://commerceos.aiagents.fabric.inc/api/v2/categories/import/{import_id}"

headers = {
    "domain": "<domain>",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {domain: '<domain>', Authorization: 'Bearer <token>'}};

fetch('https://commerceos.aiagents.fabric.inc/api/v2/categories/import/{import_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://commerceos.aiagents.fabric.inc/api/v2/categories/import/{import_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "domain: <domain>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://commerceos.aiagents.fabric.inc/api/v2/categories/import/{import_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("domain", "<domain>")
	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://commerceos.aiagents.fabric.inc/api/v2/categories/import/{import_id}")
  .header("domain", "<domain>")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://commerceos.aiagents.fabric.inc/api/v2/categories/import/{import_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["domain"] = '<domain>'
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "import_id": "a0cf63a0-55b8-4a25-9218-d972d4d65a79",
  "name": "tcs_category_test.csv",
  "status": "COMPLETED",
  "total_rows": 333,
  "processed_rows": 333,
  "new_count": 333,
  "updated_count": 0,
  "skipped_count": 0,
  "failed_count": 0,
  "input_filename": "tcs_category_test.csv",
  "input_file_url": "https://example.com/input.csv",
  "error_file_url": null,
  "error_message": null,
  "started_at": "2026-03-12T17:58:13.722428Z",
  "completed_at": "2026-03-12T17:58:14.564840Z",
  "created_at": "2026-03-12T17:58:13.605818Z"
}

{
  "errors": "<array>",
  "message": "Bad request",
  "type": "CLIENT_ERROR"
}

{
  "errors": "<array>",
  "message": "Bad request",
  "type": "CLIENT_ERROR"
}

{
  "errors": "<array>",
  "message": "Bad request",
  "type": "CLIENT_ERROR"
}

{
  "errors": "<array>",
  "message": "Bad request",
  "type": "CLIENT_ERROR"
}

GET

categories

import

{import_id}

Get category import status

curl --request GET \
  --url https://commerceos.aiagents.fabric.inc/api/v2/categories/import/{import_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'domain: <domain>'

import requests

url = "https://commerceos.aiagents.fabric.inc/api/v2/categories/import/{import_id}"

headers = {
    "domain": "<domain>",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {domain: '<domain>', Authorization: 'Bearer <token>'}};

fetch('https://commerceos.aiagents.fabric.inc/api/v2/categories/import/{import_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://commerceos.aiagents.fabric.inc/api/v2/categories/import/{import_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "domain: <domain>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://commerceos.aiagents.fabric.inc/api/v2/categories/import/{import_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("domain", "<domain>")
	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://commerceos.aiagents.fabric.inc/api/v2/categories/import/{import_id}")
  .header("domain", "<domain>")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://commerceos.aiagents.fabric.inc/api/v2/categories/import/{import_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["domain"] = '<domain>'
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "import_id": "a0cf63a0-55b8-4a25-9218-d972d4d65a79",
  "name": "tcs_category_test.csv",
  "status": "COMPLETED",
  "total_rows": 333,
  "processed_rows": 333,
  "new_count": 333,
  "updated_count": 0,
  "skipped_count": 0,
  "failed_count": 0,
  "input_filename": "tcs_category_test.csv",
  "input_file_url": "https://example.com/input.csv",
  "error_file_url": null,
  "error_message": null,
  "started_at": "2026-03-12T17:58:13.722428Z",
  "completed_at": "2026-03-12T17:58:14.564840Z",
  "created_at": "2026-03-12T17:58:13.605818Z"
}

{
  "errors": "<array>",
  "message": "Bad request",
  "type": "CLIENT_ERROR"
}

{
  "errors": "<array>",
  "message": "Bad request",
  "type": "CLIENT_ERROR"
}

{
  "errors": "<array>",
  "message": "Bad request",
  "type": "CLIENT_ERROR"
}

{
  "errors": "<array>",
  "message": "Bad request",
  "type": "CLIENT_ERROR"
}

Authorizations

Authorization

string

header

required

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

Headers

domain

string

required

The brand domain name (for example, vessel.com or containerstore.com) used to scope the request to a specific brand's data and configuration. The authenticated principal must be authorized for the specified brand.

Example:

"vessel.com"

Path Parameters

import_id

string<uuid>

required

Import ID returned from POST /api/v2/categories/import.

Example:

"a0cf63a0-55b8-4a25-9218-d972d4d65a79"

Response

Import status

import_id

string<uuid>

required

status

string

required

Example:

"COMPLETED"

total_rows

integer

required

Example:

333

processed_rows

integer

required

Example:

333

created_at

string<date-time>

required

name

string

Example:

"tcs_category_test.csv"

new_count

integer

Example:

333

updated_count

integer

Example:

0

skipped_count

integer

Example:

0

failed_count

integer

Example:

0

input_filename

string

Example:

"tcs_category_test.csv"

input_file_url

string<uri> | null

Example:

"https://example.com/input.csv"

error_file_url

string<uri> | null

Example:

null

error_message

string | null

Example:

null

started_at

string<date-time> | null

completed_at

string<date-time> | null

Bulk Import Categories Upload a catalog artifact

⌘I