---
title: "Get external order by external source and ID"
method: GET
path: "/open-api/v1.0/external-orders/{externalSource}/{externalOrderId}"
tags: ["External Orders"]
---

# Get external order by external source and ID

`GET /open-api/v1.0/external-orders/{externalSource}/{externalOrderId}`

*Rate limit: 100 requests / 10 seconds per shop. See [Rate limiting](/guides/rate-limiting).*

Returns details of a specific external order using the marketplace's source and order ID. This is the preferred method for external marketplace integrations.

## Path parameters

- `externalSource` string, required
- `externalOrderId` string, required

## Response `200`

OK

- ComFourthwallOpenapiModelExternalOrderV1
  - `orderId` string, uuid, required
  - `externalOrderId` string, required
  - `externalSource` string, required
  - `friendlyId` string, required
  - `status` string, required
  - `items` ComFourthwallOpenapiModelExternalOrderItemV1[], required
    - `offerId` string, uuid, required
    - `variantId` string, uuid, required
    - `quantity` integer, required
    - `externalLineItemId` string
    - `unitCost` Money, required
      - `value` number, required
      - `currency` string, required
    - `totalCost` Money, required
      - `value` number, required
      - `currency` string, required
    - `itemFulfillmentFee` Money, required
      - `value` number, required
      - `currency` string, required
    - `itemShippingCost` Money, required
      - `value` number, required
      - `currency` string, required
    - `itemTotalCreatorCost` Money, required
      - `value` number, required
      - `currency` string, required
  - `shippingAddress` ComFourthwallOpenapiModelExternalOrderAddressV1, required
    - `firstName` string, required
    - `lastName` string, required
    - `address1` string, required
    - `address2` string
    - `city` string, required
    - `state` string
    - `zip` string, required
    - `country` string, required
    - `phone` string
  - `costs` ComFourthwallOpenapiModelExternalOrderCostsV1, required
    - `fulfillmentFee` Money, required
      - `value` number, required
      - `currency` string, required
    - `manufacturingCost` Money, required
      - `value` number, required
      - `currency` string, required
    - `shippingCost` Money, required
      - `value` number, required
      - `currency` string, required
    - `totalCreatorCost` Money, required
      - `value` number, required
      - `currency` string, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `404` — Possible errors: `EXTERNAL_ORDER_NOT_FOUND`, `EXTERNAL_ORDER_NOT_FOUND_BY_EXTERNAL_ID`, `OFFER_VARIANT_NOT_FOUND_ERROR`, `ORDER_ID_NOT_FOUND`
- `429` — Rate limited: 100 requests / 10 seconds per shop.

---

[API](https://skmtc.net/fourthwall/apis/fourthwall-apis-2.md) · [All operations](https://skmtc.net/fourthwall/apis/fourthwall-apis-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fourthwall/fourthwall-apis-2/revisions/ef273312f051/schema)