FlavorCloud Partner API Documentation
  1. Rates
FlavorCloud Partner API Documentation
  • Authentication
    • Get Auth Token
      POST
  • Rates
    • Get Rates
      POST
    • Get Rate Detail
      GET
    • Get Multi Quote
      POST
    • Get Multi Rates
      POST
    • Get Quote
      POST
  • Shipments
    • Create Shipments
      POST
    • Get Shipments
      GET
    • Cancel Shipments
      PUT
  • Tracking
    • Get Tracking Detail
      GET
  • Batches
    • Create Batch
      POST
    • Update Batch - Add Shipment
      PUT
    • Update Batch - Remove Shipment
      PUT
    • Close Batch
      POST
    • Get Batch
      GET
  • Classifications
    • Get Classification
      POST
  • Customer
    • Add Customer
      POST
    • Get Customers
      GET
  • Landed Cost
    • Get Landed Cost
      POST
  • Manifest
    • Manifest Shipment
      POST
    • Get Manifest
      GET
  • Webhooks
    • Subscribe Webhooks
    • Unsubscribe Webhooks
  • Invoices
    • Get Invoice Detail
    • Get Invoices
  1. Rates

Get Multi Quote

POST
/MultiQuote
Rates
This API call is used to return the rate for a shipment. All the details of the shipment should be provided to the api. Our route optimization engine, determines the best available route based on cost, service level and historical performance.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json
CustomerKey
string 
optional
Customer key
Reference
string 
required
This field is for your reference., A good use of it would be to provide your order number here.
>= 1 characters<= 30 characters
LabelFormat
enum<string> 
optional
LabelFormat
Allowed values:
PDFZPL
Default:
PDF
WeightUnit
enum<string> 
required
Unit for weight of the shipment.
Allowed values:
KGLB
Currency
string 
required
currency for the rate
DimensionUnit
enum<string> 
required
Unit for dimensions of the shipment.
Allowed values:
INCM
Insurance
enum<string> 
optional
Specify if insurance is required.
Allowed values:
YN
Default:
N
ServiceCode
array[string]
optional
Allowed values:
STANDARDEXPRESSSTANDARD-ECONOMYEXPRESS-ECONOMY
TermsOfTrade
array[string]
optional
Allowed values:
DDPDDU
IsReturn
enum<string> 
optional
You can easily create return labels. All you need to do is set the IsReturn parameter to "Y", leave the addresses the same as the initial Shipment's creation request and we switch the To and From Addresses for the return Shipment.
Allowed values:
YN
Default:
N
IncludeLandedCost
boolean 
optional
Include Landed cost for DDP rates. Default is true
Default:
true
ShipToAddress
object (QuoteToAddress) 
required
Name
string 
optional
Name of person. Both name and company can be included
Default:
John Doe
AttentionName
string 
optional
Name of attention, if person
AddressLine1
string 
optional
First line of the address
Default:
1177 Wanghai Rd
AddressLine2
string 
optional
Second line of the address
AddressLine3
string 
optional
Third line of the address
City
string 
required
Full city name
State
string 
optional
State or province
Country
string 
required
ISO 3166 country code for the country the address is located in
Zip
string 
required
ZIP or postal code
Phone
string 
optional
Phone number to reach the person or organization
Default:
111-111-1111
Email
string 
optional
Email to reach the person or organization
Default:
testshipper@gmail.com
FederalTaxId
string 
optional
Federal tax identifier of the person or organization
StateTaxId
string 
optional
State tax identifier of the person or organization
ShipFromAddress
object (QuoteFromAddress) 
required
Name
string 
optional
Name of person. Both name and company can be included
Default:
John Doe
AttentionName
string 
optional
Name of attention, if person
AddressLine1
string 
optional
First line of the address
Default:
1177 Wanghai Rd
AddressLine2
string 
optional
Second line of the address
AddressLine3
string 
optional
Third line of the address
City
string 
required
Full city name
State
string 
optional
State or province
Country
string 
required
ISO 3166 country code for the country the address is located in
Zip
string 
required
ZIP or postal code
Phone
string 
optional
Phone number to reach the person or organization
Default:
111-111-1111
Email
string 
optional
Email to reach the person or organization
Default:
testshipper@gmail.com
ReasonForExport
string 
optional
State the key reason for the shipment. Possible values could be 'documents', 'gift', 'merchandise', 'returned_goods', 'sample', or 'other'
Default:
merchandise
Shipments
array[object (ShipmentsModelQuote) {3}] 
required
Piece
array[object (QuotePiece) {12}] 
optional
Package
object (Package) 
required
ITNNumber
string 
optional
ITNNumber
Example
{
  "Reference": "test-multi-quote-001",
  "LabelFormat": "PDF",
  "WeightUnit": "LB",
  "Currency": "USD",
  "DimensionUnit": "IN",
  "Insurance": "N",
  "ServiceCode": [
    "STANDARD",
    "EXPRESS"
  ],
  "TermsOfTrade": [
    "DDP",
    "DDU"
  ],
  "IsReturn": "N",
  "IncludeLandedCost": true,
  "ShipToAddress": {
    "Name": "FC Rates",
    "AttentionName": "FC Rates",
    "AddressLine1": "49 Montcalm Ave",
    "AddressLine2": "",
    "AddressLine3": "",
    "City": "York",
    "State": "ON",
    "Country": "CA",
    "Zip": "M6E 4N8",
    "Phone": "1111111111",
    "Email": "test@test.com"
  },
  "ShipFromAddress": {
    "Name": "FC Rates",
    "AttentionName": "",
    "AddressLine1": "1562 Washington St",
    "AddressLine2": "",
    "AddressLine3": "",
    "City": "San Francisco",
    "State": "CA",
    "Country": "US",
    "Zip": "94109",
    "Phone": "1111111111",
    "Email": "test@test.com"
  },
  "ReasonForExport": "merchandise",
  "Shipments": [
    {
      "Piece": [
        {
          "Quantity": 1,
          "Weight": 0.1,
          "Length": 1,
          "Width": 1,
          "Height": 1,
          "SalePrice": 10,
          "HSCode": "610910",
          "OriginCountryCode": "US",
          "Description": "T-SHIRT",
          "SKU": "1234567890",
          "Material": "",
          "Category": [
            "merchandise"
          ]
        }
      ],
      "Package": {
        "Weight": 0.5,
        "Length": 1,
        "Width": 1,
        "Height": 1
      }
    }
  ]
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://partnerapi.flavorcloud.com/MultiQuote' \
--header 'Content-Type: application/json' \
--data-raw '{
    "Reference": "test-multi-quote-001",
    "LabelFormat": "PDF",
    "WeightUnit": "LB",
    "Currency": "USD",
    "DimensionUnit": "IN",
    "Insurance": "N",
    "ServiceCode": [
        "STANDARD",
        "EXPRESS"
    ],
    "TermsOfTrade": [
        "DDP",
        "DDU"
    ],
    "IsReturn": "N",
    "IncludeLandedCost": true,
    "ShipToAddress": {
        "Name": "FC Rates",
        "AttentionName": "FC Rates",
        "AddressLine1": "49 Montcalm Ave",
        "AddressLine2": "",
        "AddressLine3": "",
        "City": "York",
        "State": "ON",
        "Country": "CA",
        "Zip": "M6E 4N8",
        "Phone": "1111111111",
        "Email": "test@test.com"
    },
    "ShipFromAddress": {
        "Name": "FC Rates",
        "AttentionName": "",
        "AddressLine1": "1562 Washington St",
        "AddressLine2": "",
        "AddressLine3": "",
        "City": "San Francisco",
        "State": "CA",
        "Country": "US",
        "Zip": "94109",
        "Phone": "1111111111",
        "Email": "test@test.com"
    },
    "ReasonForExport": "merchandise",
    "Shipments": [
        {
            "Piece": [
                {
                    "Quantity": 1,
                    "Weight": 0.1,
                    "Length": 1,
                    "Width": 1,
                    "Height": 1,
                    "SalePrice": 10,
                    "HSCode": "610910",
                    "OriginCountryCode": "US",
                    "Description": "T-SHIRT",
                    "SKU": "1234567890",
                    "Material": "",
                    "Category": [
                        "merchandise"
                    ]
                }
            ],
            "Package": {
                "Weight": 0.5,
                "Length": 1,
                "Width": 1,
                "Height": 1
            }
        }
    ]
}'

Responses

🟢200MultiQuote Response
application/json
Body
RateId
string 
required
Unique id that can be used to retrieve rate later if needed
Reference
string 
required
The reference id that was sent in the request. The intent of this id is for you to correlate the requests and responses
Currency
string 
required
currency for the rate
Standard
object (TradeModel) 
optional
DDU
object (RateDetailDDU) 
required
DDP
object (RateDetailDDP) 
required
Express
object (TradeModel) 
optional
StandardEconomy
object (TradeModel) 
optional
ExpressEconomy
object (TradeModel) 
optional
Example
{
  "RateId": "string",
  "Reference": "string",
  "Currency": "string",
  "Standard": {
    "DDU": {
      "HashKey": "string",
      "ShippingCost": "string",
      "ActualShippingCost": "string",
      "DiscountedShippingCost": "string",
      "Carrier": "string",
      "Insurance": "string",
      "Days": "string"
    },
    "DDP": {
      "HashKey": "string",
      "ShippingCost": "string",
      "ActualShippingCost": "string",
      "DiscountedShippingCost": "string",
      "Carrier": "string",
      "Insurance": "string",
      "Days": "string",
      "LandedCostDetail": {
        "Duty": "string",
        "ActualDuty": "string",
        "SalesTax": "string",
        "ActualSalesTax": "string",
        "AIT": "string",
        "ActualAIT": "string",
        "LandedCost": "string",
        "ActualLandedCost": "string",
        "DutyHashKey": "string"
      }
    }
  },
  "Express": {
    "DDU": {
      "HashKey": "string",
      "ShippingCost": "string",
      "ActualShippingCost": "string",
      "DiscountedShippingCost": "string",
      "Carrier": "string",
      "Insurance": "string",
      "Days": "string"
    },
    "DDP": {
      "HashKey": "string",
      "ShippingCost": "string",
      "ActualShippingCost": "string",
      "DiscountedShippingCost": "string",
      "Carrier": "string",
      "Insurance": "string",
      "Days": "string",
      "LandedCostDetail": {
        "Duty": "string",
        "ActualDuty": "string",
        "SalesTax": "string",
        "ActualSalesTax": "string",
        "AIT": "string",
        "ActualAIT": "string",
        "LandedCost": "string",
        "ActualLandedCost": "string",
        "DutyHashKey": "string"
      }
    }
  },
  "StandardEconomy": {
    "DDU": {
      "HashKey": "string",
      "ShippingCost": "string",
      "ActualShippingCost": "string",
      "DiscountedShippingCost": "string",
      "Carrier": "string",
      "Insurance": "string",
      "Days": "string"
    },
    "DDP": {
      "HashKey": "string",
      "ShippingCost": "string",
      "ActualShippingCost": "string",
      "DiscountedShippingCost": "string",
      "Carrier": "string",
      "Insurance": "string",
      "Days": "string",
      "LandedCostDetail": {
        "Duty": "string",
        "ActualDuty": "string",
        "SalesTax": "string",
        "ActualSalesTax": "string",
        "AIT": "string",
        "ActualAIT": "string",
        "LandedCost": "string",
        "ActualLandedCost": "string",
        "DutyHashKey": "string"
      }
    }
  },
  "ExpressEconomy": {
    "DDU": {
      "HashKey": "string",
      "ShippingCost": "string",
      "ActualShippingCost": "string",
      "DiscountedShippingCost": "string",
      "Carrier": "string",
      "Insurance": "string",
      "Days": "string"
    },
    "DDP": {
      "HashKey": "string",
      "ShippingCost": "string",
      "ActualShippingCost": "string",
      "DiscountedShippingCost": "string",
      "Carrier": "string",
      "Insurance": "string",
      "Days": "string",
      "LandedCostDetail": {
        "Duty": "string",
        "ActualDuty": "string",
        "SalesTax": "string",
        "ActualSalesTax": "string",
        "AIT": "string",
        "ActualAIT": "string",
        "LandedCost": "string",
        "ActualLandedCost": "string",
        "DutyHashKey": "string"
      }
    }
  }
}
🟠401Authentication Error
🟠422Validation Error
🔴500Error Response
Modified at 2025-04-28 20:48:26
Previous
Get Rate Detail
Next
Get Multi Rates
Built with