BigCommerce
Management API
Customs Information

Shipping V3

Get Customs Information

GET /shipping/products/customs-information

Request

Get customs information for products.

This list can be filtered to return customs information objects specific to a list of requested product_ids. This is achieved by appending the query string ?product_id:in=4,5,6 to the resource /shipping/products/customs-information.

GET /shipping/products/customs-information?product_id:in=4,5,6

Authentication

  • X-Auth-Token in header - required

Parameters

  • store_hash in path - string
  • Accept in header with default of application/json - string - required

    The MIME type of the response body.

  • product_id:in in query - array

    A comma-separated list of product IDs. For more information, see Filtering.

  • page in query - integer
  • limit in query - integer

example

Response

Body

object | application/json
  • data
    array[object]

  • meta
    object

    Meta data relating to pagination.

example

Delete Customs Information

DELETE /shipping/products/customs-information

Request

Deletes customs information objects for a product.

Example

This is a batch operation. The product_id:in query parameter is required.

DELETE /shipping/products/customs-information?product_id:in=4,5,6

Authentication

  • X-Auth-Token in header - required

Parameters

  • store_hash in path - string
  • Accept in header with default of application/json - string - required

    The MIME type of the response body.

  • product_id:in in query - string - required

example

Response

No Content

Upsert Customs Information

PUT /shipping/products/customs-information

Request

Creates and updates product customs information.

This is a batch operation where the creation of multiple customs information objects can be done with one PUT request.

Limits

  • Limit of 50 customs information objects per PUT request.

Authentication

  • X-Auth-Token in header - required

Parameters

  • store_hash in path - string
  • Content-Type in header with default of application/json - string - required

    The MIME type of the request body.

Body

array | application/json
  • product_id
    integer
    required

    The product ID to which the customs information data applies.

    Example: 77

  • country_of_origin
    string
    required

    The country of manufacture, production, or growth represented in ISO 3166-1 alpha-2 format.

    Example: US

  • commodity_description
    string
    required

    Description that provides information for customs to identify and verify the shapes, physical characteristics, and packaging of each shipment.

    >= 0 characters<= 100 characters

    Example: Baseball caps

  • international_shipping
    boolean
    required

    Flag to determine whether this product will be shipped internationally.

    Allowed: true | false

    Example: true

  • hs_codes
    object
    required

    Key-value pairs that are commonly used in the following form:

    countryISO2: '/^[0-9A-Za-z]{6,14}$/'

    This key-value pair represents a country and the associated hs_code that applies to that country.

    You can also use the ALL key in place of an ISO2 key to specify that the hs_code applies to all countries. The ALL key can be combined with other countries in the hs_code object.

    Example: {"ALL":"501000","CA":"508313","US":"641000","AU":"817355"}

Example

Response

OK

Body

object | application/json
  • data
    array[object]

Did you find what you were looking for?