External Orders

Validate external order

Changed on

Rate limit: 100 requests / 10 seconds per shop. See Rate limiting.

Validate order details and preview costs before creating. Use this endpoint to verify offer availability, calculate estimated costs, and check shipping feasibility before creating an external order.

post/open-api/v1.0/external-orders/validate

Request

  • Base URL
    https://api.fourthwall.com
  • URL
    https://api.fourthwall.com/open-api/v1.0/external-orders/validate
  • Auth
    • OAuth 2
      Implicit: https://auth.staging.fourthwall.com/auth/realms/Fourthwall/protocol/openid-connect/auth
      Scopes: order_write
    • or HTTP basic

Request body

Example request

{
  "items": [
    {
      "variantId": "c2b6d0e3-4f5g-6h7i-8j9k-0l1m2n3o4p5q"
    }
  ],
  "shippingAddress": {
    "firstName": "John",
    "lastName": "Doe",
    "address1": "123 Main Street",
    "address2": "Apt 4B",
    "city": "San Francisco",
    "state": "CA",
    "zip": "94105",
    "country": "US",
    "phone": "+1-555-123-4567"
  }
}

Response

OK

validboolean required

Example response

{
  "estimatedCosts": {
    "fulfillmentFee": {
      "value": 10,
      "currency": "USD"
    },
    "manufacturingCost": {
      "value": 10,
      "currency": "USD"
    },
    "shippingCost": {
      "value": 10,
      "currency": "USD"
    },
    "totalCreatorCost": {
      "value": 10,
      "currency": "USD"
    }
  }
}

Changes

    • breaking

      the // request property type changed from integer to string, and format from int32 to no format

    • warning

      removed the request property //

    • info

      added the non-success response with the status