---
title: "Validate Monthly Installments"
method: POST
path: "/monthly_installments/validate"
tags: ["Monthly Installments"]
---

# Validate Monthly Installments

`POST /monthly_installments/validate`

## Request

- Base URL: `https://api.conekta.io`
- URL: `https://api.conekta.io/monthly_installments/validate`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/conekta/apis/conekta-api/docs/monthly_installments/validate/post.ts> (a function with typed inputs; its response is checked against the schema)

Returns the interest-free monthly installment plans available for a card BIN and an amount, so a checkout can offer only the plans a later charge will accept. Requires monthly installments to be enabled on the company.

## Headers

- `Accept-Language` 'es' | 'en'

## Request body

- MonthlyInstallmentsValidateRequest: BIN and amount to evaluate for interest-free monthly installments
  - `bin` string, required: First 6 or 8 digits of the card number (Bank Identification Number). An 8 digit BIN that yields no match is retried with its first 6 digits.
  - `amount` integer, required: Amount to charge in the smallest currency unit (cents for MXN). Used to compute the monthly fee of each available plan.

## Response `200`

successful operation

- MonthlyInstallmentsValidateResponse: monthly installments validate response
  - `available_installments` MonthlyInstallmentsValidateResponseAvailableInstallments[], required: Interest-free monthly installment plans available for this card and amount. Empty when the card does not qualify for monthly installments, for example a debit card or a credit card not issued in Mexico. An empty array is not an error.
    - `months` integer, required: Number of monthly installments of the plan. One of 3, 6, 9, 12, 18 or 24.
    - `amount` integer, required: Amount of each monthly installment in the smallest currency unit, rounded up.
  - `bin_info` MonthlyInstallmentsValidateResponseBinInfo, required
    - `country` string, required: Country that issued the card. Monthly installments only apply to mx, with the exception of American Express.
    - `scheme` string, required: Card scheme. Monthly installments only apply to credit.
    - `issuer` string, required: Bank that issued the card.

## Other responses

- `401`: authentication error
- `422`: parameter validation error
- `500`: internal server error

## Changes

- **2026-11-03** `52f4c0dd8a1b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/conekta/apis/conekta-api/changes/monthly_installments/validate/post.md)

---

[API](https://skmtc.dev/conekta/apis/conekta-api.md) - [All operations](https://skmtc.dev/conekta/apis/conekta-api/llms.txt) - [OpenAPI document](https://skmtc.dev/conekta/apis/conekta-api/revisions/52f4c0dd8a1b?raw)
