Skip to main content

List orders​

Retrieve a paginated list of orders for the authenticated store. Requires both customerEmail and orderNameOrNumber to filter orders. Optionally filter by sourceOrderId.

Query Parameters
  • customerEmail string

    Required with orderNameOrNumber. The email address of the customer to filter orders by.

  • orderNameOrNumber string

    Required with customerEmail. The source order name or number to filter orders by.

  • sourceOrderId string

    The order identifier from the source platform to filter by.

  • after string

    Cursor for forward pagination. Pass the endCursor from a previous response to fetch the next page.

  • before string

    Cursor for backward pagination. Pass the startCursor from a previous response to fetch the previous page.

  • first number

    Number of items to return when paginating forward (used with after). Defaults to 50.

  • last number

    Number of items to return when paginating backward (used with before).

  • orderBy string

    Possible values: [asc, desc]

    Sort order for results. Defaults to descending.

Responses

OK

Schema
  • orders object[] required
  • Array [
  • orderId number

    The ID of the order in Corso, used to interact with Corso systems.

  • currencyConversionRate number

    The conversion rate between store and customer

  • storeId number required

    The ID of the store in Corso systems. Some merchants may have multiple stores under a single API client_id, so this value should always be specified. Please contact Corso if you do not have this value for your integration.

  • isShippingProtected boolean

    Whether or not the order is protected with Corso Green Shipping Protection.

  • sourceOrderId string required

    The order identifier from the source platform. Is unique across the store, and typically across the entire platform used by the merchant.

  • orderNumber string

    The order number from the source platform, if none is provided. sourceOrderId will be used

  • orderName string

    Customer-facing identifier for the order the source platform. Often composed of the store-unique order number plus some modifying prefixes and suffixes.

  • customer object
  • anyOf
  • email string required

    Customer email address.

  • phone string

    Customer phone number in E-164 format.

  • sourceCustomerId string required

    The customer ID from the source system.

  • firstName string required

    First name.

  • lastName string required

    Last name.

  • lineItems object[] required

    Possible values: >= 1

    Array of objects representing the line items on the order.

  • Array [
  • orderId number required

    The ID of the order the line item belongs to in Corso systems.

  • lineItemId number required

    The ID of the line item in Corso systems.

  • sourceCanceledOn date-time

    Date/time when the order was canceled in Corso systems.

  • createdOn date-time

    Date/time when the line item was created in Corso systems.

  • updatedOn date-time

    Date/time when the line item was last updated in Corso systems.

  • sourceLineItemId string required

    The line item ID (from the source system).

  • productId string

    The product ID for the line item (from the source system).

  • variantId string

    The variant ID for the line item (from the source system). For the line item that represents the Corso Green Shipping Product (if purchased on the order), this should match the corresponding variant ID stored by Corso in our system, so that we can identify the order as protected.

  • name string required

    The line item name, typically the value shown to the customer representing the product/variant combination purchased.

  • quantity number required

    The quantity purchased for the line item.

  • sku string required

    The SKU of product/variant of the line item.

  • tax currency required

    Any tax applied to the line item.

  • vendor string

    The vendor of the line item

  • price currency required

    The price of the line item

  • imgUrl string

    URL of the product image, if available.

  • options object[]

    Product variant options from the platform.

  • Array [
  • name string required

    The option name (e.g., "Size", "Color").

  • value string required

    The option value (e.g., "Large", "Blue").

  • ]
  • ]
  • createdOn date-time

    Date/time when the order was created in Corso systems.

  • updatedOn date-time

    Date/time when the order was most recently updated in Corso systems.

  • sourceCanceledOn date-time

    Date/time when the order was canceled in the source system.

  • sourceCreatedOn date-time

    Date/time when the order was created in the source system.

  • sourceUpdatedOn date-time

    Date/time when the order was most recently updated in the source system

  • shippingMoney currency required

    The cost of shipping the order as charged to the customer.

  • subtotalMoney currency required

    The subtotal of the order in the merchant's currency; typically equal to the cost of all product line items in the order totalled together.

  • taxMoney currency required

    The amount of all tax applied to the order as included in the order total.

  • totalMoney currency required

    The total amount charged to the customer. Must be equal to the sum of shippingMoney, subtotalMoney, and taxMoney, or the request will fail.

  • billingAddress object required
  • name string

    The name line on an address. Often the name of the customer, or the business name something is shipped to.

  • firstName string

    The first name for the address.

  • lastName string

    The last name for the address.

  • line1 string required

    Address line 1, generally the street number and name.

  • line2 string

    Address line 2. Not mandatory, but often used for an apartment or suite number.

  • city string required

    City of the Address

  • stateOrProvinceCode string required

    State or province code, typically 2 characters.

  • postalCode string required

    Postal Code

  • countryCode string required

    ISO 3166-1 alpha-2 country code

  • latitude number

    Latitude coordinate of the address.

  • longitude number

    Longitude coordinate of the address.

  • shippingAddress object required
  • name string

    The name line on an address. Often the name of the customer, or the business name something is shipped to.

  • firstName string

    The first name for the address.

  • lastName string

    The last name for the address.

  • line1 string required

    Address line 1, generally the street number and name.

  • line2 string

    Address line 2. Not mandatory, but often used for an apartment or suite number.

  • city string required

    City of the Address

  • stateOrProvinceCode string required

    State or province code, typically 2 characters.

  • postalCode string required

    Postal Code

  • countryCode string required

    ISO 3166-1 alpha-2 country code

  • latitude number

    Latitude coordinate of the address.

  • longitude number

    Longitude coordinate of the address.

  • grams number

    The weight of the order, in grams.

  • carbonGrams number

    The amount of carbon offset for the order, in grams. Only available after fulfillment (when the shipping origin can be determined).

  • carbonCalculationMethod string

    How the carbon was calculated, depending on the accuracy of the input data such as weight and distance.

  • shippingTitle string

    The name of the shipping plan used.

  • canceledReason string

    The reason the order was canceled.

  • notes string

    Any notes on the order

  • channel string

    The name of the channel the order was created on.

  • channelId string

    The ID of the sales channel the order was created from.

  • customerCurrencyCode string

    The 3 letter currency code used by the customer in ISO 4217 format

  • ]
  • pageInfo object required

    Information about the pagination of a list.

  • hasNextPage boolean required

    Whether there are more items after the last returned item.

  • hasPreviousPage boolean required

    Whether there are more items before the first returned item.

  • startCursor string nullable required

    An opaque cursor pointing to the first item in the current page. Pass as before to paginate backwards.

  • endCursor string nullable required

    An opaque cursor pointing to the last item in the current page. Pass as after to paginate forwards.

    • Loading...