GET
/
v1
/
retailers
/
{retailer_id}
/
shipments
/
{id}
/
Get a single shipment
curl --request GET \
  --url https://marketplace-api.fabric.inc/v1/retailers/{retailer_id}/shipments/{id}/ \
  --header 'Authorization: Bearer <token>'
{
  "id": 767,
  "order_id": 677,
  "batch_number": 6,
  "label_reference": "Sample label 123",
  "ordered_at": "2021-09-10T15:24:56Z",
  "customer_order_number": "765637",
  "retailer_order_number": "66367",
  "purchase_order_number": "PO-576",
  "shipping_method": {
    "id": 5,
    "name": "White Glove Bronze",
    "code": "cory_white_glove",
    "type": "ltl (less than truck load)",
    "carrier": {
      "id": 229,
      "name": "Cory Companies",
      "code": "CJCD"
    },
    "generic_shipping_method": {
      "id": 5,
      "name": "LTL",
      "description": "Less than truckload (LTL)",
      "type": "ltl"
    }
  },
  "shipping_account": {
    "id": 3,
    "nickname": "Hobie FedEx",
    "owner": "Sample Owner",
    "carrier": {
      "id": 229,
      "name": "Cory Companies",
      "code": "CJCD"
    },
    "is_first_party_bill": true
  },
  "tracking_number": "1Z9999999999999988",
  "tracking_url": "https://wwwapps.demo.com/WebTracking/track?track=yes&trackNums=1Z9999999999999988",
  "tracking": {
    "picked_up_at": "2022-08-10T15:24:56Z",
    "delivered_at": "2022-09-10T15:24:56Z",
    "tracking_details": [
      {
        "id": 78895456,
        "time": "10-10-2022",
        "status": "Delivered",
        "status_detail": "Out for delivery",
        "country": "USA",
        "state": "New York",
        "city": "New York",
        "postal_code": "123R32"
      }
    ]
  },
  "status": "Shipped",
  "is_acknowledged": true,
  "has_commercial_invoice": true,
  "canceled_at": null,
  "sold_to": {
    "id": 10,
    "type": "residential",
    "name1": "Demo Brand, Inc",
    "name2": null,
    "street1": "1332 Hermosa Ave",
    "street2": null,
    "city": "Hermosa Beach",
    "province": "CA",
    "postal_code": "90254",
    "country": "US",
    "phone1": "3105551212",
    "phone2": "3105551213",
    "fax": null,
    "email": null,
    "federal_tax_id": null
  },
  "ship_to": {
    "id": 10,
    "type": "residential",
    "name1": "Demo Brand, Inc",
    "name2": null,
    "street1": "1332 Hermosa Ave",
    "street2": null,
    "city": "Hermosa Beach",
    "province": "CA",
    "postal_code": "90254",
    "country": "US",
    "phone1": "3105551212",
    "phone2": "3105551213",
    "fax": null,
    "email": null,
    "federal_tax_id": null
  },
  "ship_from": {
    "id": 10,
    "type": "residential",
    "name1": "Demo Brand, Inc",
    "name2": null,
    "street1": "1332 Hermosa Ave",
    "street2": null,
    "city": "Hermosa Beach",
    "province": "CA",
    "postal_code": "90254",
    "country": "US",
    "phone1": "3105551212",
    "phone2": "3105551213",
    "fax": null,
    "email": null,
    "federal_tax_id": null
  },
  "ship_weight": 10,
  "ship_width": 1,
  "ship_length": 1,
  "ship_height": 1,
  "ship_girth": "<string>",
  "ship_volume": 4,
  "valid_packing_slip": true,
  "valid_shipping_label": true,
  "shipping_provider_identifier": "shp_3a61e10243da49ab92f0e3861d5d256b",
  "error_logs": {
    "id": 677,
    "message": "Sample errors to fix",
    "count": 12,
    "created_at": "2022-08-10T15:24:56Z"
  },
  "acknowledged_at": "2022-08-10T15:24:56Z",
  "closed_at": null,
  "delivered_at": "2022-09-10T15:24:56Z",
  "shipped_at": "2022-09-10T15:24:56Z",
  "updated_at": "2022-09-10T15:25:56Z",
  "created_at": "2022-09-10T15:24:56Z",
  "shipment_lines": [
    {
      "id": 1001,
      "order_line_number": "1001",
      "quantity": 1,
      "part": 1,
      "freight_class": 50,
      "updated_at": "2022-09-10T15:24:56Z",
      "variant": {
        "id": 249,
        "name": "Var45",
        "brand": {
          "id": 456,
          "code": "marla-store",
          "name": "Marla Store"
        },
        "identifier": "123-DEF12345",
        "brand_identifier": "HATR",
        "upc": 555555555202,
        "retailer_identifiers": [
          {
            "id": 5642,
            "retailer": {
              "id": 500,
              "name": "Demo Retailer",
              "code": "demo-retailer",
              "logo_url": "https://images.demo.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/logo-lg.png",
              "cover_url": "https://images.sampke.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/cover.jpg",
              "profile_tile_url": "https://images.demo.com/retailers/5ef41f6c-3361-40b7-86ce-ecd79c52e9a2/store/profile-tile.jpg",
              "joined_at": "2021-08-03T17:24:12Z",
              "is_rcn_retailer": false,
              "is_onboarded": false,
              "platform": "fabric",
              "requires_subscription": "disabled",
              "brand_permit_creation_allowed": false,
              "website": "https://demoabc.com",
              "status": "active"
            },
            "identifier": "SKU976",
            "name": "Retailer Sample"
          }
        ]
      }
    }
  ],
  "signature": null,
  "brand": {
    "id": 500,
    "name": "Marla Cielo",
    "code": "demo-brand",
    "joined_at": "2022-09-10T15:24:56Z",
    "logo_url": "https://images.revcascade.com/retailers/defaults/logo-lg.png",
    "cover_url": "https://images.revcascade.com/retailers/defaults/cover.png",
    "profile_tile_url": "https://images.revcascade.com/retailers/defaults/profile-tile.png",
    "website": null,
    "is_onboarded": false,
    "is_on_rcn": false,
    "requires_subscription": "enabled",
    "subscription_expires_at": "2024-09-19T13:32:10Z",
    "grace_period_ends_at": "2024-10-26T13:32:10Z",
    "subscription_is_expired": false,
    "subscription_is_on_grace_period": false,
    "subscription_is_delinquent": false,
    "inventory_policy": "managed",
    "status": "active"
  },
  "invoice_number": "RC123456"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
retailer_id
number
required

The unique retailer ID. In the Dropship UI this is called the Merchant ID. To find your Merchant ID, click your merchant name in the top nav.

​
id
integer
required

The unique shipment ID. This ID is automatically generated when a new shipment is created.

Response

200 - application/json

OK

​
order_id
integer
required

Order ID

Example:

677

​
id
integer

Shipment ID

Example:

767

​
batch_number
integer | null

Batch number of shipment

Required range: -2147483648 <= x <= 2147483647
Example:

6

​
label_reference
string | null

Label reference

Maximum length: 30
Example:

"Sample label 123"

​
ordered_at
string<date-time>

Time of shipment creation (UTC format)

Example:

"2021-09-10T15:24:56Z"

​
customer_order_number
string

Customer order number

Minimum length: 1
Example:

"765637"

​
retailer_order_number
string

Retailer order number

Minimum length: 1
Example:

"66367"

​
purchase_order_number
string

Purchase order number

Minimum length: 1
Example:

"PO-576"

​
shipping_method
object
​
shipping_account
object
​
tracking_number
string | null

Tracking number for shipment

Maximum length: 128
Example:

"1Z9999999999999988"

​
tracking_url
string

URL for tracking shipment

Example:

"https://wwwapps.demo.com/WebTracking/track?track=yes&trackNums=1Z9999999999999988"

​
tracking
object
​
status
string

Status of shipment

Minimum length: 1
Example:

"Shipped"

​
is_acknowledged
boolean

true: Shipment is acknowledged | false: Shipment is not acknowledged

Example:

true

​
has_commercial_invoice
boolean

true: Shipment has commercial invoice | Shipment does not have commercial invoice

Example:

true

​
canceled_at
string<date-time> | null

Time of cancellation (UTC format)

Example:

null

​
sold_to
object
​
ship_to
object
​
ship_from
object
​
ship_weight
number | null

Shipment weight

Example:

10

​
ship_width
number | null

Shipment width

Example:

1

​
ship_length
number | null

Shipment length

Example:

1

​
ship_height
number | null

Shipment height

Example:

1

​
ship_girth
string

Shipment girth

​
ship_volume
string

Shipment volume

Example:

4

​
valid_packing_slip
boolean

true: Shipment has valid packing slip | false: Shipment does not valid packing slip

Example:

true

​
valid_shipping_label
boolean

true: Shipment has valid shipping label | false: Shipment does not valid valid shipping label

Example:

true

​
shipping_provider_identifier
string | null

Identifier of the shipping provider

Maximum length: 64
Example:

"shp_3a61e10243da49ab92f0e3861d5d256b"

​
error_logs
object
​
acknowledged_at
string<date-time> | null

Time of acknowledgement (UTC format)

Example:

"2022-08-10T15:24:56Z"

​
closed_at
string<date-time> | null

Time of shipment closure (UTC format)

Example:

null

​
delivered_at
string<date-time> | null

Time of delivery (UTC format)

Example:

"2022-09-10T15:24:56Z"

​
shipped_at
string<date-time> | null

Time of shipping (UTC format)

Example:

"2022-09-10T15:24:56Z"

​
updated_at
string<date-time>

Time of shipment update (UTC format)

Example:

"2022-09-10T15:25:56Z"

​
created_at
string<date-time>

Time of shipment creation (UTC format)

Example:

"2022-09-10T15:24:56Z"

​
shipment_lines
object[]
​
signature
enum<string> | null

Signature criteria

Available options:
required,
not_required,
adult
Example:

null

​
brand
object
​
invoice_number
string

Invoice number

Example:

"RC123456"