GEThttps://api.veriko.mx/v1/plans/public

Listar el catálogo público de planes

Audiencia: public

Devuelve el catálogo de planes para las superficies sin autenticación (la landing /pricing y los widgets embebibles).

La operación es pública, tiene límite de tasa por IP y se almacena en caché durante 5 minutos. Sólo incluye planes activos y públicos (is_active = 1 e is_public = 1); cada uno lleva sus prices[] activos en el modo de cobro vigente y sus features[] bilingües activas.

No todos los planes se venden en todos los intervalos: un plan sin precio anual no trae filas con billing_interval: year. Ofrece sólo las combinaciones que aparecen en prices[].

Petición

cURLPython•JavaScript•PHP•

curl -X GET 'https://api.veriko.mx/v1/plans/public'

Ejemplo en Python — próximamente.

Ejemplo en JavaScript — próximamente.

Ejemplo en PHP — próximamente.

**Respuesta 200**`ListPublicPlansResponse` — Planes activos y públicos con precios y características activas embebidas.
Campo	Tipo	Descripción
`data`	`array`	Payload principal de la respuesta. La forma varía según el endpoint (objeto, array, o envelope JSON:API con `type`, `id`, `attributes`).
`type`*	`string`	Tipo de recurso JSON:API. Siempre `plan`. p. ej. `plan`
`id`*	`string`	Identificador único y legible del plan. p. ej. `pro`
`attributes`*	`object`	Datos del recurso, separados de su identidad.
`slug`*	`string`	Identificador único y legible del plan. Tiene el mismo valor que `id`. p. ej. `pro`
`name`*	`string`	Nombre del plan que muestran las interfaces. p. ej. `Pro`
`billing_model`*	`string`	Modelo de facturación del plan — `free`: Sin cobro; `tiered`: Cuota fija; `metered`: Cobro por consumo; `hybrid`: Cuota fija más consumo. p. ej. `free`
`monthly_validation_limit`*	`integer`	Tope de validaciones por ciclo de la suscripción. `0` no permite validaciones. p. ej. `5000`
`included_validations`*	`integer \| null`anulable	Validaciones incluidas en la cuota base antes del cobro por excedentes. `null` cuando el plan no tiene cuota base. p. ej. `5000`
`trial_days`*	`integer \| null`anulable	Días de prueba gratuita. `null` o `0` cuando el plan no ofrece prueba gratuita. p. ej. `14`
`is_default`*	`boolean`	`true` cuando es el plan asignado por defecto a las cuentas nuevas. p. ej. `true`
`sort_order`*	`integer`	Posición de ordenamiento para listar el plan dentro del catálogo (ascendente). p. ej. `20`
`prices`*	`array`	Precios activos del plan, uno por combinación de moneda, intervalo de facturación y modalidad.
`features`*	`array`	Características bilingües activas del plan, ordenadas por `sort_order`.
`meta`	`object`	Metadatos de la respuesta, incluyendo versión de la API, prefijo de ruta, identificador único de la petición y marca temporal del servidor en UTC.
`version`	`string`	Versión de la API que procesó la petición. p. ej. `1.47.0`
`api_version`	`string`	Versión del prefijo de ruta de la API (ej. `v1`). p. ej. `v1`
`request_id`	`string`	Identificador único de la petición (hex). p. ej. `a1b2c3d4e5f66f5e4d3c2b1a`
`datetime`	`object`	Descriptor compañero presente en el bloque `meta` de cada respuesta (y en el `meta` del cuerpo de los webhooks salientes). Permite a los clientes afirmar el contrato de zona horaria sin releer el spec. p. ej. `{"timezone":"UTC","format":"ISO 8601"}`
`timezone`*	`string`	Siempre `UTC`: La zona canónica para cada campo datetime del cuerpo. p. ej. `UTC`
`format`*	`string`	Siempre `ISO 8601`: Sufijo `Z` explícito en cada datetime. p. ej. `ISO 8601`
`links`	`object`	Enlaces de paginación o relacionados, presentes solo cuando el endpoint devuelve una colección paginada.

**Códigos de respuesta**`GET /v1/plans/public`
Código	Clase	Descripción	Cuerpo
200	`2xx`	Planes activos y públicos con precios y características activas embebidas.	`ListPublicPlansResponse`
429	`4xx`	Límite de tasa excedido	`ErrorResponse`

**Cabeceras de respuesta**`200`
Cabecera	Tipo	Descripción
`Cache-Control`	`string`	Directiva de caché pública: `public, max-age=300`.

**Errores de `GET /v1/plans/public`**
Código	Clave	Ejemplo
429	`rate_limit_exceeded`	Límite de peticiones excedido. Inténtalo de nuevo en 45 segundos. Envelope meta.request_id `f7a8b9c0d1e22e1d0c9b8a7f` Cabeceras de respuesta `Retry-After`: integer — Segundos a esperar antes de reintentar. Coincide con la ventana de rate-limit del endpoint (típicamente 60s para listas, 1-5s para operaciones idempotentes en vuelo). `X-RateLimit-Limit`: integer — Límite de solicitudes configurado para este bucket. Se emite en cada 429 y, en la API autenticada, también en las respuestas correctas, donde es el tope por clave del plan de la cuenta. `X-RateLimit-Remaining`: integer — Solicitudes restantes en la ventana actual. Siempre 0 en el momento del 429; en una respuesta correcta de la API autenticada es lo que queda del tope por clave. `X-RateLimit-Reset`: integer — Unix epoch absoluto (segundos) en que se reinicia la ventana. Se emite en cada 429, junto con Retry-After, y en las respuestas correctas de la API autenticada. Puede existir sobreescritura por endpoint (p. ej. `rate_limited_login`).