Listar el catálogo público de planes

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

Audiencia: public

Catálogo de planes para superficies sin autenticación (landing /pricing, widgets embebibles). Operación pública, con límite de tasa por IP y caché de cinco minutos. Devuelve los planes con is_active = 1 Y is_public = 1. Cada uno incluye prices[] ya filtrados a los is_active = 1 y features[] bilingüe (también activos). No expone stripe_product_id, stripe_price_id, user_count ni timestamps internos — la resolución de stripe_price_id ocurre server-side cuando se crea la Checkout Session. Caché: Cache-Control: public, max-age=300 (5 min).

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 + públicos con precios y viñetas 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 del recurso, fijo para esta operación. Forma parte de la identidad del recurso en la envoltura JSON:API. Siempre `plan`. p. ej. `plan`
`id`*	`string`	Slug del plan. p. ej. `pro`
`attributes`*	`object`	Atributos del recurso: los datos propiamente dichos, separados de su identidad.
`slug`*	`string`	Identificador legible del plan (slug), estable y único; el mismo valor que `id`. p. ej. `pro`
`name`*	`string`	Nombre visible del plan para mostrar en la interfaz. p. ej. `Pro`
`billing_model`*	`string`	Modelo de cobro del plan — `free` (sin costo), `tiered` (escalones fijos), `metered` (por uso) o `hybrid` (base + uso). p. ej. `free`
`monthly_validation_limit`	`integer \| null`anulable	Tope mensual de verificaciones permitidas por el plan; `null` significa sin tope. p. ej. `5000`
`included_validations`	`integer \| null`anulable	Verificaciones incluidas sin costo adicional dentro de la cuota base; `null` cuando no aplica. p. ej. `5000`
`trial_days`	`integer \| null`anulable	Duración del periodo de prueba gratuita en días; `null` o `0` cuando el plan no ofrece prueba. p. ej. `14`
`is_default`	`boolean`	Indica si 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 del plan, uno por combinación de periodicidad y moneda.
`features`*	`array`	Features incluidas en el plan, en el orden en que se muestran.
`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. `a1b2c3d4e5f6`
`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 + públicos con precios y viñetas embebidas.	`ListPublicPlansResponse`
429	`4xx`	Límite de tasa excedido	`ErrorResponse`

**Cabeceras de respuesta**`200`
Cabecera	Tipo	Descripción
`Cache-Control`	`string`	`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 `f7a8b9c0d1e2` 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 (emitido sólo en 429). `X-RateLimit-Remaining`: integer — Solicitudes restantes en la ventana actual — siempre 0 en el momento del 429 (emitido sólo en 429). `X-RateLimit-Reset`: integer — Unix epoch absoluto (segundos) en que se reinicia la ventana. Emitido sólo en 429, junto con Retry-After. Puede existir sobreescritura por endpoint (p. ej. `rate_limited_login`).