API referenceProjects
List projects
Projects with trees of your company, newest first. trees counts your company's trees only.
Filters: status, country, ecosystem_type, updated_since.
Scope: projects:read.
Authorization
bearerAuth AuthorizationBearer <token>
A Platform API token, wyc_live_... or wyc_test_..., created at Settings > API tokens in the dashboard.
In: header
Query Parameters
status?string
Value in
- "planned"
- "active"
- "completed"
- "paused"
country?string
ISO 3166-1 alpha-2.
ecosystem_type?string
Value in
- "mangrove"
- "rainforest"
- "forest"
- "coral"
- "savanna"
- "wetland"
updated_since?string
Only objects updated at or after this ISO 8601 time.
Format
date-timelimit?integer
Number of objects to return, 1 to 100.
Range
1 <= value <= 100Default
25starting_after?string
Cursor: the id of the last object of the previous page.
expand[]?array<>
Include related objects instead of their ids: partner.
Header Parameters
Accept-Language?string
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/projects"{ "object": "list", "url": "/v2/projects", "has_more": false, "data": [ { "id": "prj_9Lp3xW7mQv2kT8bZa4yR6cN1", "object": "project", "name": "Kijabe Forest", "description": "Restoration of degraded highland forest on the Rift Valley escarpment.", "country": "KE", "region": "Kiambu County", "status": "active", "ecosystem_type": "rainforest", "partner": "ptn_2mQv7LcX4rT9bW1kZa8yN3pD", "started_at": "2024-11-01", "location": { "latitude": -0.9312, "longitude": 36.5721 }, "geometry": { "type": "Polygon", "coordinates": [ [ [ 36.57, -0.93 ], [ 36.58, -0.93 ], [ 36.58, -0.92 ], [ 36.57, -0.92 ], [ 36.57, -0.93 ] ] ] }, "photos": [ { "url": "https://media.woodyoucare.foundation/projects/prj_9Lp3/cover.jpg", "caption": "Nursery, March 2026", "taken_at": "2026-03-04", "credit": null } ], "default_species": [ { "name_latin": "Juniperus procera", "name_common": "African juniper", "trees": null } ], "sdg_goals": [ 13, 15 ], "trees": { "total": 800, "pledged": 0, "planted": 200, "monitored": 600 }, "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" } }, "foundation_url": "https://woodyoucare.foundation/projects/kijabe-forest", "created_at": "2024-11-01T08:00:00Z", "updated_at": "2026-08-15T09:00:00Z" } ]}