# Query available plans

Returns the available installment plans for the card BINs and order amount informed.

**PATCH** `/instore/v2/external/orders/{order_id}/plans`

## Request parameters

### Header

- `Authorization` (string, required)
  Bearer access token.

- `trace-id` (string, required)
  Traceability identifier.

### Path

- `order_id` (string, required)
  Order ID returned by the Resolve QR endpoint (order.id).

- `bins` (array, optional)
  List of card BINs to query.

  - `bins[].original_bin` (string, optional)
  Card BIN (6 or 8 digits).

  - `bins[].issuer_id` (string, optional)
  Card issuer code.

  - `bins[].type` (string, optional)
  Card type: CREDIT or DEBIT.

  - `bins[].brand_id` (string, optional)
  Card brand: VISA, MASTER, AMEX, etc.

- `amount` (object, optional)

  - `amount.value` (number, optional)
  Total order amount.

  - `amount.currency` (string, optional)
  Order currency. For Argentina: ARS.

- `additional_info` (object, optional)
  Additional information. Send an empty object {}.

## Response parameters

- `supported_bins` (array, optional)

  - `supported_bins[].brand_id` (string, optional)

  - `supported_bins[].type` (string, optional)

  - `supported_bins[].original_bins` (array, optional)

  - `supported_bins[].plans` (array, optional)

  - `supported_bins[].plans[].id` (string, optional)

  - `supported_bins[].plans[].type` (string, optional)

  - `supported_bins[].plans[].description` (string, optional)

  - `supported_bins[].plans[].installments` (integer, optional)

  - `supported_bins[].plans[].total_amount` (object, optional)

  - `supported_bins[].plans[].total_amount.value` (number, optional)

  - `supported_bins[].plans[].total_amount.currency` (string, optional)

  - `supported_bins[].plans[].installment_amount` (object, optional)

  - `supported_bins[].plans[].installment_amount.value` (number, optional)

  - `supported_bins[].plans[].installment_amount.currency` (string, optional)

  - `supported_bins[].plans[].financial_info` (object, optional)

  - `supported_bins[].plans[].financial_info.total_financial_cost` (string, optional)

  - `supported_bins[].plans[].financial_info.nominal_annual_rate` (string, optional)

  - `supported_bins[].plans[].required_fields` (array, optional)

- `unsupported_bins` (array, optional)

- `additional_info` (optional)

## Errors

| Status | Error | Description |
| ------- | ------- | ----------- |
| 404 | — | Not Found |
| 500 | — | Internal Server Error |

## Request example

### cURL

```bash
curl -X PATCH \
  'https://api.mercadopago.com/instore/v2/external/orders/{order_id}/plans' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <ACCESS_TOKEN>' \
  -d '{
  "bins": [
  {
  "original_bin": "400103",
  "issuer_id": "310",
  "type": "CREDIT",
  "brand_id": "VISA"
  }
  ],
  "amount": {
  "value": 300.5,
  "currency": "ARS"
  },
  "additional_info": {}
  }'
```

## Response example

```json
{
  "supported_bins": [
  {
  "brand_id": "VISA",
  "type": "CREDIT",
  "original_bins": [
  "400103"
  ],
  "plans": [
  {
  "id": null,
  "type": null,
  "description": null,
  "installments": null,
  "total_amount": null,
  "installment_amount": null,
  "financial_info": null,
  "required_fields": null
  }
  ]
  }
  ],
  "unsupported_bins": [],
  "additional_info": null
}
```