QUICKSTART
API Quick Start
Authentication
SignString
Versioning
Rate Limit
Body Envelope
Request Errors
Common Scenarios
Tracking
Shipping
Returns
CHANGELOG
Changelog
Migration Guide
REFERENCE
API Overview
Orders
Create an order
post
List Orders
get
Get an order
get
Update an order
patch
Products
Create a product
post
Get a product
get
Update a product
patch
Stores
Create a store
post
List Stores
get
Get a store
get
Update a store
patch
Model
Envelope
Meta
v1
Error
v1
Pagination
v1
Primitive
Address
v1
Customer
v1
Money
v1
Shipment
v1
Weight
v1
StoreAddress
v1
Resource
Order
v1
OrderItem
v1
Product
v1
Store
v1
Support
Contact Support

Product

id
string
read-only

Unique identifier generated by AfterShip.

source_id
string
required

A unique identifier for the product in your system.

store
object

Indicate which store the product belongs to.

id
string
read-only

Unique identifier generated by AfterShip. Related to the Stores API, you can use this id to get store details using GET /stores/{id} API.

Example:
0ecb8ff7efa84d7d8f763ed7b21851d1
title
string
required

The title of the product.

slug
string

URL friendly unique identifier for the product. It is different from the order slug.

categories
array[string]

Catogories for the product used for filtering and searching products.

tags
array[string]

Tags that are used for filtering and search.

image_urls
array[string]
required

URLs of the images.

url
string

URL of a product.

published
boolean

To indicate whether a product has been published.

Default:
true
description
string

Description of a product.

variants
array[object]
required

Variants of a product.

>= 1 items
source_id
string
required

A unique identifier for the product variant in your system.

<= 32 characters
available_quantity
integer

Available quantity.

sku
string
required

A unique identifier for the product variant in the shop.

<= 1024 characters
title
string
required

The title of the product variant.

<= 1024 characters
price
string
required

The price of the product variant.

<= 100 characters
image_urls
array[string]

URLs of the images.

<= 100 items
compare_at_price
string

The original price of the item before an adjustment or a sale.

<= 100 characters
weight
Weight
Example:
{"unit":"kg","value":10}
allow_backorder
boolean

To indicate whether customers are allowed to place an order for the product variant that's out of stock.

options
array[object]

The custom product property name like Size, Color, and Material.

>= 1 items
source_created_at
string

The date and time when the product was created. ISO 8601.

source_updated_at
string

The date and time when the product was last modified. ISO 8601.

created_at
string

The date and time (ISO 8601 format) when an order was created in AfterShip.

updated_at
string

The date and time (ISO 8601 format) when an order was updated in AfterShip.

Example
{
  "id": "f74f8af7578042b0991e104533158ad1",
  "source_id": "00093d19495447a2a082bfe44d75658a",
  "store": {
    "id": "0ecb8ff7efa84d7d8f763ed7b21851d1"
  },
  "title": "update title",
  "slug": "baby-girl-clothes",
  "categories": [
    "shoes"
  ],
  "tags": [
    "baby"
  ],
  "image_urls": [
    "https://cdn.shopify.com/s/files/1/xxx/xxx/products/xxx.jpg?v=xxx"
  ],
  "url": "https://xxx.myshopify.com/products/baby-girl-clothes",
  "published": true,
  "description": "<strong>Brand Name: </strong>",
  "variants": [
    {
      "source_id": "00b0a1e329cf4ecc861136ed0ab94fc2",
      "available_quantity": 20,
      "sku": "23213-sda-asa-2T",
      "title": "baby girl clothes",
      "price": "31.8",
      "image_urls": [
        "https://cdn.shopify.com/s/files/1/xxx/xxx/products/xxx.jpg?v=xxx"
      ],
      "compare_at_price": "31.8",
      "weight": {
        "unit": "kg",
        "value": 0.1
      },
      "allow_backorder": true,
      "options": [
        {
          "name": "Color",
          "value": "BLACK DRESSES"
        }
      ]
    }
  ],
  "source_created_at": "2021-07-26T13:42:22Z",
  "source_updated_at": "2021-07-26T13:43:22Z",
  "created_at": "2022-07-19T10:56:40Z",
  "updated_at": "2022-07-20T12:53:32Z"
}