Skip to content
Skunivo Help Center

List outbounds in the selected organization

GET
/v1/organizations/{organizationId}/outbounds

API key scope: inventory:read.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Header Parameters

Section titled “Header Parameters”
X-Request-Id
string

Optional client request id returned in structured errors.

Query Parameters

Section titled “Query Parameters”
status
string
Allowed values: backordered partiallyAllocated allocated partiallyPicked picked partiallyPacked packed partiallyFulfilled fulfilled cancelled
productId
string
locationId
string
ownerId
string
channelId
string
externalOrderType
string
Example
sales_order
externalOrderId
string
Example
so_01JABC
createdFrom
string format: date-time
createdTo
string format: date-time
cursor
string
limit
number
default: 25 >= 1 <= 100

Responses

Section titled “Responses”

200

Section titled “200”

Outbounds page.

Media typeapplication/json
object
items
required
Array<object>
object
id
required
string format: uuid
organizationId
required
string format: uuid
environment
required
string
Allowed values: live test
productId
required
string format: uuid
locationId
required
string format: uuid
ownerId
required
string format: uuid
channelId
required
string format: uuid
requestedQuantity
required
number
allocatedQuantity
required
number
pickedQuantity
required
number
packedQuantity
required
number
fulfilledQuantity
required
number
pendingAllocationQuantity
required
number
pendingPickQuantity
required
number
pendingPackQuantity
required
number
pendingFulfillmentQuantity
required
number
status
required
string
Allowed values: backordered partiallyAllocated allocated partiallyPicked picked partiallyPacked packed partiallyFulfilled fulfilled cancelled
customerName
object
externalOrderType
object
externalOrderId
object
expectedShipAt
object
allocatedAt
object
fulfilledAt
object
cancelledAt
object
referenceType
object
referenceId
object
metadata
object
key
additional properties
any
version
required
number
createdBy
object
actor
required
object
type
required
string
Allowed values: user api_key system
id
object
label
required
string
product
object
id
required
string format: uuid
name
required
string
sku
required
string
location
object
id
required
string format: uuid
name
required
string
code
required
string
type
required
string
Allowed values: warehouse store virtual
owner
object
id
required
string format: uuid
name
required
string
code
required
string
type
required
string
channel
object
id
required
string format: uuid
name
required
string
code
required
string
type
required
string
lines
required
Array<object>
object
id
required
string format: uuid
organizationId
required
string format: uuid
environment
required
string
Allowed values: live test
outboundId
required
string format: uuid
productId
required
string format: uuid
locationId
required
string format: uuid
ownerId
required
string format: uuid
channelId
required
string format: uuid
requestedQuantity
required
number
allocatedQuantity
required
number
pickedQuantity
required
number
packedQuantity
required
number
fulfilledQuantity
required
number
pendingAllocationQuantity
required
number
pendingPickQuantity
required
number
pendingPackQuantity
required
number
pendingFulfillmentQuantity
required
number
product
object
id
required
string format: uuid
name
required
string
sku
required
string
location
object
id
required
string format: uuid
name
required
string
code
required
string
type
required
string
Allowed values: warehouse store virtual
owner
object
id
required
string format: uuid
name
required
string
code
required
string
type
required
string
channel
object
id
required
string format: uuid
name
required
string
code
required
string
type
required
string
serials
required
Array<object>
object
id
required
string format: uuid
serialId
required
string format: uuid
pickedAt
object
packedAt
object
shippedAt
object
serial
required
object
id
required
string format: uuid
serialNumber
required
string
status
required
string
Allowed values: in_stock picked packed consumed written_off archived
productId
required
string format: uuid
locationId
required
string format: uuid
ownerId
required
string format: uuid
channelId
required
string format: uuid
lotId
object
createdAt
required
string format: date-time
updatedAt
required
string format: date-time
createdAt
required
string format: date-time
updatedAt
required
string format: date-time
nextCursor
object
Example
{
  "items": [
    {
      "id": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
      "organizationId": "11111111-1111-4111-8111-111111111111",
      "environment": "test",
      "productId": "22222222-2222-4222-8222-222222222222",
      "locationId": "33333333-3333-4333-8333-333333333333",
      "requestedQuantity": 4,
      "allocatedQuantity": 2,
      "pickedQuantity": 1,
      "packedQuantity": 0,
      "fulfilledQuantity": 0,
      "pendingAllocationQuantity": 2,
      "pendingPickQuantity": 1,
      "pendingPackQuantity": 1,
      "pendingFulfillmentQuantity": 2,
      "status": "partiallyPicked",
      "customerName": "Acme Customer",
      "externalOrderType": "sales_order",
      "externalOrderId": "so_01JABC",
      "expectedShipAt": "2026-07-10T12:00:00.000Z",
      "allocatedAt": "2026-06-29T10:05:00.000Z",
      "fulfilledAt": null,
      "cancelledAt": null,
      "referenceType": "sales_order",
      "referenceId": "so_01JABC",
      "metadata": {
        "channel": "web"
      },
      "version": 1,
      "createdBy": null,
      "actor": {
        "type": "api_key",
        "id": "api-key-1",
        "label": "Public test integration"
      },
      "product": {
        "id": "22222222-2222-4222-8222-222222222222",
        "name": "Black T-Shirt - Medium",
        "sku": "TSHIRT-BLACK-M"
      },
      "location": {
        "id": "33333333-3333-4333-8333-333333333333",
        "name": "Main Warehouse",
        "code": "MAIN-WH",
        "type": "warehouse"
      },
      "lines": [
        {
          "id": "bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb",
          "organizationId": "11111111-1111-4111-8111-111111111111",
          "environment": "test",
          "outboundId": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
          "productId": "22222222-2222-4222-8222-222222222222",
          "locationId": "33333333-3333-4333-8333-333333333333",
          "requestedQuantity": 4,
          "allocatedQuantity": 2,
          "pickedQuantity": 1,
          "packedQuantity": 0,
          "fulfilledQuantity": 0,
          "pendingAllocationQuantity": 2,
          "pendingPickQuantity": 1,
          "pendingPackQuantity": 1,
          "pendingFulfillmentQuantity": 2,
          "product": {
            "id": "22222222-2222-4222-8222-222222222222",
            "name": "Black T-Shirt - Medium",
            "sku": "TSHIRT-BLACK-M"
          },
          "location": {
            "id": "33333333-3333-4333-8333-333333333333",
            "name": "Main Warehouse",
            "code": "MAIN-WH",
            "type": "warehouse"
          },
          "serials": [
            {
              "id": "15151515-1515-4515-8515-151515151515",
              "serialId": "14141414-1414-4414-8414-141414141414",
              "pickedAt": "2026-07-01T12:05:00.000Z",
              "packedAt": null,
              "shippedAt": null,
              "serial": {
                "id": "14141414-1414-4414-8414-141414141414",
                "serialNumber": "SN-2026-0001",
                "status": "picked",
                "productId": "22222222-2222-4222-8222-222222222222",
                "locationId": "33333333-3333-4333-8333-333333333333",
                "lotId": "12121212-1212-4212-8212-121212121212"
              }
            }
          ],
          "createdAt": "2026-06-29T10:00:00.000Z",
          "updatedAt": "2026-06-29T10:05:00.000Z"
        }
      ],
      "createdAt": "2026-06-29T10:00:00.000Z",
      "updatedAt": "2026-06-29T10:05:00.000Z"
    }
  ],
  "nextCursor": null
}

403

Section titled “403”

The organization has exhausted its monthly public API request quota.

Media typeapplication/json
Example
{
  "error": {
    "code": "PLAN_LIMIT_EXCEEDED",
    "message": "Plan limit exceeded for api_requests",
    "requestId": "req_123",
    "details": {
      "entitlementKey": "api_requests",
      "scope": "environment",
      "environment": "live",
      "configured": true,
      "limit": "50000",
      "used": "50000",
      "requested": "1",
      "currentPlan": {
        "code": "free",
        "version": 1
      },
      "requiredPlan": {
        "code": "starter",
        "version": 1,
        "requiresOverride": false
      }
    }
  }
}