Developers
API referencePlantings

List plantings

GET
/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
AuthorizationBearer <token>

A Platform API token, wyc_live_... or wyc_test_..., created at Settings > API tokens in the dashboard.

In: header

Query Parameters

source?string

Value in

  • "foundation"
  • "legacy"
project?string

Only objects of this project (prj_...).

updated_since?string

Only objects updated at or after this ISO 8601 time.

Formatdate-time
created_since?string

Only objects created at or after this ISO 8601 time.

Formatdate-time
limit?integer

Number of objects to return, 1 to 100.

Range1 <= value <= 100
Default25
starting_after?string

Cursor: the id of the last object of the previous page.

expand[]?array<>

Include related objects instead of their ids: project, 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/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"    }  ]}