Retrieves a complete list of all of your venues. The result will be encapsulated in an object like this:
{ "data": [ {...first...}, {...second...} ] }
Each data object will be the same data as in the GET single venue endpoint below.
Obtain the data for a single venue with key VEN123. Response looks like:
{
"key": "VEN123",
"name": "My Etsy Venue",
"platform": "Etsy"
}
Requests for invalid keys produce 410 GONE (to explicitly distinguish from 404).
List the blueprints for a specific venue. The result will be encapsulated in an object like this:
{ "data": [ {...first...}, {...second...} ] }
Each data object will be the same data as in the GET single blueprint endpoint.
Create an order. The venue must be a Manual venue.
The POST body must be JSON:
{
"reference": "yourprivateid",
"shipping": {
"name": "Bob Dobbs",
"address1": "123 Slack St",
"address2": "",
"city": "Nowhere",
"state": "CA",
"country": "US",
"zip": "99999"
},
"lineItems": [
{
"reference": "optionalitemref",
"design": "DES2666",
"variant": "VARTS_BLK_L",
"side": "FRONT",
"quantity": 2
}
]
}
reference - the order reference is optional but very strongly recommended. If present, it must be a unique value for this venue. This enforces idempotent order creation (see errors, below). You probably want to use your own database identifier here.
shipping - country must be a 2-letter ISO country code
lineItems reference - optional. If present, must be unique within an Order
lineItems design - must be the key of a design from your Org's library
lineItems variant - must be a variant key from the OrbitKit catalog.
lineItems side - must be a valid side for the product associated with the specified variant. See the catalog.
Errors
If you post an order with a duplicate reference
, you will receive 409 CONFLICT. The error body will include the key of the original order:
{
"message": "An order with the reference 'duplicateid' already exists in this venue",
"type": "ReferenceConflict",
"types": ["ReferenceConflict", "Conflict"],
"order": "ORD4548"
}
Result
The response will be the full order structure defined in the Orders API.