Skip to content

Seller shipping labels

Seller Shipping Labels is an authenticated pilot for Gearment POD teams, enabled per team by Gearment staff.

EasyPost is the label provider: Gearment buys the label through EasyPost, and the carrier on that label is whichever carrier the rate you selected belongs to. Provider and carrier are separate fields on every rate, label, and carrier configuration, so read them separately rather than treating EasyPost as a carrier name.

Carriers and services

There is no fixed carrier list to code against. The carrier and service combinations available to a team are configured per team by Gearment staff, so two teams can see different sets and a team's set can change without any change to this page.

Call GET /v1/vendor/shipping-labels/services and use what it returns. A rate is only purchasable when its carrier and service match a combination enabled for your team; anything outside that set is filtered out before you see it.

Workflow

  1. Call GET /v1/vendor/shipping-labels/services to discover the carrier and service combinations enabled for the team.
  2. Call POST /v1/vendor/shipping-labels/rates with US origin, destination, and package details. Quotes are valid for 15 minutes.
  3. Call POST /v1/vendor/shipping-labels with the selected rateId and a unique requestId.
  4. Use GET /v1/vendor/shipping-labels/{label_id} or GET /v1/vendor/shipping-labels to retrieve labels owned by the authenticated team.
  5. Use POST /v1/vendor/shipping-labels/{label_id}:cancel only while the provider still allows cancellation or refund.

Purchase safety

Purchasing a label is idempotent for a repeated requestId: Gearment returns the existing label instead of buying a second label. Treat a new requestId as a new purchase request.

API operations

The complete request and response schemas are in the API console.

  • GET /v1/vendor/shipping-labels/services
  • POST /v1/vendor/shipping-labels/rates
  • POST /v1/vendor/shipping-labels
  • GET /v1/vendor/shipping-labels/{label_id}
  • GET /v1/vendor/shipping-labels
  • POST /v1/vendor/shipping-labels/{label_id}:cancel