Submit a new order

post

https://api.openborder.com/api/direct/v1/orders

What this endpoint does

This endpoint creates a final order in OpenBorder’s Order Management System (OMS) once your customer has selected their shipping option and agreed to the calculated landed cost.
This call ensures the order is registered in OpenBorder’s OMS so we can:

Record the exact duties & taxes to be remitted to authorities
Guarantee the correct shipping rate is linked to the shipment
Generate accurate billing and settlement for your international shipments

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

source

string

required

Source system from which the order originated.

source_reference

number

required

Reference ID from the source system. This is the unique identifier to reference the order on subsequent calls and cannot be updated.

landedcost_request_id

string

required

Unique ID for this tax calculation request provided when calculating landed cost.

source_created_at

string

required

Timestamp in ISO format when the order was created in the source system.

source_updated_at

string

required

Timestamp in ISO format when the order was last updated in the source system.

billing_address

object

Billing address for the order.

total

number

required

Total amount of the order including all charges, taxes, duties, discounts and refund in major currency units (e.g., dollars). Up to two decimal places are allowed.

shipments

array of objects

required

Shipments on the order. Each must include a tax_request_id from the tax calculation step.

shipments*

custom_properties

object | null

Optional custom metadata or structured properties. Object max. size is 4 KB.

Headers

x-openborder-direct-api-key

string

required

OpenBorder merchant API token

Responses

204

Order successfully created. No content returned.

400

Invalid order payload received.

401

Invalid authorization token received.

422Order data failed validation rules.