Venues API
The /venues API endpoint
Jeff Schnitzer avatar
Written by Jeff Schnitzer
Updated over a week ago

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.

Did this answer your question?