Change API V1
Official vendor OpenAPI document · agent-readyPaymentsPayment Processingbasic8 EndpointsREST
For Agents
Create donations to vetted nonprofits, look up charities by cause, and calculate carbon offset or crypto-equivalent giving amounts. Useful for embedding charitable giving into checkout or transaction flows.
Use for: I want to create a donation to a vetted nonprofit, Search for nonprofits that work on climate change, Get the details of a specific charity by ID, Calculate how much to donate to offset 1.5 tons of carbon
Not supported: Does not handle payment capture, refunds, or general payouts - use for routing donations to vetted 501(c)(3) nonprofits only.
Change is a donations platform that lets businesses embed nonprofit giving into checkout, transactions, and customer-facing flows. The API exposes endpoints for creating donations, listing and looking up vetted nonprofits, retrieving past donation records, and calculating carbon offset and crypto donation amounts. It is designed for fintech, e-commerce, and crypto products that want to route a percentage of revenue or rounded-up change to charity without managing 501(c)(3) compliance themselves.
Install Jentic One Beta
Connect the Change API V1 to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Change API V1, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fchange.local%2Fchange-local" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fchange.local%2Fchange-local" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Change API V1 API.
Create a donation to any 501(c)(3) nonprofit in the Change network with the donations create endpoint
List and filter the nonprofit catalog by category, location, or keyword via the nonprofits list endpoint
Retrieve a single nonprofit profile including EIN, mission, and tax-deduction status
Calculate a carbon offset donation amount in USD for a given quantity of CO2
Calculate the equivalent fiat donation value for a crypto contribution before submission
Pull aggregate carbon donation statistics for reporting and dashboard displays
Use Cases
Patterns agents use Change API V1 API for, with concrete tasks.
★ Round-Up Donations at Checkout
E-commerce stores and fintech apps can let customers round up purchases to the nearest dollar and donate the difference to a vetted nonprofit. The Change API handles nonprofit selection, donation creation, and tax-receipt generation, so the merchant only needs to surface a checkbox and pass the rounded-up amount to the donations create endpoint. Integration typically takes under a day for a basic rounding flow.
Create a $0.43 donation to a nonprofit selected from the climate category and confirm the donation record was returned with a receipt URL
Carbon Offset Calculations
Travel, shipping, and crypto applications often need to translate a CO2 footprint into a dollar donation amount that funds reforestation or carbon-removal nonprofits. The carbon_calculate endpoint converts a tonnage input into a USD price and the carbon_stats endpoint surfaces aggregate offset totals for transparency dashboards. This removes the need to maintain offset price tables in-app.
Call carbon_calculate for 2.4 tons of CO2 and submit a donation for the returned amount to a verified climate nonprofit
Crypto Charitable Giving
Crypto wallets and exchanges can offer users an easy way to donate digital assets to nonprofits without handling on-chain conversions themselves. The crypto_calculate endpoint returns the fiat-equivalent USD amount for a token quantity, which can then be passed to the donations create endpoint to generate a tax-deductible record.
Use crypto_calculate to determine the USD value of 0.05 BTC and create a donation for that amount to a selected nonprofit
AI Agent Donation Flows via Jentic
An AI agent can take a natural-language instruction like 'donate 5 dollars to an ocean conservation charity' and resolve it end-to-end through Jentic. The agent searches Jentic for the donation operation, lists nonprofits filtered by category, picks a verified charity, and submits the donation create call. Credentials never reach the agent, and the entire flow takes seconds rather than days of direct integration.
Search Jentic for 'create a charitable donation', filter nonprofits by 'ocean conservation', and submit a $5 donation to the top result
Key Endpoints
8 endpoints — change is a donations platform that lets businesses embed nonprofit giving into checkout, transactions, and customer-facing flows.
METHOD
PATH
DESCRIPTION
POST
/api/v1/donations/create
Create a new donation to a vetted nonprofit
GET
/api/v1/donations/index
List donations for the authenticated account
GET
/api/v1/donations/show
Retrieve a single donation record by ID
GET
/api/v1/donations/carbon_calculate
Calculate the USD donation amount for a CO2 tonnage
GET
/api/v1/donations/crypto_calculate
Convert a crypto token amount to fiat donation value
GET
/api/v1/nonprofits/list
List vetted nonprofits with optional filters
GET
/api/v1/nonprofits/show
Retrieve a single nonprofit profile by ID
POST
/api/v1/donations/create
Create a new donation to a vetted nonprofit
GET
/api/v1/donations/index
List donations for the authenticated account
GET
/api/v1/donations/show
Retrieve a single donation record by ID
GET
/api/v1/donations/carbon_calculate
Calculate the USD donation amount for a CO2 tonnage
GET
/api/v1/donations/crypto_calculate
Convert a crypto token amount to fiat donation value
GET
/api/v1/nonprofits/list
List vetted nonprofits with optional filters
GET
/api/v1/nonprofits/show
Retrieve a single nonprofit profile by ID
Why Jentic?
What agents get from Jentic-routed access to this vendor.
Setup
Wiring Change by hand means handling its HTTP Basic auth with a secret key over TLS and attaching credentials to every donation and nonprofit call yourself. Through Jentic you install once, import Change from the API Directory, store the key once, and your agent calls it.
Permission scoping
Change routes donations and lists nonprofits through flat operation paths rather than a per-resource URL, so limit the agent to the operations it needs, such as creating a donation or listing nonprofits by cause. You choose which operations it may call, so anything beyond donation routing and nonprofit lookup is not included unless you add it.
Credential isolation
Your Change secret key is stored once, encrypted, by your own Jentic One instance and used to sign the Basic auth header at execution time. It never enters the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'create a charitable donation' or 'list nonprofits by cause', and Jentic returns the matching Change operation with its input schema so the agent calls the right endpoint without browsing the reference docs.
Related APIs
Alternatives and complements available in the Jentic catalogue.
Complementary
Stripe API
Stripe handles the payment capture; Change directs a portion of the captured funds to a vetted nonprofit.
Use Stripe alongside Change when you need to charge the customer first, then route a percentage of the proceeds as a donation.
FAQs
Specific to using Change API V1 API through Jentic.
What authentication does the Change API use?
The Change API uses HTTP Basic authentication over TLS, with your public and secret keys passed as the username and password. When you call this API through Jentic, your Change credentials stay encrypted in your Jentic One instance and the agent receives a scoped execution token rather than your raw secret key.
Can I create one-time donations to any 501(c)(3) nonprofit with the Change API?
Yes. Call POST /api/v1/donations/create with the nonprofit ID (looked up via /api/v1/nonprofits/list) and an amount in USD cents. The donation is recorded against the vetted nonprofit and Change handles the tax-receipt and disbursement workflow.
How do I calculate a carbon offset donation with the Change API?
Use GET /api/v1/donations/carbon_calculate with a CO2 tonnage parameter. The endpoint returns a USD amount that can be passed directly to /api/v1/donations/create against a climate-focused nonprofit to fund verified offsets.
What are the rate limits for the Change API?
Change does not publish a fixed public rate limit; production limits depend on your account tier. Treat the API as a payment-grade integration: implement exponential backoff on 429 responses and avoid bursting more than a few requests per second from a single key.
How do I create a donation through Jentic?
Install the Jentic SDK with pip install jentic, search for the operation with a query like 'create a charitable donation', load the schema for POST /api/v1/donations/create, and execute with the nonprofit ID and amount. Run Jentic One, the self-hosted execution layer, to issue an API key.
Does the Change API support crypto-denominated donations?
Yes. The /api/v1/donations/crypto_calculate endpoint converts a crypto token amount into a fiat-equivalent USD value. You then submit that USD amount to the donations create endpoint, which produces a standard tax-deductible record on behalf of the donor.
Can I limit what my agent is allowed to do with the Change API?
Yes. Because the Change API exposes flat operation paths rather than per-resource URLs, your self-hosted Jentic One instance lets you decide exactly which operations the agent may call, such as creating a donation or listing nonprofits by cause. If you scope the agent to donation creation and nonprofit lookup, it cannot touch the carbon or crypto calculation endpoints or list past donation records unless you add those operations too. Your own rules govern which operations and credentials the agent uses, so anything beyond the endpoints you grant stays off limits.
GET STARTED