> For the complete documentation index, see [llms.txt](https://docs.qentaz.com/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.qentaz.com/documentation/planes-y-suscripciones/consultar-suscripcion.md).

# Consultar Suscripción

Permite consultar la información de una suscripción existente a partir de su identificador visible. La respuesta incluye el estado actual de la suscripción, la información del cliente y el enlace para completar la vinculación del medio de pago cuando corresponda.

## Endpoint

<mark style="color:blue;">`GET`</mark> `{{base_url}}/subscription/{subscription_id}`

## **Headers**

| Name                                                   | Value            |
| ------------------------------------------------------ | ---------------- |
| `Content-Type`*<mark style="color:red;">**\***</mark>* | application/json |
| `x-auth-token`*<mark style="color:red;">**\***</mark>* | {token}          |
| `child-id`                                             | {business\_id}   |

{% hint style="info" %}
El child-id es opcional y se usa para las cuentas administradas para conocer más puedes ingresa a este [enlace](/documentation/cobros/terminos-de-relevancia.md#cuentas-administradas).
{% endhint %}

## **Parámetros**

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Campo</th><th width="120.39453125">Tipo</th><th width="119.5">Obligatorio</th><th>Descripción</th></tr></thead><tbody><tr><td><code>subscription_id</code></td><td>String</td><td>Sí</td><td>Identificador visible de la suscripción que se desea consultar.<br><br><em><mark style="color:blue;"><code>Ejemplo: B1B2B3B4</code></mark></em></td></tr></tbody></table>

***

## **Response**

{% tabs %}
{% tab title="200" icon="octagon-check" %}

```json
{
  "subscription_id": "B1B2B3B4",
  "plan_id": "A1A2A3A4",
  "status": "active",
  "subscription_url": "https://{host}/s/abc123",
  "customer": {
    "name": "Juan Pérez",
    "email": "cliente@correo.com",
    "phone": "3001234567",
    "id_type": "CC",
    "id_number": "1020304050"
  },
  "form_values": {
    "field_one": "Juan Pérez",
    "field_two": "cliente@correo.com",
    "field_three": "3001234567",
    "field_four": "1020304050"
  },
  "created_at": "2026-06-28T15:30:00Z"
}
```

{% endtab %}

{% tab title="400" icon="octagon-xmark" %}

```json
{
  "error": {
    "type": "bad_request",
    "message": "The request contains invalid or incomplete data.",
    "details": [
      {
        "field": "payment_policy.total_charges",
        "message": "total_charges must be between 1 and 12."
      }
    ]
  }
}
```

{% endtab %}

{% tab title="401" icon="hexagon-exclamation" %}

```json
{
  "error": {
    "type": "unauthorized",
    "message": "Authentication failed."
  }
}
```

{% endtab %}
{% endtabs %}

***

## Ejemplo

{% tabs %}
{% tab title="cURL" %}

```bash
curl --request GET \
  --url https://{{base_url}}/subscription/B1B2B3B4 \
  -H "x-auth-token: YOUR_SECRET_TOKEN"
```

{% endtab %}
{% endtabs %}