POST
/
buy
Buy Item
curl --request POST \
  --url https://api.buybase.ai/buy \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '{
  "items": [
    {}
  ],
  "user_id": "<string>",
  "store_id": "<string>"
}'
{
  "message": "Order created successfully",
  "code": "ORDER_CREATED"
}

​
Headers

​
authorization
string
required

Your API key for authentication.

​
Body

​
items
array
required

Array of items to purchase.

[
  {
    "variant_id": "string", // Shopify variant ID
    "quantity": 1 // Must be at least 1
  }
]
​
user_id
string
required

The unique identifier for the user.

​
store_id
string
required

The unique identifier for the store.

​
Response

​
message
string

A message indicating the result of the purchase operation.

​
code
string

A code indicating the result of the purchase operation. Possible values:

  • ORDER_CREATED: Order created successfully
  • AUTH_MISSING: No API key provided
  • INVALID_KEY: Invalid API key
  • BAD_REQUEST_ERROR: Invalid request parameters
  • STORE_NOT_FOUND: Store ID not found
  • USER_NOT_FOUND: User ID not found
  • STORE_NOT_VERIFIED: Store is not verified yet
  • FORBIDDEN: Not authorized to access store
  • INTERNAL_ERROR: Server error occurred
​
error
string

Error message if the request fails.

{
  "message": "Order created successfully",
  "code": "ORDER_CREATED"
}