Saltar al contenido
Facturador

Ver suscriptor

GET /api/subscriptions/subscribers/{subscriber_id}

Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).

Devuelve el suscriptor con sus hijos, servidores y suscripciones.

Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor). Los registros de suscripciones son de toda la empresa: un vendedor ve y gestiona los mismos que el administrador.

Formato de respuesta: estándar {success, data, message?} (registro único).

Parámetros de la ruta:

Campo Tipo Obligatorio Descripción / valores permitidos
subscriber_id integer Sí Id del suscriptor (cliente).
Campo Tipo Descripción
id integer Id del suscriptor (es el id del cliente: el mismo customer_id de los comprobantes).
identity_document_type_id / number / name / trade_name string Identificación.
email / telephone / address / country_id / location_id string / array Contacto y dirección.
parent_id integer o null Suscriptor padre.
discord_user / slack_channel / discord_channel / gitlab_user string o null Datos extra.
subscriptions_count integer Suscripciones del cliente.

Además: children[] {id, name, number, identity_document_type_id}, servers[] {id, host, ip, user, has_password} (la contraseña nunca se devuelve) y subscriptions[] {id, plan_id, plan_name, status, start_date, total}.

Errores:

  • 404 si el registro no existe.
  • 401 sin token o con un token inválido.

Parámetros

Parámetro Dónde Obligatorio Ejemplo Descripción
subscriber_id ruta sí 1520

Respuestas

200 — Suscriptor

{
  "success": true,
  "data": {
    "id": 1520,
    "identity_document_type_id": "1",
    "number": "45879632",
    "name": "MARÍA FERNANDA QUISPE ROJAS",
    "trade_name": null,
    "email": "maria.quispe@correo.pe",
    "telephone": "987654321",
    "address": "Av. Arequipa 1450, Lince",
    "country_id": "PE",
    "location_id": [
      "15",
      "1501",
      "150116"
    ],
    "parent_id": null,
    "discord_user": "mquispe",
    "slack_channel": null,
    "discord_channel": "#socios-gold",
    "gitlab_user": null,
    "subscriptions_count": 1,
    "children": [
      {
        "id": 1533,
        "name": "DIEGO QUISPE ROJAS",
        "number": "78451236",
        "identity_document_type_id": "1"
      }
    ],
    "servers": [
      {
        "id": 12,
        "host": "vps1.midominio.pe",
        "ip": "190.12.45.8",
        "user": "deploy",
        "has_password": true
      }
    ],
    "subscriptions": [
      {
        "id": 48,
        "plan_id": 3,
        "plan_name": "Plan Mensual Gold",
        "status": "authorized",
        "start_date": "2026-11-14",
        "total": 118.0
      }
    ]
  }
}

404 — No existe

{
  "success": false,
  "message": "Registro no encontrado."
}

Pruébalo

Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.