---
product_landing_hero:
 - title: Subscriptions
 - message: The Subscriptions API allows creating and managing automatic recurring charges. Define the frequency and amount; Mercado Pago handles the billing and retries if a payment is declined. This reference describes the available endpoints and how to interact with them.
 - info: Looking for integration steps? [Go to the Subscriptions documentation](/developers/en/docs/subscriptions/overview)
---

## Available endpoints

All endpoints that make up the Subscriptions API integration.

:::AccordionComponent{title="Subscriptions" pill="Core"}

A subscription is the central object of the integration. It can be created directly with the subscriber's payment method or linked to an existing plan.

| Operation | Path | Description |
|---|---|---|
| :TagComponent{tag="POST" text="Create subscription" href="/developers/en/reference/online-payments/subscriptions/create-preapproval/post" color="green"} | `/preapproval` | Creates a subscription with amount, frequency and the subscriber's payment method; can be linked to a plan or configured independently. |
| :TagComponent{tag="GET" text="Search subscriptions" href="/developers/en/reference/online-payments/subscriptions/search-preapproval/get" color="accent"} | `/preapproval/search` | Searches subscriptions by filters such as status, `preapproval_plan_id` or payer; returns paginated results. |
| :TagComponent{tag="GET" text="Get subscription" href="/developers/en/reference/online-payments/subscriptions/get-preapproval/get" color="accent"} | `/preapproval/{id}` | Returns the status and details of a subscription by its ID. |
| :TagComponent{tag="PUT" text="Update subscription" href="/developers/en/reference/online-payments/subscriptions/update-preapproval/put" color="orange"} | `/preapproval/{id}` | Updates subscription data such as status, amount or payment method. |
| :TagComponent{tag="GET" text="Export subscriptions" href="/developers/en/reference/online-payments/subscriptions/export-preapproval/get" color="accent"} | `/preapproval/export` | Exports a CSV file with the subscriptions matching the search parameters. |

:::

:::AccordionComponent{title="Plans" pill="Core"}

A plan defines the billing parameters shared by a group of subscribers: amount, frequency and payment method configuration.

| Operation | Path | Description |
|---|---|---|
| :TagComponent{tag="POST" text="Create subscription plan" href="/developers/en/reference/online-payments/subscriptions/create-preapproval-plan/post" color="green"} | `/preapproval_plan` | Creates a subscription template with fixed frequency and amount to link multiple subscribers. |
| :TagComponent{tag="GET" text="Search plans" href="/developers/en/reference/online-payments/subscriptions/search-preapproval-plan/get" color="accent"} | `/preapproval_plan/search` | Searches subscription plans by filters such as status or name; returns paginated results. |
| :TagComponent{tag="GET" text="Get subscription plan" href="/developers/en/reference/online-payments/subscriptions/get-preapproval-plan/get" color="accent"} | `/preapproval_plan/{id}` | Returns the details of a subscription plan by its ID. |
| :TagComponent{tag="PUT" text="Update subscription plan" href="/developers/en/reference/online-payments/subscriptions/update-preapproval-plan/put" color="orange"} | `/preapproval_plan/{id}` | Updates the data of an existing subscription plan. |

:::

:::AccordionComponent{title="Invoices" pill="Core"}

An invoice represents each recurring charge generated by a subscription, including the status and result of the corresponding billing attempt.

| Operation | Path | Description |
|---|---|---|
| :TagComponent{tag="GET" text="Get invoice data" href="/developers/en/reference/online-payments/subscriptions/get-authorized-payment/get" color="accent"} | `/authorized_payments/{id}` | Returns the details of an invoice (authorized charge) for a subscription by its ID. |
| :TagComponent{tag="GET" text="Search invoices" href="/developers/en/reference/online-payments/subscriptions/authorized-payment-search/get" color="accent"} | `/authorized_payments/search` | Searches invoices by filters such as `preapproval_id` or status; returns paginated results. |

:::

:::AccordionComponent{title="Payments" pill="Query"}

Payments are the transactions linked to a subscription's invoices. Use them to verify the status and final details of each processed charge.

| Operation | Path | Description |
|---|---|---|
| :TagComponent{tag="GET" text="Search payments" href="/developers/en/reference/online-payments/subscriptions/search-payments/get" color="accent"} | `/v1/payments/search` | Searches payments associated with a subscription by filters such as date or status; covers the last 12 months. |
| :TagComponent{tag="GET" text="Get payment" href="/developers/en/reference/online-payments/subscriptions/get-payment/get" color="accent"} | `/v1/payments/{id}` | Returns the status and details of a payment by its ID. |

:::

<br>
<br>

---
product_landing_how_integrate:
 - title: All set to get started?
 - sub_title: Go to the first endpoint and start creating your first subscriptions.
 - button_description: Create subscription
 - button_link: /developers/en/reference/online-payments/subscriptions/create-preapproval/post
---