Common API recipes

These ready-to-run curl examples cover the most common REST API tasks. Replace YOUR_API_KEY with your own key and adjust the values for your data.

List and filter items

curl "https://fiddle.io/rest/api/v2/items?limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

Fetch a single record

curl https://fiddle.io/rest/api/v2/items/ITEM_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

Create a sales order

curl -X POST https://fiddle.io/rest/api/v2/sales-orders \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "CUSTOMER_ID",
    "lineItems": [
      { "itemId": "ITEM_ID", "quantity": 2 }
    ]
  }'

Adjust stock

curl -X POST https://fiddle.io/rest/api/v2/stock-adjustments \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "itemId": "ITEM_ID",
    "locationId": "LOCATION_ID",
    "quantity": -5,
    "reason": "Damaged"
  }'

List endpoints support pagination. Request pages in a loop and stop when a page returns fewer records than your limit — and keep an eye on the rate limit on large jobs.

Field names and the full set of endpoints are documented in Swagger UI at /rest/api/v2/docs/swagger, where you can try each call live.

Next steps

Use these calls alongside webhooks to keep external systems in sync without polling.