> ## Documentation Index
> Fetch the complete documentation index at: https://docs.beachdepository.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Label Rates

> Fetch shipping rates for an inbound shipment

Quotes FedEx shipping rates for a package being shipped into the vault on behalf of an FBO account.

**Permission:** `inbound_shipments:create`

## Request body

<ParamField body="fboAccountId" type="string" required>
  ID of the FBO account the shipment is for. Used to resolve the vault's intake address and, if
  `fromAddressId` is used, to look up the stored address.
</ParamField>

<ParamField body="fromAddress" type="object">
  The ship-from address (the customer's address). Provide this **or** `fromAddressId`, not both.
  Required: `street1`, `city`, `state`, `zip`, `country`. Optional: `street2`, `name`, `company`,
  `phone`, `email`.
</ParamField>

<ParamField body="fromAddressId" type="string">
  ID of a saved address on the FBO account to ship from (see [List FBO Account
  Addresses](/api-reference/fbo-accounts/list-addresses)). Only `return` and `alternate` addresses
  are valid. Provide this **or** `fromAddress`, not both.
</ParamField>

<ParamField body="insuredValueDollars" type="integer" required>
  Declared value to insure, in whole dollars. Capped at 100,000.
</ParamField>

<ParamField body="weightLb" type="integer">
  Package weight, whole pounds. Defaults to 2.
</ParamField>

<ParamField body="weightOz" type="integer">
  Package weight, additional whole ounces. Defaults to 0.
</ParamField>

<ParamField body="predefinedPackage" type="string">
  A FedEx box preset. One of `FedExEnvelope`, `FedExPak`, `FedExTube`, `FedExBox`, `FedExSmallBox`,
  `FedExMediumBox`, `FedExLargeBox`, `FedExExtraLargeBox`. Omit to use custom dimensions instead.
</ParamField>

<ParamField body="packageLength" type="number">
  Custom package length in inches. Ignored if `predefinedPackage` is set.
</ParamField>

<ParamField body="packageWidth" type="number">
  Custom package width in inches. Ignored if `predefinedPackage` is set.
</ParamField>

<ParamField body="packageHeight" type="number">
  Custom package height in inches. Ignored if `predefinedPackage` is set.
</ParamField>

## Response

Returns the qualified rates. Pass a rate's `id` as `rateId` to [Create Inbound Shipment](/api-reference/inbound-shipments/create) to buy that label along with the shipment. Quoted rates stay purchasable for 15 minutes.

```json theme={null}
{
  "data": {
    "rates": [
      {
        "id": "rate_abc123",
        "shipmentId": "ship_abc123",
        "carrier": "FedEx",
        "service": "FedEx Ground",
        "serviceCode": "FEDEX_GROUND",
        "rate": "41.68",
        "itemCost": 31.55,
        "insuranceFee": 8.13,
        "cabrellaFee": 2.0,
        "itemTotal": 33.55,
        "grandTotal": 41.68,
        "currency": "USD",
        "deliveryDays": 3,
        "deliveryDate": "07/24/2026",
        "hasInsurance": true,
        "isCheapest": true,
        "isFastest": false,
        "message": null,
        "retailCost": 55.0,
        "retailSavedPercent": "24%"
      }
    ],
    "allRatesCount": 3,
    "filteredOutCount": 2,
    "validatedFromAddress": {
      "street1": "123 Main St",
      "city": "Dallas",
      "state": "TX",
      "zip": "75001",
      "country": "US"
    }
  }
}
```

<Note>
  `filteredOutCount` is the number of returned carrier rates that were excluded for not being FedEx
  or not carrying full insurance coverage.
</Note>