# Customs Product API

Customs Product APIs let you create and manage saved customs product records for international shipments. These records can be reused in shipment requests to prefill customs item details such as product description, origin country, HS tariff code, quantity, unit price, and product dimensions.
Using these APIs helps reduce repeated data entry and improves consistency when the same product details are used across multiple domestic/international shipments.
Saved customs product identifiers can be passed in shipment/OMS workflows where customs item details are required.

Version: 1.0.0
License: PB Software License Agreement

## Servers

```
https://api-dev.sendpro360.pitneycloud.com/shipping
```

```
https://api-qa.sendpro360.pitneycloud.com/shipping
```

Sandbox Server
```
https://api-sandbox.sendpro360.pitneybowes.com/shipping
```

Production Server (uses live data)
```
https://api.sendpro360.pitneybowes.com/shipping
```

Sandbox Server for Canada
```
https://api-ppd.shipping360.pitneybowes.com/ca/shipping
```

Production Server for Canada
```
https://api.shipping360.pitneybowes.com/ca/shipping
```

## Security

### bearerAuth

Type: http
Scheme: bearer

## Download OpenAPI description

[Customs Product API](https://docs.sendpro360.pitneycloud.com/_bundle/openapi/customproduct.yaml)

## Customs Product

APIs for managing saved customs product records used to prefill customs item details for domestic/international shipments.

### Add Customs Product

 - [POST /api/v1/customsproduct](https://docs.sendpro360.pitneycloud.com/openapi/customproduct/customs-product/addcustomsproduct.md): This operation creates a customs product and returns its identifier. Use this identifier in shipment APIs to prefill customs item fields (HS tariff code, origin country, unit price, weight, quantity).
> Note: Support for this capability in the Rate Shipment and Create Shipment APIs is under active development. It is targeted for upcoming release.

### Get all Customs Products

 - [GET /api/v1/customsproduct](https://docs.sendpro360.pitneycloud.com/openapi/customproduct/customs-product/getcustomsproduct.md): Returns a list of all Customs Products.

### Get Customs Product by Id

 - [GET /api/v1/customsproduct/{customsProductId}](https://docs.sendpro360.pitneycloud.com/openapi/customproduct/customs-product/getcustomsproductbyid.md): This operation retrieves the details of a specific Customs Product mapping by its unique description.  
A customs product (description) represents a saved configuration of customs items defined for international shipment.

### Update Customs Product

 - [PUT /api/v1/customsproduct/{customsProductId}](https://docs.sendpro360.pitneycloud.com/openapi/customproduct/customs-product/updatecustomsproduct.md): This operation Updates the details for the specified Customs Product.  
The customs product (description)  itself cannot be changed.

### Delete Customs Product

 - [DELETE /api/v1/customsproduct/{customsProductId}](https://docs.sendpro360.pitneycloud.com/openapi/customproduct/customs-product/deletecustomsproduct.md): This operation deletes the Customs Product by its unique description.