{"files":{"SKILL.md":"---\nname: api-v1\ndescription: \"API V1 API skill. Use when working with API V1 for api. Covers 8 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# API V1\nAPI version: v1\n\n## Auth\nBearer basic\n\n## Base URL\nhttps://api.getchange.io\n\n## Setup\n1. Set Authorization header with Bearer token\n2. GET /api/v1/donations/show -- retrieve a donation\n3. POST /api/v1/donations/create -- create first create\n\n## Endpoints\n8 endpoints across 1 group. See references/api-spec.lap for full details.\n\n### Api\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /api/v1/donations/create | Create a donation |\n| GET | /api/v1/donations/show | Retrieve a donation |\n| GET | /api/v1/donations/index | List your donations |\n| GET | /api/v1/donations/carbon_calculate | Calculate shipping carbon offset |\n| GET | /api/v1/donations/crypto_calculate | Calculate crypto carbon offset |\n| GET | /api/v1/donations/carbon_stats | Retrieve carbon offset stats |\n| GET | /api/v1/nonprofits/show | Show a nonprofit |\n| GET | /api/v1/nonprofits/list | Search a nonprofit |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"Create a create?\" -> POST /api/v1/donations/create\n- \"List all show?\" -> GET /api/v1/donations/show\n- \"List all index?\" -> GET /api/v1/donations/index\n- \"List all carbon_calculate?\" -> GET /api/v1/donations/carbon_calculate\n- \"List all crypto_calculate?\" -> GET /api/v1/donations/crypto_calculate\n- \"List all carbon_stats?\" -> GET /api/v1/donations/carbon_stats\n- \"List all list?\" -> GET /api/v1/nonprofits/list\n- \"How to authenticate?\" -> See Auth section above\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- Paginated endpoints accept limit/offset or cursor parameters\n- Create/update endpoints return the modified resource on success\n- Error responses include status codes and descriptions in the spec\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api API V1\n@base https://api.getchange.io\n@version v1\n@auth Bearer basic\n@endpoints 8\n@toc api(8)\n\n@endpoint POST /api/v1/donations/create\n@desc Create a donation\n@required {amount: str # The amount of the donation in cents., nonprofit_id: str # The id of a nonprofit from the CHANGE network., funding_source: str(merchant/customer) # Source of the donation funds. If you are collecting payment from your customer for the donation, use `customer`.}\n@optional {zip_code: str # The customer's zip code. Provide this to unlock geographic insights.}\n@returns(200) Donation successful\n@errors {400: Param `nonprofit_id` invalid}\n\n@endpoint GET /api/v1/donations/show\n@desc Retrieve a donation\n@required {id: str # The id of a donation. Ids are returned when a donation is created.}\n@returns(200) successful\n\n@endpoint GET /api/v1/donations/index\n@desc List your donations\n@optional {page: num # Which page to return. This endpoint is paginated, and returns maximum 30 donations per page.}\n@returns(200) successful\n\n@endpoint GET /api/v1/donations/carbon_calculate\n@desc Calculate shipping carbon offset\n@required {weight_lb: num # The total weight (in pounds) of the shipment.}\n@optional {origin_address: num # The origin zip code (US only) of the shipment. If you send this parameter, also send `destination_address`., destination_address: num # The destination zip code (US only) of the shipment. If you send this parameter, also send `origin_address`., distance_mi: num # The total distance (in miles) of the shipment. You can use this parameter in place of `origin_address` and `destination_address`., transportation_method: str(air/truck/rail/sea) # The primary transportation method of the shipment.}\n@returns(200) successful\n\n@endpoint GET /api/v1/donations/crypto_calculate\n@desc Calculate crypto carbon offset\n@required {currency: str(eth/btc) # The currency of the transaction.}\n@optional {count: num # The number of transactions to offset.}\n@returns(200) successful\n\n@endpoint GET /api/v1/donations/carbon_stats\n@desc Retrieve carbon offset stats\n@optional {id: num # The id of a donation to the CarbonFund nonprofit. Ids are returned when a donation is created. If an ID is not provided, the total stats for all donations to CarbonFund are returned.}\n@returns(200) successful\n\n@endpoint GET /api/v1/nonprofits/show\n@desc Show a nonprofit\n@required {id: str # The id of a nonprofit from the CHANGE network.}\n@returns(200) Show successful\n\n@endpoint GET /api/v1/nonprofits/list\n@desc Search a nonprofit\n@optional {name: str # A string to search., page: num # The page to return. This endpoint is paginated, and returns up to 30 nonprofits at a time.}\n@returns(200) List successful\n\n@end\n"}}