Kiwify API
★ Only Publicly Available OpenAPI DocumentE CommerceStorefrontbearer20 EndpointsREST
For Agents
Pull Kiwify sales and product data, issue refunds, manage affiliates, and reconcile creator payouts through the public API.
Use for: List all products in my Kiwify catalogue, Retrieve the sale with order id 1234 from Kiwify, Issue a refund for a Kiwify sale that the customer disputed, Get the sales statistics for the last 30 days from Kiwify
Not supported: Does not handle course content authoring, video hosting, or buyer-facing checkout UI — use for sales, refunds, affiliates, webhooks, and finance reconciliation only.
Jentic publishes the only available OpenAPI specification for Kiwify API, keeping it validated and agent-ready. Kiwify is a Brazilian digital product and online course platform that handles checkout, affiliates, payouts, and webhook delivery for creators. The public API exposes products, sales, refunds, affiliates, webhooks, event participants, and finance balances and withdrawals, so creators can pull sales data, automate refund flows, and reconcile payouts outside the dashboard. It also covers OAuth token issuance for partner integrations.
Install Jentic One Beta
Connect the Kiwify API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Kiwify API, 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://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | 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 Kiwify API.
List products from a Kiwify creator catalogue with details and pricing
Pull sales records and look up an individual order by id
Issue a refund against a Kiwify sale on behalf of the seller
Aggregate sales statistics for a Kiwify creator account
Manage Kiwify affiliates and inspect individual affiliate records
Register and inspect webhooks for Kiwify sale and refund events
Reconcile balances and withdrawals from the Kiwify finance endpoints
Use Cases
Patterns agents use Kiwify API for, with concrete tasks.
★ Refund Automation for Creators
Automate Kiwify refund handling so support staff or an agent can process refunds without opening the dashboard. The /sales/{order_id} and /sales/{order_id}/refund endpoints expose the order context and refund action together, so an agent can verify a sale before issuing a refund. Useful for course creators with high refund volume during launches.
Look up Kiwify order 'ORD-2024-001', confirm status is 'paid', and call POST /sales/{order_id}/refund to issue a full refund.
Sales Dashboard Sync
Sync Kiwify sales into an internal BI tool or a creator dashboard. The /sales endpoint paginates orders with product, customer, and revenue fields, and /sales/stats gives aggregated KPIs for the same window. Saves creators from CSV exports and keeps revenue numbers fresh in tools like Notion, Airtable, or a custom finance sheet.
Pull Kiwify sales for the last 7 days from /sales, then call /sales/stats and write a daily revenue summary to the creator's reporting sheet.
Affiliate Program Management
Operate a Kiwify affiliate program with programmatic access to affiliate records. The /affiliates endpoints list active partners and let an agent retrieve commission and conversion data per affiliate id. Best for course creators running competitions, sending personalised reports, or paying out top performers automatically.
List Kiwify affiliates, fetch /affiliates/{affiliate_id} for the top 10 by sales, and email each a performance summary.
Webhook-Driven Fulfilment Workflow
Register Kiwify webhooks so downstream tools react to sale and refund events in real time. Use POST /webhooks to attach a destination URL and GET /webhooks to audit current registrations. Combined with the events endpoint this forms a reliable fulfilment trigger for delivering bonus content, granting community access, or revoking access on refund.
Register a webhook on https://example.com/kiwify-events for the order.paid event and verify it appears in GET /webhooks.
Agent-Driven Creator Operations via Jentic
Let an AI agent answer creator questions like 'what did I earn yesterday' or 'refund order ABC' by calling Kiwify through Jentic. The agent searches Jentic for the matching Kiwify operation, loads the schema, and executes with a scoped bearer token. This is much faster than wiring an OAuth client and webhook handler into the agent stack directly.
Through Jentic, search for 'list Kiwify sales', load the /sales operation, and report yesterday's order count and total revenue.
Key Endpoints
20 endpoints — jentic publishes the only available openapi specification for kiwify api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
POST
/oauth/token
Issue a Kiwify OAuth bearer token
GET
/products
List creator products
GET
/sales
List sales orders
GET
/sales/{order_id}
Retrieve a single sale
POST
/sales/{order_id}/refund
Issue a refund for a sale
GET
/sales/stats
Aggregate sales statistics
GET
/finance/saldos
Read account balances
POST
/oauth/token
Issue a Kiwify OAuth bearer token
GET
/products
List creator products
GET
/sales
List sales orders
GET
/sales/{order_id}
Retrieve a single sale
POST
/sales/{order_id}/refund
Issue a refund for a sale
GET
/sales/stats
Aggregate sales statistics
GET
/finance/saldos
Read account balances
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
Kiwify OAuth bearer tokens are stored encrypted in the Jentic vault. Agents receive scoped access to /sales, /products, and /webhooks without ever seeing the client_secret used at /oauth/token.
Intent-based discovery
Agents search by intent (e.g., 'refund a Kiwify order', 'list Kiwify sales') and Jentic returns the matching operation with its request schema, so the agent calls the right endpoint without reading the docs.
Time to first call
Direct Kiwify integration: 1-2 days for OAuth setup, webhook registration, and refund flow handling. Through Jentic: under 1 hour — search, load, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
Complementary
Stripe API
Underlying card processing and payouts platform Kiwify itself rides on top of
Use Stripe directly when the creator wants raw payment-processing control; use Kiwify when they want bundled checkout, affiliate, and course delivery.
FAQs
Specific to using Kiwify API through Jentic.
Why is there no official OpenAPI spec for Kiwify API?
Kiwify does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Kiwify API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Kiwify API use?
The Kiwify API uses OAuth 2.0 with a bearer access token. POST /oauth/token exchanges client credentials for an access token that is then sent as Authorization: Bearer <token> on all other endpoints. Through Jentic, the bearer token is stored in the Jentic vault and the agent never sees the raw secret.
Can I issue refunds through the Kiwify API?
Yes. POST /sales/{order_id}/refund issues a refund against a specific order. Verify the order status with GET /sales/{order_id} first to avoid refunding pending or already-refunded orders.
What are the rate limits for the Kiwify API?
Kiwify does not publish hard rate limits in the public API spec but throttles abusive clients per account. Cache /products and /sales/stats responses where possible — Jentic's runtime caches identical reads across agent runs to reduce hits.
How do I list Kiwify sales from an AI agent through Jentic?
Search Jentic for 'list Kiwify sales', load the GET /sales operation, then execute with a date range filter. Jentic injects the OAuth bearer token from the vault so the agent does not need to handle the /oauth/token exchange directly.
Does the Kiwify API expose creator finance data?
Yes. GET /finance/saldos returns the current account balance and GET /finance/saques lists withdrawals. Use these to reconcile payouts against the sales captured by /sales.
GET STARTED