---
title: ShippingLabelPurchaseErrorCode - GraphQL Admin
description: Possible error codes that can be returned by `ShippingLabelPurchaseError`.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/enums/ShippingLabelPurchaseErrorCode
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/enums/ShippingLabelPurchaseErrorCode.md
api_name: admin
api_type: graphql
type: enum
---

# Shipping​Label​Purchase​Error​Code

enum

Possible error codes that can be returned by `ShippingLabelPurchaseError`.

## Valid values

* CARRIER\_​NOT\_​AVAILABLE

  The carrier is not available for this label. Please try another carrier.

* CONNECTION\_​ERROR

  We could not reach the shipping carrier. Please try again in a few minutes.

* DISABLED\_​SHIPPING\_​ACCOUNT

  The requested shop's shipping account is disabled. Please contact support.

* JOB\_​NOT\_​ENQUEUED

  There is another shipping label being purchased for this order.

* KILL\_​SWITCH

  Kill switch is enabled for this carrier.

* PERMANENT\_​ERROR

  A non-recoverable error occurred while purchasing the label. Review the shipment details and try again.

* PURCHASE\_​IN\_​PROGRESS

  We are still processing the purchase for this label.

* PURCHASE\_​LABEL\_​VALIDATION\_​ERROR

  The shipping label could not be purchased due to invalid information. Please verify the shipping address, package weight and dimensions, and customs details (for international shipments).

* TRANSIENT\_​ERROR

  An error occurred while purchasing the label. Please try again.

* UNKNOWN\_​ERROR

  An unknown error occurred while purchasing the label.

***

## Fields

* [Shipping​Label​Purchase​Error.code](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShippingLabelPurchaseError#field-ShippingLabelPurchaseError.fields.code)

  OBJECT

  The shipping label purchase processing failure.

***

## Map

### Fields with this enum

* [Shipping​Label​Purchase​Error.code](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShippingLabelPurchaseError#field-ShippingLabelPurchaseError.fields.code)