--- title: "Consulta una lista de promociones" method: GET path: "/api/v1/promociones" tags: ["Promociones"] --- # Consulta una lista de promociones `GET /api/v1/promociones` Devuelve las promociones de la agencia aplicando los filtros indicados. **Límite:** - 10 peticiones por minuto **Requisitos:** - `promociones_read` ## Query parameters - `OrdenarPor` 'Referencia' | 'FechaUltimaModificacion' | 'AnoConstruccion' - `MarcaAguaImagenes` boolean — Incluye la marca de agua a las imágenes. Por defecto true - `DescripcionImagenes` boolean — Añade las descripciones a las imágenes de las promociones. Por defecto false - `NumeroPagina` integer — Número de página a obtener (mínimo 1). - `TamanoPagina` integer — Número de elementos por página (máximo 100). - `Ordenacion` 'Ascendente' | 'Descendente' ## Response `200` OK - PromocionApiCollectionPagedResponse - `elementos` Promocion[], nullable - `portalId` integer, nullable - `idPromocion` integer, nullable - `referencia` string, nullable - `nombre` string, nullable - `disponible` boolean, nullable - `publicarEnWeb` boolean, nullable - `destacada` boolean, nullable - `tipoPromocion` TipoPromocion - `idTipoPromocion` integer, nullable - `tipo` string, nullable - `tipoEn` string, nullable - `tipoDe` string, nullable - `tipoFr` string, nullable - `tipoIt` string, nullable - `tipoCa` string, nullable - `tipoPt` string, nullable - `tipoGl` string, nullable - `tipoSv` string, nullable - `tipoRu` string, nullable - `tipoNl` string, nullable - `tipoNo` string, nullable - `tipoEu` string, nullable - `tipoUk` string, nullable - `tipoPl` string, nullable - `tipoComercializacion` TipoComercializacion - `idTipoComercializacion` integer, nullable - `tipo` string, nullable - `tipoEn` string, nullable - `tipoDe` string, nullable - `tipoFr` string, nullable - `tipoIt` string, nullable - `tipoCa` string, nullable - `tipoPt` string, nullable - `tipoGl` string, nullable - `tipoSv` string, nullable - `tipoRu` string, nullable - `tipoNl` string, nullable - `tipoNo` string, nullable - `tipoEu` string, nullable - `tipoUk` string, nullable - `tipoPl` string, nullable - `tipoVpo` TipoVpo - `idTipoVpo` integer, nullable - `tipo` string, nullable - `tipoEn` string, nullable - `tipoDe` string, nullable - `tipoFr` string, nullable - `tipoIt` string, nullable - `tipoCa` string, nullable - `tipoPt` string, nullable - `tipoGl` string, nullable - `tipoSv` string, nullable - `tipoRu` string, nullable - `tipoNl` string, nullable - `tipoNo` string, nullable - `tipoEu` string, nullable - `tipoUk` string, nullable - `tipoPl` string, nullable - `fechaCaptacion` string, date-time, nullable - `constructor` string, nullable - `promotor` string, nullable - `fechaEntrega` string, date-time, nullable - `anoConstruccion` integer, nullable - `piscina` boolean, nullable - `zonasComunes` boolean, nullable - `jardin` boolean, nullable - `trastero` boolean, nullable - `garaje` boolean, nullable - `poblacion` string, nullable - `provincia` string, nullable - `calle` string, nullable - `codigoPostal` string, nullable - `numero` string, nullable - `longitud` string, nullable - `latitud` string, nullable - `zoom` integer, nullable - `mostrarDireccionExacta` boolean, nullable - `tituloWeb` PromocionTituloWeb - `txtTituloWeb` string, nullable - `txtTituloWebCa` string, nullable - `txtTituloWebDe` string, nullable - `txtTituloWebEn` string, nullable - `txtTituloWebFr` string, nullable - `txtTituloWebGl` string, nullable - `txtTituloWebIt` string, nullable - `txtTituloWebNl` string, nullable - `txtTituloWebNo` string, nullable - `txtTituloWebPt` string, nullable - `txtTituloWebRu` string, nullable - `txtTituloWebSv` string, nullable - `txtTituloWebUk` string, nullable - `txtTituloWebEu` string, nullable - `txtTituloWebPl` string, nullable - `descripcionWeb` PromocionDescripcionWeb - `txtDescripcionWeb` string, nullable - `txtDescripcionWebCa` string, nullable - `txtDescripcionWebDe` string, nullable - `txtDescripcionWebEn` string, nullable - `txtDescripcionWebFr` string, nullable - `txtDescripcionWebGl` string, nullable - `txtDescripcionWebIt` string, nullable - `txtDescripcionWebNl` string, nullable - `txtDescripcionWebNo` string, nullable - `txtDescripcionWebPt` string, nullable - `txtDescripcionWebRu` string, nullable - `txtDescripcionWebSv` string, nullable - `txtDescripcionWebUk` string, nullable - `txtDescripcionWebEu` string, nullable - `txtDescripcionWebPl` string, nullable - `descripcionAmpliada` PromocionDescripcionAmpliada - `txtDescripcionAmpliada` string, nullable - `txtDescripcionAmpliadaCa` string, nullable - `txtDescripcionAmpliadaDe` string, nullable - `txtDescripcionAmpliadaEn` string, nullable - `txtDescripcionAmpliadaFr` string, nullable - `txtDescripcionAmpliadaGl` string, nullable - `txtDescripcionAmpliadaIt` string, nullable - `txtDescripcionAmpliadaNl` string, nullable - `txtDescripcionAmpliadaNo` string, nullable - `txtDescripcionAmpliadaPl` string, nullable - `txtDescripcionAmpliadaPt` string, nullable - `txtDescripcionAmpliadaRu` string, nullable - `txtDescripcionAmpliadaSv` string, nullable - `txtDescripcionAmpliadaUk` string, nullable - `txtDescripcionAmpliadaEu` string, nullable - `memoriaCalidades` PromocionMemoriaCalidades - `txtDescripcionCalidades` string, nullable - `txtDescripcionCalidadesCa` string, nullable - `txtDescripcionCalidadesDe` string, nullable - `txtDescripcionCalidadesEn` string, nullable - `txtDescripcionCalidadesFr` string, nullable - `txtDescripcionCalidadesGl` string, nullable - `txtDescripcionCalidadesIt` string, nullable - `txtDescripcionCalidadesNl` string, nullable - `txtDescripcionCalidadesNo` string, nullable - `txtDescripcionCalidadesPt` string, nullable - `txtDescripcionCalidadesRu` string, nullable - `txtDescripcionCalidadesSv` string, nullable - `txtDescripcionCalidadesUk` string, nullable - `txtDescripcionCalidadesEu` string, nullable - `txtDescripcionCalidadesPl` string, nullable - `urlVisitaVirtual` string, nullable - `fotos` PromocionMultimedia[], nullable - `url` string, nullable - `descripcion` string, nullable - `descripcionEn` string, nullable - `descripcionDe` string, nullable - `descripcionFr` string, nullable - `descripcionIt` string, nullable - `descripcionGl` string, nullable - `descripcionCa` string, nullable - `descripcionPt` string, nullable - `descripcionSv` string, nullable - `descripcionRu` string, nullable - `descripcionNl` string, nullable - `descripcionNo` string, nullable - `descripcionEu` string, nullable - `descripcionUk` string, nullable - `descripcionPl` string, nullable - `orden` integer, nullable - `destacada` boolean, nullable - `videos` PromocionMultimedia[], nullable - `url` string, nullable - `descripcion` string, nullable - `descripcionEn` string, nullable - `descripcionDe` string, nullable - `descripcionFr` string, nullable - `descripcionIt` string, nullable - `descripcionGl` string, nullable - `descripcionCa` string, nullable - `descripcionPt` string, nullable - `descripcionSv` string, nullable - `descripcionRu` string, nullable - `descripcionNl` string, nullable - `descripcionNo` string, nullable - `descripcionEu` string, nullable - `descripcionUk` string, nullable - `descripcionPl` string, nullable - `orden` integer, nullable - `destacada` boolean, nullable - `archivos` PromocionMultimedia[], nullable - `url` string, nullable - `descripcion` string, nullable - `descripcionEn` string, nullable - `descripcionDe` string, nullable - `descripcionFr` string, nullable - `descripcionIt` string, nullable - `descripcionGl` string, nullable - `descripcionCa` string, nullable - `descripcionPt` string, nullable - `descripcionSv` string, nullable - `descripcionRu` string, nullable - `descripcionNl` string, nullable - `descripcionNo` string, nullable - `descripcionEu` string, nullable - `descripcionUk` string, nullable - `descripcionPl` string, nullable - `orden` integer, nullable - `destacada` boolean, nullable - `inmuebles` string[], nullable - `totalElementos` integer - `pagina` integer - `tamanoPagina` integer --- [API](https://skmtc.net/mobiliagestion/apis/mobilia-public-api.md) · [All operations](https://skmtc.net/mobiliagestion/apis/mobilia-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mobiliagestion/mobilia-public-api/revisions/e774e9d40b9b/schema)