logo

Bundles

The Bundles API allows you to create and retrieve bundles.

GetBundle

Get bundle information for a bundle.

SecurityBEARER
Request
path Parameters
bundleId
required
string (BundleIdType) = 11 characters ^B[0-9a-zA-Z]+$

The globally unique bundle identifier created by Flexport and assigned on bundle creation. May be referred to in other documentation as the Flexport SKU or BSKU.

Responses
200

OK

Response Schema: application/json
externalBundleId
required
string (ExternalBundleIdType) [ 1 .. 255 ] characters

A permanent unique reference for this bundle generated by and meaningful to the API user. This value will be used when sending orders to identify the bundle to ship. This value must be unique among all bundles created via API.

title
required
string [ 3 .. 255 ] characters

The bundle title or short description. Should represent a single line of text suitable to identify the bundle or for search purposes.

sku
required
string (SkuType) [ 1 .. 255 ] characters

The human-readable Stock Keeping Unit (SKU) for reporting. This value may change over time.

required
Array of objects (BundleContent) [ 1 .. 20 ] items
Array ([ 1 .. 20 ] items)
productId
required
string (ProductIdType) = 11 characters ^D[0-9a-zA-Z]+$

The globally unique product identifier created by Flexport and assigned on product creation. May be referred to in other documentation as the Flexport SKU or DSKU.

quantity
required
number <double>

Provide the quantity of that product that will be part of the bundle being created.

bundleId
required
string (BundleIdType) = 11 characters ^B[0-9a-zA-Z]+$

The globally unique bundle identifier created by Flexport and assigned on bundle creation. May be referred to in other documentation as the Flexport SKU or BSKU.

createdAt
required
string <date-time> (CreationDate)

The timestamp of creation in RFC 3339 format. e.g. 2017-07-21T17:32:28Z

401

Unauthorized

403

Forbidden

404

No bundle found with the bundleId provided

get/logistics/api/2024-07/bundles/{bundleId}
Response samples
application/json
{
  • "externalBundleId": "string",
  • "title": "string",
  • "sku": "string",
  • "bundleContents": [
    • {
      • "productId": "stringstrin",
      • "quantity": 0
      }
    ],
  • "bundleId": "stringstrin",
  • "createdAt": "2019-08-24T14:15:22Z"
}

GetBundleInventory

Get available inventory information for the bundle.

SecurityBEARER
Request
path Parameters
bundleId
required
string (BundleIdType) = 11 characters ^B[0-9a-zA-Z]+$

The globally unique bundle identifier created by Flexport and assigned on bundle creation. May be referred to in other documentation as the Flexport SKU or BSKU.

Responses
200

OK

Response Schema: application/json
bundleId
required
string (BundleIdType) = 11 characters ^B[0-9a-zA-Z]+$

The globally unique bundle identifier created by Flexport and assigned on bundle creation. May be referred to in other documentation as the Flexport SKU or BSKU.

availableUnits
required
number <double>

The number of units available for sale - not reserved for open orders, belonging to bundles that are in a pickable and shippable state at connected warehouses.

401

Unauthorized

403

Forbidden

404

No bundle found with the bundleId provided

get/logistics/api/2024-07/bundles/{bundleId}/inventory
Response samples
application/json
{
  • "bundleId": "stringstrin",
  • "availableUnits": 0
}

CreateBundle

Creates a new bundle.

SecurityBEARER
Request
Request Body schema: application/json
required
externalBundleId
required
string (ExternalBundleIdType) [ 1 .. 255 ] characters

A permanent unique reference for this bundle generated by and meaningful to the API user. This value will be used when sending orders to identify the bundle to ship. This value must be unique among all bundles created via API.

title
required
string [ 3 .. 255 ] characters

The bundle title or short description. Should represent a single line of text suitable to identify the bundle or for search purposes.

sku
required
string (SkuType) [ 1 .. 255 ] characters

The human-readable Stock Keeping Unit (SKU) for reporting. This value may change over time.

required
Array of objects (BundleContent) [ 1 .. 20 ] items
Array ([ 1 .. 20 ] items)
productId
required
string (ProductIdType) = 11 characters ^D[0-9a-zA-Z]+$

The globally unique product identifier created by Flexport and assigned on product creation. May be referred to in other documentation as the Flexport SKU or DSKU.

quantity
required
number <double>

Provide the quantity of that product that will be part of the bundle being created.

Responses
202

Bundle has been created

401

Unauthorized

403

Forbidden

404

No bundle found with the bundleId provided

422

Unprocessable Entity

post/logistics/api/2024-07/bundles
Request samples
application/json
{
  • "externalBundleId": "string",
  • "title": "string",
  • "sku": "string",
  • "bundleContents": [
    • {
      • "productId": "stringstrin",
      • "quantity": 0
      }
    ]
}
Response samples
application/json
{
  • "externalBundleId": "string",
  • "title": "string",
  • "sku": "string",
  • "bundleContents": [
    • {
      • "productId": "stringstrin",
      • "quantity": 0
      }
    ],
  • "bundleId": "stringstrin",
  • "createdAt": "2019-08-24T14:15:22Z"
}
➔ Next to Inbounds