Skip to main content

​
Overview

Retrieve tracking updates to keep your marketplace order statuses in sync after Turtles accepts an order. Turtles returns updates keyed by purchaseOrderNumber, which should match the internal order ID, transaction ID, or associated ID you sent when you created the marketplace order.

​
Base URL

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

​
Authentication

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

​
Endpoint

GET https://triton.turtles.com/api/orders?updated_since={unixTimestamp}
Fetch Turtles orders updated since a Unix timestamp in seconds.
Query parameterTypeDescription
updated_sinceintegerUnix timestamp in seconds. Use the timestamp from your last successful poll.
We recommend polling once every 6 hours. Some partners poll daily or hourly depending on volume, but do not poll more than once per hour.

​
Example

curl -X GET "https://triton.turtles.com/api/orders?updated_since=1714413600" \
  -u "$TURTLES_USER:$TURTLES_PASS" \
  -H "Accept: application/json"
Advance your stored poll timestamp only after the request succeeds and your system finishes processing the response.

​
Response

Turtles returns a JSON object keyed by purchaseOrderNumber. 
{
  "internal-order-1001": {
    "status": "Shipped",
    "updated_at": "1714417200",
    "trackings": [
      {
        "carrier": "FedEx",
        "tracking": "380161079953",
        "url": "https://www.fedex.com/fedextrack/?trknbr=380161079953",
        "delivery_status": "intransit"
      }
    ],
    "vendor_order_id": 1654696
  }
}
FieldTypeDescription
statusstringTurtles order status, for example Received, Processing shipment, Shipped, or Delivered.
updated_atstringLast update timestamp.
trackingsarrayTracking records for the order.
trackings[].carrierstringCarrier name.
trackings[].trackingstringTracking number.
trackings[].urlstringCarrier tracking URL.
trackings[].delivery_statusstringCarrier delivery status, for example inforeceived, intransit, or delivered.
vendor_order_idnumberTurtles vendor order ID.

​
Suggested status handling

Turtles valueSuggested marketplace status
Delivered order status or delivered delivery statusDelivered
Shipped order statusShipped
intransit or inforeceived delivery statusShipped
Processing shipment or Received order statusProcessing
Canceled or Cancelled order statusCanceled

​
Suggested sync flow

  1. Store the Unix timestamp from your last successful tracking poll.
  2. Call the tracking endpoint with updated_since.
  3. For each response key, find the marketplace order with the same internal reference.
  4. Save the carrier, tracking number, tracking URL, and latest status.
  5. Advance your stored poll timestamp after all updates are processed successfully.