# List SKUs

Returns all SKUs belonging to the authenticated merchant.

See the Pagination section in the API overview above for details on how pagination works.

Endpoint: GET /skus
Version: 2.0.0
Security: BearerAuth

## Query parameters:

  - `limit` (integer)
    Number of items to return per page (for pagination)

  - `created_at[gt]` (string)
    Filter results created after this date (ISO 8601 format)

  - `created_at[lt]` (string)
    Filter results created before this date (ISO 8601 format)

  - `created_at[gte]` (string)
    Filter results created on or after this date (ISO 8601 format)

  - `created_at[lte]` (string)
    Filter results created on or before this date (ISO 8601 format)

  - `sku_code[in]` (array)
    Filter results by one or more merchant SKU codes

## Response 200 fields (application/json):

  - `data` (array)

  - `data.barcode` (string,null)
    Barcode of the SKU

  - `data.batch_tracking_enabled` (boolean, required)
    Whether batch tracking of this SKU is enabled

  - `data.cost_in_cents` (integer,null)
    Cost in cents (currency of the shop is implied)

  - `data.country_code_of_origin` (string,null)
    2-letter [ISO 3166-1](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) code of country of origin

  - `data.created_at` (string, required)
    When this SKU was created

  - `data.updated_at` (string, required)
    When this SKU was last updated

  - `data.dangerous_good` (boolean, required)
    Sku is a dangerous good

  - `data.fulfilled_by` (string, required)
    Who is fulfilling this SKU. Possible values:
- hive: Fulfilled by Hive
- new: Default value for newly imported SKUs
- other: Fulfilled by another party
    Enum: "hive", "new", "other"

  - `data.h_codes` (array, required)
    Hazardous good H Codes

  - `data.hazardous_good` (boolean, required)
    SKU is a hazardous good

  - `data.hs_code` (string,null)
    The general [Harmonized System (HS) code](https://en.wikipedia.org/wiki/Harmonized_System) for the SKU

  - `data.id` (integer, required)
    Hive unique identifier for this SKU

  - `data.image_url` (string,null)
    Publicly accessible URL of an image for this SKU

  - `data.inventory` (object, required)

  - `data.inventory.available` (integer, required)
    Quantity available for sale (stocked minus reserved)

  - `data.inventory.reserved` (integer, required)
    Quantity reserved/committed for orders

  - `data.inventory.stocked` (integer, required)
    Quantity in the warehouse (available plus reserved)

  - `data.inventory_batches` (array, required)
    Current inventory per batch

  - `data.inventory_batches.expiry_date` (string,null, required)
    Expiration date of the batch (ISO8601 date, read-only)

  - `data.inventory_batches.id` (integer, required)
    Hive unique ID for the batch (read-only)

  - `data.inventory_batches.name` (string, required)
    Name of the batch (read-only)

  - `data.inventory_batches.stocked_quantities` (array, required)
    Inventory per warehouse for this batch (see SkuInventoryBatchQuantityPerWarehouse) (read-only)

  - `data.inventory_batches.stocked_quantities.stocked` (integer, required)
    Quantity in the warehouse for this batch in this warehouse

  - `data.inventory_batches.stocked_quantities.warehouse_id` (integer, required)
    Hive's unique warehouse ID

  - `data.inventory_batches.tracking_code` (string, required)
    Tracking code (read-only)

  - `data.inventory_per_warehouse` (array, required)
    Current inventory per warehouse

  - `data.name` (string, required)
    Name of this SKU

  - `data.sku_code` (string, required)
    SKU code - visible in the UI

  - `data.status` (string, required)
    Status of this SKU. Possible values:
- active: SKU is active and available for orders
- deleted: SKU is deleted and no longer available
    Enum: "active", "deleted"

  - `data.un_numbers` (array, required)
    Dangerous good UN Numbers

  - `data.weight_in_kg` (number, required)
    Weight of SKU in kilograms

  - `pagination` (object)

  - `pagination.first_page_url` (string)
    URL to fetch the first page of results

  - `pagination.limit` (integer)
    Number of items returned per page

  - `pagination.next_page_url` (string,null)
    URL to fetch the next page of results. If null, there are no more results.

## Response 401 fields (application/json):

  - `errors` (any, required)
    Error information. Can be:
- Object with field names as keys and error arrays as values (for validation errors)
- Array of error objects with message, code, and optional metadata
- Array of strings (for simple error messages)

  - `success` (boolean)
    Indicates if the request was successful

  - `title` (string)
    A brief, human-readable message about the error

  - `status` (integer)
    HTTP status code

## Response 403 fields (application/json):

  - `errors` (any, required)
    Error information. Can be:
- Object with field names as keys and error arrays as values (for validation errors)
- Array of error objects with message, code, and optional metadata
- Array of strings (for simple error messages)

  - `success` (boolean)
    Indicates if the request was successful

  - `title` (string)
    A brief, human-readable message about the error

  - `status` (integer)
    HTTP status code

## Response 429 fields (application/json):

  - `errors` (any, required)
    Error information. Can be:
- Object with field names as keys and error arrays as values (for validation errors)
- Array of error objects with message, code, and optional metadata
- Array of strings (for simple error messages)

  - `success` (boolean)
    Indicates if the request was successful

  - `title` (string)
    A brief, human-readable message about the error

  - `status` (integer)
    HTTP status code