---
title: "List all products"
method: GET
path: "/products"
tags: ["Carriers, products & services"]
---

# List all products

`GET /products`

Returns a list of shipping products and services.


Only products available for the user are returned.


The codes of the products and services are required when creating a shipment.

## Query parameters

- `id` integer
- `product_code` string
- `sender_country_code` string
- `receiver_country_code` string
- `carrier_code` string
- `per_page` integer
- `page` integer

## Response `200`

Successful.

- ShippingProduct[]
  - `code` string — Product code used when referring to the specific product.
  - `id` integer — ID of the product. Only used in older version of the Shipmondo API.
  - `name` string — Name of the product.
  - `available` boolean — Is the product available to book on either own agreements or Shipmondo's agreement?
  - `own_agreement_available` boolean — Is the product available to book on own agreements?
  - `available_customer_numbers` object[] — Customer numbers associated with own available agreements. If none available then an empty array is returned
    - `customer_number` string
  - `customs_declaration_required` boolean — Does the product require customs information to book?
  - `service_point_available` boolean — Can the product be booked with a service point?
  - `service_point_required` boolean — Is service point required to book this product?
  - `expected_transit_time` string — The expected transit time of the product.
  - `sender_country_code` string — ISO 3166-1 alpha-2 country code that the product is sent from.
  - `receiver_country_code` string — ISO 3166-1 alpha-2 country code that the product is sent to.
  - `required_fields` string — Comma-separated string indicating fields that are required to book a shipment with the product.
  - `optional_fields` string — Comma-separated string indicating fields that are optional to book a shipment with the product.
  - `required_parcel_fields` string — Comma-separated string indicating fields that are required (for the objects in the "parcels" array) when booking a shipment with the product.
  - `optional_parcel_fields` string — Comma-separated string indicating fields that are optional (for the objects in the "parcels" array) when booking a shipment with the product.
  - `carrier` Carrier
    - `id` integer — ID of the carrier.
    - `code` string — Carrier code used elsewhere to refer to the specific carrier.
    - `name` string — Name of the carrier.
  - `destination_country` Country
    - `code` string — ISO3166-1 alpha-2 country code.
    - `name` string — Name of the country in English
    - `customs_declaration_required` boolean — Does the product require customs information to book?
  - `available_services` ShippingProductService[]
    - `code` string — Service code to be included in the booking of shipments.
    - `id` integer — ID of the service. Used for booking in older versions of the API.
    - `name` string — Name of the service.
    - `required_fields` string — Comma-separated string indicating fields that are required to book a shipment with the service.
    - `optional_fields` string — Comma-separated string indicating fields that are optional to book a shipment with the service.
  - `required_services` RequiredShippingProductService[]
    - `code` string — Service code to be included in the booking of shipments.
    - `id` integer — ID of the service. Used for booking in older versions of the API.
    - `name` string — Name of the service.
    - `required_fields` string — Comma-separated string indicating fields that are required to book a shipment with the service.
    - `optional_fields` string — Comma-separated string indicating fields that are optional to book a shipment with the service.
    - `note` string — Information about the service.
  - `weight_intervals` WeightInterval[] — Weight intervals available for use on shipment with this product using Shipmondo's agreement.
    - `from_weight` integer — Weight in grams at which the interval starts
    - `to_weight` integer — Weight in grams at which the interval ends.
    - `description` string — Text used to display the weight interval.
  - `ta_weight_intervals` WeightInterval[] — Weight intervals available for use on shipments with this product using your own carrier agreement.
    - `from_weight` integer — Weight in grams at which the interval starts
    - `to_weight` integer — Weight in grams at which the interval ends.
    - `description` string — Text used to display the weight interval.
  - `allowed_incoterms` string[] — Array of allowed Incoterms for the specific product. If empty all Incoterms are allowed.

## Other responses

- `401` — Unauthorized.
- `404` — Resource not found.

---

[API](https://skmtc.net/shipmondo/apis/shipmondo-api.md) · [All operations](https://skmtc.net/shipmondo/apis/shipmondo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shipmondo/shipmondo-api/revisions/3b9f91693dec/schema)