Listar todos los packs
Lista los packs de la empresa con paginación por cursor. - Filtra por search, slug (también encuentra slugs anteriores), sku, tag, channel, status, availability[in] y updated[gte]. - Ordena con sort por created, name o price (prefijo - para orden descendente). - view=storefront devuelve solo los packs a la venta en la web, sin campos internos. - Lecturas condicionales: envía If-None-Match para obtener 304 sin cuerpo.
Tu API key como token Bearer: fact_live_… en producción, fact_test_… en sandbox. Consulta la guía de autenticación.
En: header
Parámetros de ruta
Identificador público (UUID v7) de la empresa. Obtenlo de GET /v1/me (data.scope[].id).
uuidParámetros de consulta
Día (YYYY-MM-DD, zona horaria de la empresa) para el que se resuelve la promotion. Por defecto, hoy. Una fecha con hora usa su día.
Formato incorrecto: 400 parameter_invalid_iso8601.
Número de objetos a devolver, entre 1 y 100 (25 por defecto).
251 <= value <= 100Cursor de paginación hacia delante: pasa el id del último objeto de la página anterior (el next_cursor de la respuesta anterior).
uuidCursor de paginación hacia atrás: pasa el id del primer objeto de la página actual.
uuidSlug del pack. También encuentra los packs que lo usaron antes. Coincidencia exacta con slug.
SKU del pack. Coincidencia exacta con sku.
Etiqueta de clasificación. Coincidencia exacta con tag.
Canal de venta para el que está habilitado el pack: documents o web. Coincidencia exacta con channel.
"documents" | "web"Estado del pack: active, inactive o archived. Coincidencia exacta con status.
"active" | "inactive" | "archived"Disponibilidad: in_stock, low, out_of_stock o untracked. Admite varios valores con availability[in]. Coincidencia exacta con availability.
"in_stock" | "low" | "out_of_stock" | "untracked"Disponibilidad: in_stock, low, out_of_stock o untracked. Admite varios valores con availability[in]. Lista separada por comas. Coincide cualquiera de los valores.
Fecha de última actualización (ISO 8601). Mayor o igual que el valor indicado.
date-timeOrden: created, name, price ascendente, o con prefijo - para descendente (por defecto created, el más antiguo primero).
"created" | "-created" | "name" | "-name" | "price" | "-price"Búsqueda de texto libre. LIKE %term% escapado (sin distinguir mayúsculas, máx. 80 caracteres) sobre las columnas de texto clave del recurso, combinado con los demás filtros (AND) y compatible con el cursor.
length <= 80Forma del pack: all (por defecto) devuelve el pack completo y storefront solo lo que puede mostrar una tienda web, y únicamente de los packs a la venta ahí. Cualquier otro pack responde 404.
"all""all" | "storefront"Headers
Petición condicional: envía el ETag que guardaste de una respuesta anterior de esta operación (entrecomillado, tal como se recibió) para obtener 304 Not Modified sin cuerpo cuando el contenido no ha cambiado. Omítelo para recibir siempre la respuesta completa.
Fija la versión de la API (YYYY-MM-DD, versionado por fecha estilo Stripe) para esta petición; omítelo para usar la versión fijada de la clave, o la última si no hay ninguna. Versión no soportada → 400 unsupported_api_version; malformada → 400 parameter_invalid_format. La versión efectiva se refleja en la cabecera de respuesta Factuarea-Version. Consulta la guía de Versioning.
dateCuerpo de la respuesta
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json