API referenceCertificates
List certificates
Certificates of your company, newest first: the company certificate and the personal ones.
Filters: type, recipient, project, updated_since, created_since.
Scope: certificates: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
type?string
Value in
- "company"
- "personal"
- "gift"
recipient?string
project?string
Only objects of this project (prj_...).
updated_since?string
Only objects updated at or after this ISO 8601 time.
Format
date-timecreated_since?string
Only objects created 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.
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/certificates"{ "object": "list", "url": "/v2/certificates", "has_more": false, "data": [ { "id": "cert_3pDmQ2xL7rCkZa8bW1vT9yN6", "object": "certificate", "livemode": true, "type": "personal", "number": "WYC-2026-000418", "trees": 1, "project": "prj_9Lp3xW7mQv2kT8bZa4yR6cN1", "recipient": "rcp_1vT9yN6pDmQ2xL7rCkZa8bW3", "allocations": [ "alloc_6yN3pDmQ2xL7rCkZa8bW1vT9" ], "language": "nl", "issued_at": "2026-09-28T09:15:00Z", "url": "https://woodyou.care/certificate/cert_3pDmQ2xL7rCkZa8bW1vT9yN6", "download_url": "https://woodyou.care/certificate/cert_3pDmQ2xL7rCkZa8bW1vT9yN6/download?expires=1790600000&signature=...", "created_at": "2026-09-28T09:15:00Z", "updated_at": "2026-09-28T09:15:00Z" } ]}