# Recurly Invoice API **Canonical:** https://apis.io/apis/recurly/recurly-invoice-api/ **Provider:** Recurly — https://apis.io/providers/recurly/ **Base URL:** https://v3.recurly.com **Documentation:** https://recurly.com/developers/api/v2021-02-25/index.html Recurly Invoice API is one of 71 APIs that [Recurly](https://apis.io/providers/recurly/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification. This API exposes 17 JSON Schema definitions. Tagged areas include Invoices. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, a getting-started guide, a changelog, and 17 JSON Schemas. An invoice relates charges, credits, and payments together. When a subscription is created or renewed or a charge is created on the account, Recurly will sum the charges, discount or tax as appropriate, and send the invoice out for collection. ## Operations (18) | Method | Path | Summary | |---|---|---| | GET | `/accounts/{account_id}/invoices` | List an account's invoices | | POST | `/accounts/{account_id}/invoices` | Create an invoice for pending line items | | POST | `/accounts/{account_id}/invoices/preview` | Preview new invoice for pending line items | | GET | `/invoices` | List a site's invoices | | GET | `/invoices/{invoice_id}` | Fetch an invoice | | PUT | `/invoices/{invoice_id}` | Update an invoice | | GET | `/invoices/{invoice_id}.pdf` | Fetch an invoice as a PDF | | PUT | `/invoices/{invoice_id}/apply_credit_balance` | Apply available credit to a pending or past due charge invoice | | PUT | `/invoices/{invoice_id}/collect` | Collect a pending or past due, automatic invoice | | PUT | `/invoices/{invoice_id}/mark_failed` | Mark an open invoice as failed | | PUT | `/invoices/{invoice_id}/mark_successful` | Mark an open invoice as successful | | PUT | `/invoices/{invoice_id}/reopen` | Reopen a closed, manual invoice | | PUT | `/invoices/{invoice_id}/void` | Void a credit invoice | | POST | `/invoices/{invoice_id}/transactions` | Record an external payment for a manual invoices | | GET | `/invoices/{invoice_id}/related_invoices` | List an invoice's related credit or charge invoices | | POST | `/invoices/{invoice_id}/refund` | Refund an invoice | | GET | `/subscriptions/{subscription_id}/invoices` | List a subscription's invoices | | GET | `/business_entities/{business_entity_id}/invoices` | List a business entity's invoices | ## Machine-readable artifacts (32) - **OpenAPI** — https://artifacts.apis.io/recurly/openapi/recurly-invoice-api-openapi.yml - **Documentation** — https://docs.recurly.com/recurly-subscriptions/docs/integration-paths - **APIReference** — https://recurly.com/developers/api/v2021-02-25/index.html - **Authentication** — https://docs.recurly.com/recurly-subscriptions/docs/api-keys - **GettingStarted** — https://docs.recurly.com/recurly-subscriptions/docs/quick-start-guide - **Webhooks** — https://docs.recurly.com/recurly-subscriptions/docs/overview-webhooks - **ChangeLog** — https://recurly.com/developers/api/changelog.html - **SourceCode** — https://github.com/recurly/recurly-client-spec - **AsyncAPI** — https://artifacts.apis.io/recurly/asyncapi.yml - **JSONSchema** — https://artifacts.apis.io/recurly/json-schema/recurly-line-item-schema.json - **JSONSchema** — https://artifacts.apis.io/recurly/json-schema/recurly-subscription-create-schema.json - **JSONSchema** — https://artifacts.apis.io/recurly/json-schema/recurly-invoice-schema.json - **JSONSchema** — https://artifacts.apis.io/recurly/json-schema/recurly-subscription-schema.json - **JSONSchema** — https://artifacts.apis.io/recurly/json-schema/recurly-add-on-create-schema.json - **JSONSchema** — https://artifacts.apis.io/recurly/json-schema/recurly-purchase-create-schema.json - **APIReference** — https://recurly.com/developers/api-v2/v2.29/index.html - **Documentation** — https://docs.recurly.com/recurly-subscriptions/docs/upgrade-to-api-v3 - **Documentation** — https://docs.recurly.com/recurly-commerce/docs/getting-started - **JSONSchema** — https://artifacts.apis.io/recurly/json-schema/recurly-subscription-dto-schema.json - **JSONSchema** — https://artifacts.apis.io/recurly/json-schema/recurly-billing-attempt-dto-schema.json - **JSONSchema** — https://artifacts.apis.io/recurly/json-schema/recurly-subscription-create-request-dto-schema.json - **JSONSchema** — https://artifacts.apis.io/recurly/json-schema/recurly-subscription-line-dto-schema.json - **JSONSchema** — https://artifacts.apis.io/recurly/json-schema/recurly-subscription-offer-dto-schema.json - **JSONSchema** — https://artifacts.apis.io/recurly/json-schema/recurly-subscriber-dto-schema.json - **Documentation** — https://docs.recurly.com/recurly-recover/docs/getting-started - **JSONSchema** — https://artifacts.apis.io/recurly/json-schema/recurly-transaction-schema.json - **JSONSchema** — https://artifacts.apis.io/recurly/json-schema/recurly-recovery-invoice-create-schema.json - **JSONSchema** — https://artifacts.apis.io/recurly/json-schema/recurly-dunning-campaign-schema.json - **JSONSchema** — https://artifacts.apis.io/recurly/json-schema/recurly-invoice-collection-schema.json - **JSONSchema** — https://artifacts.apis.io/recurly/json-schema/recurly-dunning-campaign-list-schema.json - **Documentation** — https://docs.recurly.com/recurly-revrec/docs/getting-started - **Documentation** — https://docs.recurly.com/recurly-engage/docs/recurly-engage-sdk ## Other Recurly APIs (12) - [Recurly Compass MCP server](https://apis.io/apis/recurly/recurly-compass-mcp-server/) - [Recurly Account Acquisition Info API](https://apis.io/apis/recurly/recurly-account-acquisition-info-api/) - [Recurly Account API](https://apis.io/apis/recurly/recurly-account-api/) - [Recurly Account Note API](https://apis.io/apis/recurly/recurly-account-note-api/) - [Recurly Accounts API](https://apis.io/apis/recurly/recurly-accounts-api/) - [Recurly Add On API](https://apis.io/apis/recurly/recurly-add-on-api/) - [Recurly Adjustments API](https://apis.io/apis/recurly/recurly-adjustments-api/) - [Recurly Automated Exports API](https://apis.io/apis/recurly/recurly-automated-exports-api/) - [Recurly BaseOrderLineItems API](https://apis.io/apis/recurly/recurly-baseorderlineitems-api-api/) - [Recurly BaseOrders API](https://apis.io/apis/recurly/recurly-baseorders-api-api/) - [Recurly Billing Info API](https://apis.io/apis/recurly/recurly-billing-info-api/) - [Recurly Billing Infos API](https://apis.io/apis/recurly/recurly-billing-infos-api/) ## Tags Invoices --- Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/recurly/recurly-invoice-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/recurly/.