---
title: "Get shipping options"
method: POST
path: "/customers/{customerId}/subscriptions/{subscriptionId}/shipping-options"
tags: ["Subscriptions"]
---

# Get shipping options

`POST /customers/{customerId}/subscriptions/{subscriptionId}/shipping-options`

## Request

- Base URL: `https://api.awtomic.com`
- URL: `https://api.awtomic.com/customers/{customerId}/subscriptions/{subscriptionId}/shipping-options`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/awtomic/apis/awtomic-api/docs/customers/:customerId/subscriptions/:subscriptionId/shipping-options/post.ts> (a function with typed inputs; its response is checked against the schema)

Poll for shipping options for a new shipping address for a subscription.

If no draftId is provided, a new subscription draft will be created and returned.

## Path parameters

- `customerId` string, required
- `subscriptionId` string, required

## Request body

- object
  - `deliveryAddress` AddressShopify
    - `address1` string: Address line 1
    - `address2` string: Address line 2
    - `city` string: City
    - `company` string: Company
    - `countryCode` string: Country
    - `firstName` string: First name
    - `lastName` string: Last name
    - `phone` string: Phone
    - `provinceCode` string: Province
    - `zip` string: Zip
  - `draftId` string: Used if polling for options already requested

## Response `200`

Shipping options

- object
  - `draftId` string
  - `deliveryAddress` AddressShopify
    - `address1` string: Address line 1
    - `address2` string: Address line 2
    - `city` string: City
    - `company` string: Company
    - `countryCode` string: Country
    - `firstName` string: First name
    - `lastName` string: Last name
    - `phone` string: Phone
    - `provinceCode` string: Province
    - `zip` string: Zip
  - `deliveryOptions` object
    - `deliveryOptions` ShippingOption[]
      - `formattedPrice` string
      - `title` string
      - `code` string
      - `presentmentTitle` string
      - `description` string

## Other responses

- `400`: Validation error

---

[API](https://skmtc.dev/awtomic/apis/awtomic-api.md) - [All operations](https://skmtc.dev/awtomic/apis/awtomic-api/llms.txt) - [OpenAPI document](https://skmtc.dev/awtomic/apis/awtomic-api/revisions/5e6970981abe?raw)