If you sell anything on a monthly or annual basis, you already know the hard part is not the first sale. It is everything after it: charging the right card on the right day, sending invoices that match what the customer actually signed up for, handling the upgrade someone asked for mid-month, and chasing the payment that quietly failed because a card expired. Recurly is a company that does that work, and it does it through an API, which is a way for your software, or an AI assistant you use, to ask Recurly to do things on your behalf without anyone clicking through a dashboard. You can find the full profile on APIs.io.
What Recurly does
Recurly is a subscription management and recurring billing platform. It handles signups, plans, add-ons, coupons, dunning, invoicing, tax, revenue recognition and analytics for subscription businesses. Its product family includes Recurly Subscriptions, Recurly Commerce for Shopify, Recurly Engage, Recurly RevRec and an AI layer it calls Recurly Compass. The main way to work with it programmatically is the Recurly v3 REST API, which covers accounts, subscriptions, invoices, transactions, plans, purchases and subscriptions that come in through the app stores.
What you can get done
Start, change and end subscriptions
The core job is Subscription Lifecycle Management: creating a subscription when someone signs up, looking it up when they call support, and ending it when they leave. Your signup form, your CRM or your internal tools can all do this directly.
POST /subscriptionscreates a new subscription for a customer.GET /accounts/{account_id}/subscriptionslists everything one customer is subscribed to.PUT /subscriptions/{subscription_id}updates a subscription.DELETE /subscriptions/{subscription_id}terminates a subscription.
When a customer wants to move up a tier or add seats, that is Subscription Modification. The useful part here is that you can show the customer what a change will cost before you make it.
POST /subscriptions/{subscription_id}/change/previewpreviews what a change would look like.POST /subscriptions/{subscription_id}/changecreates the change.GET /subscriptions/{subscription_id}/changefetches a change that is pending.DELETE /subscriptions/{subscription_id}/changeremoves a pending change if the customer changes their mind.
Send invoices that match reality
Invoicing & Statement Management is about producing, finding and correcting the invoices your customers receive. Your accounting team or finance tools can pull them without anyone exporting spreadsheets.
GET /invoiceslists every invoice on your site.GET /accounts/{account_id}/invoiceslists the invoices for one customer.POST /accounts/{account_id}/invoices/previewpreviews a new invoice for pending charges.POST /accounts/{account_id}/invoicescreates an invoice for those pending charges.GET /invoices/{invoice_id}fetches a single invoice.
Recover failed payments
Dunning is the industry word for the polite, escalating process of asking a customer to fix a payment that failed. Recurly’s Payment Collection & Dunning capability lets you set those campaigns up and manage the cards and bank details on file, so revenue that would have quietly slipped away has a chance to come back.
GET /dunning_campaignslists your dunning campaigns.POST /dunning_campaignscreates a new one.PUT /dunning_campaigns/{dunning_campaign_id}updates a campaign.GET /accounts/{account_id}/billing_infoslists the payment methods stored on a customer.POST /accounts/{account_id}/billing_infosadds new billing information to a customer.
Design plans and run promotions
Before anyone can subscribe, you need something to subscribe to. Plan & Entitlement Design covers the plans themselves, with their billing intervals and pricing.
GET /planslists your plans.POST /planscreates a plan.PUT /plans/{plan_id}updates a plan.
And when it is time to run a sale, Discount & Promotion Management handles coupons, including batches of single-use codes for a campaign.
POST /couponscreates a new coupon.POST /coupons/{coupon_id}/generategenerates unique coupon codes.DELETE /coupons/{coupon_id}expires a coupon.PUT /coupons/{coupon_id}/restorebrings an inactive coupon back.
Bill for what customers actually use
If part of your pricing depends on usage, such as messages sent, gigabytes stored or hours booked, Usage Metering lets your product report that usage so it lands on the next invoice.
POST /subscriptions/{subscription_id}/add_ons/{add_on_id}/usagelogs a usage record.GET /subscriptions/{subscription_id}/add_ons/{add_on_id}/usagelists the usage recorded so far.PUT /usage/{usage_id}corrects a usage record.
Recurly also covers Gift Cards, Gifting & Cashback, with POST /gift_cards to create a gift card and POST /gift_cards/{redemption_code}/redeem to redeem one, which is handy if you want people to give your subscription as a present.
Getting started
Recurly is a hosted service, so you call their endpoint rather than running anything yourself. The v3 API uses HTTP Basic authentication with a site API key; Recurly documents how to create and manage those in its API keys guide. The integration paths page is the best place to decide how to connect, and if you are on the older XML API there is an upgrade guide to v3.
If you work with an AI assistant, Recurly publishes a public Compass MCP server, which lets tools like Claude or Cursor search Recurly’s docs and API reference directly. It is also listed on APIs.io as the Recurly Compass MCP server.
On cost, Recurly’s Starter plan is listed at $249 per month plus a share of billing volume; see the pricing section on APIs.io for the details we have on file.
For the individual APIs, start with the Recurly Account API, the Recurly Billing Infos API and the Recurly Add On API, and browse the rest from the Recurly profile on APIs.io.
If recurring revenue is leaking out through failed cards and manual invoicing, pick the one capability above that hurts most and hand it to Recurly’s API first.
