List orders

curl --request GET \
  --url https://api.cubbo.com/v1/orders \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.cubbo.com/v1/orders', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cubbo.com/v1/orders",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cubbo.com/v1/orders"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.cubbo.com/v1/orders")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "orders": [
    {
      "id": 987654,
      "store_id": 1234,
      "order_number": "ORD-0001",
      "status": "shipped",
      "channel_created_at": "2026-01-10T14:02:11.000Z",
      "order_date": "2026-01-10T14:02:11.000Z",
      "shipping_date": "2026-01-11T18:30:00.000Z",
      "pending_at": "2026-01-10T14:05:00.000Z",
      "shipping_email": "buyer@example.com",
      "shipping_status": "shipment_in_transit",
      "is_paid": true,
      "channel_order_id": "5566778899",
      "channel_name": "shopify",
      "is_cod": false,
      "cod_amount": null,
      "has_carrier_insurance": false,
      "requires_document_return": false,
      "requires_pickup_on_delivery": false,
      "currency": "MXN",
      "total_price": "899.00",
      "shipping": {
        "first_name": "Ana",
        "last_name": "Example",
        "company": null,
        "phone": "+525500000000",
        "address_1": "Av. Ejemplo 123",
        "address_2": null,
        "email": "buyer@example.com",
        "zip_code": "01000",
        "country": "MX",
        "state": "CDMX",
        "city": "Ciudad de Mexico",
        "number": "123",
        "interior_number": null,
        "neighborhood": "Centro",
        "references": "Blue door",
        "city_code": null
      },
      "billing": {
        "first_name": "Ana",
        "last_name": "Example",
        "company": null,
        "phone": "+525500000000",
        "tax_id": null,
        "tax_regime": null,
        "state_registration": null,
        "address_1": "Av. Ejemplo 123",
        "address_2": null,
        "number": "123",
        "interior_number": null,
        "neighborhood": "Centro",
        "email": "buyer@example.com",
        "zip_code": "01000",
        "country": "MX",
        "state": "CDMX",
        "city": "Ciudad de Mexico"
      },
      "delivery_tracking": [
        {
          "shipping_number": "TRK000000001",
          "tracking_url": "https://carrier.example.com/track/TRK000000001",
          "cubbo_tracking_url": "https://tracking.example.com/orders/abc123",
          "service_id": "express",
          "shipping_status": "shipment_in_transit",
          "package_index": 1,
          "total_packages": 1
        }
      ],
      "return_shipping_labels": [],
      "estimated_time_arrival": "2026-01-13T00:00:00.000Z",
      "delivered_at": null,
      "updated_at": "2026-01-11T18:31:00.000Z",
      "is_click_and_collect": false,
      "click_and_collect_metadata": null,
      "latest_estimated_time_arrival_range": {
        "range_begin": "2026-01-13T06:00:00.000Z",
        "range_end": "2026-01-14T05:59:59.000Z"
      },
      "channel_shipping_line_code": "standard",
      "warehouse_timezone": "America/Mexico_City",
      "is_first_time_buyer": true,
      "is_subscription_renewal": false,
      "is_multi_package": false,
      "shipping_method": {
        "id": 42,
        "carrier_name": "DHL",
        "shipping_name": "DHL Express",
        "is_cod": false
      },
      "order_lines": [
        {
          "id": 5551,
          "name": "Red T-shirt M",
          "sku": "SKU-RED-M",
          "quantity": 2,
          "generated": false,
          "price_per_item": "449.5",
          "product": {
            "id": 777,
            "name": "Red T-shirt M",
            "billing_name": "T-shirt",
            "description": null,
            "has_imei": false,
            "is_fragile": false,
            "is_kit": false,
            "bar_code": "7500000000001",
            "is_dropshipping": false,
            "is_scannable": true,
            "price": "449.5",
            "weight": 0.3,
            "product_codes": [
              {
                "id": 9001,
                "sku": "SKU-RED-M"
              }
            ]
          },
          "stock_units": [
            {
              "id": 31001
            },
            {
              "id": 31002
            }
          ]
        }
      ],
      "invoices": [],
      "store": {
        "id": 1234,
        "name": "Example Store"
      },
      "channel_integration": {
        "id": 55,
        "channel_type_name": "shopify"
      },
      "return": null,
      "created_by_return": null
    }
  ],
  "meta": {
    "current_page": 1,
    "next_page": 2,
    "prev_page": null,
    "total_pages": 7,
    "first_page": true,
    "last_page": false,
    "per_page": 10,
    "total_count": 63
  }
}

Orders

List orders

Returns a paginated list of a store’s orders with their order lines, invoices (NF-e, Brazil only), shipping method, delivery tracking and, optionally, the order’s event history. Use it to sync order status and tracking into your own systems. Filter by status, order type, order number, buyer email or date ranges.

Results are paginated: page (default 1) and per_page (default 10, capped at 100). The meta object tells you whether more pages exist.
Filtering status by processing also returns orders in picking and packing, since all three mean “being prepared in the warehouse”.
order_number accepts a single string or an array of strings (order_number[]=ORD-0001&order_number[]=ORD-0002). When you filter by order number, stock units of products that use unit codes also expose their unit_code while the order is packing or shipped.
sort_by accepts any order field (for example created_at, channel_created_at, shipping_date, updated_at), or shipping_methods.<field> / stores.<field>; an unknown field returns 422 Field not found. sort is desc unless you pass asc. Without sort_by the order of results is not guaranteed.
include_event_history=true adds order_histories to every order (status changes, tracking updates and incidents).
is_b2b is only present for stores that handle both B2B and D2C orders.
Each order in this list carries the subset of Order fields listed in the response schema description; the full Order object is returned by the create and update endpoints.

GET

orders

List orders

curl --request GET \
  --url https://api.cubbo.com/v1/orders \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.cubbo.com/v1/orders', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cubbo.com/v1/orders",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cubbo.com/v1/orders"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.cubbo.com/v1/orders")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "orders": [
    {
      "id": 987654,
      "store_id": 1234,
      "order_number": "ORD-0001",
      "status": "shipped",
      "channel_created_at": "2026-01-10T14:02:11.000Z",
      "order_date": "2026-01-10T14:02:11.000Z",
      "shipping_date": "2026-01-11T18:30:00.000Z",
      "pending_at": "2026-01-10T14:05:00.000Z",
      "shipping_email": "buyer@example.com",
      "shipping_status": "shipment_in_transit",
      "is_paid": true,
      "channel_order_id": "5566778899",
      "channel_name": "shopify",
      "is_cod": false,
      "cod_amount": null,
      "has_carrier_insurance": false,
      "requires_document_return": false,
      "requires_pickup_on_delivery": false,
      "currency": "MXN",
      "total_price": "899.00",
      "shipping": {
        "first_name": "Ana",
        "last_name": "Example",
        "company": null,
        "phone": "+525500000000",
        "address_1": "Av. Ejemplo 123",
        "address_2": null,
        "email": "buyer@example.com",
        "zip_code": "01000",
        "country": "MX",
        "state": "CDMX",
        "city": "Ciudad de Mexico",
        "number": "123",
        "interior_number": null,
        "neighborhood": "Centro",
        "references": "Blue door",
        "city_code": null
      },
      "billing": {
        "first_name": "Ana",
        "last_name": "Example",
        "company": null,
        "phone": "+525500000000",
        "tax_id": null,
        "tax_regime": null,
        "state_registration": null,
        "address_1": "Av. Ejemplo 123",
        "address_2": null,
        "number": "123",
        "interior_number": null,
        "neighborhood": "Centro",
        "email": "buyer@example.com",
        "zip_code": "01000",
        "country": "MX",
        "state": "CDMX",
        "city": "Ciudad de Mexico"
      },
      "delivery_tracking": [
        {
          "shipping_number": "TRK000000001",
          "tracking_url": "https://carrier.example.com/track/TRK000000001",
          "cubbo_tracking_url": "https://tracking.example.com/orders/abc123",
          "service_id": "express",
          "shipping_status": "shipment_in_transit",
          "package_index": 1,
          "total_packages": 1
        }
      ],
      "return_shipping_labels": [],
      "estimated_time_arrival": "2026-01-13T00:00:00.000Z",
      "delivered_at": null,
      "updated_at": "2026-01-11T18:31:00.000Z",
      "is_click_and_collect": false,
      "click_and_collect_metadata": null,
      "latest_estimated_time_arrival_range": {
        "range_begin": "2026-01-13T06:00:00.000Z",
        "range_end": "2026-01-14T05:59:59.000Z"
      },
      "channel_shipping_line_code": "standard",
      "warehouse_timezone": "America/Mexico_City",
      "is_first_time_buyer": true,
      "is_subscription_renewal": false,
      "is_multi_package": false,
      "shipping_method": {
        "id": 42,
        "carrier_name": "DHL",
        "shipping_name": "DHL Express",
        "is_cod": false
      },
      "order_lines": [
        {
          "id": 5551,
          "name": "Red T-shirt M",
          "sku": "SKU-RED-M",
          "quantity": 2,
          "generated": false,
          "price_per_item": "449.5",
          "product": {
            "id": 777,
            "name": "Red T-shirt M",
            "billing_name": "T-shirt",
            "description": null,
            "has_imei": false,
            "is_fragile": false,
            "is_kit": false,
            "bar_code": "7500000000001",
            "is_dropshipping": false,
            "is_scannable": true,
            "price": "449.5",
            "weight": 0.3,
            "product_codes": [
              {
                "id": 9001,
                "sku": "SKU-RED-M"
              }
            ]
          },
          "stock_units": [
            {
              "id": 31001
            },
            {
              "id": 31002
            }
          ]
        }
      ],
      "invoices": [],
      "store": {
        "id": 1234,
        "name": "Example Store"
      },
      "channel_integration": {
        "id": 55,
        "channel_type_name": "shopify"
      },
      "return": null,
      "created_by_return": null
    }
  ],
  "meta": {
    "current_page": 1,
    "next_page": 2,
    "prev_page": null,
    "total_pages": 7,
    "first_page": true,
    "last_page": false,
    "per_page": 10,
    "total_count": 63
  }
}

Authorizations

Authorization

string

header

required

Token returned by POST /auth/token, sent as Authorization: Bearer <token>.

Query Parameters

store_id

integer

required

ID of the store whose orders you want to list.

status

enum<string>[]

Only return orders in these statuses. processing implicitly includes picking and packing.

Fulfillment status of an order. processing, picking and packing all mean the order is being prepared in the warehouse. holded means the order is on hold. packed is unused.

Available options:

initial,

unpaid,

empty,

pending,

error,

cancelation_window,

entirely_dropshipping,

backorder,

processing,

picking,

packing,

packed,

shipped,

canceled,

holded,

interrupted,

returned,

return_arrived,

returning,

reentered,

awaiting_fulfillment_request,

awaiting_dropoff,

arrived_at_warehouse

order_type

enum<string>[]

Only return orders of these types.

Kind of order. SALE is a regular sale; DONATION ships goods without a sale; REMOVE_STOCK, REMOVE_DAMAGED_STOCK, REMOVE_EXPIRED_STOCK and REMOVE_LOST_STOCK withdraw stock from the warehouse; STOCK_TRANSFER_OUT moves stock to another store; C2C is a consumer-to-consumer shipment created by Cubbo and cannot be created through the API.

Available options:

SALE,

DONATION,

REMOVE_STOCK,

REMOVE_DAMAGED_STOCK,

REMOVE_EXPIRED_STOCK,

REMOVE_LOST_STOCK,

STOCK_TRANSFER_OUT,

C2C

order_number

Exact order number, or an array of order numbers. Enables unit_code exposure on stock units.

shipping_email

string

Case-insensitive partial match on the buyer's shipping email.

shipping_date[from]

string<date-time>

Lower bound of the shipping date range. Required when shipping_date[to] is sent.

shipping_date[to]

string<date-time>

Upper bound of the shipping date range. Required when shipping_date[from] is sent.

channel_created_at[from]

string<date-time>

Lower bound of the range on the date the order was created in the sales channel. Required when channel_created_at[to] is sent.

channel_created_at[to]

string<date-time>

Upper bound of the range on the date the order was created in the sales channel. Required when channel_created_at[from] is sent.

sort_by

string

Field to sort by. Any order field, or shipping_methods.<field> / stores.<field>. Unknown fields return 422.

sort

enum<string>

default:desc

Sort direction. Any value other than asc sorts descending.

Available options:

asc,

desc

page

integer

default:1

Page number, starting at 1.

per_page

integer

default:10

Orders per page. Values above 100 are capped at 100.

Required range: x <= 100

include_event_history

boolean

default:false

When true, each order includes order_histories with its status and tracking events.

Response

Orders matching the filters, with pagination metadata.

orders

object[]

required

Orders on this page. Each item is an Order limited to: id, store_id, order_number, status, channel_created_at, order_date, shipping_date, pending_at, shipping_email, shipping_status, is_paid, channel_order_id, channel_name, is_cod, cod_amount, has_carrier_insurance, requires_document_return, requires_pickup_on_delivery, currency, total_price, shipping, billing, delivery_tracking, return_shipping_labels, estimated_time_arrival, delivered_at, updated_at, is_click_and_collect, click_and_collect_metadata, latest_estimated_time_arrival_range, channel_shipping_line_code, warehouse_timezone, is_first_time_buyer, is_subscription_renewal, is_multi_package, is_b2b (mixed B2B/D2C stores only), plus the associations shipping_method (id, carrier_name, shipping_name, is_cod), order_lines (id, name, sku, quantity, generated, price_per_item, product, stock_units), invoices, store (id, name), channel_integration (id, channel_type_name), return, created_by_return and, when include_event_history=true, order_histories (new_status, incident_description, timestamp, origin).

Show child attributes

Authentication

Orders

Click and collect

Inventory

Lots

Shipping labels

Replenishments

Reports

Returns

Shipping methods

Stores

Webhooks

List orders

Authorizations

Query Parameters

Response