Get available inventory for a country

curl -X GET 'https://product.api.e-cross.tech/ext/inventories/sku/1234567891/country/BR'
\ -H 'Authorization: Bearer YOUR_TOKEN' 

{
  "quantity": 10,
  "inventories": [
    {
      "id": "ACME-1234567891-1-AVAILABLE",
      "skuId": "1234567891",
      "skuName": "T-Shirt",
      "merchantId": "ACME",
      "quantity": 9,
      "inventoryType": "AVAILABLE",
      "lastUpdateDate": "2026-01-17T19:58:53Z",
      "warehouseId": 1,
      "warehouseName": "Default Warehouse",
      "warehouseCountry": "ES",
      "warehouseType": "MERCHANT"
    },
    {
      "id": "ACME-1234567891-1000-AVAILABLE",
      "skuId": "1234567891",
      "skuName": "T-Shirt",
      "merchantId": "ACME",
      "quantity": 1,
      "inventoryType": "AVAILABLE",
      "lastUpdateDate": "2026-01-25T12:15:01Z",
      "warehouseId": 1000,
      "warehouseName": "Returns Warehouse BR",
      "warehouseCountry": "BR",
      "warehouseType": "RETURNS",
      "returnedOrders": [
        {
          "orderId": "ACME-ECOM-TEST-003",
          "returnedDate": "2026-01-25T12:15:01Z",
          "quantity": 5
        }
      ]
    }
  ]
}

This API returns the total available quantity for the SKU across the origin warehouses summed with the available local inventory of the specified country (commonly generated due to returns).

curl -X GET 'https://product.api.e-cross.tech/ext/inventories/sku/1234567891/country/BR'
\ -H 'Authorization: Bearer YOUR_TOKEN' 

{
  "quantity": 10,
  "inventories": [
    {
      "id": "ACME-1234567891-1-AVAILABLE",
      "skuId": "1234567891",
      "skuName": "T-Shirt",
      "merchantId": "ACME",
      "quantity": 9,
      "inventoryType": "AVAILABLE",
      "lastUpdateDate": "2026-01-17T19:58:53Z",
      "warehouseId": 1,
      "warehouseName": "Default Warehouse",
      "warehouseCountry": "ES",
      "warehouseType": "MERCHANT"
    },
    {
      "id": "ACME-1234567891-1000-AVAILABLE",
      "skuId": "1234567891",
      "skuName": "T-Shirt",
      "merchantId": "ACME",
      "quantity": 1,
      "inventoryType": "AVAILABLE",
      "lastUpdateDate": "2026-01-25T12:15:01Z",
      "warehouseId": 1000,
      "warehouseName": "Returns Warehouse BR",
      "warehouseCountry": "BR",
      "warehouseType": "RETURNS",
      "returnedOrders": [
        {
          "orderId": "ACME-ECOM-TEST-003",
          "returnedDate": "2026-01-25T12:15:01Z",
          "quantity": 5
        }
      ]
    }
  ]
}

Path Parameters

string

required

The SKU ID in the sales channel (the SKU_ID used to create the SKU).

string

required

The country code (ISO 3166-1 alpha-2) of the destination country.

Response Fields

integer

The sum of all quantities from the inventories in the response. This represents the total available quantity for the SKU to be sold in the specified country.

array

Array containing available inventory entries for the specified SKU and country.

Show inventory details

string

The unique identifier of this SKU inventory record.

string

The unique identifier of the merchant within the e-CROSS platform.

string

The SKU ID in the sales channel.

string

The SKU name within e-CROSS. If the SKU isn’t registered in the e-CROSS platform, this field won’t be returned.

integer

The ID of the warehouse where the SKU is stocked.

string

The name of the warehouse where the SKU is stocked.

string

The country of the warehouse where the SKU is stocked.

string

The type of warehouse. Can be MERCHANT or RETURNS.

integer

The quantity of SKUs stocked in this warehouse.

string

The type of this inventory record. Always AVAILABLE for this endpoint.

string

The date and time when the product inventory entry was created or the quantity was changed, in ISO 8601 format.

string

The date and time when the sales channel updated the inventory quantity in their system. If no integration has occurred yet, this field won’t be returned.

array

Array containing the orders that generated the inventory position. Only present for RETURNS warehouses.

Show returnedOrders details

string

The ID of the order that generated the inventory position.

string

The date and time when the order was returned, in ISO 8601 format.

integer

The quantity of the SKU that was returned.

Overview

Authentication APIs

Sales Channel APIs

Merchant Catalog APIs

Order APIs

Shipment APIs

Parcel APIs

Sandbox APIs

Path Parameters

Response Fields

​Path Parameters

​Response Fields

Path Parameters

Response Fields