> ## Documentation Index > Fetch the complete documentation index at: https://developers.openborder.com/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve Landed Cost Calculation > ## What this endpoint does This **GET** endpoint lets your merchants **retrieve the full landed cost calculation** for a specific request using its unique `landedcost_request_id`. Use this to retrieve the exact landed cost breakdown for a transaction, including all itemized taxes, duties, and jurisdiction details by passing the `landedcost_request_id` that was returned by the Calculate landed cost endpoint. This ensures you can: - Safely replay results for auditing or compliance. - Display the same landed cost breakdown to the customer, even if they return to checkout later. ## OpenAPI ````yaml /api-reference/landed-cost.json get /v1/landed-cost/{landedcost_request_id} openapi: 3.0.0 info: title: OpenBorder Direct API Service description: Direct API Service description for OPEN API documentation version: '0.1' contact: {} servers: - url: https://api.openborder.com/api/direct/ description: Production - url: https://api.staging.openborder.com/api/direct/ description: Sandbox security: [] tags: [] paths: /v1/landed-cost/{landedcost_request_id}: get: tags: - Landed Cost summary: |+ Retrieve Landed Cost Calculation description: >- ## What this endpoint does This **GET** endpoint lets your merchants **retrieve the full landed cost calculation** for a specific request using its unique `landedcost_request_id`. Use this to retrieve the exact landed cost breakdown for a transaction, including all itemized taxes, duties, and jurisdiction details by passing the `landedcost_request_id` that was returned by the Calculate landed cost endpoint. This ensures you can: - Safely replay results for auditing or compliance. - Display the same landed cost breakdown to the customer, even if they return to checkout later. operationId: CartController_retrieveLandedCost parameters: - name: x-openborder-direct-api-key in: header description: OpenBorder merchant API token required: true schema: type: string - name: landedcost_request_id required: true in: path schema: type: string responses: '200': description: Landed cost previously calculated. content: application/json: schema: $ref: '#/components/schemas/TaxCalculationResponse' '401': description: Invalid authorization token received. '404': description: Specified landedcost_request_id not found. components: schemas: TaxCalculationResponse: type: object properties: landedcost_request_id: type: string description: >- Unique ID for this tax calculation request, must be submitted with the final order — store this for auditing or support. currency_code: type: string description: ISO 4217 currency code used for all amounts (e.g., "CAD"). external_reference_id: type: string description: >- Your original reference ID (e.g., cart or session ID) — helps link this calculation back to your system. nullable: true created_at: type: string description: ISO timestamp showing when the calculation was processed. usd_conversion_rate: type: number description: >- Conversion rate from the returned currency to USD at the time of calculation — useful for reporting. shipments: description: List of results for each shipment you submitted. type: array items: $ref: '#/components/schemas/CartShipmentResponse' hs_codes: description: >- The HS Code each product has been classified to. Availability Note: This field is conditionally populated in the response body. It will only be included if your merchant configuration requires the HS Code for proper processing (ex. international shipping or customs declaration). If the field is not required for your integration, a null value will be returned. type: array items: $ref: '#/components/schemas/SkuHsCodeEntry' required: - landedcost_request_id - currency_code - external_reference_id - created_at - usd_conversion_rate - shipments - hs_codes CartShipmentResponse: type: object properties: shipment_id: type: string description: >- The ID you provided for this shipment — use it to map results back to your original request. shipment_type: type: string description: 'Type of shipment: "cross_border" or "local".' enum: - cross_border - local shipping_rate_taxes: description: >- Tax and landed cost results for each shipping rate option you submitted. type: array items: $ref: '#/components/schemas/ShippingRateTaxesResponse' required: - shipment_id - shipment_type - shipping_rate_taxes SkuHsCodeEntry: type: object properties: sku: type: string description: SKU of the product hs_code: type: string description: >- HS code assigned to the product when calculating duties/taxes. **HS code is determined based on the product and ship to country**. required: - sku - hs_code ShippingRateTaxesResponse: type: object properties: shipping_rate_id: type: string description: ID of the shipping rate you submitted (e.g., "STANDARD_UPS"). shipping_rate: type: number description: >- The cost of the shipping rate in major currency units (e.g., dollars). Up to two decimal places. tax_transaction_id: type: string description: >- Unique tax transaction ID for the selected shipping option. You must save this and send it when you commit the final order to show which rate was chosen. landed_cost: description: >- Duties, taxes, fees, and a detailed breakdown for this shipping rate. allOf: - $ref: '#/components/schemas/LandedCost' required: - shipping_rate_id - shipping_rate - tax_transaction_id - landed_cost LandedCost: type: object properties: duties: type: number description: Total import duties in major currency units. total_taxes: type: number description: Total taxes for the shipment — sum of shipment and product taxes. shipment_taxes: type: number description: Portion of taxes that apply to shipping fees. product_taxes: type: number description: Portion of taxes that apply to the products. breakdown: description: >- Itemized details of each tax or duty, by type, jurisdiction, and amount. type: array items: $ref: '#/components/schemas/TaxBreakdown' required: - duties - total_taxes - shipment_taxes - product_taxes - breakdown TaxBreakdown: type: object properties: type: type: string description: 'Type of charge: "shipment_tax", "product_tax", or "duty".' enum: - shipment_tax - product_tax - duty tax_name: type: string description: Descriptive name of the tax or duty (e.g., "GST", "Import Duty"). rate: type: number description: Percentage rate applied to the taxable amount. amount: type: number description: >- Final amount for this tax or duty in major currency units (e.g., dollars). taxable_amount: type: number description: The base amount that the rate was applied to. jurisdiction: description: The jurisdiction or region that this tax or duty applies to. allOf: - $ref: '#/components/schemas/Jurisdiction' sku: type: string description: >- The SKU of the product the tax or duty applies to, if relevant. If the cost is shipment-level (not product-specific), this will be null. nullable: true required: - type - tax_name - rate - amount - taxable_amount - jurisdiction - sku Jurisdiction: type: object properties: name: type: string description: >- The name of the jurisdiction or region where the tax/duty applies (e.g., "Ontario" or "Federal"). type: type: string description: >- The type of jurisdiction — for example, "state", "country", or "federal". required: - name - type ````