> ## Documentation Index
> Fetch the complete documentation index at: https://developers.e-cross.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Get available inventory for a country

> Retrieve available inventories for a SKU in a specific country

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).

<RequestExample>
  ```bash cURL  theme={null}
  curl -X GET 'https://product.api.e-cross.tech/ext/inventories/sku/1234567891/country/BR'
  \ -H 'Authorization: Bearer YOUR_TOKEN' 
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "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
          }
        ]
      }
    ]
  }

  ```
</ResponseExample>

### Path Parameters

<ParamField path="skuId" type="string" required>
  The SKU ID in the sales channel (the SKU\_ID used to create the SKU).
</ParamField>

<ParamField path="country" type="string" required>
  The country code (ISO 3166-1 alpha-2) of the destination country.
</ParamField>

### Response Fields

<ResponseField name="quantity" type="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.
</ResponseField>

<ResponseField name="inventories" type="array">
  Array containing available inventory entries for the specified SKU and country.

  <Expandable title="inventory details">
    <ResponseField name="id" type="string">
      The unique identifier of this SKU inventory record.
    </ResponseField>

    <ResponseField name="merchantId" type="string">
      The unique identifier of the merchant within the e-CROSS platform.
    </ResponseField>

    <ResponseField name="skuId" type="string">
      The SKU ID in the sales channel.
    </ResponseField>

    <ResponseField name="skuName" type="string">
      The SKU name within e-CROSS. If the SKU isn't registered in the e-CROSS platform, this field won't be returned.
    </ResponseField>

    <ResponseField name="warehouseId" type="integer">
      The ID of the warehouse where the SKU is stocked.
    </ResponseField>

    <ResponseField name="warehouseName" type="string">
      The name of the warehouse where the SKU is stocked.
    </ResponseField>

    <ResponseField name="warehouseCountry" type="string">
      The country of the warehouse where the SKU is stocked.
    </ResponseField>

    <ResponseField name="warehouseType" type="string">
      The type of warehouse. Can be `MERCHANT` or `RETURNS`.
    </ResponseField>

    <ResponseField name="quantity" type="integer">
      The quantity of SKUs stocked in this warehouse.
    </ResponseField>

    <ResponseField name="inventoryType" type="string">
      The type of this inventory record. Always `AVAILABLE` for this endpoint.
    </ResponseField>

    <ResponseField name="lastUpdateDate" type="string">
      The date and time when the product inventory entry was created or the quantity was changed, in ISO 8601 format.
    </ResponseField>

    <ResponseField name="lastIntegrationDate" type="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.
    </ResponseField>

    <ResponseField name="returnedOrders" type="array">
      Array containing the orders that generated the inventory position. Only present for RETURNS warehouses.

      <Expandable title="returnedOrders details">
        <ResponseField name="orderId" type="string">
          The ID of the order that generated the inventory position.
        </ResponseField>

        <ResponseField name="returnedDate" type="string">
          The date and time when the order was returned, in ISO 8601 format.
        </ResponseField>

        <ResponseField name="quantity" type="integer">
          The quantity of the SKU that was returned.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>