---
title: ShippingLabelPurchaseResult - GraphQL Admin
description: Tracks the progress of an asynchronous shipping label purchase request.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/objects/ShippingLabelPurchaseResult
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/objects/ShippingLabelPurchaseResult.md
api_name: admin
api_type: graphql
type: object
---

# Shipping​Label​Purchase​Result

object

Requires `read_orders` access scope. Also: The user requires `buy_shipping_labels` permission.

Tracks the progress of an asynchronous shipping label purchase request.

## Fields

* done

  [Boolean!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean)

  non-null

  This indicates if the job is still queued or has been run.

* errors

  [\[Shipping​Label​Purchase​Error!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShippingLabelPurchaseError)

  non-null

  Purchase-processing errors for the request. Synchronous validation errors are returned from the `shippingLabelPurchase` mutation's `userErrors` field instead.

* id

  [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID)

  non-null

  A globally-unique ID that's returned when running an asynchronous mutation.

* shipping​Labels

  [\[Shipping​Label!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShippingLabel)

  non-null

  The shipping labels created by the purchase request. Labels are returned only after successful purchase.

* status

  [Shipping​Label​Purchase​Result​Status!](https://shopify.dev/docs/api/admin-graphql/latest/enums/ShippingLabelPurchaseResultStatus)

  non-null

  The current purchase status. A purchase starts as `PENDING_PURCHASE` and ends as either `PURCHASED` or `PURCHASE_FAILED`.

***

## Map

No referencing types

***

## Mutations

* [shipping​Label​Purchase](https://shopify.dev/docs/api/admin-graphql/latest/mutations/shippingLabelPurchase)

  mutation

  Purchases a shipping label for a fulfillment order.

  The `shippingLabelPurchase` mutation buys one shipping label for one fulfillment order using Shopify Shipping. The mutation validates the fulfillment order, shipment details, package information, and available rates before it starts an asynchronous label purchase.

  ***

  **Note:** The shop must have accepted the Shopify Shipping terms of service before an app can purchase labels.\</p> \<p>FedEx label purchases are not supported.

  ***

  After validation, the mutation builds the shipment details, fetches available rates, selects a rate, and enqueues the label purchase. If you provide `preferredRateSelection`, the mutation attempts to purchase the matching carrier and service. If you don't provide `preferredRateSelection`, the mutation uses Shopify Shipping's default rate selection.

  Default rate selection first tries to keep the fulfillment order's buyer-selected delivery method when available. If no buyer-selected rate matches, the mutation uses the shop's preferred carrier and service when configured. Otherwise, it uses Shopify's recommended rate for the shipment destination.

  For Merchant of Record (MoR) and Markets Pro orders, the mutation first removes rates from carriers that don't support Markets Pro.

  A shipping label can be purchased only when the fulfillment order meets the following criteria:

  * The fulfillment order is fulfillable and requires shipping.
  * The order has a destination shipping address.
  * The fulfillment order has an assigned location that can be used as the origin address.
  * The shipment has a valid shipping date, package, weight, and required customs information.
  * At least one shipping rate is available for the shipment.

  The mutation can return errors in two places:

  * Synchronous validation errors are returned in the mutation's `userErrors` field. For example, invalid fulfillment orders, invalid package dimensions, missing customs information, or unavailable rates.
  * Asynchronous purchase-processing errors are returned in the `ShippingLabelPurchaseResult.errors` field after the purchase starts. For example, carrier availability, connection, billing, or other purchase-processing failures.

  Use the returned `ShippingLabelPurchaseResult.id` to poll the purchase status with the `node` query. The result starts with a status of `PENDING_PURCHASE` and ends with `PURCHASED` or `PURCHASE_FAILED`. When the purchase succeeds, `shippingLabels` contains the purchased label.

  * shipping​Label​Purchase

    [Shipping​Label​Purchase​Input!](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ShippingLabelPurchaseInput)

    required

    ### Arguments

    The shipment, package, and rate preferences for the label purchase.

  ***

***

## ShippingLabelPurchaseResult Mutations

### Mutated by

* [shipping​Label​Purchase](https://shopify.dev/docs/api/admin-graphql/latest/mutations/shippingLabelPurchase)

***

## Interfaces

* * [Job​Result](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/JobResult)

    interface

  * [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)

    interface

***

## ShippingLabelPurchaseResult Implements

### Implements

* [Job​Result](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/JobResult)
* [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)