List orders

GET

/api/v1/commerce/orders

curl --request GET \
  --url https://digize.com/api/v1/commerce/orders \
  --header 'x-api-key: <x-api-key>'

• Digize

Up to 1,000 orders, the newest first, and how many match. Narrow it to one customer with contactId, to payment statuses with status, or find orders with search: an order number such as 1042 or #1042, or words from the customer’s name or email.

Needs the commerce:read permission.

Authorizations

• apiKey
• bearer

Parameters

Query Parameters

contactId

string

>= 1 characters <= 64 characters

search

string

<= 200 characters

status

Array<string>

Allowed values: paid partially_refunded refunded disputed

Responses

200

Done

Media typeapplication/json

object

rows

required

Array<object>

object

id

required

string

number

required

number

customer

required

object

id

required

string

name

required

string

email

required

string

status

required

string

Allowed values: paid partially_refunded refunded disputed

fulfillment

required

string

Allowed values: unfulfilled fulfilled not_required

channel

required

string

Allowed values: storefront subscription checkout_link

currency

required

string

lines

required

Array<object>

object

id

required

string

productId

required

string

variantId

required

string

name

required

string

variant

required

string

sku

required

string

quantity

required

number

price

required

number

fulfilled

required

number

refunded

required

number

subtotal

required

number

discount

required

number

discountCode

required

string | null

shipping

required

number

shippingName

required

string | null

tax

required

number

taxName

required

string

taxIncluded

required

boolean

total

required

number

giftCard

required

What a gift card paid of the total.

number

refunded

required

number

checkoutId

required

string

paymentId

required

The Stripe PaymentIntent, when Stripe was paid.

string

placedAt

required

string format: date-time

fulfilledAt

required

Any of:

string

string format: date-time

null

null

refundedAt

required

Any of:

string

string format: date-time

null

null

cancelledAt

required

Any of:

string

string format: date-time

null

null

phone

required

string

shippingAddress

required

Any of:

object

object

name

required

string

line1

required

string

line2

required

string | null

city

required

string

zip

required

string

country

required

string

null

null

tracking

required

Any of:

object

object

carrier

required

string

number

required

string | null

url

required

string | null

null

null

note

required

string

tags

required

Array<string>

attention

required

Something the team needs to look at.

string | null

receipt

required

Unreceipted: no sending domain yet, so only Stripe’s receipt went.

string

Allowed values: queued unreceipted not_sent

total

required

number

Example

{
  "rows": [
    {
      "status": "paid",
      "fulfillment": "unfulfilled",
      "channel": "storefront",
      "receipt": "queued"
    }
  ]
}

400

What was sent isn’t valid (invalid).

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: invalid unauthorized forbidden not_found conflict too_large rate_limited unavailable internal

message

required

string

details

object

key

additional properties

any

Example

{
  "error": {
    "code": "invalid"
  }
}

401

No key, or one that’s unknown, off or expired.

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: invalid unauthorized forbidden not_found conflict too_large rate_limited unavailable internal

message

required

string

details

object

key

additional properties

any

Example

{
  "error": {
    "code": "invalid"
  }
}

403

The key doesn’t have the permission this needs.

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: invalid unauthorized forbidden not_found conflict too_large rate_limited unavailable internal

message

required

string

details

object

key

additional properties

any

Example

{
  "error": {
    "code": "invalid"
  }
}

404

Nothing has that id (not_found).

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: invalid unauthorized forbidden not_found conflict too_large rate_limited unavailable internal

message

required

string

details

object

key

additional properties

any

Example

{
  "error": {
    "code": "invalid"
  }
}

429

Over the rate limit; see retry-after.

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: invalid unauthorized forbidden not_found conflict too_large rate_limited unavailable internal

message

required

string

details

object

key

additional properties

any

Example

{
  "error": {
    "code": "invalid"
  }
}