# Overview

The Cross-Border Delivery Services (CBDS) APIs provide capabilities to support international shipping compliance and cost calculation. These APIs help determine product classification, identify country-specific shipping restrictions, calculate landed costs  (duties and taxes), and screen buyers or sellers against denied or sanctioned party lists.

The APIs are grouped into the following categories:

- **HS Classification:** Retrieve HS codes for items for a single country or across multiple countries.  
- **Restrictions:** Identify import and export restrictions for items based on destination or origin countries.  
- **Landed Cost Quote:** Calculate applicable duties and taxes for international shipments.  
- **Denied Party Screening:** Screen buyers or sellers against embargoed or sanctioned parties at the country level.


Version: 1.0.0

## 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
```

## Security

### basicAuth

Type: http
Scheme: basic

### bearerAuth

Type: http
Scheme: bearer

## Download OpenAPI description

[Overview](https://docs.sendpro360.pitneycloud.com/_bundle/openapi/crossborderdeliveryservices.yaml)

## HSClassification

APIs provide HS/HTS tariff code for a single item (to be shipped) to a given destination country or across multiple destination countries. 

### Get HS Code for Single Country

 - [POST /api/v1/crossborder-services/hsclassification](https://docs.sendpro360.pitneycloud.com/openapi/crossborderdeliveryservices/hsclassification/retrievehscode.md): Returns the full-length HS/HTS tariff code for a single item to a given destination country.Pre-classify products or obtain tariff codes when needed for crossborder transactions from AI models, facilitating customs formalities and the accurate calculation of import charges.

### Get HS Codes Across Countries

 - [POST /api/v1/crossborder-services/hsclassification/bulk](https://docs.sendpro360.pitneycloud.com/openapi/crossborderdeliveryservices/hsclassification/retrievehscodebulk.md): Returns full-length HS/HTS tariff codes for a single item across multiple destination countries in a single request. This bulk API is useful for global classification needs, allowing businesses to prepare items for international shipping and customs compliance across regions.

## Restriction

APIs determine if the item (to be shipped) has regulatory, legal, or carrier-based restrictions for a single destination country or across multiple destination countries.

### Get Shipping Restrictions for Single Country

 - [POST /api/v1/crossborder-services/restriction](https://docs.sendpro360.pitneycloud.com/openapi/crossborderdeliveryservices/restriction/returnshipmentrestrictions.md): This API helps determine if the item has regulatory, legal, or carrier-based restrictions for a single destination country.  Use this API to determine which countries are available for listing, and/or perform screenings to determine shipping compliance for crossborder transactions. Responses include restrictions and prohibitions for CITES, Health, Limited Quantity, Hazmat & Dangerous Goods, ITAR and Medical related regulations.

### Get Shipping Restrictions Across Countries

 - [POST /api/v1/crossborder-services/restriction/bulk](https://docs.sendpro360.pitneycloud.com/openapi/crossborderdeliveryservices/restriction/returnshipmentbulkrestrictions.md): This API helps determine if the item has regulatory, legal, or carrier-based restrictions for multiple destination countries.  Use this API to determine which countries are available for listing, and/or perform screenings to determine shipping compliance for crossborder transactions. Responses include restrictions and prohibitions for CITES, Health, Limited Quantity, Hazmat & Dangerous Goods, ITAR and Medical related regulations.

## Landed Cost Quote

APIs calculate estimated duties and taxes for a basket of items (to be shipped) being shipped to a single country or for a single item (to be shipped) across multiple destination countries.

### Calculate Duties and Taxes for Single Country

 - [POST /api/v1/crossborder-services/landedCostQuote](https://docs.sendpro360.pitneycloud.com/openapi/crossborderdeliveryservices/landed-cost-quote/calculatedutiesandtaxes.md): This API calculates estimated duties and taxes for a basket of items being shipped to a single country.
A landed cost is the total of all charges involved in a crossborder transaction, including transportation, import duties and taxes, shipping insurance, and related fees. Use this API to power a superior “duty-paid” checkout experience with accurate D&T estimates, and/or to inform business planning around import costs.

### Calculate Duties and Taxes for Single Item Across Countries

 - [POST /api/v1/crossborder-services/landedCostQuote/bulk](https://docs.sendpro360.pitneycloud.com/openapi/crossborderdeliveryservices/landed-cost-quote/calculatebulkdutiesandtaxes.md): This API calculates estimated duties and taxes duties for a single item across multiple destination countries.
A landed cost is the total of all charges involved in a crossborder transaction, including transportation, import duties and taxes, shipping insurance, and related fees. Use this API to power a superior "duty-paid" checkout experience with accurate D&T estimates, and/or to inform business planning around import costs.

## Denied Party Screening

API check compliance of the shipper and/or consignee addresses against government-issued watch lists to avoid doing business with prohibited individuals, entities, or organizations.

### Denied Party Screening

 - [POST /api/v1/denied-party-screening](https://docs.sendpro360.pitneycloud.com/openapi/crossborderdeliveryservices/denied-party-screening/deniedpartyscreening.md): This API operation is used to submit shipper and/or consignee address information for denied party screening and receive a compliance status indicating whether the address is approved, potentially matched, or matched to a restricted entity.
The API does not approve or reject shipments; instead, it provides actionable compliance insights that clients can use to determine next steps.

