Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.turtles.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Create a marketplace order when your customer has checked out and Turtles needs to fulfill the item.
Set purchaseOrderNumber to the internal order ID, transaction ID, or associated ID you want to use for future tracking.

​
Base URL

https://triton.turtles.com
This is the public production API. Turtles does not currently provide a sandbox URL.

​
Authentication

Order endpoints use HTTP Basic Auth with your Turtles API credentials. 
-u "$TURTLES_USER:$TURTLES_PASS"

​
Endpoint

POST https://triton.turtles.com/api/orders
Partners receive valid itemId values from the product feed provided during onboarding.
FieldTypeRequiredDescription
itemIdnumberYesTurtles item ID to fulfill.
purchaseOrderNumberstringYesYour internal order ID, transaction ID, or associated ID for matching future tracking updates.
namestringYesRecipient full name.
emailstringYesRecipient email address.
phonestringYesRecipient phone number, preferably in E.164 format.
addressstringYesStreet address line 1.
address2stringNoStreet address line 2.
citystringYesRecipient city.
statestringYesState or province code.
zipCodestringYesPostal code.
countrystringYesTwo-letter country code, for example US.

​
Example

curl -X POST "https://triton.turtles.com/api/orders" \
  -u "$TURTLES_USER:$TURTLES_PASS" \
  -H "Content-Type: application/json" \
  -d '{
    "itemId": 12345,
    "purchaseOrderNumber": "internal-order-1001",
    "name": "Jane Doe",
    "email": "jane@example.com",
    "phone": "+15551234567",
    "address": "123 Main St",
    "address2": "Apt 4B",
    "city": "Austin",
    "state": "TX",
    "zipCode": "78701",
    "country": "US"
  }'
A 201 Created response means Turtles accepted the order. Store the purchaseOrderNumber you sent so you can match future tracking updates.
Automatic retries should reuse the same purchaseOrderNumber. Confirm duplicate-order behavior with Turtles before retrying create requests automatically.
Next, retrieve tracking updates for created orders.