BigCommerce Docs

curl https://api-b2b.bigcommerce.com/api/v3/io/orders/123 \
     -H "X-Auth-Token: <apiKey>"

{
  "code": 1,
  "data": [
    {
      "id": 12345,
      "bcOrderId": 123,
      "totalIncTax": 2210.47,
      "poNumber": "04152025-0002",
      "status": "Awaiting Payment",
      "customStatus": "Invoice Sent",
      "cartId": "095a15a6-8a27-4c20-b357-36b82e9d5929",
      "items": 50,
      "usdIncTax": 2210.47,
      "companyId": 12345,
      "currencyCode": "USD",
      "money": [
        {
          "currencyLocation": "left",
          "currencyToken": "$",
          "decimalToken": ".",
          "decimalPlaces": 2,
          "thousandsToken": ","
        }
      ],
      "statusCode": 7,
      "isArchived": false,
      "channelId": 1,
      "channelName": "B2B Store",
      "isInvoiceOrder": 0,
      "invoiceId": 12345,
      "invoiceNumber": 12345678,
      "invoiceStatus": 2,
      "extraInt1": 12345,
      "extraInt2": 12345,
      "extraInt3": 12345,
      "extraInt4": 12345,
      "extraInt5": 12345,
      "extraStr1": "Great Buys Incorporated",
      "extraStr2": "Great Buys Incorporated",
      "extraStr3": "Great Buys Incorporated",
      "extraStr4": "Great Buys Incorporated",
      "extraStr5": "Great Buys Incorporated",
      "extraText": "Great Buys Incorporated",
      "extraInfo": [
        {
          "billingAddressId": 12345,
          "shippingAddressId": 12345
        }
      ],
      "extraFields": [
        {
          "fieldName": "Fintech ID",
          "fieldValue": "1234567890"
        }
      ],
      "createdAt": 1744735719,
      "updatedAt": 1744735734
    }
  ]
}

Retrieves limited information for a specific order based on the bcOrderId provided. The response includes the same fields as the Get All Orders endpoint, including B2B extra fields and PO numbers.

The bcOrderId parameter must include a valid BigCommerce Order ID (not the B2B Edition order ID returned in certain Orders endpoints) for the request to be successful.

Retrieves limited information for a specific order based on the `bcOrderId` provided. The response includes the same fields as the Get All Orders endpoint, including B2B extra fields and PO numbers. The `bcOrderId` parameter must include a valid BigCommerce Order ID (**not** the B2B Edition order ID returned in certain Orders endpoints) for the request to be successful.

Authentication

X-Auth-Tokenstring

Authentication header

Header	Argument	Description
`X-Auth-Token`	`access_token`	For more about API accounts that generate `access_token`s, see our Guide to API Accounts.

### Authentication header | Header | Argument | Description | |:-------|:---------|:------------| | `X-Auth-Token` | `access_token` | For more about API accounts that generate `access_token`s, see our [Guide to API Accounts](/developer/docs/overview/api-fundamentals/api-accounts). | ### Further reading For example requests and more information about authenticating BigCommerce APIs, see [Authentication and Example Requests](/developer/docs/overview/api-fundamentals/api-accounts#x-auth-token-header-example-requests). For more about BigCommerce OAuth scopes, see our [Guide to API Accounts](/developer/docs/overview/api-fundamentals/api-accounts#oauth-scopes). For a list of API status codes, see [API Status Codes](/developer/api-reference/rest/overview#rest-http-status-codes).

X-Store-Hashstring

Authentication header

Header	Argument	Description
`X-Store-Hash`	`store_hash`	The unique store hash associated with a BigCommerce store that has B2B Edition enabled.

### Authentication header | Header | Argument | Description | |:-------|:---------|:------------| | `X-Store-Hash` | `store_hash` | The unique store hash associated with a BigCommerce store that has B2B Edition enabled. |

Path parameters

bcOrderIdintegerRequired

The BigCommerce order ID.

Response

codeintegerDefaults to 200

HTTP Response Code

datalist of objects

Errors

404

Not Found Error