Pagination and filters

List endpoints return objects newest first:

{
  "object": "list",
  "url": "/v2/allocations",
  "has_more": true,
  "data": [ { "id": "alloc_01K...", "object": "allocation" } ]
}

• limit: 1 to 100, default 25.
• starting_after: the id of the last object you received. Repeat while has_more is true.

curl "https://woodyou.care/api/v2/allocations?limit=100&starting_after=alloc_01K..." \
  -H "Authorization: Bearer wyc_live_..."

FiltersCopy Anchor Link

Most lists accept project (a prj_ id), updated_since and created_since (ISO 8601); allocations also status (pledged, planted or monitored), planting and recipient. Use updated_since to sync changes since your last run, or better, use webhooks. A planting's updated_at also moves when its dossier grows, so one updated_since sweep over /plantings catches new photos and monitoring.

Related objects come as ids. Add expand[]=planting, expand[]=project, expand[]=recipient or expand[]=partner to include the full object instead; the reference lists what each endpoint can expand.

LanguageCopy Anchor Link

Project names, species names, captions and notes are translated. Send Accept-Language: nl for Dutch; the default is English.