Skip to main content

​
Start here

Use list endpoints to pull items, and create to upsert when you need to push updates back.

​
Plan your sync

  • Decide a cadence (hourly, daily, etc.)
  • Choose your matching key (for example, external IDs)

​
Fetch items

curl -X GET "https://api.sanka.com/v1/public/items" \
  -H "Authorization: Bearer <access_token>"
Example response:
{
  "data": [
    {
      "id": "itm_123",
      "name": "Apple",
      "price": 120,
      "currency": "JPY",
      "status": "active",
      "updated_at": "2026-01-20T12:00:00Z"
    }
  ]
}

​
Apply updates

  • Match by id or external ID
  • Update only changed records to reduce load
  • Use Create Item to upsert by external_id when pushing changes