{"openapi":"3.1.0","info":{"title":"TreeRM API","version":"1.0.0","description":"Read-only data about tree-planting organizations, their programs, sourced metrics and upcoming events. Data license CC BY 4.0; cite TreeRM.org. Every HTML page also has a Markdown twin (append .md).","license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"},"contact":{"email":"hello@treerm.org","url":"https://treerm.org/about"}},"servers":[{"url":"https://treerm.org"}],"paths":{"/api/v1/stats":{"get":{"summary":"Directory totals","responses":{"200":{"description":"Counts of organizations, countries, trees on record and metrics."}}}},"/api/v1/activity-types":{"get":{"summary":"Activity taxonomy with organization counts","responses":{"200":{"description":"List of activity types."}}}},"/api/v1/organizations":{"get":{"summary":"List organizations","parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"Full-text search over name, tagline, description and location."},{"name":"activity","in":"query","schema":{"type":"string"},"description":"Activity type slug."},{"name":"country","in":"query","schema":{"type":"string"},"description":"ISO 3166-1 alpha-2; matches headquarters or countries where they plant."},{"name":"scope","in":"query","schema":{"type":"string","enum":["local","regional","national","global"]}},{"name":"type","in":"query","schema":{"type":"string","enum":["nonprofit","government","company","community","coalition","social_enterprise"]}},{"name":"sort","in":"query","schema":{"type":"string","enum":["name","trees","recent"]}},{"name":"page","in":"query","schema":{"type":"integer"}},{"name":"per_page","in":"query","schema":{"type":"integer","maximum":200}},{"name":"near","in":"query","schema":{"type":"string"},"description":"`lat,lng`, `me` (the requester's approximate location), or a place name such as `Austin, TX` or `Nairobi, Kenya` (resolved against GeoNames cities over 15,000 people)."},{"name":"radius_km","in":"query","schema":{"type":"integer","enum":[40,80,160,400,800]},"description":"Radius for `near`. Default 160."}],"responses":{"200":{"description":"Paginated organizations."}}}},"/api/v1/places":{"get":{"summary":"Place-name suggestions for the near parameter","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Up to 8 cities with coordinates."}}}},"/api/v1/organizations.csv":{"get":{"summary":"Organizations as CSV","responses":{"200":{"description":"CSV, same filters as the JSON list."}}}},"/api/v1/organizations/{slug}":{"get":{"summary":"One organization with programs, metrics and upcoming events","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Organization detail."},"404":{"description":"Not found."}}}},"/api/v1/events":{"get":{"summary":"Upcoming events and volunteer opportunities","parameters":[{"name":"type","in":"query","schema":{"type":"string","enum":["volunteer_planting","tree_adoption_giveaway","tree_care_workday","training_workshop","seed_collection","nursery_workday","fundraiser","community_meeting","other"]}},{"name":"country","in":"query","schema":{"type":"string"}},{"name":"q","in":"query","schema":{"type":"string"}},{"name":"past","in":"query","schema":{"type":"string","enum":["1"]},"description":"Include past events."},{"name":"page","in":"query","schema":{"type":"integer"}},{"name":"per_page","in":"query","schema":{"type":"integer","maximum":200}},{"name":"near","in":"query","schema":{"type":"string"},"description":"`lat,lng`, `me` (the requester's approximate location), or a place name such as `Austin, TX` or `Nairobi, Kenya` (resolved against GeoNames cities over 15,000 people)."},{"name":"radius_km","in":"query","schema":{"type":"integer","enum":[40,80,160,400,800]},"description":"Radius for `near`. Default 160."}],"responses":{"200":{"description":"Events with registration links to the organizations' own systems."}}}}},"externalDocs":{"description":"llms.txt index","url":"https://treerm.org/llms.txt"}}