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

# getShippingLabelQuotes

> Quote shipping rates for a shipment. Rates are ephemeral.

**Required scopes:** [`shipping_read`](/docs/api-reference/v3/reference/scopes#scope-shipping_read)

## Arguments

<ResponseField name="input" type={<a href="/docs/api-reference/v3/reference/shipping/outbound-shipment-request-input">OutboundShipmentRequestInput!</a>} required>
  The shipment to quote rates for.

  <Expandable title="fields" lazyRender>
    <ResponseField name="contentsSummary" type={<a href="/docs/api-reference/v3/reference/shipping/contents-summary-input">ContentsSummaryInput</a>}>
      Total declared contents. Required by carriers that want a declaration even with no customs items.

      <Expandable title="fields" lazyRender>
        <ResponseField name="description" type="String!" required>
          Plain-language description of everything in the shipment.
        </ResponseField>

        <ResponseField name="value" type={<a href="/docs/api-reference/v3/reference/common/money-input">MoneyInput!</a>} required>
          Total declared value of the shipment.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="customs" type={<a href="/docs/api-reference/v3/reference/shipping/outbound-customs-input">OutboundCustomsInput</a>}>
      Customs declaration. Required for international shipments; carriers reject them without one.

      <Expandable title="fields" lazyRender>
        <ResponseField name="aesExemptionCode" type={<a href="/docs/api-reference/v3/reference/shipping/aes-exemption-code">AesExemptionCode</a>}>
          AES exemption to cite when your account files by exemption. Ignored if your account files by ITN; defaults to `NOEEI_30_37_A`.
        </ResponseField>

        <ResponseField name="contentsExplanation" type="String">
          Description of the contents to print on the form. Defaults to your configured description, or the item descriptions joined together.
        </ResponseField>

        <ResponseField name="contentsType" type={<a href="/docs/api-reference/v3/reference/shipping/customs-contents-type">CustomsContentsType</a>}>
          What the shipment holds. Defaults to `MERCHANDISE`.
        </ResponseField>

        <ResponseField name="items" type={<a href="/docs/api-reference/v3/reference/shipping/outbound-customs-item-input">[OutboundCustomsItemInput!]!</a>} required>
          The declared lines (max 100).
        </ResponseField>

        <ResponseField name="itn" type="String">
          Internal Transaction Number for a shipment you filed with AES, e.g. "AES X20260827123456". Used only if your account is configured to file by ITN.
        </ResponseField>

        <ResponseField name="nonDeliveryOption" type={<a href="/docs/api-reference/v3/reference/shipping/customs-non-delivery-option">CustomsNonDeliveryOption</a>}>
          What to do if the shipment cannot be delivered. Defaults to `RETURN`.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="deliveredDutyPaid" type="Boolean">
      Assigns who is billed for duties and import taxes: the sender (DDP) or the recipient (DAP). Does not affect the quoted or charged rate — duties are billed separately after the shipment moves. Omit to leave the choice to your carrier configuration.
    </ResponseField>

    <ResponseField name="fromAddress" type={<a href="/docs/api-reference/v3/reference/shipping/outbound-address-input">OutboundAddressInput!</a>} required>
      Ship-from address.

      <Expandable title="fields" lazyRender>
        <ResponseField name="city" type="String" />

        <ResponseField name="country" type="String!" required />

        <ResponseField name="email" type="String" />

        <ResponseField name="name" type="String" />

        <ResponseField name="phone" type="String" />

        <ResponseField name="state" type="String" />

        <ResponseField name="street1" type="String" />

        <ResponseField name="street2" type="String" />

        <ResponseField name="zip" type="String!" required />
      </Expandable>
    </ResponseField>

    <ResponseField name="parcels" type={<a href="/docs/api-reference/v3/reference/shipping/outbound-parcel-input">[OutboundParcelInput!]!</a>} required>
      The parcels in the shipment (max 5).

      <Expandable title="fields" lazyRender>
        <ResponseField name="height" type={<a href="/docs/api-reference/v3/reference/catalog/dimension-input">DimensionInput!</a>} required />

        <ResponseField name="length" type={<a href="/docs/api-reference/v3/reference/catalog/dimension-input">DimensionInput!</a>} required />

        <ResponseField name="weight" type={<a href="/docs/api-reference/v3/reference/catalog/weight-input">WeightInput!</a>} required />

        <ResponseField name="width" type={<a href="/docs/api-reference/v3/reference/catalog/dimension-input">DimensionInput!</a>} required />
      </Expandable>
    </ResponseField>

    <ResponseField name="returnAddress" type={<a href="/docs/api-reference/v3/reference/shipping/outbound-address-input">OutboundAddressInput</a>}>
      Return address, if different from the ship-from address.

      <Expandable title="fields" lazyRender>
        <ResponseField name="city" type="String" />

        <ResponseField name="country" type="String!" required />

        <ResponseField name="email" type="String" />

        <ResponseField name="name" type="String" />

        <ResponseField name="phone" type="String" />

        <ResponseField name="state" type="String" />

        <ResponseField name="street1" type="String" />

        <ResponseField name="street2" type="String" />

        <ResponseField name="zip" type="String!" required />
      </Expandable>
    </ResponseField>

    <ResponseField name="taxIdentifiers" type={<a href="/docs/api-reference/v3/reference/shipping/tax-identifier-input">[TaxIdentifierInput!]</a>}>
      Tax identifiers for the shipment, e.g. an IOSS number for EU-bound goods.

      <Expandable title="fields" lazyRender>
        <ResponseField name="entity" type={<a href="/docs/api-reference/v3/reference/shipping/tax-identifier-entity">TaxIdentifierEntity!</a>} required>
          Which party the identifier belongs to.
        </ResponseField>

        <ResponseField name="issuingCountry" type={<a href="/docs/api-reference/v3/reference/common/country-code">CountryCode!</a>} required>
          Country of the authority that issued it.
        </ResponseField>

        <ResponseField name="type" type={<a href="/docs/api-reference/v3/reference/shipping/tax-identifier-type">TaxIdentifierType!</a>} required>
          The kind of identifier.
        </ResponseField>

        <ResponseField name="value" type="String!" required>
          The identifier itself.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="toAddress" type={<a href="/docs/api-reference/v3/reference/shipping/outbound-address-input">OutboundAddressInput!</a>} required>
      Ship-to address.

      <Expandable title="fields" lazyRender>
        <ResponseField name="city" type="String" />

        <ResponseField name="country" type="String!" required />

        <ResponseField name="email" type="String" />

        <ResponseField name="name" type="String" />

        <ResponseField name="phone" type="String" />

        <ResponseField name="state" type="String" />

        <ResponseField name="street1" type="String" />

        <ResponseField name="street2" type="String" />

        <ResponseField name="zip" type="String!" required />
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

## Returns

<ResponseField name="getShippingLabelQuotes" type={<a href="/docs/api-reference/v3/reference/shipping/outbound-rates-result">OutboundRatesResult!</a>} required>
  Quoted rates plus any carrier messages from the quote.

  <Expandable title="fields" lazyRender>
    <ResponseField name="messages" type={<a href="/docs/api-reference/v3/reference/shipping/outbound-rate-message">[OutboundRateMessage!]!</a>} required>
      Carrier messages from the quote.

      <Expandable title="fields" lazyRender>
        <ResponseField name="carrier" type="String!" required>
          Carrier the message is about.
        </ResponseField>

        <ResponseField name="carrierAccountId" type="String!" required>
          Carrier account the message is about.
        </ResponseField>

        <ResponseField name="message" type="String!" required>
          The carrier's message.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="rates" type={<a href="/docs/api-reference/v3/reference/shipping/outbound-rate-quote">[OutboundRateQuote!]!</a>} required>
      The purchasable rates.

      <Expandable title="fields" lazyRender>
        <ResponseField name="carrier" type="String!" required>
          Carrier offering this rate.
        </ResponseField>

        <ResponseField name="carrierAccountId" type="String!" required>
          Carrier account this rate was quoted on.
        </ResponseField>

        <ResponseField name="deliveryDays" type="Int">
          Carrier's estimated days in transit, when provided.
        </ResponseField>

        <ResponseField name="estimatedDeliveryDate" type={<a href="/docs/api-reference/v3/reference/common/date-time">DateTime</a>}>
          Carrier's estimated delivery date, when provided.
        </ResponseField>

        <ResponseField name="rate" type={<a href="/docs/api-reference/v3/reference/common/money">Money!</a>} required>
          Price charged for this rate. Carriage only — duties, import taxes, and customs fees are not included.

          <Expandable title="fields" lazyRender>
            <ResponseField name="amount" type={<a href="/docs/api-reference/v3/reference/common/decimal">Decimal!</a>} required>
              The exact amount as a decimal string (e.g. "19.99").
            </ResponseField>

            <ResponseField name="currency" type="String!" required>
              ISO 4217 currency code (e.g. USD).
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="service" type="String!" required>
          Carrier service level of this rate.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

## Example

```graphql theme={null}
mutation {
  getShippingLabelQuotes(input: { ... })
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.