Orders

8 reads and 10 writes, on train 2026-11. Scopes: orders:read · orders:write.

Operation	Method	Scope	Path
List customers	`GET`	`orders:read`	`/api/v1/sales/customers`
Get customer	`GET`	`orders:read`	`/api/v1/sales/customers/{customer_id}`
List invoices	`GET`	`orders:read`	`/api/v1/sales/invoices`
Get an invoice	`GET`	`orders:read`	`/api/v1/sales/invoices/{invoice_id}`
List sales orders	`GET`	`orders:read`	`/api/v1/sales/orders`
Create sales order	`POST`	`orders:write`	`/api/v1/sales/orders`
Get sales order	`GET`	`orders:read`	`/api/v1/sales/orders/{order_id}`
Update sales order	`PATCH`	`orders:write`	`/api/v1/sales/orders/{order_id}`
Allocate sales order	`POST`	`orders:write`	`/api/v1/sales/orders/{order_id}/allocate`
Cancel sales order	`POST`	`orders:write`	`/api/v1/sales/orders/{order_id}/cancel`
Confirm sales order	`POST`	`orders:write`	`/api/v1/sales/orders/{order_id}/confirm`
Invoice a sales order	`POST`	`orders:write`	`/api/v1/sales/orders/{order_id}/invoice`
Send shipping notice	`POST`	`orders:write`	`/api/v1/sales/orders/{order_id}/shipping-notice`
Every order file that has arrived	`GET`	`orders:read`	`/api/v1/sales/orders/documents`
File one order a retailer sent	`POST`	`orders:write`	`/api/v1/sales/orders/documents`
One order file, its reading and the source to check it against	`GET`	`orders:read`	`/api/v1/sales/orders/documents/{document_id}`
Take a refused order file as the new draft	`POST`	`orders:write`	`/api/v1/sales/orders/documents/{document_id}/take`
Import sales orders	`POST`	`orders:write`	`/api/v1/sales/orders/import`

List customers

GET /api/v1/sales/customers

Scopes: orders:read

Everyone the record knows, from a connected channel or from an order somebody typed. Deliberately thin: a display name, the email's domain, a country and a coarsened region, and never a street address, a phone number or an email in the clear. Do not call this to build a marketing list, and do not call it to find one person you already have the id for: GET /sales/customers/{customer_id} serves that one with their orders and returns.

Optional	In	What it is
`trading_partner_id`	query	Only this account's own customer record.
`search`	query	A term containing an `@` is read as an email address and matched against its pseudonym, exactly.
`offset`	query	How many customers to skip. The list is ordered by the most recent order, newest first.
`limit`	query	How many customers to return, at most 100.
`Tightly-Version`	header	The date train to answer on.

bash

curl "https://api.app.tightly.io/api/v1/sales/customers" \
  -H "Authorization: Bearer $TIGHTLY_API_KEY"

What it answers

json

{
  "data": {
    "filtered_max_size": 2,
    "offset": 0,
    "rows": [
      {
        "account": {
          "name": "Coastline DS",
          "trading_partner_id": "tp-coastline"
        },
        "country_code": "US",
        "customer_id": "cus_01JQ8ZK7C4N2R9V6T3M0X5A1BD",
        "display_name": "Coastline DS",
        "display_name_words": "Coastline DS",
        "email_domain": "coastline.example",
        "first_order_at": "Jul 14, 2026",
        "kind": "account",
        "last_order_at": "Sep 5, 2026",
        "orders_count": 3,
        "redacted_at": null,
        "region": "CA",
        "source_system": "tightly"
      },
      {
        "account": null,
        "country_code": "US",
        "customer_id": "cus_7QK2V0X9MB3D5T8HAJ1NCR6FZ4",
        "display_name": null,
        "display_name_words": "Not on file",
        "email_domain": null,
        "first_order_at": "Sep 2, 2026",
        "kind": "consumer",
        "last_order_at": "Sep 2, 2026",
        "orders_count": 1,
        "redacted_at": "Sep 4, 2026",
        "region": "NY",
        "source_system": "shopify"
      }
    ],
    "size": 2
    …
  }
}

What it refuses

400 offset or limit is outside the range the list offers.
401 key_invalid: "The API key is not valid." No usable key: malformed, unknown, revoked, expired or stopped.
403 scope_missing: "This key cannot read Orders." The key does not hold Orders (scope_missing), or is issued to one account and named another (account_mismatch).
429

Optional	In	What it is
`state`	query	received is not read yet; applied made a draft; refused created nothing and says why.
`lane`	query	The door the paper came through: an upload, a mail attachment, a link in a mail, the buyer's own seat, or the EDI network.
`trading_partner_id`	query	One account's papers only.
`since`	query	Papers received on or after this day.
`limit`	query	Rows per page.
`offset`	query	Rows to skip, for the next page.
`Tightly-Version`	header	The date train to answer on.

Orders ​

List customers ​

Get customer ​

List invoices ​

Get an invoice ​

List sales orders ​

Create sales order ​

Get sales order ​

Update sales order ​

Allocate sales order ​

Cancel sales order ​

Confirm sales order ​

Invoice a sales order ​

Send shipping notice ​

Every order file that has arrived ​

File one order a retailer sent ​

One order file, its reading and the source to check it against ​

Take a refused order file as the new draft ​

Import sales orders ​

Orders

List customers

Get customer

List invoices

Get an invoice

List sales orders

Create sales order

Get sales order

Update sales order

Allocate sales order

Cancel sales order

Confirm sales order

Invoice a sales order

Send shipping notice

Every order file that has arrived

File one order a retailer sent

One order file, its reading and the source to check it against

Take a refused order file as the new draft

Import sales orders