List plantings
Plantings with trees of your company, newest first, each with its proof dossier: species, polygon, photos, latest monitoring and verification.
Filters: project, source, updated_since, created_since. updated_since also catches dossier additions such as new photos or a monitoring measurement.
Scope: plantings:read.
Authorization
bearerAuth A Platform API token, wyc_live_... or wyc_test_..., created at Settings > API tokens in the dashboard.
In: header
Query Parameters
Value in
- "foundation"
- "legacy"
Only objects of this project (prj_...).
Only objects updated at or after this ISO 8601 time.
date-timeOnly objects created at or after this ISO 8601 time.
date-timeNumber of objects to return, 1 to 100.
1 <= value <= 10025Cursor: the id of the last object of the previous page.
Include related objects instead of their ids: project, partner.
Header Parameters
Language of translated texts such as project names and species: en (default) or nl.
Value in
- "en"
- "nl"
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/plantings"{ "object": "list", "url": "/v2/plantings", "has_more": false, "data": [ { "id": "plt_4vT9bW1kZa8yN3pDmQ2xL7rC", "object": "planting", "project": "prj_9Lp3xW7mQv2kT8bZa4yR6cN1", "partner": "ptn_2mQv7LcX4rT9bW1kZa8yN3pD", "source": "foundation", "planted_at": "2026-01-12", "trees": 500, "trees_for_company": 250, "species": [ { "name_latin": "Acacia tortilis", "name_common": "Umbrella thorn", "trees": 300 }, { "name_latin": "Grevillea robusta", "name_common": "Silky oak", "trees": 200 } ], "location": { "latitude": -0.9305, "longitude": 36.5733 }, "geometry": { "type": "Polygon", "coordinates": [ [ [ 36.572, -0.931 ], [ 36.574, -0.931 ], [ 36.574, -0.93 ], [ 36.572, -0.93 ], [ 36.572, -0.931 ] ] ] }, "photos": [ { "url": "https://media.woodyoucare.foundation/plantings/plt_4vT9/1.jpg", "caption": null, "taken_at": "2026-01-12", "credit": "Green Belt Movement" } ], "planting_method": "seedling", "notes": null, "latest_monitoring": { "id": "mon_7kZ2bW9xQ4mLp1vT8rN3yC6a", "object": "monitoring", "planting": "plt_4vT9bW1kZa8yN3pDmQ2xL7rC", "project": "prj_9Lp3xW7mQv2kT8bZa4yR6cN1", "recorded_at": "2026-07-20", "survival_rate": 0.91, "trees_alive": 455, "method": "field_survey", "photos": [ { "url": "https://media.woodyoucare.foundation/monitoring/mon_7kZ2/1.jpg", "caption": null, "taken_at": "2026-07-20", "credit": "Green Belt Movement" } ], "notes": "Dry season losses within expectation." }, "verification": { "status": "verified", "latest": { "id": "ver_5tR8wQ2mLp9vX3kZb7yN4cH1", "object": "verification", "project": "prj_9Lp3xW7mQv2kT8bZa4yR6cN1", "period_start": "2026-01-01", "period_end": "2026-06-30", "verifier_name": "Control Union", "verifier_website_url": "https://www.controlunion.com", "document_url": "https://media.woodyoucare.foundation/verifications/ver_5tR8.pdf", "summary": "Field audit of 3 plantings, 12,400 trees counted.", "trees_verified": 12400, "published_at": "2026-08-15T09:00:00Z" } }, "created_at": "2026-01-15T08:00:00Z", "updated_at": "2026-07-21T10:00:00Z" } ]}