NAV Kelisto logo
shell

Introduction

The Kelisto API is organized around REST. Our API is designed to have predictable, resource-oriented URLs and to use HTTP response codes to indicate API errors. We use built-in HTTP features, like HTTP verbs, which can be understood by off-the-shelf HTTP clients.

JSON will be returned in all responses from the API, including errors.

To make the OctKelistoobat API as secure as possible. Authentication is performed through API Token.

Authentication

# Example request
$ curl https://api.kelisto.es/api/:api_version/:endpoint?apikey=YOUR_API_TOKEN

Authentication to the API occurs via API token. All API requests must be made over HTTPS. You must authenticate for all requests. Your API keys carry many privileges, so be sure to keep them secret!

Versioning

Releases

# Definition
https://api.kelisto.es/api/:api_version/

# Last stable base URL
https://api.kelisto.es/api/v3/
Release  Start
v3 Last stable Feb 2020
v2  Jun 2019
v1 Jan 2017

Pagination

All top-level Kelisto API resources have support for bulk fetches “list” API methods. For instance, you can list broadbands, list bank accounts.

 The pagination object

 Attributes

# Example request
$ curl http://api.kelisto.es/api/v3/communications/offers/internet?product_name=internet_tv_mobile
# Example object
{
  "pagination": {
    "links": {
      "first": "http://api.kelisto.es/api/v3/communications/offers/internet?product_name=internet_tv_mobile&page=1",
      "next": "http://api.kelisto.es/api/v3/communications/offers/internet?product_name=internet_tv_mobile&page=2",
      "last": "http://api.kelisto.es/api/v3/communications/offers/internet?product_name=internet_tv_mobile&page=5"
    },
    "current_page": 1,
    "page_items": 25,
    "total_count": 110,
    "total_pages": 5
  },
  "data": [
    {...}
  ]
},
Attribute  Description
links hash Links to next pages.
current_page integer Current items shown.
page_items integer Maximum elements by page. Default is 25.
total_count integer Total number of elements stored for this item.
total_pages integer Maximum numbers of pages.
data array An array containing the actual response elements, paginated by any request parameters.

Arguments

Argument  Description
page optional A cursor to fetch a specific page.
limit optional A limit on the number of objects to be returned. Must be included between 1 and 100

Errors

Kelisto API uses conventional HTTP response codes to indicate the success or failure of an API request. In general: Codes in the 2xx range indicate success. Codes in the 4xx range indicate an error that failed given the information provided. Codes in the 5xx range indicate an error with Kelisto's servers.

HTTP Status code summary

Code Meaning
200  OK. Everything worked as expected.
400  Bad Request. The request was unacceptable, often due to missing a required parameter.
401  Unauthorized. No valid API key provided.
402 Request Failed. The parameters were valid but the request failed.
403  Forbidden. The API key doesn't have permissions to perform the request.
404 Not Found. The requested resource doesn't exist.
429  Too Many Requests. Too many requests hit the API too quickly.
5xx  Server Errors. Something went wrong on Kelisto's end.

 API Communications

Internet offers

The internet offer object

Attributes

# Example object

{
  "id": 1165,
  "name": "Love Medio Max 300 Mb + Netflix",
  "slug": "love-100-mb-medio-max",
  "product_name": "internet_tv_mobile",
  "product_type": "internet",
  "claim": "¡Amazon prime 12 meses gratis!",
  "starred": false,
  "best_buy": false,
  "sponsored": false,
  "updated_at": "2020-06-18T18:10:40.908+02:00",
  "description": "<p>Con la tarifa <strong>Love Medio Max</strong> de <strong>Orange</strong> no solo disfrutarás de Internet en casa y desde el móvil, también tendrás acceso a todo el contenido de la plataforma de Netflix. Todas las tarifas Love de Orange pueden combinarse para que el usuario elija las condiciones que quiera, pero en este caso el paquete incluye <strong>300 Mb de fibra simétricos</strong>, lo que quiere decir que dispondrás de la misma velocidad al subir y al descargar archivos. Tampoco tendrás problemas para navegar desde diferentes dispositivos a la vez a través del Wifi de casa. Vinculada a la fibra, tendrás también una <strong>línea de telefonía fija gratis</strong> con llamadas ilimitadas a otros fijos y 1.000 minutos para hablar con móviles.</p>\n\n<p>Esta oferta  incluye dos líneas móviles, la primera ofrece llamadas ilimitadas  y 25 GB a compartir con una segunda línea que además ofrece llamadas a 0 cént/min.Si eres de los que ven a menudo contenido en <em>streaming</em>, sueles jugar online o te gusta estar siempre conectado, no tendrás que preocuparte por si te pasas de megas. Con respecto a las llamadas, tendrás <strong>minutos ilimitados</strong> para hablar con móviles y fijos nacionales, con el establecimiento de llamada incluido. Como es habitual compartir tarifa entre varios usuarios, a tu paquete Love podrás <strong>añadirle las líneas de móvil adicionales</strong> que necesites  por un pequeño extra en tu cuota mensual y así asociar todos tus números a tu contrato.</p>\n\n<p>Además, con esta tarifa también incluye <strong>Netflix</strong>, que solo te costará dos euros al mes (ya incluidos en el precio final), mucho menos que si te suscribieras a la plataforma por tu cuenta. Si quieres completar tu contenido, también puedes contratar los paquetes de <em>streaming</em> que ofrece el operador: Orange TV Cine y Series y Orange TV Fútbol. Recuerda, eso sí, que esta oferta tiene un <strong>compromiso de permanencia de 12 meses</strong>. Y para rematar esta oferta, Orange te regala una <strong>suscripción gratis a Amazon Prime</strong> para que puedas disfrutar de todas sus ventajas durante un año.</p>\n",
  "contract_length": 12,
  "free_featured_label": "Promo por Navidad",
  "free_featured_label_description": "Promoción valida solo por navidad ",
  "has_deal": true,
  "url": "//comunicacion.kelisto.es/landings/orange/love-100-mb-medio-max?utm_term=comparadores_Kelisto_COMPARADOR_1_RES_PC",
  "has_cpa_deal": true,
  "cpa_redirect_url": "url.to/cpa",
  "prices": {
    "price": 69.95,
    "line_rental": 0,
    "router_price": 0,
    "router_delivery_cost": 0,
    "installation_price": 0,
    "line_installation_price": 0,
    "annual_price": 629.58,
    "current_monthly_price": 34.98
  },
  "internet": {
    "speed_download": 300,
    "speed_upload": 300,
    "internet_type": "optical_fiber",
    "symmetric": true
  },
  "landing": {
    "title": "Disfruta de Amazon prime 12 meses gratis",
    "legal": null
  },
  "has_landline": true,
  "landline": {
    "line_rental": 0,
    "minutes_to_mobile": 1000,
    "minutes_to_landline": 999999999,
    "connection_charge": 0
  },
  "has_mobile": true,
  "mobile": {
    "minutes": 999999999,
    "included_lines": 2,
    "data": 25000,
    "minutes_excess": "Sin coste",
    "data_excess": "la velocidad se reduce hasta 16kbps",
    "connection_charge": 0,
    "network": "Orange",
    "roaming": null,
    "coverage": "4g",
    "additional_lines": [
      {
        "name": "Smartphone Sin Límites",
        "data": "datos a compartir con la principal",
        "minutes": "min. ilimitados",
        "price": 15.95
      },
      {
        "name": "Smartphone 200 min.",
        "data": "datos a compartir con la principal",
        "minutes": "200 min.",
        "price": 11.95
      },
      {
        "name": "Orange Bono 2 GB ",
        "data": "2 GB a compartir con la principal",
        "minutes": "0 min.",
        "price": 8.95
      },
      {
        "name": "Orange Bono 5 GB ",
        "data": "5 GB a compartir con la principal",
        "minutes": "0 min.",
        "price": 14.95
      },
      {
        "name": "Orange Bono 10 GB ",
        "data": "10 GB a compartir con la principal",
        "minutes": "0 min.",
        "price": 19.95
      },
      {
        "name": "Bono Datos",
        "data": "datos a compartir con la principal",
        "minutes": "0 min.",
        "price": 7.95
      }
    ]
  },
  "has_tv": true,
  "tv": {
    "description": "<p>Netflix incluido</p>\n",
    "claim": "Netflix",
    "tv_channels": [
      {
        "name": "Netflix",
        "type": "Series",
        "image": {
          "url": "http://api.kelisto.es/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBTZz09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--d39299e21308db8554af50aa2c8c3b011c5d8519/netflix.jpg"
        }
      },
      {
        "name": "amazon prime video",
        "type": "Cine",
        "image": {
          "url": "http://api.kelisto.es/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBY1E9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--8c511301a0fe022fe67ac307cda40e7772328f9f/amazon%20prime%20video%202.jpg"
        }
      }
    ]
  },
  "has_promo": true,
  "promo": {
    "starts_at": null,
    "expires_at": "2020-06-30T23:54:00.000+02:00",
    "claim": "Pack Orange TV Total por 29,95€/mes",
    "description": "<p>Disfruta de un <strong>50% de descuento durante 6 meses</strong>.<br>\nAdemás llévate Amazon prime durante 12 meses gratis y añade <strong>todo el fútbol más el cine y series</strong> tan solo te costará <strong>29,95 euros al mes</strong> gracias al pack <strong>Orange TV Total</strong>.</p>\n",
    "months": 6,
    "monthly_price": 34.98,
    "type": "price"
  },
  "provider": {
    "id": 7,
    "name": "Orange",
    "network": "Orange",
    "roaming": null,
    "slug": "orange",
    "title": null,
    "phone_number": "900263196",
    "image": {
      "url": "http://api.kelisto.es/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBEQT09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--459c6a8cd2eeab5bfea05a902bb98c7c38c90ba4/orange.jpg"
    },
    "description": null
  },
  "ratings": {
    "rating": 8.9,
    "price": 8,
    "speed": 8,
    "minutes": 10,
    "data": 10
  },
  "has_review": false
}
Attribute Description
id integer Unique identifier for the resource.
name string Offer name.
slug string  Unique url identifier for the resource.
product_name string  The specific product name. Its value should be one of these: broadband, internet_mobile, internet_tv, internet_tv_mobile and wifi4g.
product_type string  Product type identifier internet.
claim string Short offer description.
starred boolean -
best_buy boolean Returns true if the offer is a best buy, elsewhere false.
sponsored boolean Returns true if the offer is sponsored, elsewhere false.
updated_at timestamp Last update time.
description string Description using HTML format.
contract_length integer Number of months of contract length.
free_featured_label string Returns a free label created by the PM, for special occasions, example: Promo blackfriday.
free_featured_label_description text Returns the description of the free label.
has_deal boolean Return true if Kelisto has a deal for this offer with its provider.
url string Offer landing page URL.
has_cpa_deal boolean Returns true if CPA redirection is active.
cpa_redirect_url string Offer CPA page URL.
prices hash Price object.
internet hash Internet object.
landing hash Landing object.
has_landline boolean Returns true if the current offer has landlines hash attributes.
landline optional, hash Landline object.
has_mobile boolean Returns true if the current offer has mobile hash attributes.
mobile optional, hash Mobile object.
has_tv boolean Returns true if the current offer has tv hash attributes.
tv optional, hash TV object.
has_promo boolean Returns true if the current offer has promo hash attributes.
promo optional, hash Promo object.
provider hash Provider object.
has_review boolean Returns true if the current offer has review hash attributes.
review optional, hash Review object.
ratings hash Ratings object.
promoted_offers optional, array Array with promoted Internet objects for offer provider. ONLY available on OD endpoint

Retrieve an internet offer

# Definition
GET https://api.kelisto.es/api/v3/communications/offers/internet/:slug?provider_slug=:provider_slug&product_name=:product_name

# Example request
$ curl https://api.kelisto.es/api/v3/communications/offers/internet/love-100-mb-medio-max?provider_slug=orange&product_name=internet_tv_mobile
# Example response

{
  "data": {
    "id": 1165,
    "name": "Love Medio Max 300 Mb + Netflix",
    "slug": "love-100-mb-medio-max",
    "product_name": "internet_tv_mobile",
    "product_type": "internet",
    "claim": "¡Amazon prime 12 meses gratis!",
    "starred": false,
    "best_buy": false,
    "sponsored": false,
    "updated_at": "2020-06-18T18:10:40.908+02:00",
    "description": "<p>Con la tarifa <strong>Love Medio Max</strong> de <strong>Orange</strong> no solo disfrutarás de Internet en casa y desde el móvil, también tendrás acceso a todo el contenido de la plataforma de Netflix. Todas las tarifas Love de Orange pueden combinarse para que el usuario elija las condiciones que quiera, pero en este caso el paquete incluye <strong>300 Mb de fibra simétricos</strong>, lo que quiere decir que dispondrás de la misma velocidad al subir y al descargar archivos. Tampoco tendrás problemas para navegar desde diferentes dispositivos a la vez a través del Wifi de casa. Vinculada a la fibra, tendrás también una <strong>línea de telefonía fija gratis</strong> con llamadas ilimitadas a otros fijos y 1.000 minutos para hablar con móviles.</p>\n\n<p>Esta oferta  incluye dos líneas móviles, la primera ofrece llamadas ilimitadas  y 25 GB a compartir con una segunda línea que además ofrece llamadas a 0 cént/min.Si eres de los que ven a menudo contenido en <em>streaming</em>, sueles jugar online o te gusta estar siempre conectado, no tendrás que preocuparte por si te pasas de megas. Con respecto a las llamadas, tendrás <strong>minutos ilimitados</strong> para hablar con móviles y fijos nacionales, con el establecimiento de llamada incluido. Como es habitual compartir tarifa entre varios usuarios, a tu paquete Love podrás <strong>añadirle las líneas de móvil adicionales</strong> que necesites  por un pequeño extra en tu cuota mensual y así asociar todos tus números a tu contrato.</p>\n\n<p>Además, con esta tarifa también incluye <strong>Netflix</strong>, que solo te costará dos euros al mes (ya incluidos en el precio final), mucho menos que si te suscribieras a la plataforma por tu cuenta. Si quieres completar tu contenido, también puedes contratar los paquetes de <em>streaming</em> que ofrece el operador: Orange TV Cine y Series y Orange TV Fútbol. Recuerda, eso sí, que esta oferta tiene un <strong>compromiso de permanencia de 12 meses</strong>. Y para rematar esta oferta, Orange te regala una <strong>suscripción gratis a Amazon Prime</strong> para que puedas disfrutar de todas sus ventajas durante un año.</p>\n",
    "contract_length": 12,
    "has_deal": true,
    "url": "//comunicacion.kelisto.es/landings/orange/love-100-mb-medio-max?utm_term=comparadores_Kelisto_COMPARADOR_1_RES_PC",
    "has_cpa_deal": false,
    "cpa_redirect_url": "",
    "prices": {
      "price": 69.95,
      "line_rental": 0.0,
      "router_price": 0.0,
      "router_delivery_cost": 0.0,
      "installation_price": 0.0,
      "line_installation_price": 0.0,
      "annual_price": 629.58,
      "current_monthly_price": 34.98
    },
    "internet": {
      "speed_download": 300,
      "speed_upload": 300,
      "internet_type": "optical_fiber",
      "symmetric": true
    },
    "landing": {
      "title": "Disfruta de Amazon prime 12 meses gratis",
      "legal": null
    },
    "has_landline": true,
    "landline": {
      "line_rental": 0.0,
      "minutes_to_mobile": 1000,
      "minutes_to_landline": 999999999,
      "connection_charge": 0.0
    },
    "has_mobile": true,
    "mobile": {
      "minutes": 999999999,
      "included_lines": 2,
      "data": 25000,
      "minutes_excess": "Sin coste",
      "data_excess": "la velocidad se reduce hasta 16kbps",
      "connection_charge": 0.0,
      "network": "Orange",
      "roaming": null,
      "coverage": "4g",
      "additional_lines": [
        {
          "name": "Smartphone Sin Límites",
          "data": "datos a compartir con la principal",
          "minutes": "min. ilimitados",
          "price": 15.95
        },
        {
          "name": "Smartphone 200 min.",
          "data": "datos a compartir con la principal",
          "minutes": "200 min.",
          "price": 11.95
        },
        {
          "name": "Orange Bono 2 GB ",
          "data": "2 GB a compartir con la principal",
          "minutes": "0 min.",
          "price": 8.95
        },
        {
          "name": "Orange Bono 5 GB ",
          "data": "5 GB a compartir con la principal",
          "minutes": "0 min.",
          "price": 14.95
        },
        {
          "name": "Orange Bono 10 GB ",
          "data": "10 GB a compartir con la principal",
          "minutes": "0 min.",
          "price": 19.95
        },
        {
          "name": "Bono Datos",
          "data": "datos a compartir con la principal",
          "minutes": "0 min.",
          "price": 7.95
        }
      ]
    },
    "has_tv": true,
    "tv": {
      "description": "<p>Netflix incluido</p>\n",
      "claim": "Netflix",
      "tv_channels": [
        {
          "name": "Netflix",
          "type": "Series",
          "image": {
            "url": "http://api.kelisto.es/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBTZz09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--d39299e21308db8554af50aa2c8c3b011c5d8519/netflix.jpg"
          }
        },
        {
          "name": "amazon prime video",
          "type": "Cine",
          "image": {
            "url": "http://api.kelisto.es/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBY1E9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--8c511301a0fe022fe67ac307cda40e7772328f9f/amazon%20prime%20video%202.jpg"
          }
        }
      ]
    },
    "has_promo": true,
    "promo": {
      "starts_at": null,
      "expires_at": "2020-06-30T23:54:00.000+02:00",
      "claim": "Pack Orange TV Total por 29,95€/mes",
      "description": "<p>Disfruta de un <strong>50% de descuento durante 6 meses</strong>.<br>\nAdemás llévate Amazon prime durante 12 meses gratis y añade <strong>todo el fútbol más el cine y series</strong> tan solo te costará <strong>29,95 euros al mes</strong> gracias al pack <strong>Orange TV Total</strong>.</p>\n",
      "months": 6,
      "monthly_price": 34.98,
      "type": "price"
    },
    "provider": {
      "id": 7,
      "name": "Orange",
      "network": "Orange",
      "roaming": null,
      "slug": "orange",
      "title": null,
      "phone_number": "900263196",
      "image": {
        "url": "http://api.kelisto.es/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBEQT09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--459c6a8cd2eeab5bfea05a902bb98c7c38c90ba4/orange.jpg"
      },
      "description": null
    },
    "ratings": {
      "rating": 8.9,
      "price": 8,
      "speed": 8,
      "minutes": 10,
      "data": 10
    },
    "has_review": false,
    "promoted_offers": [ ... ]
  }
}

Arguments

Parameter Description
slug Required string The slug of the offer to retrieve.
provider_slug Required string The slug of the provider related to the offer.
product_name Required string The product name related to the offer. Value should be one of these: broadband, internet_mobile, internet_tv, internet_tv_mobile, wifi4g.
section Optional Integer The defines which provider’s phone number is going to be displayed. The value must be one of these: Compare, Offer_detail, Compare_top, Compare_sem, process_help_results, process_help_results_sem, article, article_podium, article_opinion_card, newsletter. In case we don’t receive the section param, we will provide the default section phone number.
source Optional Integer Defines el source the phone number displayed. the value must be: idealista, default. In case we do not receive no parameters the default will be taken.

 Returns

Returns an internet offer object if a valid slug and provider slug were provided.

Note it will also add an additional promoted_offers (array) attribute with the 'most sales/promoted' offers we also show in the landings

List all internet offers

# Definition
GET https://api.kelisto.es/api/v3/communications/offers/internet?product_name=:product_name

# Example request
$ curl https://api.kelisto.es/api/v3/communications/offers/internet?product_name=internet_tv_mobile
# Example response
{
  "pagination": {
    "links": {
      "first": "http://api.kelisto.es/api/v3/communications/offers/internet?product_name=internet_tv_mobile&page=1",
      "last": "http://api.kelisto.es/api/v3/communications/offers/internet?product_name=internet_tv_mobile&page=1"
    },
    "current_page": 1,
    "page_items": 25,
    "total_count": 25,
    "total_pages": 1
  },
  "data": [
    {
      "id": 1165,
      "name": "Love Medio Max 300 Mb + Netflix",
      "slug": "love-100-mb-medio-max",
      "product_name": "internet_tv_mobile",
      "product_type": "internet",
      "claim": "¡Amazon prime 12 meses gratis!",
      "starred": false,
      "best_buy": false,
      "sponsored": false,
      "updated_at": "2020-06-18T18:10:40.908+02:00",
      "description": "<p>Con la tarifa <strong>Love Medio Max</strong> de <strong>Orange</strong> no solo disfrutarás de Internet en casa y desde el móvil, también tendrás acceso a todo el contenido de la plataforma de Netflix. Todas las tarifas Love de Orange pueden combinarse para que el usuario elija las condiciones que quiera, pero en este caso el paquete incluye <strong>300 Mb de fibra simétricos</strong>, lo que quiere decir que dispondrás de la misma velocidad al subir y al descargar archivos. Tampoco tendrás problemas para navegar desde diferentes dispositivos a la vez a través del Wifi de casa. Vinculada a la fibra, tendrás también una <strong>línea de telefonía fija gratis</strong> con llamadas ilimitadas a otros fijos y 1.000 minutos para hablar con móviles.</p>\n\n<p>Esta oferta  incluye dos líneas móviles, la primera ofrece llamadas ilimitadas  y 25 GB a compartir con una segunda línea que además ofrece llamadas a 0 cént/min.Si eres de los que ven a menudo contenido en <em>streaming</em>, sueles jugar online o te gusta estar siempre conectado, no tendrás que preocuparte por si te pasas de megas. Con respecto a las llamadas, tendrás <strong>minutos ilimitados</strong> para hablar con móviles y fijos nacionales, con el establecimiento de llamada incluido. Como es habitual compartir tarifa entre varios usuarios, a tu paquete Love podrás <strong>añadirle las líneas de móvil adicionales</strong> que necesites  por un pequeño extra en tu cuota mensual y así asociar todos tus números a tu contrato.</p>\n\n<p>Además, con esta tarifa también incluye <strong>Netflix</strong>, que solo te costará dos euros al mes (ya incluidos en el precio final), mucho menos que si te suscribieras a la plataforma por tu cuenta. Si quieres completar tu contenido, también puedes contratar los paquetes de <em>streaming</em> que ofrece el operador: Orange TV Cine y Series y Orange TV Fútbol. Recuerda, eso sí, que esta oferta tiene un <strong>compromiso de permanencia de 12 meses</strong>. Y para rematar esta oferta, Orange te regala una <strong>suscripción gratis a Amazon Prime</strong> para que puedas disfrutar de todas sus ventajas durante un año.</p>\n",
      "contract_length": 12,
      "has_deal": true,
      "url": "//comunicacion.kelisto.es/landings/orange/love-100-mb-medio-max?utm_term=comparadores_Kelisto_COMPARADOR_1_RES_PC",
      "has_cpa_deal": true,
      "cpa_redirect_url": "url.to/cpa",
      "prices": {
        "price": 69.95,
        "line_rental": 0.0,
        "router_price": 0.0,
        "router_delivery_cost": 0.0,
        "installation_price": 0.0,
        "line_installation_price": 0.0,
        "annual_price": 629.58,
        "current_monthly_price": 34.98
      },
      "internet": {
        "speed_download": 300,
        "speed_upload": 300,
        "internet_type": "optical_fiber",
        "symmetric": true
      },
      "landing": {
        "title": "Disfruta de Amazon prime 12 meses gratis",
        "legal": null
      },
      "has_landline": true,
      "landline": {
        "line_rental": 0.0,
        "minutes_to_mobile": 1000,
        "minutes_to_landline": 999999999,
        "connection_charge": 0.0
      },
      "has_mobile": true,
      "mobile": {
        "minutes": 999999999,
        "included_lines": 2,
        "data": 25000,
        "minutes_excess": "Sin coste",
        "data_excess": "la velocidad se reduce hasta 16kbps",
        "connection_charge": 0.0,
        "network": "Orange",
        "roaming": null,
        "coverage": "4g",
        "additional_lines": [
          {
            "name": "Smartphone Sin Límites",
            "data": "datos a compartir con la principal",
            "minutes": "min. ilimitados",
            "price": 15.95
          },
          {
            "name": "Smartphone 200 min.",
            "data": "datos a compartir con la principal",
            "minutes": "200 min.",
            "price": 11.95
          },
          {
            "name": "Orange Bono 2 GB ",
            "data": "2 GB a compartir con la principal",
            "minutes": "0 min.",
            "price": 8.95
          },
          {
            "name": "Orange Bono 5 GB ",
            "data": "5 GB a compartir con la principal",
            "minutes": "0 min.",
            "price": 14.95
          },
          {
            "name": "Orange Bono 10 GB ",
            "data": "10 GB a compartir con la principal",
            "minutes": "0 min.",
            "price": 19.95
          },
          {
            "name": "Bono Datos",
            "data": "datos a compartir con la principal",
            "minutes": "0 min.",
            "price": 7.95
          }
        ]
      },
      "has_tv": true,
      "tv": {
        "description": "<p>Netflix incluido</p>\n",
        "claim": "Netflix",
        "tv_channels": [
          {
            "name": "Netflix",
            "type": "Series",
            "image": {
              "url": "http://api.kelisto.es/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBTZz09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--d39299e21308db8554af50aa2c8c3b011c5d8519/netflix.jpg"
            }
          },
          {
            "name": "amazon prime video",
            "type": "Cine",
            "image": {
              "url": "http://api.kelisto.es/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBY1E9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--8c511301a0fe022fe67ac307cda40e7772328f9f/amazon%20prime%20video%202.jpg"
            }
          }
        ]
      },
      "has_promo": true,
      "promo": {
        "starts_at": null,
        "expires_at": "2020-06-30T23:54:00.000+02:00",
        "claim": "Pack Orange TV Total por 29,95€/mes",
        "description": "<p>Disfruta de un <strong>50% de descuento durante 6 meses</strong>.<br>\nAdemás llévate Amazon prime durante 12 meses gratis y añade <strong>todo el fútbol más el cine y series</strong> tan solo te costará <strong>29,95 euros al mes</strong> gracias al pack <strong>Orange TV Total</strong>.</p>\n",
        "months": 6,
        "monthly_price": 34.98,
        "type": "price"
      },
      "provider": {
        "id": 7,
        "name": "Orange",
        "network": "Orange",
        "roaming": null,
        "slug": "orange",
        "title": null,
        "phone_number": "900263196",
        "image": {
          "url": "http://api.kelisto.es/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBEQT09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--459c6a8cd2eeab5bfea05a902bb98c7c38c90ba4/orange.jpg"
        },
        "description": null
      },
      "ratings": {
        "rating": 8.9,
        "price": 8,
        "speed": 8,
        "minutes": 10,
        "data": 10
      },
      "has_review": false
    },
    {...}
  ]
}

Arguments

Parameter Description
product_name optional string Specific product name. Value should be one of these: broadband, internet_mobile, internet_tv, internet_tv_mobile, wifi4g. Return all product name offers if no provided.
status optional string Retrieve offers by status (active, inactive, snapshot or discontinue). It can be an array of statuses. Default: active.
speed_download optional integer-operator Retrieve offers by speed. Supports operators.
m_minutes optional integer-operator Retrieve offers by m_minutes. Supports operators.
m_data optional integer-operator Retrieve offers by m_data. Supports operators.
m_included_lines optional integer Retrieve offers with or without a landline phone.
landline optional string Return offer with or without landline.
price optional float-operator Retrieve offers by price. Supports operators.
providers optional string Retrieve offers by provider slugs.
Eg: providers=yoigo; providers=yoigo,movistar.
channels optional string Retrieve offers by TV channels. Possible values: all_soccer, la_liga, champions, film_and_serie, movistar_series and ott_streaming.
permanence optional boolean Retrieve offers with or without permanence.
Eg: permanence=true; permanence=false.
postcode optional integer Retrieve offers assigned to a specific postal code.
cheapest_by_provider optional boolean Retrieve only the cheapest offer per provider.
sort_by optional string The field that defines the order. Use suffix - to define descending order and + for ascending order. (i.e. +name). Multiple sorting values can be specified ('+name,-slug')

 Returns

Returns a list of internet offer objects.

List top internet offers

# Definition
GET https://api.kelisto.es/api/v3/communications/top_offers/internet/:product_name?filters

# Example request
$ curl https://api.kelisto.es/api/v3/communications/top_offers/internet/broadband?m_data[eq]=50
# Example response
{
  "pagination": {
    "links": {
    "first": "https://api.kelisto.es/api/v3/communications/top_offers/internet/broadband?page=1",
    "last": "https://api.kelisto.es/api/v3/communications/top_offers/internet/broadband?page=1"
    },
    "current_page": 1,
    "page_items": 25,
    "total_count": 3,
    "total_pages": 1
  },
  "data": [
    {
      "id": 1256,
      "name": "Másmóvil Adsl 20 Mb",
      "slug": "masmovil-adsl-20-mb",
      "product_name": "broadband",
      "product_type": "internet",
      "claim": "Alta de línea e instalación gratuitos",
      "starred": false,
      "best_buy": false,
      "sponsored": false,
      "updated_at": "2020-10-09T14:30:29.695+02:00",
      "status": "snapshot",
      "description": "<p>MásMóvil incluye en su catálogo de tarifas de Internet una oferta para contratar <strong>ADSL con 20 Mb</strong> de velocidad máxima de bajada y 2 Mb de subida. Como la mayoría de ofertas de ADSL, con MásMóvil no solo te llevas Internet: también tendrás una línea fija con <strong>llamadas ilimitadas a fijos y 60 minutos para hablar con otros móviles</strong>. </p>\n\n<p>Si eres nuevo en la compañía, no te preocupes: <strong>el alta de línea y el coste de la instalación son gratuitos</strong>. Con MásMóvil también puedes contratar una línea de telefonía móvil para llamar y navegar por Internet cuando estés fuera de casa.</p>\n",
      "contract_length": 12,
      "permanence": true,
      "has_deal": true,
      "url": "//comunicacion.kelisto.dev/landings/masmovil/masmovil-adsl-20-mb?Id_brand=mm",
      "has_cpa_deal": false,
      "cpa_redirect_url": null,
      "prices": {
        "price": 10,
        "line_rental": 19.99,
        "router_price": 0,
        "router_delivery_cost": 0,
        "installation_price": 0,
        "line_installation_price": 0,
        "annual_price": 359.88,
        "current_monthly_price": 29.99
      },
      "internet": {
        "speed_download": 20,
        "speed_upload": 2,
        "internet_type": "adsl",
        "symmetric": false
      },
      "landing": {
        "title": "Precio para siempre",
        "legal": ""
      },
      "has_landline": true,
      "landline": {
        "line_rental": 19.99,
        "minutes_to_mobile": 60,
        "minutes_to_landline": 999999999,
        "connection_charge": 0
      },
      "has_mobile": false,
      "has_tv": false,
      "has_promo": true,
      "promo": {
        "starts_at": null,
        "expires_at": null,
        "claim": "Precio para siempre",
        "description": null,
        "months": 0,
        "monthly_price": null,
        "type": "others"
      },
      "provider": {
        "id": 14,
        "name": "MásMóvil",
        "network": "Yoigo/Orange",
        "roaming": "Con Másmóvil puedes llamar y navegar como si estuvieras en España en los siguientes países de la Unión Europea: Alemania, Austria, Bélgica, Bulgaria, Chipre, Croacia, Dinamarca, Eslovaquia, Eslovenia, Estonia, Finlandia, Francia, Gibraltar, Grecia, Guadalupe, Guayana Francesa, Holanda, Hungría, Irlanda, Isla Martinica, Isla Reunión, Islandia, Italia, Letonia, Liechtenstein, Lituania, Luxemburgo, Malta, Noruega, Polonia, Portugal (Madeira y Azores), Reino Unido, República Checa, Rumania, Suecia.",
        "slug": "masmovil",
        "title": "Fibra Óptica, ADSL, telefonía móvil y telefonía fija",
        "status": "active",
        "phone_number": "900835760",
        "description": "<p>Por tres sencillas razones: ofrece tanto fibra como ADSL, tiene precios económicos –que no esconden subidas de precios- y pone a disposición de sus clientes hasta tres redes de cobertura diferentes.</p>\n"
      },
      "ratings": {
        "rating": 8.4,
        "price": 10,
        "speed": 6,
        "minutes": 0,
        "data": 50
      },
      "has_review": false
    },
    { # other internet offer object },
    { # other internet offer object }
  ]
}

Arguments

Parameter Description
product_name Required string Specific product name. Value should be one of these: broadband, internet_mobile, internet_tv, internet_tv_mobile, wifi4g.
speed_download optional integer-operator Retrieve offers by speed. Supports operators.
m_minutes optional integer-operator Retrieve offers by m_minutes. Supports operators.
m_data optional integer-operator Retrieve offers by m_data. Supports operators.
current_provider optional string Exclude the current provider.
excluded_provider optional string excludes the unwanted provider(s). Eg: excluded_provider = yoigo ; excluded_provider = yoigo,vodafone,movistar
channels optional string Retrieve offers by TV channels. Possible values: all_soccer, la_liga, champions, film_and_serie, movistar_series and ott_streaming.
postcode optional integer Retrieve offers assigned to a specific postal code. Only applies for some product types.
section Optional Integer The defines which provider’s phone number is going to be displayed. The value must be one of these: Compare, Offer_detail, Compare_top, Compare_sem, process_help_results, process_help_results_sem, article, article_podium, article_opinion_card, newsletter. In case we don’t receive the section param, we will provide the default section phone number.
m_included_lines optional integer Retrieve offers with or without a landline phone.
landline optional string Return offer with or without landline
source Optional Integer Defines el source the phone number displayed. the value must be: idealista, default. In case we do not receive no parameters the default will be taken.
monthly_cost optional string
comparison_id Required integer Comparisons's unique identifier.
customer_email optional string Customer's email.
customer_name optional string Customer's name.
customer_newsletter_accepted optional boolean Returns true if the customer has subscribed to the newsletter, otherwise is false
limit optional integer Limits the number of offers to be displayed (returns by default 3 offers).

Returns

Returns a list of 3 offers with the possibility of displaying up to 6 offers objects internet offer objects:

# Definition
GET https://api.kelisto.es/api/v3/communications/related_offers/internet/:slug?provider_slug=:provider_slug

# Example request
$ curl https://api.kelisto.es/api/v3/communications/related_offers/internet/adamo-1-gb-20-gb?provider_slug=adamo
# Example response

{
  "data": [
    {
      "id": 1431,
      "name": "Finetwork Fibra 300 Mb + 24 GB",
      "slug": "finetwork-300-mb-24-gb",
      "product_name": "internet_mobile",
      "product_type": "internet",
      "claim": "¡Acumula los megas para el mes siguiente!",
      "starred": false,
      "best_buy": false,
      "sponsored": false,
      "updated_at": "2020-11-25T16:11:35.977+01:00",
      "status": "active",
      "description": "<p><strong>Finetwork</strong> cuenta con una de las tarifas de fibra y móvil más competitivas del mercado: <strong>Fibra 300 Mb + 24 GB</strong> por menos de 35 euros al mes. Si contratas este plan, disfrutarás de <strong>fibra óptica simétrica</strong>, es decir, de la velocidad real que contratas (300 Mbps) tanto al hacer descargas como subidas. </p>\n\n<p>Esta velocidad es más que suficiente para que, por ejemplo, estés usando cinco dispositivos a la vez conectados a tu Wifi sin que la velocidad se vea afectada. Podrás ver contenidos en tus plataformas de <em>streaming</em>, jugar online desde el ordenador o subir contenido a las redes sociales, entre otras cosas. </p>\n\n<p>Por otro lado, esta tarifa incluye una línea móvil con <strong>24 GB</strong> de datos para navegar y <strong>llamadas ilimitadas</strong>. Esta cantidad está por encima del consumo medio habitual y te permitirá usar tu conexión 4G no solo para consultar tu correo o chatear, también para descargar algún juego o disfrutar de alguna película online. </p>\n\n<p>Además, gracias a los servicios GigaBank y GigaTransfer podrás acumular los datos que no uses para gastarlos el siguiente mes y transferir tus megas a otro usuario de Finetwork. Asimismo, tendrás disponible el servicio de <em>roaming</em> para que no tengas sorpresas en tu factura cuando viajes dentro de la Unión Europea. </p>\n\n<p>Recuerda que tendrás ventajas adicionales al contratar esta tarifa: <strong>la instalación es gratuita, no exige permanencia y podrás contratar líneas adicionales a un precio reducido</strong>. La cuota se mantendrá fija y sin subidas pasados los primeros meses.</p>\n\n<p>Aunque Finetwork es una compañía independiente de los grandes grupos de telecomunicaciones, usa como soporte las redes de <strong>Vodafone</strong> tanto para prestar su servicio de fibra como para permitir la conexión 4G. Tiene presencia en todo el país, pero, en caso de que a tu domicilio no le llegue su cobertura de fibra, te ofrecerá ADSL como alternativa.</p>\n",
      "contract_length": 0,
      "permanence": false,
      "has_deal": true,
      "url": "//comunicacion.kelisto.dev/landings/fi-network/finetwork-300-mb-24-gb",
      "prices": {
        "price": 34.9,
        "line_rental": 0.0,
        "router_price": 0.0,
        "router_delivery_cost": 0.0,
        "installation_price": 0.0,
        "line_installation_price": 0.0,
        "annual_price": 418.8,
        "current_monthly_price": 34.9
      },
      "internet": {
        "speed_download": 300,
        "speed_upload": 300,
        "internet_type": "optical_fiber",
        "symmetric": true
      },
      "landing": {
        "title": "",
        "legal": ""
      },
      "has_landline": false,
      "has_mobile": true,
      "mobile": {
        "minutes": 999999999,
        "included_lines": 1,
        "data": 24000,
        "minutes_excess": "Sin coste",
        "data_excess": "la velocidad se reduce hasta 16kbps",
        "connection_charge": 0.0,
        "network": "Vodafone",
        "roaming": "",
        "coverage": "4g",
        "additional_lines": [
          {
            "name": "Finetwork - Línea adicional 1",
            "data": "30GB",
            "minutes": "ilimitados",
            "price": 19.9
          },
          {
            "name": "Finetwork - Línea adicional 2",
            "data": "23GB",
            "minutes": "ilimitados",
            "price": 14.9
          },
          {
            "name": "Finetwork - Línea adicional 3",
            "data": "12GB",
            "minutes": "ilimitados",
            "price": 10.9
          },
          {
            "name": "Finetwork - Línea adicional 4",
            "data": "10GB",
            "minutes": "ilimitados",
            "price": 9.9
          },
          {
            "name": "Finetwork - Línea adicional 5",
            "data": "5GB",
            "minutes": "300 minutos",
            "price": 7.9
          }
        ]
      },
      "has_tv": false,
      "has_promo": true,
      "promo": {
        "starts_at": null,
        "expires_at": "2020-06-30T23:47:00.000+02:00",
        "claim": "25 GB extra de regalo",
        "description": "<p>Si contratas esta tarifa ahora, podrás disfrutar de <strong>25 GB extra en tu línea móvil totalmente gratis</strong>.</p>\n",
        "months": 0,
        "monthly_price": null,
        "type": "others"
      },
      "provider": {
        "id": 26,
        "name": "Finetwork",
        "network": "Vodafone",
        "roaming": "",
        "slug": "fi-network",
        "title": "Ofertas de fibra y telefonía móvil",
        "status": "active",
        "phone_number": "910021319",
        "image": {
          "url": "https://admin.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbG9FIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--4582a0307caeabe3fcfc3cb9b330f164e0319b79/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--9bf916c83f9ea8616ecddb3dafca36d672ce853d/Finetwork%20logo.jpg",
          "url_profile": "https://admin.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaG9IIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--a1151ba54b895ac3b3670d320f61b0b03c3f9f9c/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRZd01IZzBNREJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTmpBd2VEUXdNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--2749c10775aa63b422ff27fe2f2689f5949748c7/finetwork600x400.jpg"
        },
        "description": "<p>Muy sencillo, porque tiene algunas de las tarifas de fibra óptica más baratas del mercado. Además, te da la opción de quitar el compromiso de permanencia y de acumular y compartir tus datos móviles con otros usuarios de la compañía.</p>\n"
      },
      "ratings": {
        "rating": 9.6,
        "price": 10,
        "speed": 8,
        "minutes": 10,
        "data": 10
      },
      "has_review": false
    },
    {...}
  ]
}

Arguments

Parameter Description
slug Required string The slug of the offer which we need to retrieve their related offers.
provider_slug Required string The slug of the offer provider.
limit optional string Number of related offers to retrieve Default: 3.
section Optional Integer The defines which provider’s phone number is going to be displayed. The value must be one of these: Compare, Offer_detail, Compare_top, Compare_sem, process_help_results, process_help_results_sem, article, article_podium, article_opinion_card, newsletter. In case we don’t receive the section param, we will provide the default section phone number.
source Optional Integer Defines el source the phone number displayed. the value must be: idealista, default. In case we do not receive no parameters the default will be taken.

 Returns

Returns a list of internet offer objects.

# Definition
GET https://api.kelisto.es/api/v3/communications/featured_offers/internet/:product_name

# Example request
$ curl https://api.kelisto.es/api/v3/communications/featured_offers/internet/broadband
# Example response

{
  "data": [
    {
      "id": 1256,
      "name": "Másmóvil Adsl 20 Mb",
      "slug": "masmovil-adsl-20-mb",
      "product_name": "broadband",
      "product_type": "internet",
      "claim": "Alta de línea e instalación gratuitos",
      "starred": true,
      "best_buy": false,
      "sponsored": false,
      "updated_at": "2020-10-09T14:30:29.695+02:00",
      "status": "snapshot",
      "description": "<p>MásMóvil incluye en su catálogo de tarifas de Internet una oferta para contratar <strong>ADSL con 20 Mb</strong> de velocidad máxima de bajada y 2 Mb de subida. Como la mayoría de ofertas de ADSL, con MásMóvil no solo te llevas Internet: también tendrás una línea fija con <strong>llamadas ilimitadas a fijos y 60 minutos para hablar con otros móviles</strong>. </p>\n\n<p>Si eres nuevo en la compañía, no te preocupes: <strong>el alta de línea y el coste de la instalación son gratuitos</strong>. Con MásMóvil también puedes contratar una línea de telefonía móvil para llamar y navegar por Internet cuando estés fuera de casa.</p>\n",
      "contract_length": 12,
      "permanence": true,
      "cheapest": false,
      "recommended": false,
      "url": "//comunicacion.kelisto.dev/landings/masmovil/masmovil-adsl-20-mb?Id_brand=mm",
      "has_cpa_deal": false,
      "cpa_redirect_url": null,
      "prices": {
        "price": 10,
        "line_rental": 19.99,
        "router_price": 0,
        "router_delivery_cost": 0,
        "installation_price": 0,
        "line_installation_price": 0,
        "annual_price": 359.88,
        "current_monthly_price": 29.99
      },
      "internet": {
        "speed_download": 20,
        "speed_upload": 2,
        "internet_type": "adsl",
        "symmetric": false
      },
      "landing": {
        "title": "Precio para siempre",
        "legal": ""
      },
      "has_landline": true,
      "landline": {
        "line_rental": 19.99,
        "minutes_to_mobile": 60,
        "minutes_to_landline": 999999999,
        "connection_charge": 0
      },
      "has_mobile": false,
      "has_tv": false,
      "has_promo": true,
      "promo": {
        "starts_at": null,
        "expires_at": null,
        "claim": "Precio para siempre",
        "description": null,
        "months": 0,
        "monthly_price": null,
        "type": "others",
      },
      "provider": {
       "id": 14,
        "name": "MásMóvil",
        "network": "Yoigo/Orange",
        "roaming": "Con Másmóvil puedes llamar y navegar como si estuvieras en España en los siguientes países de la Unión Europea: Alemania, Austria, Bélgica, Bulgaria, Chipre, Croacia, Dinamarca, Eslovaquia, Eslovenia, Estonia, Finlandia, Francia, Gibraltar, Grecia, Guadalupe, Guayana Francesa, Holanda, Hungría, Irlanda, Isla Martinica, Isla Reunión, Islandia, Italia, Letonia, Liechtenstein, Lituania, Luxemburgo, Malta, Noruega, Polonia, Portugal (Madeira y Azores), Reino Unido, República Checa, Rumania, Suecia.",
        "slug": "masmovil",
        "title": "Fibra Óptica, ADSL, telefonía móvil y telefonía fija",
        "status": "active",
        "phone_number": "900835760",
        "description": "<p>Por tres sencillas razones: ofrece tanto fibra como ADSL, tiene precios económicos –que no esconden subidas de precios- y pone a disposición de sus clientes hasta tres redes de cobertura diferentes.</p>\n"
      },
      "ratings": {
         "rating": 8.4,
        "price": 10,
        "speed": 6,
        "minutes": 0,
        "data": 50
      },
      "has_review": false
    },
    {...}
  ]
}

Arguments

Parameter Description
product_name Required string Specific product name. Value should be one of these: broadband, internet_mobile, internet_tv, internet_tv_mobile, wifi4g.
section Optional Integer The defines which provider’s phone number is going to be displayed. The value must be one of these: Compare, Offer_detail, Compare_top, Compare_sem, process_help_results, process_help_results_sem, article, article_podium, article_opinion_card, newsletter. In case we don’t receive the section param, we will provide the default section phone number.
source Optional Integer Defines el source the phone number displayed. the value must be: idealista, default. In case we do not receive no parameters the default will be taken.

 Returns

Returns a list with 3 internet offer objects: internet offer objects.

Mobile offers

The mobile offer object

Attributes

# Example object

{
  "id": 733,
  "name": "Finetwork 7 GB + Ilimitados",
  "slug": "finetwork-contrato-7-gb-ilimitados",
  "product_name": "contract",
  "product_type": "mobile",
  "claim": "Acumula las GBs que no gastes para el mes siguiente",
  "starred": false,
  "best_buy": false,
  "sponsored": false,
  "updated_at": "2020-06-15T13:11:51.586+02:00",
  "description": "<p>La tarifa <strong>7 GB + minutos ilimitados</strong> de <strong>Finetwork</strong> es la tarifa intermedia de la operadora que combina datos y minutos.</p>\n\n<p>Por un lado, te ofrece minutos ilimitados para hablar con los tuyos sin estar pendiente del tiempo que pasas al teléfono. Por el otro, <strong>7 GB</strong> de datos para navegar desde tu <em>smartphone</em>. Estos <strong>7 GB</strong> te permitirán hacer uso de tu móvil para ver vídeos, escuchar música online, consultar tu correo electrónico, subir contenido a tus redes sociales y mucho más. En cualquier caso, si se te quedaran cortos los 7 GB podrás contratar un bono extra de 1 GB por 3,99 euros. Otra ventaja es que si  no agotas todos los datos de tu tarifa se te acumularán para que puedas usarlos el siguiente mes.  Al margen de los datos y los minutos, esta tarifa igualmente te incluye 1.000 SMS gratis.</p>\n\n<p>Esta tarifa móvil también cuenta con el servicio de <em>roaming</em>, gracias al cual podrás hacer uso de tu tarifa móvil en los países de la Unión Europea, Noruega, Islandia y Liechtenstein (zona 1) como si estuvieras en España. Si tienes pensado viajar a otro país que no entre en los anteriormente mencionados, consulta las tarifas especiales que se aplican en dicho país para así evitar sorpresas.</p>\n\n<p>Para facilitarte las cosas, <strong>Finetwork</strong> ha creado una <em>app</em> para que puedas gestionar tu cuenta con mayor comodidad desde tu <em>smartphone</em>. De esta forma para algunas gestiones no tendrás que acudir a atención al cliente. Entre otras cosas, esta <em>app</em> te permitirá consultar tus facturas o tener un mayor control de tus gastos.</p>\n\n<p>Esta tarifa, al igual que el resto de tarifas móviles del operador, <strong>no cuenta con un compromiso de permanencia</strong> por lo que tú elijes cuándo darte de baja o cambiar el servicio, y sin penalización alguna.</p>\n",
  "contract_length": 0,
  "free_featured_label": "Promo por Navidad",
  "free_featured_label_description": "Promoción valida solo por navidad ",
  "has_deal": true,
  "url": "https://www.finetwork.com/checkout?product-id=4&service=movil&utm_source=kelisto&utm_medium=comparador&utm_campaign=tarifas_movil&utm_term=7gb&utm_content=button",
  "prices": {
    "price": "9.9",
    "annual_price": "118.8",
    "current_monthly_price": "9.9"
  },
  "internet": {
    "internet_type": "4g"
  },
  "mobile": {
    "minutes": 999999999,
    "included_lines": null,
    "data": 7000,
    "minutes_excess": "0,036 cént/ min, 0,18 cént de establecimiento llamada",
    "data_excess": "la velocidad se reduce a 32 Kbps",
    "connection_charge": 0.0,
    "network": "Vodafone",
    "roaming": ""
  },
  "has_promo": true,
  "promo": {
    "starts_at": null,
    "expires_at": null,
    "claim": "66 GB extra gratis para este verano",
    "description": "<p>Con la nueva promoción de verano de Finetwork podrás disfrutar de <strong>66 GB extra totalmente gratis</strong> durante este verano. Ten en cuenta que estos GB no son ni acumulables ni transferibles y serán los primeros que consumas cuando navegues. Después de estos pasarás a gastar los gigas que tengas acumulados y fnalmente los de tu tarifa móvil. Podrás administrar los 66 GB como quieras del 15 de junio al 15 de septiembre.</p>\n",
    "months": 0,
    "monthly_price": null,
    "type": "others"
  },
  "provider": {
    "id": 26,
    "name": "Finetwork",
    "network": "Vodafone",
    "roaming": "",
    "slug": "fi-network",
    "title": null,
    "phone_number": "919035950",
    "image": {
      "url": "http://api.kelisto.es/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbG9FIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--e84933f4084698fc49fad94fc98e6ed382661347/Finetwork%20logo.jpg"
    },
    "description": null
  },
  "ratings": {
    "rating": 9.4,
    "price": 10,
    "minutes": 10,
    "data": 8
  },
  "has_review": false
}
Attribute Description
id integer Unique identifier for the resource.
name string Offer name.
slug string  Unique url identifier for the resource.
product_name string  The specific product name. Its value should be one of these: prepaid, contract.
product_type string  Product type identifier mobile.
claim string Short offer description.
starred boolean -
best_buy boolean Returns true if the offer is a best buy, elsewhere false.
sponsored boolean Returns true if the offer is sponsored, elsewhere false.
updated_at timestamp Last update time.
description string Description using HTML format.
contract_length integer Number of months of contract length.
free_featured_label string Returns a free label created by the PM, for special occasions, example: Promo blackfriday.
free_featured_label_description text Returns the description of the free label.
has_deal boolean Return true if Kelisto has a deal for this offer with its provider.
url string Offer landing page URL.
prices hash Price object.
internet hash Internet object.
mobile optional, hash Mobile object.
has_promo boolean Returns true if the current offer has promo hash attributes.
promo optional, hash Promo object.
provider hash Provider object.
has_review boolean Returns true if the current offer has review hash attributes.
review optional, hash Review object.
ratings hash Ratings object.

Retrieve a mobile offer

# Definition
GET https://api.kelisto.es/api/v3/communications/offers/mobile/:slug?provider_slug=:provider_slug&product_name=contract

# Example request
$ curl https://api.kelisto.es/api/v3/communications/offers/mobile/finetwork-contrato-7-gb-ilimitados?provider_slug=fi-network&product_name=contract
# Example response
{
  "data": {
    "id": 733,
    "name": "Finetwork 7 GB + Ilimitados",
    "slug": "finetwork-contrato-7-gb-ilimitados",
    "product_name": "contract",
    "product_type": "mobile",
    "claim": "Acumula las GBs que no gastes para el mes siguiente",
    "starred": false,
    "best_buy": false,
    "sponsored": false,
    "updated_at": "2020-06-15T13:11:51.586+02:00",
    "description": "<p>La tarifa <strong>7 GB + minutos ilimitados</strong> de <strong>Finetwork</strong> es la tarifa intermedia de la operadora que combina datos y minutos.</p>\n\n<p>Por un lado, te ofrece minutos ilimitados para hablar con los tuyos sin estar pendiente del tiempo que pasas al teléfono. Por el otro, <strong>7 GB</strong> de datos para navegar desde tu <em>smartphone</em>. Estos <strong>7 GB</strong> te permitirán hacer uso de tu móvil para ver vídeos, escuchar música online, consultar tu correo electrónico, subir contenido a tus redes sociales y mucho más. En cualquier caso, si se te quedaran cortos los 7 GB podrás contratar un bono extra de 1 GB por 3,99 euros. Otra ventaja es que si  no agotas todos los datos de tu tarifa se te acumularán para que puedas usarlos el siguiente mes.  Al margen de los datos y los minutos, esta tarifa igualmente te incluye 1.000 SMS gratis.</p>\n\n<p>Esta tarifa móvil también cuenta con el servicio de <em>roaming</em>, gracias al cual podrás hacer uso de tu tarifa móvil en los países de la Unión Europea, Noruega, Islandia y Liechtenstein (zona 1) como si estuvieras en España. Si tienes pensado viajar a otro país que no entre en los anteriormente mencionados, consulta las tarifas especiales que se aplican en dicho país para así evitar sorpresas.</p>\n\n<p>Para facilitarte las cosas, <strong>Finetwork</strong> ha creado una <em>app</em> para que puedas gestionar tu cuenta con mayor comodidad desde tu <em>smartphone</em>. De esta forma para algunas gestiones no tendrás que acudir a atención al cliente. Entre otras cosas, esta <em>app</em> te permitirá consultar tus facturas o tener un mayor control de tus gastos.</p>\n\n<p>Esta tarifa, al igual que el resto de tarifas móviles del operador, <strong>no cuenta con un compromiso de permanencia</strong> por lo que tú elijes cuándo darte de baja o cambiar el servicio, y sin penalización alguna.</p>\n",
    "contract_length": 0,
    "has_deal": true,
    "url": "https://www.finetwork.com/checkout?product-id=4&service=movil&utm_source=kelisto&utm_medium=comparador&utm_campaign=tarifas_movil&utm_term=7gb&utm_content=button",
    "prices": {
      "price": "9.9",
      "annual_price": "118.8",
      "current_monthly_price": "9.9"
    },
    "internet": {
      "internet_type": "4g"
    },
    "mobile": {
      "minutes": 999999999,
      "included_lines": null,
      "data": 7000,
      "minutes_excess": "0,036 cént/ min, 0,18 cént de establecimiento llamada",
      "data_excess": "la velocidad se reduce a 32 Kbps",
      "connection_charge": 0.0,
      "network": "Vodafone",
      "roaming": ""
    },
    "has_promo": true,
    "promo": {
      "starts_at": null,
      "expires_at": null,
      "claim": "66 GB extra gratis para este verano",
      "description": "<p>Con la nueva promoción de verano de Finetwork podrás disfrutar de <strong>66 GB extra totalmente gratis</strong> durante este verano. Ten en cuenta que estos GB no son ni acumulables ni transferibles y serán los primeros que consumas cuando navegues. Después de estos pasarás a gastar los gigas que tengas acumulados y fnalmente los de tu tarifa móvil. Podrás administrar los 66 GB como quieras del 15 de junio al 15 de septiembre.</p>\n",
      "months": 0,
      "monthly_price": null,
      "type": "others"
    },
    "provider": {
      "id": 26,
      "name": "Finetwork",
      "network": "Vodafone",
      "roaming": "",
      "slug": "fi-network",
      "title": null,
      "phone_number": "919035950",
      "image": {
        "url": "http://api.kelisto.es/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbG9FIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--e84933f4084698fc49fad94fc98e6ed382661347/Finetwork%20logo.jpg"
      },
      "description": null
    },
    "ratings": {
      "rating": 9.4,
      "price": 10,
      "minutes": 10,
      "data": 8
    },
    "has_review": false
  }
}

Arguments

Parameter Description
slug Required string The slug of the offer to retrieve.
provider_slug Required string The slug of the provider related to the offer.
product_name Required string The slug of the provider related to the offer. Value should be one of these: contract, prepaid.
section Optional Integer The defines which provider’s phone number is going to be displayed. The value must be one of these: Compare, Offer_detail, Compare_top, Compare_sem, process_help_results, process_help_results_sem, article, article_podium, article_opinion_card, newsletter. In case we don’t receive the section param, we will provide the default section phone number.
source Optional Integer Defines el source the phone number displayed. the value must be: idealista, default. In case we do not receive no parameters the default will be taken.

 Returns

Returns a mobile offer object if a valid slug and provider slug were provided.

List all mobile offers

# Definition
GET https://api.kelisto.es/api/v3/communications/offers/mobile/?product_name=:product_name

# Example request
$ curl https://api.kelisto.es/api/v3/communications/offers/mobile?product_name=contract
# Example response
{
  "pagination": {
    "links": {
      "first": "http://api.kelisto.es/api/v3/communications/offers/mobile?product_name=contract&page=1",
      "next": "http://api.kelisto.es/api/v3/communications/offers/mobile?product_name=contract&page=2",
      "last": "http://api.kelisto.es/api/v3/communications/offers/mobile?product_name=contract&page=6"
    },
    "current_page": 1,
    "page_items": 25,
    "total_count": 128,
    "total_pages": 6
  },
  "data": [
    {
      "id": 733,
      "name": "Finetwork 7 GB + Ilimitados",
      "slug": "finetwork-contrato-7-gb-ilimitados",
      "product_name": "contract",
      "product_type": "mobile",
      "claim": "Acumula las GBs que no gastes para el mes siguiente",
      "starred": false,
      "best_buy": false,
      "sponsored": false,
      "updated_at": "2020-06-15T13:11:51.586+02:00",
      "description": "<p>La tarifa <strong>7 GB + minutos ilimitados</strong> de <strong>Finetwork</strong> es la tarifa intermedia de la operadora que combina datos y minutos.</p>\n\n<p>Por un lado, te ofrece minutos ilimitados para hablar con los tuyos sin estar pendiente del tiempo que pasas al teléfono. Por el otro, <strong>7 GB</strong> de datos para navegar desde tu <em>smartphone</em>. Estos <strong>7 GB</strong> te permitirán hacer uso de tu móvil para ver vídeos, escuchar música online, consultar tu correo electrónico, subir contenido a tus redes sociales y mucho más. En cualquier caso, si se te quedaran cortos los 7 GB podrás contratar un bono extra de 1 GB por 3,99 euros. Otra ventaja es que si  no agotas todos los datos de tu tarifa se te acumularán para que puedas usarlos el siguiente mes.  Al margen de los datos y los minutos, esta tarifa igualmente te incluye 1.000 SMS gratis.</p>\n\n<p>Esta tarifa móvil también cuenta con el servicio de <em>roaming</em>, gracias al cual podrás hacer uso de tu tarifa móvil en los países de la Unión Europea, Noruega, Islandia y Liechtenstein (zona 1) como si estuvieras en España. Si tienes pensado viajar a otro país que no entre en los anteriormente mencionados, consulta las tarifas especiales que se aplican en dicho país para así evitar sorpresas.</p>\n\n<p>Para facilitarte las cosas, <strong>Finetwork</strong> ha creado una <em>app</em> para que puedas gestionar tu cuenta con mayor comodidad desde tu <em>smartphone</em>. De esta forma para algunas gestiones no tendrás que acudir a atención al cliente. Entre otras cosas, esta <em>app</em> te permitirá consultar tus facturas o tener un mayor control de tus gastos.</p>\n\n<p>Esta tarifa, al igual que el resto de tarifas móviles del operador, <strong>no cuenta con un compromiso de permanencia</strong> por lo que tú elijes cuándo darte de baja o cambiar el servicio, y sin penalización alguna.</p>\n",
      "contract_length": 0,
      "has_deal": true,
      "url": "https://www.finetwork.com/checkout?product-id=4&service=movil&utm_source=kelisto&utm_medium=comparador&utm_campaign=tarifas_movil&utm_term=7gb&utm_content=button",
      "prices": {
        "price": "9.9",
        "annual_price": "118.8",
        "current_monthly_price": "9.9"
      },
      "internet": {
        "internet_type": "4g"
      },
      "mobile": {
        "minutes": 999999999,
        "included_lines": null,
        "data": 7000,
        "minutes_excess": "0,036 cént/ min, 0,18 cént de establecimiento llamada",
        "data_excess": "la velocidad se reduce a 32 Kbps",
        "connection_charge": 0.0,
        "network": "Vodafone",
        "roaming": ""
      },
      "has_promo": true,
      "promo": {
        "starts_at": null,
        "expires_at": null,
        "claim": "66 GB extra gratis para este verano",
        "description": "<p>Con la nueva promoción de verano de Finetwork podrás disfrutar de <strong>66 GB extra totalmente gratis</strong> durante este verano. Ten en cuenta que estos GB no son ni acumulables ni transferibles y serán los primeros que consumas cuando navegues. Después de estos pasarás a gastar los gigas que tengas acumulados y fnalmente los de tu tarifa móvil. Podrás administrar los 66 GB como quieras del 15 de junio al 15 de septiembre.</p>\n",
        "months": 0,
        "monthly_price": null,
        "type": "others"
      },
      "provider": {
        "id": 26,
        "name": "Finetwork",
        "network": "Vodafone",
        "roaming": "",
        "slug": "fi-network",
        "title": null,
        "phone_number": "919035950",
        "image": {
          "url": "http://api.kelisto.es/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbG9FIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--e84933f4084698fc49fad94fc98e6ed382661347/Finetwork%20logo.jpg"
        },
        "description": null
      },
      "ratings": {
        "rating": 9.4,
        "price": 10,
        "minutes": 10,
        "data": 8
      },
      "has_review": false
    },
    {...}
  ]
}

Arguments

Parameter Description
product_name optional string Specific product name. Value should be one of these: contract, prepaid. Return all product name offers if no provided.
status optional string Retrieve offers by status (active, inactive, snapshot or discontinue). It can be an array of statuses. Default: active.
m_minutes optional integer-operator Retrieve offers by m_minutes. Supports operators.
m_data optional integer-operator Retrieve offers by m_data. Supports operators.
price optional float-operator Retrieve offers by price. Supports operators.
providers optional string Retrieve offers by provider slugs.
Eg: providers=yoigo; providers=yoigo,movistar.
internet4g optional boolean Retrieve offers with internet 4g.
sort_by optional string The field that defines the order. Use suffix - to define descending order and + for ascending order. (i.e. +name). Multiple sorting values can be specified ('+name,-slug')

 Returns

Returns a list of mobile offer objects.

List top mobile offers

# Definition
GET https://api.kelisto.es/api/v3/communications/top_offers/mobile/:product_name?filters

# Example request
$ curl https://api.kelisto.es/api/v3/communications/top_offers/mobile/contract?m_data[lt]=50
# Example response
{
  "pagination": {
    "links": {
      "first": "https://api.kelisto.dev/api/v3/communications/top_offers/internet/broadband?page=1",
      "last": "https://api.kelisto.dev/api/v3/communications/top_offers/internet/broadband?page=1"
    },
    "current_page": 1,
    "page_items": 25,
    "total_count": 3,
    "total_pages": 1
  },
  "data": [
    {
      "id": 1256,
      "name": "Másmóvil Adsl 20 Mb",
      "slug": "masmovil-adsl-20-mb",
      "product_name": "broadband",
      "product_type": "internet",
      "claim": "Alta de línea e instalación gratuitos",
      "starred": false,
      "best_buy": false,
      "sponsored": false,
      "updated_at": "2020-10-09T14:30:29.695+02:00",
      "status": "snapshot",
      "description": "<p>MásMóvil incluye en su catálogo de tarifas de Internet una oferta para contratar <strong>ADSL con 20 Mb</strong> de velocidad máxima de bajada y 2 Mb de subida. Como la mayoría de ofertas de ADSL, con MásMóvil no solo te llevas Internet: también tendrás una línea fija con <strong>llamadas ilimitadas a fijos y 60 minutos para hablar con otros móviles</strong>. </p>\n\n<p>Si eres nuevo en la compañía, no te preocupes: <strong>el alta de línea y el coste de la instalación son gratuitos</strong>. Con MásMóvil también puedes contratar una línea de telefonía móvil para llamar y navegar por Internet cuando estés fuera de casa.</p>\n",
      "contract_length": 12,
      "permanence": true,
      "has_deal": true,
      "url": "//comunicacion.kelisto.dev/landings/masmovil/masmovil-adsl-20-mb?Id_brand=mm",
      "has_cpa_deal": false,
      "cpa_redirect_url": null,
      "prices": {
        "price": 10,
        "line_rental": 19.99,
        "router_price": 0,
        "router_delivery_cost": 0,
        "installation_price": 0,
        "line_installation_price": 0,
        "annual_price": 359.88,
        "current_monthly_price": 29.99
      },
      "internet": {
        "speed_download": 20,
        "speed_upload": 2,
        "internet_type": "adsl",
        "symmetric": false
      },
      "landing": {
        "title": "Precio para siempre",
        "legal": ""
      },
      "has_landline": true,
      "landline": {
        "line_rental": 19.99,
        "minutes_to_mobile": 60,
        "minutes_to_landline": 999999999,
        "connection_charge": 0
      },
      "has_mobile": false,
      "has_tv": false,
      "has_promo": true,
      "promo": {
        "starts_at": null,
        "expires_at": null,
        "claim": "Precio para siempre",
        "description": null,
        "months": 0,
        "monthly_price": null,
        "type": "others"
      },
      "provider": {
        "id": 14,
        "name": "MásMóvil",
        "network": "Yoigo/Orange",
        "roaming": "Con Másmóvil puedes llamar y navegar como si estuvieras en España en los siguientes países de la Unión Europea: Alemania, Austria, Bélgica, Bulgaria, Chipre, Croacia, Dinamarca, Eslovaquia, Eslovenia, Estonia, Finlandia, Francia, Gibraltar, Grecia, Guadalupe, Guayana Francesa, Holanda, Hungría, Irlanda, Isla Martinica, Isla Reunión, Islandia, Italia, Letonia, Liechtenstein, Lituania, Luxemburgo, Malta, Noruega, Polonia, Portugal (Madeira y Azores), Reino Unido, República Checa, Rumania, Suecia.",
        "slug": "masmovil",
        "title": "Fibra Óptica, ADSL, telefonía móvil y telefonía fija",
        "status": "active",
        "phone_number": "900835760",
        "description": "<p>Por tres sencillas razones: ofrece tanto fibra como ADSL, tiene precios económicos –que no esconden subidas de precios- y pone a disposición de sus clientes hasta tres redes de cobertura diferentes.</p>\n"
      },
      "ratings": {
        "rating": 8.4,
        "price": 10,
        "speed": 6,
        "minutes": 0,
        "data": 0
      },
      "has_review": false
    },
    { # other mobile offer object },
    { # other mobile offer object }
  ]
}

Arguments

Parameter Description
product_name Required string Specific product name. Value should be one of these: contract, prepaid.
m_minutes optional integer-operator Retrieve offers by m_minutes. Supports operators.
m_data optional integer-operator Retrieve offers by m_data. Supports operators.
current_provider optional string Exclude the current provider.
excluded_provider optional string excludes the unwanted provider(s). Eg: excluded_provider = yoigo ; excluded_provider = yoigo,vodafone,movistar
section Optional Integer The defines which provider’s phone number is going to be displayed. The value must be one of these: Compare, Offer_detail, Compare_top, Compare_sem, process_help_results, process_help_results_sem, article, article_podium, article_opinion_card, newsletter. In case we don’t receive the section param, we will provide the default section phone number.
source Optional Integer Defines el source the phone number displayed. the value must be: idealista, default. In case we do not receive no parameters the default will be taken.
monthly_cost optional string
comparison_id Required integer Comparisons's unique identifier.
customer_email optional string Customer's email.
customer_name optional string Customer's name.
customer_newsletter_accepted optional boolean Returns true if the customer has subscribed to the newsletter, otherwise is false
limit optional integer Limits the number of offers to be displayed (returns by default 3 offers).

 Returns

Returns a list of 3 offers with the possibility of displaying up to 6 offers objects mobile offer objects:

# Definition
GET https://api.kelisto.es/api/v3/communications/related_offers/mobile/:slug?provider_slug=:provider_slug

# Example request
$ curl https://api.kelisto.es/api/v3/communications/related_offers/mobile/100-min-100-mb?provider_slug=simyo
# Example response

{
  "data": [
   {
      "id": 830,
      "name": "Finetwork 8 GB + Ilimitados",
      "slug": "finetwork-contrato-8-gb-ilimitados",
      "product_name": "contract",
      "product_type": "mobile",
      "claim": "Acumula las GBs que no gastes para el mes siguiente",
      "starred": false,
      "best_buy": false,
      "sponsored": false,
      "updated_at": "2020-12-10T13:40:15.362+01:00",
      "status": "active",
      "description": "<p>La tarifa <strong>8 GB + minutos ilimitados</strong> de <strong>Finetwork</strong> es la tarifa intermedia de la operadora que combina datos y minutos.</p>\n\n<p>Por un lado, te ofrece minutos ilimitados para hablar con los tuyos sin estar pendiente del tiempo que pasas al teléfono. Por el otro, <strong>8 GB</strong> de datos para navegar desde tu <em>smartphone</em>. Estos <strong>8 GB</strong> te permitirán hacer uso de tu móvil para ver vídeos, escuchar música online, consultar tu correo electrónico, subir contenido a tus redes sociales y mucho más. En cualquier caso, si se te quedaran cortos los 8 GB podrás contratar un bono extra de 1 GB por 3,99 euros. Otra ventaja es que si  no agotas todos los datos de tu tarifa se te acumularán para que puedas usarlos el siguiente mes.  Al margen de los datos y los minutos, esta tarifa igualmente te incluye 1.000 SMS gratis.</p>\n\n<p>Esta tarifa móvil también cuenta con el servicio de <em>roaming</em>, gracias al cual podrás hacer uso de tu tarifa móvil en los países de la Unión Europea, Noruega, Islandia y Liechtenstein (zona 1) como si estuvieras en España. Si tienes pensado viajar a otro país que no entre en los anteriormente mencionados, consulta las tarifas especiales que se aplican en dicho país para así evitar sorpresas.</p>\n\n<p>Para facilitarte las cosas, <strong>Finetwork</strong> ha creado una <em>app</em> para que puedas gestionar tu cuenta con mayor comodidad desde tu <em>smartphone</em>. De esta forma para algunas gestiones no tendrás que acudir a atención al cliente. Entre otras cosas, esta <em>app</em> te permitirá consultar tus facturas o tener un mayor control de tus gastos.</p>\n\n<p>Esta tarifa, al igual que el resto de tarifas móviles del operador, <strong>no cuenta con un compromiso de permanencia</strong> por lo que tú elijes cuándo darte de baja o cambiar el servicio, y sin penalización alguna.</p>\n",
      "contract_length": 0,
      "permanence": false,
      "has_deal": true,
      "url": "https://track.adform.net/C/?bn=40865436",
      "prices": {
        "price": "8.9",
        "annual_price": "106.8",
        "current_monthly_price": "8.9"
      },
      "internet": {
        "internet_type": "4g"
      },
      "mobile": {
        "minutes": 999999999,
        "included_lines": null,
        "data": 8000,
        "minutes_excess": "0,036 cént/ min, 0,18 cént de establecimiento llamada",
        "data_excess": "la velocidad se reduce a 32 Kbps",
        "connection_charge": 0.0,
        "network": "Vodafone",
        "roaming": ""
      },
      "has_promo": true,
      "promo": {
        "starts_at": null,
        "expires_at": null,
        "claim": " Llévate una Smartband de regalo",
        "description": "<p>Si contratas esta tarifa ahora, te llevarás de regalo una <em>Smartband</em> y podrás disfrutar de <strong>25 GB extra en tu línea móvil totalmente gratis</strong>.</p>\n",
        "months": 0,
        "monthly_price": null,
        "type": "others"
      },
      "provider": {
        "id": 26,
        "name": "Finetwork",
        "network": "Vodafone",
        "roaming": "",
        "slug": "fi-network",
        "title": "Ofertas de fibra y telefonía móvil",
        "status": "active",
        "phone_number": "910002671",
        "image": {
          "url": "http://api.kelisto.us/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbG9FIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--e84933f4084698fc49fad94fc98e6ed382661347/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--0347ba86f55403d966d523f5ca9b4394cf130337/Finetwork%20logo.jpg",
          "url_profile": "http://api.kelisto.us/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaG9IIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--f6f2a523e2170a938edd01c5e31d86c561552bd9/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRZd01IZzBNREJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTmpBd2VEUXdNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--2fd8a46960860cc6f29168aeffa30e20ff333a7a/finetwork600x400.jpg"
        },
        "description": "<p>Muy sencillo, porque tiene algunas de las tarifas de fibra óptica más baratas del mercado. Además, te da la opción de quitar el compromiso de permanencia y de acumular y compartir tus datos móviles con otros usuarios de la compañía.</p>\n"
      },
      "ratings": {
        "rating": 9.4,
        "price": 10,
        "minutes": 10,
        "data": 8
      },
      "has_review": false
    },
    {...}
  ]
}

Arguments

Parameter Description
slug Required string The slug of the offer which we need to retrieve their related offers.
provider_slug Required string The slug of the offer provider.
limit optional string Number of related offers to retrieve Default: 3.
section Optional Integer The defines which provider’s phone number is going to be displayed. The value must be one of these: Compare, Offer_detail, Compare_top, Compare_sem, process_help_results, process_help_results_sem, article, article_podium, article_opinion_card, newsletter. In case we don’t receive the section param, we will provide the default section phone number.
source Optional Integer Defines el source the phone number displayed. the value must be: idealista, default. In case we do not receive no parameters the default will be taken.

 Returns

Returns a list of mobile offer objects.

# Definition
GET https://api.kelisto.es/api/v3/communications/featured_offers/mobile/:product_name

# Example request
$ curl https://api.kelisto.es/api/v3/communications/featured_offers/mobile/contract
# Example response

{
  "data": [
   {
      "id": 830,
      "name": "Finetwork 8 GB + Ilimitados",
      "slug": "finetwork-contrato-8-gb-ilimitados",
      "product_name": "contract",
      "product_type": "mobile",
      "claim": "Acumula las GBs que no gastes para el mes siguiente",
      "starred": true,
      "best_buy": false,
      "sponsored": false,
      "updated_at": "2020-12-10T13:40:15.362+01:00",
      "status": "active",
      "description": "<p>La tarifa <strong>8 GB + minutos ilimitados</strong> de <strong>Finetwork</strong> es la tarifa intermedia de la operadora que combina datos y minutos.</p>\n\n<p>Por un lado, te ofrece minutos ilimitados para hablar con los tuyos sin estar pendiente del tiempo que pasas al teléfono. Por el otro, <strong>8 GB</strong> de datos para navegar desde tu <em>smartphone</em>. Estos <strong>8 GB</strong> te permitirán hacer uso de tu móvil para ver vídeos, escuchar música online, consultar tu correo electrónico, subir contenido a tus redes sociales y mucho más. En cualquier caso, si se te quedaran cortos los 8 GB podrás contratar un bono extra de 1 GB por 3,99 euros. Otra ventaja es que si  no agotas todos los datos de tu tarifa se te acumularán para que puedas usarlos el siguiente mes.  Al margen de los datos y los minutos, esta tarifa igualmente te incluye 1.000 SMS gratis.</p>\n\n<p>Esta tarifa móvil también cuenta con el servicio de <em>roaming</em>, gracias al cual podrás hacer uso de tu tarifa móvil en los países de la Unión Europea, Noruega, Islandia y Liechtenstein (zona 1) como si estuvieras en España. Si tienes pensado viajar a otro país que no entre en los anteriormente mencionados, consulta las tarifas especiales que se aplican en dicho país para así evitar sorpresas.</p>\n\n<p>Para facilitarte las cosas, <strong>Finetwork</strong> ha creado una <em>app</em> para que puedas gestionar tu cuenta con mayor comodidad desde tu <em>smartphone</em>. De esta forma para algunas gestiones no tendrás que acudir a atención al cliente. Entre otras cosas, esta <em>app</em> te permitirá consultar tus facturas o tener un mayor control de tus gastos.</p>\n\n<p>Esta tarifa, al igual que el resto de tarifas móviles del operador, <strong>no cuenta con un compromiso de permanencia</strong> por lo que tú elijes cuándo darte de baja o cambiar el servicio, y sin penalización alguna.</p>\n",
      "contract_length": 0,
      "permanence": false,
      "cheapest": false,
      "recommended": false,
      "has_deal": true,
      "url": "https://track.adform.net/C/?bn=40865436",
      "prices": {
        "price": "8.9",
        "annual_price": "106.8",
        "current_monthly_price": "8.9"
      },
      "internet": {
        "internet_type": "4g"
      },
      "mobile": {
        "minutes": 999999999,
        "included_lines": null,
        "data": 8000,
        "minutes_excess": "0,036 cént/ min, 0,18 cént de establecimiento llamada",
        "data_excess": "la velocidad se reduce a 32 Kbps",
        "connection_charge": 0.0,
        "network": "Vodafone",
        "roaming": ""
      },
      "has_promo": true,
      "promo": {
        "starts_at": null,
        "expires_at": null,
        "claim": " Llévate una Smartband de regalo",
        "description": "<p>Si contratas esta tarifa ahora, te llevarás de regalo una <em>Smartband</em> y podrás disfrutar de <strong>25 GB extra en tu línea móvil totalmente gratis</strong>.</p>\n",
        "months": 0,
        "monthly_price": null,
        "type": "others"
      },
      "provider": {
        "id": 26,
        "name": "Finetwork",
        "network": "Vodafone",
        "roaming": "",
        "slug": "fi-network",
        "title": "Ofertas de fibra y telefonía móvil",
        "status": "active",
        "phone_number": "910002671",
        "image": {
          "url": "http://api.kelisto.us/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbG9FIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--e84933f4084698fc49fad94fc98e6ed382661347/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--0347ba86f55403d966d523f5ca9b4394cf130337/Finetwork%20logo.jpg",
          "url_profile": "http://api.kelisto.us/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaG9IIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--f6f2a523e2170a938edd01c5e31d86c561552bd9/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRZd01IZzBNREJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTmpBd2VEUXdNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--2fd8a46960860cc6f29168aeffa30e20ff333a7a/finetwork600x400.jpg"
        },
        "description": "<p>Muy sencillo, porque tiene algunas de las tarifas de fibra óptica más baratas del mercado. Además, te da la opción de quitar el compromiso de permanencia y de acumular y compartir tus datos móviles con otros usuarios de la compañía.</p>\n"
      },
      "ratings": {
        "rating": 9.4,
        "price": 10,
        "minutes": 10,
        "data": 8
      },
      "has_review": false
    },
    {...}
  ]
}

Arguments

Parameter Description
product_name Required string Specific product name. Value should be one of these: prepaid, contract.
section Optional Integer The defines which provider’s phone number is going to be displayed. The value must be one of these: Compare, Offer_detail, Compare_top, Compare_sem, process_help_results, process_help_results_sem, article, article_podium, article_opinion_card, newsletter. In case we don’t receive the section param, we will provide the default section phone number.
source Optional Integer Defines el source the phone number displayed. the value must be: idealista, default. In case we do not receive no parameters the default will be taken.

 Returns

Returns a list with 3 internet offer objects: internet offer objects.

Providers

The provider object

# Example object

{
  "id": 13,
  "name": "Yoigo",
  "network": "Yoigo/Orange",
  "roaming": "En UE y Países Asociados:\r\n\r\nPuedes usar los datos de tu tarifa cuando estés navegando en países de la Unión Europea o países asociados sin ningún coste adicional, es como si estuvieras en España, siempre sujeto a la política de uso razonable en zona UE.\r\n\r\nFuera de la UE:\r\n\r\nSi estas navegando fuera de la Unión Europea el precio será distinto a lo que tengas contratado, puedes consultar el detalle",
  "slug": "yoigo",
  "title": "Lorem ipsum dolem amet",
  "phone_number": "800622396",
  "product_names": {
    "current": [
      "internet_mobile",
      "broadband",
      "internet_tv_mobile",
      "internet_tv",
      "wifi4g"
    ],
    "previous": [
      "contract",
      "prepaid"
    ]
  },
  "image": {
    "url": "https://assets.kelisto.us/ta5e4ccky6wzcuf1kuzb2xs1b3un",
    "url_rectangular": "https://assets.kelisto.us/ta5e4ccky6wzcuf1kuzb2xs1b3un",
    "url_profile": "https://assets.kelisto.us/1lyol30c6jac17cf08pi11l4seqr",
    "url_positive": "https://assets.kelisto.us/ta5e4ccky6wzcuf1kuzb2xs1b3un",
    "url_negative": "https://assets.kelisto.us/ta5e4ccky6wzcuf1kuzb2xs1b3un"
  },
  "colors": {
    "brand":  "#FFFFFF",
    "bullets": "#FFFFFF",
    "price": "#000000",
    "titles":  "#FFFFFF"
  },
  "description": "<p>Lorem ipsum dolem amet</p>",
  "status": "active",
}

 Attributes

Attribute Description
id integer Unique identifier for the resource.
name string Provider name.
slug string Unique url identifier for the resource.
network string Provider network.
roaming string Roaming possibilities at current provider.
phone_number string Provider phone.
product_names hash Product names for which this provider has offers. current key contains the product names that are currently active and previous key contains the ones that are inactive or discontinue. Can contain broadband, internet_tv, internet_mobile, internet_tv_mobile, wifi4g, contract and prepaid.
title string Provider title.
description string Provider description in HTML format.
status string Provider status. Can be active, inactive or discontinue.
image hash Image object.
colors hash List of brand colors (brand, bullets, price and titles.)

Retrieve a provider

# Definition
GET https://api.kelisto.es/api/v3/communications/providers/:slug

# Example request
$ curl https://api.kelisto.es/api/v3/communications/providers/yoigo
# Example response

{
  "data": {
    "id": 13,
    "name": "Yoigo",
    "network": "Yoigo/Orange",
    "roaming": "En UE y Países Asociados:\r\n\r\nPuedes usar los datos de tu tarifa cuando estés navegando en países de la Unión Europea o países asociados sin ningún coste adicional, es como si estuvieras en España, siempre sujeto a la política de uso razonable en zona UE.\r\n\r\nFuera de la UE:\r\n\r\nSi estas navegando fuera de la Unión Europea el precio será distinto a lo que tengas contratado, puedes consultar el detalle",
    "slug": "yoigo",
    "title": "Lorem ipsum dolem amet",
    "phone_number": "800622396",
    "image": {
      "url": "https://assets.kelisto.us/ta5e4ccky6wzcuf1kuzb2xs1b3un",
      "url_rectangular": "https://assets.kelisto.us/ta5e4ccky6wzcuf1kuzb2xs1b3un",
      "url_profile": "https://assets.kelisto.us/1lyol30c6jac17cf08pi11l4seqr",
      "url_positive": "https://assets.kelisto.us/ta5e4ccky6wzcuf1kuzb2xs1b3un",
      "url_negative": "https://assets.kelisto.us/ta5e4ccky6wzcuf1kuzb2xs1b3un"
    },
    "colors": {
      "brand":  "#FFFFFF",
      "bullets": "#FFFFFF",
      "price": "#000000",
      "titles":  "#FFFFFF"
    },
    "description": "<p>Lorem ipsum dolem amet</p>",
    "status": "active"
  }
}

Arguments

Parameter Description
slug Required string The slug of the provider to retrieve.

 Returns

Returns a provider object if a valid slug were provided.

List all providers

# Definition
GET https://api.kelisto.es/api/v3/communications/providers?product_name=:product_name&status=:status

# Example request
$ curl https://api.kelisto.es/api/v3/communications/providers?product_name=internet_tv_mobile&status=active
# Example response

{
  "pagination": {
    "links": {
      "first": "http://api.kelisto.es/api/v3/communications/providers?product_name=internet_tv_mobile&page=1",
      "last": "http://api.kelisto.es/api/v3/communications/providers?product_name=internet_tv_mobile&page=1"
    },
    "current_page": 1,
    "page_items": 25,
    "total_count": 11,
    "total_pages": 1
  },
  "data": [
    {
      "id": 13,
      "name": "Yoigo",
      "network": "Yoigo/Orange",
      "roaming": "En UE y Países Asociados:\r\n\r\nPuedes usar los datos de tu tarifa cuando estés navegando en países de la Unión Europea o países asociados sin ningún coste adicional, es como si estuvieras en España, siempre sujeto a la política de uso razonable en zona UE.\r\n\r\nFuera de la UE:\r\n\r\nSi estas navegando fuera de la Unión Europea el precio será distinto a lo que tengas contratado, puedes consultar el detalle",
      "slug": "yoigo",
      "title": "Lorem ipsum dolem amet",
      "phone_number": "800622396",
      "product_names": {
        "current": [
          "internet_tv_mobile",
          "internet_mobile",
          "internet_tv",
          "wifi4g",
          "broadband",
          "contract"
        ],
        "previous": [
          "prepaid"
        ]
      },
      "image": {
        "url": "https://assets.kelisto.us/ta5e4ccky6wzcuf1kuzb2xs1b3un",
        "url_rectangular": "https://assets.kelisto.us/ta5e4ccky6wzcuf1kuzb2xs1b3un",
        "url_profile": "https://assets.kelisto.us/1lyol30c6jac17cf08pi11l4seqr",
        "url_positive": "https://assets.kelisto.us/ta5e4ccky6wzcuf1kuzb2xs1b3un",
        "url_negative": "https://assets.kelisto.us/ta5e4ccky6wzcuf1kuzb2xs1b3un"
      },
      "colors": {
        "brand":  "#FFFFFF",
        "bullets": "#FFFFFF",
        "price": "#000000",
        "titles":  "#FFFFFF"
      },
      "description": "<p>Lorem ipsum dolem amet</p>",
      "status": "active"
    },
    {...}
  ]
}

Arguments

Argument  Description
product_name optional  string - Retrieve providers with offers with a desired product name. Value should be one of these: broadband, internet_tv, internet_mobile, internet_tv_mobile, wifi4g, contract, prepaid.
product_type optional  string - Retrieve providers with offers with a desired product type. Value should be one of these: internet, mobile
status optional string Retrieve providers by status (active, inactive or discontinue). It can be an array of statuses. Default: active.

 Returns

Returns a list of provider objects.

Retrieve all provider products

# Definition
GET https://api.kelisto.es/api/v3/communications/providers/:slug/multiproduct

# Example request
$ curl https://api.kelisto.es/api/v3/communications/providers/jazztel/multiproduct
# Example response

{
  "data": {
    "id": 10,
    "name": "Jazztel",
    "network": "Orange",
    "roaming": null,
    "slug": "jazztel",
    "title": null,
    "phone_number": null,
    "image": {
      "url": "http://api.kelisto.es/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBEdz09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--3e777801122b84637e11e47c003f8d07229efa8e/jazztel.jpg"
    },
    "description": null,
    "status": "active",
    "product_names": [
      "internet_tv_mobile",
      "internet_mobile",
      "broadband",
      "internet_tv",
      "contract"
    ],
    "products": [
      {
        "product_name": "internet_tv_mobile",
        "offers": [
          {
            "id": 1109,
            "name": "Jazztel Irresistible 300 Mb + Cine y Series",
            "slug": "jazztel-irresistible-300-mb-cine-series",
            "product_name": "internet_tv_mobile",
            "product_type": "internet",
            "claim": "Disponible para ALTA NUEVA durante COVID19",
            "starred": false,
            "best_buy": false,
            "sponsored": false,
            "updated_at": "2020-04-03T13:38:32.636+02:00",
            "description": "<p>Para aquellos que estén buscando un pack que te permita estar siempre conectado y ver televisión de pago, <strong>Jazztel</strong> tiene la tarifa perfecta: <strong>Jazztel Irresistible 300 Mb + Orange TV Cine y Series</strong>. Con esta tarifa podrás disfrutar de la fibra de <strong>300 Mb</strong> para tu hogar, que es una de las mejores velocidades del mercado, y de  <strong>la línea de fijo</strong> con <strong>llamadas ilimitadas a fijos y móviles</strong> .</p>\n\n<p>Además, tendrás <strong>minutos ilimitados y 25 GB de datos móviles</strong> para hablar y  navegar por Internet desde tu teléfono sin preocupaciones. Con estos datos podrás hacer un uso intensivo de la conexión a la red desde tu móvil, ver contenidos en <em>streaming</em>, usar tus redes sociales, jugar con diferentes aplicaciones online o, incluso, conectar otro dispositivo a tus datos móviles. </p>\n\n<p>En cuanto a la televisión, podrás ver tus películas favoritas o los últimos estrenos desde el sofá de tu casa con <strong>Orange TV Cine y Series</strong>, donde podrás disfrutar de 40 canales de la TDT y de pago, además de tener acceso a más de 10.000 contenidos disponibles bajo demanda. Si eres futbolero y no te quieres perder nada esta temporada, puede añadir los packs <strong>Orange TV Fútbol</strong> y <strong>Orange Liga de Campeones</strong>, que te incluyen toda <strong>LaLiga Santander y LaLiga SmartBank</strong>, por un lado, y la <strong>Champions, Europa League, Supercopa de Europa y algunas ligas internacionales como la Premier League inglesa</strong>, por el otro.</p>\n\n<p>Entre las ventajas de esta tarifa, destaca que la instalación de la fibra es gratuita y que se conecta a la red de Orange, por lo que tendrás <strong>cobertura en casi todos los rincones de España</strong>. A cambio, la operadora te exige que firmes un <strong>compromiso de permanencia de 12 meses</strong>. </p>\n",
            "contract_length": 12,
            "has_deal": true,
            "url": "//comunicacion.kelisto.es/landings/jazztel/jazztel-irresistible-300-mb-cine-series?utoranw=kelisto_comparadores_kelisto_pc_kelisto",
            "prices": {
              "price": 73.9,
              "line_rental": 0.0,
              "router_price": 0.0,
              "router_delivery_cost": 0.0,
              "installation_price": 0.0,
              "line_installation_price": 0.0,
              "annual_price": 886.8,
              "current_monthly_price": 73.9
            },
            "internet": {
              "speed_download": 300,
              "speed_upload": 300,
              "internet_type": "optical_fiber",
              "symmetric": true
            },
            "landing": {
              "title": "Mientras esté en vigor el estado de alarma, se suspenden las portabilidades fijas y móviles, sólo se gestionaran altas",
              "legal": null
            },
            "has_landline": true,
            "landline": {
              "line_rental": 0.0,
              "minutes_to_mobile": 999999999,
              "minutes_to_landline": 999999999,
              "connection_charge": 0.0
            },
            "has_mobile": true,
            "mobile": {
              "minutes": 999999999,
              "data": 25000,
              "minutes_excess": "Sin coste",
              "data_excess": "la velocidad se reduce hasta 16kbps",
              "connection_charge": 0.0,
              "network": "Orange",
              "roaming": null,
              "coverage": "4g",
              "additional_lines": [
                {
                  "name": "Jazztel ",
                  "data": "1GB",
                  "minutes": "0 cént/min",
                  "price": 4.0
                },
                {
                  "name": "Jazztel",
                  "data": "25 GB",
                  "minutes": "Ilimitadas",
                  "price": 20.0
                },
                {
                  "name": "Jazztel",
                  "data": "10 GB",
                  "minutes": "Ilimitadas",
                  "price": 16.0
                },
                {
                  "name": "Jazztel",
                  "data": "4 GB",
                  "minutes": "ilimitadas",
                  "price": 10.0
                },
                {
                  "name": "Jazztel",
                  "data": "4 GB",
                  "minutes": "250 min",
                  "price": 9.0
                }
              ]
            },
            "has_tv": true,
            "tv": {
              "description": "<p>Incluye 40 canales con el mejor cine y series del mercado</p>\n",
              "claim": "Orange TV cine y series",
              "tv_channels": [
                {
                  "name": "Orange series",
                  "type": "Series",
                  "image": {
                    "url": "http://api.kelisto.es/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBIQT09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--82488cb232b272b0416d579a262691fe01cbd97f/orange-series.jpg"
                  }
                },
                {
                  "name": "Wuaki selection",
                  "type": "Cine",
                  "image": {
                    "url": "http://api.kelisto.es/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBTdz09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--36045c80bef0d30fac051ce43a151b0a5084d6ab/wuaki-selection.png"
                  }
                }
              ]
            },
            "has_promo": false,
            "provider": {
              "id": 10,
              "name": "Jazztel",
              "network": "Orange",
              "roaming": null,
              "slug": "jazztel",
              "title": null,
              "phone_number": null,
              "image": {
                "url": "https://assets.kelisto.us/ta5e4ccky6wzcuf1kuzb2xs1b3un",
                "url_rectangular": "https://assets.kelisto.us/ta5e4ccky6wzcuf1kuzb2xs1b3un",
                "url_profile": "https://assets.kelisto.us/1lyol30c6jac17cf08pi11l4seqr",
                "url_positive": "https://assets.kelisto.us/ta5e4ccky6wzcuf1kuzb2xs1b3un",
                "url_negative": "https://assets.kelisto.us/ta5e4ccky6wzcuf1kuzb2xs1b3un"
              },
              "colors": {
                "brand":  "#FFFFFF",
                "bullets": "#FFFFFF",
                "price": "#000000",
                "titles":  "#FFFFFF"
              },
              "description": null
            },
            "ratings": {
              "rating": 8.9,
              "price": 8,
              "speed": 8,
              "minutes": 10,
              "data": 10
            },
            "has_review": false
          },
          {...}
        ]
      },
      {
        "product_name": "internet_tv_mobile",
        "offers": [...]
      }
    ]
  }
}

Arguments

Parameter Description
slug Required string The slug of the provider.
section Optional Integer The defines which provider’s phone number is going to be displayed. The value must be one of these: Compare, Offer_detail, Compare_top, Compare_sem, process_help_results, process_help_results_sem, article, article_podium, article_opinion_card, newsletter. In case we don’t receive the section param, we will provide the default section phone number.
source Optional Integer Defines el source the phone number displayed. the value must be: idealista, default. In case we do not receive no parameters the default will be taken.
status optional string Retrieve offers by status (active, inactive, snapshot or discontinue). It can be an array of statuses. Default: active.
sort_by optional string The field that defines the offers order. Use suffix - to define descending order and + for ascending order. (i.e. +name). Multiple sorting values can be specified ('+name,-slug')

 Returns

Returns a list of product objects.

Cities

The city object

# Example object

{
  "name": "Madrid",
  "slug": "madrid",
  "postcode": "28013",
  "province": {
    "name": "Comunidad de Madrid"
  }
}

 Attributes

Attribute  Description
name string  Name of the city.
slug string Unique url identifier for the resource.
postcode string Postal code of the city.
province province object Province of the city.

List all cities

# Definition
GET https://api.kelisto.es/api/v3/communications/cities

# Example request
$ curl https://api.kelisto.es/api/v3/communications/cities
# Example response
{
  "pagination": {
    "links": {
      "first": "http://api.kelisto.es/api/v3/communications/cities?page=1",
      "next": "http://api.kelisto.es/api/v3/communications/cities?page=2",
      "last": "http://api.kelisto.es/api/v3/communications/cities?page=5"
    },
    "current_page": 1,
    "page_items": 25,
    "total_count": 125,
    "total_pages": 5
  },
  "data": [
    {
      "name": "Madrid",
      "slug": "madrid",
      "postcode": "28013",
      "province": {
        "name": "Comunidad de Madrid"
      }
    },
    {
      "name": "Barcelona",
      "slug": "barcelona",
      "postcode": "08002",
      "province": {
        "name": "Cataluña"
      }
    },
    {
      "name": "Valencia",
      "slug": "valencia",
      "postcode": "46002",
      "province": {
        "name": "Comunidad Valenciana"
      }
    },
    {...}
  ]
}

 Returns

Returns a list of city objects.

Retrieve cities by province

# Definition
GET https://api.kelisto.es/api/v3/communications/cities

# Example request
$ curl https://api.kelisto.es/api/v3/communications/cities?province=galicia
# Example response
{
  "pagination": {
    "links": {
      "first": "http://admin.kelisto.es/api/v3/communications/cities?province=galicia&page=1",
      "last": "http://api.kelisto.es/api/v3/communications/cities/madrid?page=2"
    },
    "current_page": 1,
    "page_items": 25,
    "total_count": 5,
    "total_pages": 1
  },
  "data": [
    {
      "name": "Vigo",
      "slug": "vigo",
      "postcode": "36201",
      "province": {
        "name": "Galicia"
      }
    },
    {
      "name": "Santiago de Compostela",
      "slug": "santiago-de-compostela",
      "postcode": "15705",
      "province": {
        "name": "Galicia"
      }
    },
    {
      "name": "Ferrol",
      "slug": "ferrol",
      "postcode": "15404",
      "province": {
        "name": "Galicia"
      }
    },
    {
      "name": "Lugo",
      "slug": "lugo",
      "postcode": "27001",
      "province": {
        "name": "Galicia"
      }
    },
    {
      "name": "La Coruña",
      "slug": "la-coruna",
      "postcode": "15005",
      "province": {
        "name": "Galicia"
      }
    }
  ]
}

 Arguments

Argument  Description
province optional  string Retrieve cities by province name, shows all cities if province name was not found in the database. Available provinces can be found in provinces endpoint.

Returns

Returns a list of city objects.

Retrieve all city offers

# Definition
GET https://api.kelisto.es/api/v3/communications/cities/:slug

# Example request
$ curl https://api.kelisto.es/api/v3/communications/cities/madrid
# Example request

{
  "pagination": {
    "links": {
      "first": "http://api.kelisto.es/api/v3/communications/cities/madrid?page=1",
      "next": "http://api.kelisto.es/api/v3/communications/cities/madrid?page=2",
      "last": "http://api.kelisto.es/api/v3/communications/cities/madrid?page=2"
    },
    "current_page": 1,
    "page_items": 25,
    "total_count": 30,
    "total_pages": 2
  },
  "data": {
    "name": "Madrid",
    "slug": "madrid",
    "postcode": "28013",
    "province": {
      "name": "Comunidad de Madrid"
    },
    "offers": [
      {
        "id": 1364,
        "name": "Alterna Fibra 100 Mb",
        "slug": "alterna-solo-fibra-100",
        "product_name": "broadband",
        "product_type": "internet",
        "claim": null,
        "starred": false,
        "best_buy": false,
        "sponsored": false,
        "updated_at": "2020-05-26T15:48:46.992+02:00",
        "description": "<p><strong>Alterna</strong> ofrece una de las ofertas de fibra y teléfono fijo más atractivas del mercado. A un precio muy competitivo, pone a disposición de sus clientes su tarifa <strong>Fibra 100 Mb</strong>.</p>\n\n<p>Si contratas esta oferta, tendrás <strong>100 Mb de fibra simétrica</strong> y una <strong>línea fija con llamadas ilimitadas a fijos y 60 minutos a móviles</strong>. Una vez superes la hora incluida en tu plan, pasarás a pagar 24,2 céntimos por cada minuto extra (más 20 céntimos por el establecimiento de la llamada).<br>\nLa gran ventaja de esta propuesta es que la fibra ofrecida por<strong>Alterna</strong> es simétrica, lo cual quiere decir que tendrás la misma velocidad de subida que de bajada. Recuerda, por otro lado, que si a tu domicilio no llega aún la fibra óptica tendrás la opción de contratar ADSL.</p>\n\n<p>Como ocurre con el resto de tarifas que incluyen fibra, si te decantas por esta opción tendrás que aceptar un <strong>compromiso de permanencia de 12 meses de duración</strong>, que de no cumplir implicará una penalización económica. Como ventaja adicional, <strong>tanto el <em>router</em> como la instalación son completamente gratuitas</strong>.</p>\n",
        "contract_length": 12,
        "has_deal": true,
        "url": "https://ofertas.alternaonline.es/telco/con_fib_mov/tarif2/100.html?tsource=374",
        "prices": {
          "price": 29.95,
          "line_rental": 0.0,
          "router_price": 0.0,
          "router_delivery_cost": 0.0,
          "installation_price": 0.0,
          "line_installation_price": 0.0,
          "annual_price": 359.4,
          "current_monthly_price": 29.95
        },
        "internet": {
          "speed_download": 100,
          "speed_upload": 100,
          "internet_type": "optical_fiber",
          "symmetric": true
        },
        "landing": {
          "title": "",
          "legal": ""
        },
        "has_landline": true,
        "landline": {
          "line_rental": 0.0,
          "minutes_to_mobile": 60,
          "minutes_to_landline": 999999999,
          "connection_charge": 0.0
        },
        "has_mobile": false,
        "has_tv": false,
        "has_promo": true,
        "promo": {
          "starts_at": null,
          "expires_at": "2020-01-31T23:59:00.000+01:00",
          "claim": "¡Instalación y router gratis!",
          "description": null,
          "months": null,
          "monthly_price": null,
          "type": "others"
        },
        "provider": {
          "id": 27,
          "name": "Alterna",
          "network": "Yoigo/Orange",
          "roaming": "",
          "slug": "alterna",
          "title": null,
          "phone_number": "911334040",
          "image": {
            "url": "http://api.kelisto.es/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbUlFIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--9afd930db3c36feb892092fd73ebef8fa878d499/alterna%20black.jpg"
          },
          "description": null
        },
        "ratings": {
          "rating": 8.4,
          "price": 10,
          "speed": 6,
          "minutes": 0,
          "data": 0
        },
        "has_review": false
      },
      {...}
    ]
  }
}

 Arguments

Argument  Description
slug Required  string
status optional string Retrieve offers by status (active, inactive, snapshot or discontinue). It can be an array of statuses. Default: active.
providers optional  string-array Retrieve offers by provider.
permanence optional  boolean Retrieve offers with or without permanence.
internet_type optional string Retrieve offers by internet_type. Value should be one of these: adsl, optical_fiber.
speed_download optional  float Retrieve offers by speed. Supports operators.

Returns

Returns a list of internet offer objets.

Provinces

The province object

# Example object

{
  "name": "Andalucía"
}

 Attributes

Attribute  Description
name string  Name of the province.

List all provinces

# Definition
GET https://api.kelisto.es/api/v3/communications/provinces

# Example request
$ curl https://api.kelisto.es/api/v3/communications/provinces
# Example response
{
  "pagination": {
    "links": {
      "first": "http://api.kelisto.es/api/v3/communications/provinces?page=1",
      "last": "http://api.kelisto.es/api/v3/communications/provinces?page=1"
    },
    "current_page": 1,
    "page_items": 25,
    "total_count": 17,
    "total_pages": 1
  },
  "data": [
    {
      "name": "Andalucía"
    },
    {
      "name": "Aragón"
    },
    {
      "name": "Asturias"
    },
    {...}
  ]
}

 Returns

Returns a list of province objets.

Comms related objects

Some API requests returns related objects depending of offer type.

The price object

Attributes

# Example object

{
  "price": "44.99",
  "line_rental": "0.0",
  "router_price": "0.0",
  "router_delivery_cost": "0.0",
  "installation_price": "0.0",
  "line_installation_price": "0.0",
  "annual_price": "494.88",
  "current_monthly_price": "29.99"
}
Attribute Description
price float Monthly offer price (euros).
line_rental optional, float Monthly price charged by line rental (euros).
router_price optional, float Price charged for internet router (euros).
router_delivery_cost optional, float Price charged to send the internet router (euros).
installation_price optional, float Price charged by technical installation (euros).
line_installation_price optional, float Price charged by line installation (euros).
annual_price float Total price charged in within one year period, taking care of promo months and line_rental (euros).
current_monthly_price float Price charged in within actual month period, taking care promo price and line_rental (euros).

The landline object

Attributes

# Example object

{
  "landline": {
    "line_rental": "0.0",
    "minutes_to_mobile": 60,
    "minutes_to_landline": 999999999,
    "connection_charge": "0.0"
  }
}
Attribute Description
line_rental float Monthly price charged by line rental (euros).
minutes_to_mobile integer Free monthly minutes available on landline to mobile lines (999999999 for unlimited).
minutes_to_landline integer Free monthly minutes available on landline to landlines (999999999 for unlimited).
connection_charge float Connection charge from landline calls when free minutes reached (cents).

The internet object

Attributes

# Example object

{
  "speed_download": 50,
  "speed_upload": 50,
  "symmetric": true,
  "internet_type": "optical_fiber"
}
Attribute Description
speed_download integer download speed (megabits).
speed_upload integer upload speed (megabits).
symmetric boolean false when download and upload speed are different, otherwise true.
internet_type string defines internet connection type, possible values adsl, optical_fiber, 3G, 4G or 5G.

The mobile object

Attributes

# Example object

{
  "minutes": 999999999,
  "data": 15000,
  "minutes_excess": "Sin coste",
  "data_excess": "la velocidad se reduce",
  "connection_charge": "0.0",
  "network": "Orange",
  "roaming": "Roaming incluído en Europa y EEUU",
  "coverage": "4g",
  "additional_lines": [
    {
      "data": "500 Mb",
      "id": 15,
      "minutes": "0 cént +20 cént estab.llamada",
      "name": "Linea Mini XS-1 año gratis",
      "price": 0.0
    },
    {
      "data": "10 GB",
      "id": 18,
      "minutes": "Ilimitadas",
      "name": "Línea M- 50% Dcto 6 meses",
      "price": 15.0
    }
  ]
}
Attribute Description
minutes integer Free monthly minutes available on mobile line (999999999 for unlimited).
data integer Free monthly internet data available on mobile line in MB (999999999 for unlimited).
minutes_excess string Mobile line calls price when free minutes reached.
data_excess string Mobile line internet data price when free data reached.
connection_charge float Connection charge from mobile calls when free minutes reached (cents).
network string Mobile line network operator.
roaming string Roaming possibilities at current line.
coverage optional, string Internet coverage for this mobile line (3g, 4g, 5g).
additional_lines optional, array Additional line object.

The additional lines object

Attributes

# Example object

{
  "id": 15,
  "data": "500 Mb",
  "minutes": "0 cént +20 cént estab.llamada",
  "name": "Linea Mini XS-1 año gratis",
  "price": 0.0
}
Attribute Description
id integer Unique identifier for the resource.
data string Internet data description.
minutes string Calls minutes description.
name string Name for this additional line.
price float Additional monthly price.

The TV object

Attributes

# Example object

{
  "claim": "Netflix y Amazon Prime",
  "description": "<p>Netflix incluido</p>",
  "tv_channels": [
    {
      "name": "Netflix",
      "type": "Series",
      "image": {
        "url": "https://api.kelisto.es/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBTZz09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--5e03ff819f24067e7ebe38980eb2b0369139999d/netflix.jpg"
      }
    },
    {
      "name": "Amazon Prime Video",
      "type": "Cine",
      "image": {
        "url": "https://api.kelisto.es/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBY1E9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--5e858155b84eeb2d0b73ff3628f0928086c46161/amazon%20prime%20video%202.jpg"
      }
    }
  ]
}
Attribute Description
claim string Short TV description.
description text Extended TV description in HTML format.
tv_channels array TV Channel objects.

The TV channel object

Attributes

# Example object

{
  "name": "Netflix",
  "type": "Series",
  "image": {
    "url": "https://api.kelisto.es/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBTZz09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--5e03ff819f24067e7ebe38980eb2b0369139999d/netflix.jpg"
  }
}
Attribute Description
name string TV channel name.
type string Tv channel type. Values should include one of these: Cine, Deportes, Documentales, Estilo de vida, Fútbol, Infantil, Internacional, Latinos, Música, Noticias, Series, Varios.
image hash Image object.

The comms rating object

Attributes

# Example object

{
  "rating": 4,
  "price": 4.5,
  "speed": 3,
  "minutes": 4,
  "data": 4.2
}
Attribute Description
rating float Global offer rating.
price float Price offer rating.
speed optional, float Download speed offer rating (just for internet offers).
minutes float Minutes offer rating.
data float Data offer rating.

 API Finances

Deposit offers

The deposit offer object

Attributes

# Example object

{
  "id": 16,
  "name": "Depósito 1.0 MIX a 6 Meses",
  "slug": "deposito-1-00",
  "product_name": "deposit",
  "product_type": "deposit",
  "claim": "",
  "starred": false,
  "best_buy": true,
  "sponsored": false,
  "updated_at": "2020-02-05T11:18:13.271+01:00",
  "status": "inactive",
  "description": "<p>El <strong>Depósito 1.0 MIX a 6 meses de Banco Mediolanum</strong> es un depósito a plazo fijo con el que podrás conseguir un interés por tus ahorros del 0,99% TIN (1% TAE) siempre que tus ahorros se mantengan en la entidad durante el plazo que acordaste inicialmente: es decir, durante 6 meses.</p>\n",
  "has_deal": false,
  "url": null,
  "remunerations": {
    "fixed_term": 6,
    "currency": "EUR",
    "max_amount": 500,
    "min_amount": 2,
    "interest_payment": "maturity_date",
    "interest": 0.99,
    "ear_interest": null,
    "tax_description": "<p>El <strong>Depósito 1.0 MIX a 6 meses</strong> de <strong>Banco Mediolanum</strong> está sujeto al pago de impuestos, es decir, como cualquier otro depósito a plazo fijo, tendrás que pagar por los intereses que recibas. </p>\n"
  },
  "obligations": {
    "signup_online": true,
    "signup_in_branch": true,
    "client_type": "general",
    "new_clients": true,
    "old_clients": true,
    "linked_account": true,
    "obligatory_vinculation": false,
    "payroll_vinculation": false,
    "receipts_vinculation": false,
    "insurances_vinculation": false,
    "card_vinculation": false,
    "use_card_vinculation": false,
    "savings_vinculation": false,
    "pension_vinculation": false,
    "invest_vinculation": false,
    "min_balance_vinculation": false,
    "vinculation_number": 0,
    "cities_number": null,
    "signup_description": "<p>Para contratar el <strong>Depósito 1.0 MIX a 6 meses</strong> de <strong>Banco Mediolanum</strong>, tienes dos opciones:</p>\n\n<p>-Asistir a alguna de sus 51 oficinas que tienen repartidas por 23 comunidades autónomas. </p>\n\n<p>-Family Banker, que es un asesor personal que pertenece a la entidad y con el que podrás firmar la adquisición de tu depósito.</p>\n",
    "linked_fund_description": "<p>El Depósito 1.0 MIX a 6 meses de Banco Mediolanum está protegido por el Fondo de Garantía de Depósitos español. Lo que significa que, en caso de quiebra de la entidad, te garantizarán hasta 100.000 euros por titular. </p>\n",
    "country": {
      "name": "Spain",
      "continent": "Europe",
      "currency": "EUR",
      "translations": {
        "en": "Spain",
        "es": "España"
      }
    }
  },
  "costs": {
    "total_cancellation": "cancellable",
    "interest_cancellation": true,
    "cancellation_reduction": true,
    "interest_cancellation_reduction": null,
    "other_cancellation": false,
    "partial_cancellation": "non_cancellable",
    "other_cancellation_description": null,
    "early_cancellation_description": null
  },
  "has_promo": false,
  "bank": {
    "id": 5,
    "name": "Banco Mediolanum",
    "slug": "banco-mediolanum",
    "image": {
      "url": "https://api.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBYzA9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--1bca8c03b3ada83171f47daf0924e389b5c11fa1/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--e4438123782b514c5dd2c7ccc53000c045a02e84/banco-mediolanum-s.jpg",
      "url_square": "https://api.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBYzA9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--1bca8c03b3ada83171f47daf0924e389b5c11fa1/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--e4438123782b514c5dd2c7ccc53000c045a02e84/banco-mediolanum-s.jpg",
      "url_rectangular": "https://api.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBYzQ9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--006b80a619c2253241139317d0c020a95205ba6e/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRERNMk5IZzVObDRHT2daRlZEb01aM0poZG1sMGVVa2lDMk5sYm5SbGNnWTdCMVE2Q1dOeWIzQkpJZzh6TmpSNE9UWXJNQ3N3QmpzSFZBPT0iLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--145c204ed502b2f8bd6b1400501ac239797de85e/banco-mediolanum-w.jpg"
    }
  },
  "ratings": {
    "rating": 7.3,
    "interest": 7,
    "min_amount": 10,
    "max_amount": 4,
    "partial_cancellation": 10,
    "other_cancellation": 10
  },
  "has_review": false
}
Attribute Description
id integer Unique identifier for the resource.
name string Offer name.
slug string  Offer slug.
product_name string  The specific product name (deposit).
product_type string  Product type identifier (deposit).
claim string Short offer description.
starred boolean -
best_buy boolean Returns true if the offer is a best buy, elsewhere false.
sponsored boolean Returns true if the offer is sponsored, elsewhere false.
updated_at timestamp Last update time.
status string Status of the offer. Can be active, inactive, snapshot or discontinue.
description string Description using HTML format.
has_deal boolean Return true if Kelisto has a deal for this offer with its provider.
url string Offer landing page URL.
remunerations hash Remuneration object.
obligations hash Obligation object.
costs hash Costs object.
has_promo boolean Returns true if the current offer has promo hash attributes.
promo optional, hash Promo object.
bank hash Bank object.
ratings hash Rating object.
has_review boolean Returns true if the current offer has review hash attributes.
review optional, hash Review object.

The deposit remuneration object

Attributes

# Example object

{
  "fixed_term": 6,
  "currency": "EUR",
  "max_amount": 500,
  "min_amount": 2,
  "interest_payment": "maturity_date",
  "interest": 0.99,
  "ear_interest": 0.80,
  "tax_description": "<p>El <strong>Depósito 1.0 MIX a 6 meses</strong> de <strong>Banco Mediolanum</strong> está sujeto al pago de impuestos, es decir, como cualquier otro depósito a plazo fijo, tendrás que pagar por los intereses que recibas. </p>\n\n<p>En cuanto a la cuantía que te cobrarán, dependerá del rendimiento que consigas.</p>\n"
}
Attribute Description
fixed_term integer Term in months.
currency string Currency code.
max_amount integer Maximum allowed amount (€).
min_amount integer Minimum allowed amount (€).
interest_payment string Interest payment type. Can be maturity_date, monthly, quarterly, early, annual or bi-annual.
interest float Interest applied (%).
ear_interest float EAR interest applied (TAE (%)).
tax_description string Description of the taxes applied.

The deposit obligation object

Attributes

# Example object

{
  "signup_online": true,
  "signup_in_branch": true,
  "client_type": "general",
  "new_clients": true,
  "old_clients": true,
  "linked_account": true,
  "obligatory_vinculation": false,
  "payroll_vinculation": false,
  "receipts_vinculation": false,
  "insurances_vinculation": false,
  "card_vinculation": false,
  "use_card_vinculation": false,
  "savings_vinculation": false,
  "pension_vinculation": false,
  "invest_vinculation": false,
  "min_balance_vinculation": false,
  "vinculation_number": 0,
  "cities_number": 3,
  "signup_description": "<p>Para contratar el <strong>Depósito 1.0 MIX a 6 meses</strong> de <strong>Banco Mediolanum</strong>, tienes dos opciones:</p>\n\n<p>-Asistir a alguna de sus 51 oficinas que tienen repartidas por 23 comunidades autónomas. </p>\n\n<p>-Family Banker, que es un asesor personal que pertenece a la entidad y con el que podrás firmar la adquisición de tu depósito.</p>\n",
  "linked_fund_description": "<p>El Depósito 1.0 MIX a 6 meses de Banco Mediolanum está protegido por el Fondo de Garantía de Depósitos español. Lo que significa que, en caso de quiebra de la entidad, te garantizarán hasta 100.000 euros por titular. </p>\n",
  "country": {
    "name": "Spain",
    "continent": "Europe",
    "currency": "EUR",
    "translations": {
      "en": "Spain",
      "es": "España"
    }
  }
}
Attribute Description
signup_online boolean Defines if the client can sign up an offer online.
signup_in_branch boolean Defines if the client can sign up an offer in person at the bank.
client_type string Type of client. Can be general, children or teenagers.
new_clients boolean Defines if the offer is available for new clients.
old_clients boolean Defines if the offer is available for old clients.
linked_account boolean Defines if the offer is vinculated to a bank account.
obligatory_vinculation boolean Defines if the offer requires the client to have other vinculations with the bank.
payroll_vinculation boolean Defines if the offer requires the client to receive the payroll in the bank.
receipts_vinculation boolean Defines if the offer requires the client to pay receipts in the bank.
insurances_vinculation boolean Defines if the offer requires the client to pay insurances in the bank.
card_vinculation boolean Defines if the offer requires the client to have a card of the bank.
use_card_vinculation boolean Defines if the offer requires the client to use the card of the bank.
savings_vinculation boolean Defines if the offer requires the client to have their savings in the bank.
pension_vinculation boolean Defines if the offer requires the client to receive their pension in the bank.
invest_vinculation boolean Defines if the offer requires the client to invest through the bank.
min_balance_vinculation boolean Defines if the offer requires the client to have a minimum balance in the bank.
vinculation_number integer Number of required vinculations.
cities_number integer Number of localities where this offer is available.
signup_description string Description of how to sign up the offer.
linked_fund_description string Funds guaranty description.
country hash Country object.

The deposit costs object

Attributes

# Example object

{
  "total_cancellation": "cancellable",
  "interest_cancellation": true,
  "cancellation_reduction": true,
  "interest_cancellation_reduction": 3,
  "other_cancellation": true,
  "partial_cancellation": "non_cancellable",
  "other_cancellation_description": "Al cancelar de otras formas se aplica una penalización.",
  "early_cancellation_description": "Al cancelar parcialmente se aplica una penalización."
}
Attribute Description
total_cancellation string Defines how is the offer cancellable. Can be non_cancellable, cancellable or check_with.
interest_cancellation boolean Defines if the interest is cancelled with the offer.
cancellation_reduction boolean Defines it the interest is reduced when the offer is cancelled.
interest_cancellation_reduction integer Interest reduction percentage when the offer is cancelled (%).
other_cancellation boolean Defines if there is any other charge for cancellation.
partial_cancellation string Defines how is the offer partially cancellable. Can be non_cancellable, cancellable or check_with.
other_cancellation_description string Describes other charges applied due to cancellation.
early_cancellation_description string Describes more information about partial cancellation.

Retrieve a deposit offer

# Definition
GET https://api.kelisto.es/api/v3/finances/offers/deposits/:slug?bank_slug=:bank_slug

# Example request
$ curl https://api.kelisto.es/api/v3/finances/offers/deposits/deposito-1-00?bank_slug=banco-mediolanum
# Example response

{
  "data": {
    "id": 38,
    "name": "Depósito 1.0 MIX a 6 Meses",
    "slug": "deposito-1-00",
    "product_name": "deposit",
    "product_type": "deposit",
    "claim": null,
    "starred": false,
    "best_buy": true,
    "sponsored": false,
    "updated_at": "2019-07-26T08:36:12.743+02:00",
    "status": "active",
    "description": "<p>El <strong>Depósito 1.0 MIX a 6 meses de Banco Mediolanum</strong> es un depósito a plazo fijo con el que podrás conseguir un interés por tus ahorros del 0,99% TIN (1% TAE) siempre que tus ahorros se mantengan en la entidad durante el plazo que acordaste inicialmente: es decir, durante 6 meses.</p>\n</p>\n",
    "has_deal": false,
    "url": null,
    "remunerations": {
      "fixed_term": 6,
      "currency": "EUR",
      "max_amount": 500,
      "min_amount": 2,
      "interest_payment": "maturity_date",
      "interest": 0.99,
      "ear_interest": null,
      "tax_description": "<p>El <strong>Depósito 1.0 MIX a 6 meses</strong> de <strong>Banco Mediolanum</strong> está sujeto al pago de impuestos, es decir, como cualquier otro depósito a plazo fijo, tendrás que pagar por los intereses que recibas. </p>\n\n<p>En cuanto a la cuantía que te cobrarán, dependerá del rendimiento que consigas. De forma que:</p>\n\n<p>-Entre 0€ y 6.000€: un 19%</p>\n\n<ul>\n<li><p>Entre 6.000,01 y 50.000€: un 21%</p></li>\n<li><p>Más de 50.000€: un 23%</p></li>\n</ul>\n"
    },
    "obligations": {
      "signup_online": true,
      "signup_in_branch": true,
      "client_type": "general",
      "new_clients": true,
      "old_clients": true,
      "linked_account": true,
      "obligatory_vinculation": false,
      "payroll_vinculation": false,
      "receipts_vinculation": false,
      "insurances_vinculation": false,
      "card_vinculation": false,
      "use_card_vinculation": false,
      "savings_vinculation": false,
      "pension_vinculation": false,
      "invest_vinculation": false,
      "min_balance_vinculation": false,
      "vinculation_number": 0,
      "cities_number": null,
      "signup_description": "<p>Para contratar el <strong>Depósito 1.0 MIX a 6 meses</strong> de <strong>Banco Mediolanum</strong>, tienes dos opciones:</p>\n\n<p>-Asistir a alguna de sus 51 oficinas que tienen repartidas por 23 comunidades autónomas. </p>\n\n<p>-Family Banker, que es un asesor personal que pertenece a la entidad y con el que podrás firmar la adquisición de tu depósito.</p>\n",
      "linked_fund_description": "<p>El Depósito 1.0 MIX a 6 meses de Banco Mediolanum está protegido por el Fondo de Garantía de Depósitos español. Lo que significa que, en caso de quiebra de la entidad, te garantizarán hasta 100.000 euros por titular. </p>\n",
      "country": {
        "name": "Spain",
        "continent": "Europe",
        "currency": "EUR",
        "translations": {
          "en": "Spain",
          "es": "España"
        }
      }
    },
    "costs": {
      "total_cancellation": "cancellable",
      "interest_cancellation": true,
      "cancellation_reduction": true,
      "interest_cancellation_reduction": null,
      "other_cancellation": false,
      "partial_cancellation": "non_cancellable",
      "other_cancellation_description": null,
      "early_cancellation_description": null
    },
    "has_promo": false,
    "bank": {
      "id": 5,
      "name": "Banco Mediolanum",
      "slug": "banco-mediolanum",
      "image": {
        "url": "https://api.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBYzA9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--1bca8c03b3ada83171f47daf0924e389b5c11fa1/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--e4438123782b514c5dd2c7ccc53000c045a02e84/banco-mediolanum-s.jpg",
        "url_square": "https://api.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBYzA9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--1bca8c03b3ada83171f47daf0924e389b5c11fa1/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--e4438123782b514c5dd2c7ccc53000c045a02e84/banco-mediolanum-s.jpg",
        "url_rectangular": "https://api.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBYzQ9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--006b80a619c2253241139317d0c020a95205ba6e/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRERNMk5IZzVObDRHT2daRlZEb01aM0poZG1sMGVVa2lDMk5sYm5SbGNnWTdCMVE2Q1dOeWIzQkpJZzh6TmpSNE9UWXJNQ3N3QmpzSFZBPT0iLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--145c204ed502b2f8bd6b1400501ac239797de85e/banco-mediolanum-w.jpg"
      }
    },
    "ratings": {
      "rating": 7.9,
      "interest": 7,
      "min_amount": 10,
      "max_amount": 4,
      "partial_cancellation": 10,
      "other_cancellation": 10
    },
    "has_review": false
  }
}

Arguments

Parameter Description
slug Required string The slug of the offer to retrieve.
bank_slug Required string The slug of the bank related to the offer.

 Returns

Returns a Deposit offer object if a valid slug, and bank_slug were provided.

List all deposit offers

# Definition
GET https://api.kelisto.es/api/v3/finances/offers/deposits?<criteria>

# Example request
$ curl https://api.kelisto.es/api/v3/finances/offers/deposits?bank_slug=banca-sistema&cancellable=true&fixed_term[gt]=100&fixed_term[lt]=130&max_amount=200000&min_amount=4000
# Example response
{
  "pagination": {
    "links": {
      "first": "https://api.kelisto.dev/api/v3/finances/offers/deposits?bank_slug=banca-sistema&page=1",
      "next": "https://api.kelisto.dev/api/v3/finances/offers/deposits?bank_slug=banca-sistema&page=2",
      "last": "https://api.kelisto.dev/api/v3/finances/offers/deposits?bank_slug=banca-sistema&page=4"
    },
    "current_page": 1,
    "page_items": 25,
    "total_count": 77,
    "total_pages": 4
  },
  "data": [
    {
      "id": 65,
      "name": "Depósito a 10 años",
      "slug": "deposito-10-anos",
      "product_name": "deposit",
      "product_type": "deposit",
      "claim": null,
      "starred": false,
      "best_buy": true,
      "sponsored": false,
      "updated_at": "2019-07-26T10:22:07.185+02:00",
      "status": "snapshot",
      "description": "<p>Dentro de la oferta de plazos fijos denominada “SI conto! DEPOSITO” podrás encontrar el Depósito a 10 años de Banca Sistema, la oferta más largo plazo de esta entidad italiana. Con este producto podrás conseguir una remuneración del 2,20% TIN (2,01% TAE), siempre que mantengas tus ahorros durante 120 meses en la entidad. </p>\n",
      "has_deal": false,
      "url": null,
      "remunerations": {
        "fixed_term": 120,
        "currency": "EUR",
        "max_amount": 100000,
        "min_amount": 5000,
        "interest_payment": "maturity_date",
        "interest": 2.2,
        "ear_interest": null,
        "tax_description": "<p>Al contratar un depósito a plazo fijo en Banca Sistema hay varias cuestiones que debes conocer.</p>\n"
      },
      "obligations": {
        "signup_online": true,
        "signup_in_branch": false,
        "client_type": "general",
        "new_clients": true,
        "old_clients": true,
        "linked_account": true,
        "obligatory_vinculation": false,
        "payroll_vinculation": false,
        "receipts_vinculation": false,
        "insurances_vinculation": false,
        "card_vinculation": false,
        "use_card_vinculation": false,
        "savings_vinculation": false,
        "pension_vinculation": false,
        "invest_vinculation": false,
        "min_balance_vinculation": false,
        "vinculation_number": 0,
        "cities_number": null,
        "signup_description": "<p>Si quieres contratar el Depósito a 10 años de Banca Sistema tendrás que estar previamente registrado en la plataforma electrónica de Raisin y tener abierta una Cuenta Raisin.</p>\n",
        "linked_fund_description": "<p>El Depósito a 10 años de BACB está respaldado por el Fondo de Garantía de Depósitos de Italia, que funciona igual que el Fondo de Garantía de España. Su  fin es garantizar que, en caso de que el banco quebrase, cada titular podría recuperar hasta 100.000 euros.</p>\n",
        "country": {
          "name": "Italy",
          "continent": "Europe",
          "currency": "EUR",
          "translations": {
            "en": "Italy",
            "es": "Italia"
          }
        }
      },
      "costs": {
        "total_cancellation": "cancellable",
        "interest_cancellation": true,
        "cancellation_reduction": true,
        "interest_cancellation_reduction": null,
        "other_cancellation": false,
        "partial_cancellation": "non_cancellable",
        "other_cancellation_description": null,
        "early_cancellation_description": null
      },
      "has_promo": true,
      "promo": {
        "started_at": "2019-06-01T00:00:00.000+02:00",
        "expired_at": "2024-07-01T00:00:00.000+02:00",
        "claim": "¡Gana hasta 100€!",
        "description": "<p>Al contratar tu nuevo depósito en Raisin podrás conseguir hasta 100 euros de regalo si cumples los requisitos.\n"
      },
      "bank": {
        "id": 62,
        "name": "Banca Sistema",
        "slug": "banca-sistema",
        "image": {
          "url": "https://api.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdFFDIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--7e31ab63afd81a6737d7d308cb843a97ae1a2648/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--e4438123782b514c5dd2c7ccc53000c045a02e84/banca-sistema-s.jpg",
          "url_square": "https://api.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdFFDIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--7e31ab63afd81a6737d7d308cb843a97ae1a2648/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--e4438123782b514c5dd2c7ccc53000c045a02e84/banca-sistema-s.jpg",
          "url_rectangular": "https://api.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdFVDIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--8b65844220a0965f791d0bbcd6ec83e157e49207/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRERNMk5IZzVObDRHT2daRlZEb01aM0poZG1sMGVVa2lDMk5sYm5SbGNnWTdCMVE2Q1dOeWIzQkpJZzh6TmpSNE9UWXJNQ3N3QmpzSFZBPT0iLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--145c204ed502b2f8bd6b1400501ac239797de85e/banca-sistema-w.jpg"
        }
      },
      "ratings": {
        "rating": 9.6,
        "interest": 10,
        "min_amount": 9,
        "max_amount": 9,
        "partial_cancellation": 10,
        "other_cancellation": 10
      },
      "has_review": false
    },
    # deposit object matching criteria,
    # deposit object matching criteria,
    # deposit object matching criteria,
    # ...
  ]
}

Arguments

Parameter Description
bank_slug optional string The slug of the bank related to the offer.
status optional string Retrieve offers by status (active, inactive, snapshot or discontinue). It can be an array of statuses. Default: active.
cancellable optional boolean Retrieve offers which total_cancellation is cancellable.
fixed_term[operator] optional integer-operator Retrieve offers which fixed_term matches conditions defined by operator.
max_amount optional integer Retrieve offers which max_amount is equal or lower than this value.
min_amount optional integer Retrieve offers which min_amount is equal or higher than this value.
operating_in_spain optional integer Retrieve offers belonging to banks that operate in spain.

 Returns

Returns a list with the deposit offer objects that match specified criteria.

Multiproduct deposit list request

# Definition
GET https://api.kelisto.es/api/v3/finances/multiproduct/:bank_slug/deposits

# Example request
$ curl https://api.kelisto.es/api/v3/finances/multiproduct/pibank/deposits
# Example response

{
  "data":{
    "id":30,
    "name":"Pibank",
    "slug":"pibank",
    "status":"active",
    "image":{
      "url":"https://api.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcUFMIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--f40bb06d4c07e5880532c045d03f066db9225523/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpQ3pnd2VEZ3dYZ1k3QmxRNkRHZHlZWFpwZEhsSklndGpaVzUwWlhJR093WlVPZ2xqY205d1NTSU9PREI0T0RBck1Dc3dCanNHVkE9PSIsImV4cCI6bnVsbCwicHVyIjoidmFyaWF0aW9uIn19--cb6dbdeb942b2cec9d8893c07f51de2233e977f4/_0011_pibank-s.jpg",
      "url_square":"https://api.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcUFMIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--f40bb06d4c07e5880532c045d03f066db9225523/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpQ3pnd2VEZ3dYZ1k3QmxRNkRHZHlZWFpwZEhsSklndGpaVzUwWlhJR093WlVPZ2xqY205d1NTSU9PREI0T0RBck1Dc3dCanNHVkE9PSIsImV4cCI6bnVsbCwicHVyIjoidmFyaWF0aW9uIn19--cb6dbdeb942b2cec9d8893c07f51de2233e977f4/_0011_pibank-s.jpg",
      "url_rectangular":"https://api.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcUVMIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--0cdf2adaa1e221c001302b906ba3f01f7beb65b4/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpRERNMk5IZzVObDRHT3daVU9neG5jbUYyYVhSNVNTSUxZMlZ1ZEdWeUJqc0dWRG9KWTNKdmNFa2lEek0yTkhnNU5pc3dLekFHT3daVSIsImV4cCI6bnVsbCwicHVyIjoidmFyaWF0aW9uIn19--a2fcbcd5ef415c9684a7286153d10c6fb68a026b/_0011_pibank-w.jpg"
    },
    "product_names":[
      "deposit"
    ],
    "products":[
      {
        "product_name":"deposit",
        "offers":[
          {
            "id":693,
            "name":"Depósito a 12 meses",
            "slug":"deposito-12-meses-pibank",
            "product_name":"deposit",
            "product_type":"deposit",
            "claim":"Con abono trimestral de intereses",
            "starred":false,
            "best_buy":false,
            "sponsored":false,
            "updated_at":"2022-10-07T08:44:49.608+02:00",
            "status":"active",
            "description":"<p>El <strong>Depósito a 12 meses de Pibank</strong>, la banca online de Banco Pichincha, es un <strong>depósito a plazo fijo</strong>, es decir, un producto bancario que te concederá una rentabilidad por tus ahorros a cambio de que los mantengas en la entidad durante un período de tiempo determinado. En este caso, Pibank te premiará con un Tipo de Interés Nominal (TIN) del 2% (2,01% TAE) a cambio de que respetes un período de permanencia de 12 meses. </p>\n\n<p>En cuanto al <strong>cobro de intereses</strong>, Pibank te los abonará trimestralmente en la cuenta bancaria asociada al depósito que tendrás que abrir en el momento de su contratación. Eso sí, recuerda que si quieres <strong>cancelar tu depósito de forma anticipada</strong>, podrás hacerlo en cualquier momento (tanto de forma total como parcial), pero tendrás que devolver estos intereses. </p>\n\n<p>Además, debes tener en cuenta que la remuneración que consigas será, como sucede con los beneficios de todas las cuentas remuneradas y depósitos a plazo, un <strong>rendimiento del capital mobiliario</strong>, por lo que tendrás que pagar impuestos a Hacienda. La cuantía de estos impuestos dependerá del importe total de tus intereses,  pero nunca superará el 23%. </p>\n\n<p>Para <strong>contratar el Depósito a 12 meses de Pibank</strong> solo necesitarás ser mayor de 18 años,  disponer de un dispositivo con conexión a Internet y contar con una Cuenta Nómina o una Cuenta Remunerada de Pibank. Este producto no requiere de un importe mínimo para su contratación, por lo que podrás invertir cualquier cantidad, ni te impone ningún tope máximo. Ahora bien, recuerda que el Fondo de Garantía de Depósitos ( que es el mecanismo que protege el dinero que mantengas en este tipo de productos) solo respalda hasta 100.000€ por entidad y titular en casa de quiebra de una entidad. </p>\n",
            "has_deal":false,
            "url":null,
            "remunerations":{
              "fixed_term":12,
              "currency":"EUR",
              "max_amount":-1,
              "min_amount":0,
              "interest_payment":"quarterly",
              "interest":2,
              "ear_interest":2.01,
              "tax_description":"<p>Los beneficios que te genere el Depósito a 12 meses de Pibank están sujetos al pago de impuestos en tanto que rendimiento de capital mobiliario. La cuantía de estos impuestos dependerá del importe total de tus intereses,  pero nunca superará el 23%. </p>\n"
            },
            "obligations":{
              "signup_online":true,
              "signup_in_branch":true,
              "client_type":"general",
              "new_clients":true,
              "old_clients":true,
              "linked_account":true,
              "obligatory_vinculation":false,
              "payroll_vinculation":false,
              "receipts_vinculation":false,
              "insurances_vinculation":false,
              "card_vinculation":false,
              "use_card_vinculation":false,
              "savings_vinculation":false,
              "pension_vinculation":false,
              "invest_vinculation":false,
              "min_balance_vinculation":false,
              "vinculation_number":0,
              "cities_number":-1,
              "signup_description":"<p>El Depósito a 12 de Pibank solo puede contratarse a través de Internet.</p>\n",
              "linked_fund_description":"<p>Los ahorros que mantengas en este depósito cuentan con el respaldo del <strong>Fondo de Garantía de Depósitos Español</strong>, que cubre un máximo de 100.000€ por depositante y entidad.</p>\n",
              "country":{
                "name":"Spain",
                "continent":"Europe",
                "currency":"EUR",
                "translations":{
                  "en":"Spain",
                  "es":"España"
                }
              }
            },
            "costs":{
              "total_cancellation":"cancellable",
              "interest_cancellation":true,
              "cancellation_reduction":false,
              "interest_cancellation_reduction":null,
              "other_cancellation":false,
              "partial_cancellation":"cancellable",
              "other_cancellation_description":null,
              "early_cancellation_description":null
            },
            "has_promo":false,
            "bank":{
              "id":30,
              "name":"Pibank",
              "slug":"pibank",
              "status":"active",
              "image":{
                "url":"https://api.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcUFMIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--f40bb06d4c07e5880532c045d03f066db9225523/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpQ3pnd2VEZ3dYZ1k3QmxRNkRHZHlZWFpwZEhsSklndGpaVzUwWlhJR093WlVPZ2xqY205d1NTSU9PREI0T0RBck1Dc3dCanNHVkE9PSIsImV4cCI6bnVsbCwicHVyIjoidmFyaWF0aW9uIn19--cb6dbdeb942b2cec9d8893c07f51de2233e977f4/_0011_pibank-s.jpg",
                "url_square":"https://api.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcUFMIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--f40bb06d4c07e5880532c045d03f066db9225523/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpQ3pnd2VEZ3dYZ1k3QmxRNkRHZHlZWFpwZEhsSklndGpaVzUwWlhJR093WlVPZ2xqY205d1NTSU9PREI0T0RBck1Dc3dCanNHVkE9PSIsImV4cCI6bnVsbCwicHVyIjoidmFyaWF0aW9uIn19--cb6dbdeb942b2cec9d8893c07f51de2233e977f4/_0011_pibank-s.jpg",
                "url_rectangular":"https://api.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcUVMIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--0cdf2adaa1e221c001302b906ba3f01f7beb65b4/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpRERNMk5IZzVObDRHT3daVU9neG5jbUYyYVhSNVNTSUxZMlZ1ZEdWeUJqc0dWRG9KWTNKdmNFa2lEek0yTkhnNU5pc3dLekFHT3daVSIsImV4cCI6bnVsbCwicHVyIjoidmFyaWF0aW9uIn19--a2fcbcd5ef415c9684a7286153d10c6fb68a026b/_0011_pibank-w.jpg"
              }
            },
            "ratings":{
              "rating":7.4,
              "interest":10,
              "min_amount":10,
              "max_amount":0,
              "partial_cancellation":10,
              "other_cancellation":10
            },
            "has_review":false
          }
        ]
      }
    ]
  }
}

Arguments

Parameter Description
bank_slug URL segment string The slug of the bank related to the offer (as part of the url)

Returns

Returns basic bank information with a list of deposit offer objects products grouped by product_name

# Definition
GET https://api.kelisto.es/api/v3/finances/related_offers/deposits/:slug?:bank_slug

# Example request
$ curl https://admin.kelisto.es/api/v3/finances/related_offers/deposits/deposito-12-meses-pibank?bank_slug=pibank

{
  "data": [
    {
      "id": 6,
      "name": "Depósito Facto 12 meses",
      "slug": "deposito-facto-12-meses",
      "product_name": "deposit",
      "product_type": "deposit",
      "claim": "Sucursal española, no Mod 720",
      "starred": false,
      "best_buy": true,
      "sponsored": true,
      "updated_at": "2023-06-19T03:00:08.800+02:00",
      "status": "active",
      "sponsored_order": 1,
      "description": "<p>El Depósito Facto a 12 meses de BFF (antes Banca Farmafactoring) es un depósito a plazo fijo con el que podrás conseguir una remuneración del 3,50% TIN (Tipo de Interés Nominal) y 3,546% TAE (Tasa Anual Equivalente) si mantienes tus ahorros depositados durante el plazo acordado con esta entidad de origen italiano. </p>\n\n<p>En caso de querer <strong>contratar</strong> el Depósito Facto a 12 meses de BFF, debes tener en cuenta un par de cuestiones: </p>\n\n<ul>\n<li>Solo podrás hacerlo a través de la página web de la entidad. </li>\n<li>Al contratarlo, abrirá también una cuenta corriente, llamada Cuenta Facto, que es totalmente gratuita y que será donde cobres los intereses que lograrás con el Depósito Facto a 12 meses de BFF. </li>\n<li>Para poder contratar el Depósito Facto a 12 meses de BFF  necesitarás tener unos ahorros mínimos de 5.000€. La inversión máxima que podrás destinara este plazo fijo es de 3.000.000€.</li>\n</ul>\n\n<p>En lo que respecta a la <strong>liquidación o pago de los intereses</strong>, con el Depósito Facto a 12 meses de BFF los irás cobrando cada 90 días. Una vez haya terminado el plazo de un año acordado con la entidad, recibirás tus ahorros más los intereses generados en tu Cuenta Facto y, desde ahí, podrás decidir si quieres <strong>renovar</strong> esta imposición y, en caso afirmativo, si deseas hacerlo por el mismo plazo o por otro distinto. </p>\n\n<p>Antes de contratar el Depósito Facto a 12 meses de BFF debes tener en cuenta que <strong>no permite la cancelación anticipada</strong>: es decir, no podrás recuperar tu dinero antes del plazo de un año que habías acordado con la entidad. </p>\n\n<p>En lo que respecta a la <strong>protección</strong> del Depósito Facto a 12 meses de BFF, este producto de ahorro cuenta con el respaldo del Fondo Interbancario di Titula Dei Depositi (FITD), es decir, el fondo de garantía de depósitos de Italia, de donde es originaria BFF. Este sistema, al igual que el español, garantiza que podrás recuperar hasta 100.000€ por entidad y titular en caso de quiebra de la entidad. </p>\n",
      "has_deal": true,
      "url": "https://clk.tradedoubler.com/click?p=277745&a=2924858&g=24649814",
      "remunerations": {
        "fixed_term": 12,
        "currency": "EUR",
        "max_amount": 3000000,
        "min_amount": 5000,
        "interest_payment": "quarterly",
        "interest": 3.5,
        "ear_interest": 3.546,
        "tax_description": "<p>Como sucede con el resto de depósitos a plazo fijo, los intereses que cobres con el <strong>Depósito Facto a 12 meses</strong> de BFF estarán sujetos al pago de impuestos. Esto se debe a que se consideran rendimientos del capital mobiliario y, por tanto, te tocará pagar por ellos. </p>\n\n<p>Ahora bien, en función de la cantidad que consigas, tendrás que pagar diferentes porcentajes:</p>\n\n<p>--Entre 0 y 6.000€: un 19%</p>\n\n<ul>\n<li><p>Entre 6.000,01 y 50.000€: un 21%</p></li>\n<li><p>Más de 50.000€: un 23%</p></li>\n</ul>\n"
      },
      "obligations": {
        "signup_online": true,
        "signup_in_branch": false,
        "client_type": "general",
        "new_clients": true,
        "old_clients": true,
        "linked_account": true,
        "obligatory_vinculation": false,
        "payroll_vinculation": false,
        "receipts_vinculation": false,
        "insurances_vinculation": false,
        "card_vinculation": false,
        "use_card_vinculation": false,
        "savings_vinculation": false,
        "pension_vinculation": false,
        "invest_vinculation": false,
        "min_balance_vinculation": false,
        "vinculation_number": 0,
        "cities_number": -1,
        "signup_description": "<p>El <strong>Depósito Facto a 12 meses</strong> de <strong>BFF</strong> se puede contratar online. Para ello, tendrás que seguir con el siguiente proceso:</p>\n\n<p>-Rellenar los datos personales y fiscales del formulario que te pasará la entidad.</p>\n\n<p>-Descargar y firmar el contrato online o tradicionalmente.</p>\n\n<p>-Ingresar tu dinero en tu Cuenta Facto.</p>\n\n<p>-Gestiona tu depósito y comienza a operar. </p>\n",
        "linked_fund_description": "<p>Aunque BFF ofrece sus productos en España, los Depósitos Facto cuentan con el respaldo del Sistema de Garantía de Depósitos Italiano. Ahora bien, este mecanismo te ofrece la misma protección que el Fondo de Garantía de Depósitos español: hasta 100.000 euros por titular. <br>\nPor tanto, si la entidad quebrara y, por ejemplo, tu Depósito Facto a 12 meses estuviera a nombre de dos personas, tendrías una garantía de hasta 200.000 euros. Para tu tranquilidad, recuerda que los depósitos de cualquier banco de la Unión Europea tienen la misma protección: hasta 100.000 euros por banco y por titular. </p>\n",
        "country": {
          "name": "Italy",
          "continent": "Europe",
          "currency": "EUR",
            "translations": {
            "en": "Italy",
            "es": "Italia"
          }
        }
      },
      "costs": {
        "total_cancellation": "non_cancellable",
        "interest_cancellation": false,
        "cancellation_reduction": false,
        "interest_cancellation_reduction": null,
        "other_cancellation": false,
        "partial_cancellation": "non_cancellable",
        "other_cancellation_description": null,
        "early_cancellation_description": null
      },
      "has_promo": false,
      "bank": {
        "id": 61,
        "name": "Banca Farmafactoring",
        "slug": "bff",
        "status": "active",
        "background_color": "#ffa100",
        "product_types": [
        "deposit"
        ],
        "product_names": {
          "bank_account": [],
          "card": [],
          "deposit": [
          "deposit"
          ],
          "mortgage": [],
          "loan": []
        },
        "image": {
          "url": "https://assets.kelisto.us/uetax56i335quw431zm45rda7gsk",
          "url_square": "https://assets.kelisto.us/uetax56i335quw431zm45rda7gsk",
          "url_rectangular": "https://assets.kelisto.us/jm92d2o9y7h8fxw2dj9oy9j3kbkb",
          "url_big": "https://assets.kelisto.us/v16xn30tysk2rktalvu7ud0406hc"
        }
      },
      "ratings": {
        "rating": 9.8,
        "interest": 10,
        "min_amount": 10,
        "max_amount": 10,
        "partial_cancellation": 8,
        "other_cancellation": 10
      },
      "has_review": false
    },
    # another deposit offer
    # another deposit offer
  ]
}

Arguments

Parameter Description
bank_slug Required string The slug of the bank related to the offers (as part of the url).
slug Required string The slug of the offer which we need to retrieve their related offers (as part of the url).

Returns

Returns a list of related deposit offer objects sorted by relevance

Card offers

The card offer object

Attributes

# Example object

{
  "id": 161,
  "name": "Cybertarjeta Caixabank",
  "slug": "tarjeta-monedero-cybertarjeta",
  "product_name": "wallet_card",
  "product_type": "card",
  "claim": "",
  "starred": false,
  "best_buy": false,
  "sponsored": false,
  "updated_at": "2021-04-12T11:09:42.082+02:00",
  "status": "active",
  "description": "<p>La Cybertarjeta de Caixabank es una <strong>tarjeta monedero</strong>, es decir, un medio de pago que solo podrás utilizar para pagar con el dinero que previamente hayas cargado en él, en lugar de estar vinculado al dinero que tengas en una cuenta bancaria, como ocurriría con una tarjeta de débito. Además, tiene la particularidad de que solo puede usarse para realizar compras por Internet, por lo que es una solución muy práctica para realizar pagos online con total seguridad. </p>\n\n<p>Por lo que respecta a su <strong>coste</strong>, debes tener en cuenta que la Cybertarjeta de Caixabank es totalmente gratuita. Por tanto, no deberás pagar nada por su emisión ni por su mantenimiento, aunque sí deberás ser cliente de la entidad para poder conseguirla. Eso sí, esto no te eximirá de tener que pagar *<em>otras comisiones</em>: Por ejemplo:</p>\n\n<ul>\n<li>Cada vez que quieras <strong>recargar</strong> la Cybertarjeta de Caixabank deberás abonar un 1% de la cantidad que recargues, con un mínimo de 1€.</li>\n<li>Determinados servicios, como la recuperación de saldo (10€), la gestión de saldo (10€/año) o la inoperancia (10€/año) sí supondrán un gasto para ti. </li>\n</ul>\n\n<p>Para poder <strong>solicitar la Cybertarjeta de Caixabank</strong>, la entidad te ofrece varias vías:</p>\n\n<ul>\n<li>La banca online de Caixabank.</li>\n<li>Las oficinas de la entidad. </li>\n</ul>\n\n<p>Para poder conseguirla, solo tendrás que ser cliente de Caixabank, tener más de 18 años y disponer del servicio de banca digital de la entidad o de una de sus tarjetas convencionales (Visa Electron, Visa Classic, etc.). Una vez obtenida, para recargarla solo tendrás que activarla y efectuar un primer ingreso de dinero a través de la banca online o los cajeros y oficinas de Caixabank. </p>\n\n<p>En lo que respecta a su <strong>operativa</strong>, cada cliente de Caixabank puede tener un total de cinco Cybertarjetas. Además, esta tarjeta monedero de Caixabank no tiene límite de gasto: podrás utilizarla hasta que se agote todo el dinero que hayas recargado en ella. </p>\n\n<p>En cuanto a las <strong>ventajas adicionales</strong> de la Cybertarjeta de Caixabank, esta tarjeta monedero dispone de  un servicio especial para proteger las compras denominado CaixaBankProtect. Con este sistema:</p>\n\n<ul>\n<li> Contarás con protección en caso de robo o fraude con tarjeta: no tendrás que asumir ninguna de las cantidades que pudieran gastar sin tu permiso. Es más, podrás reclamar todas las compras o disposiciones en efectivo fraudulentas que se hubieran realizado el día que bloqueaste tu tarjeta y los trece meses anteriores a esa fecha. </li>\n<li>Recibirás alertas en tu móvil cuando efectúes una operación por un importe elevado o desde otro país. </li>\n<li>Tendrás la opción de limitar el uso de tu tarjeta: por ejemplo, elegir que solo sirva para compras online o para operaciones en comercios físicos. </li>\n</ul>\n",
  "card_type": "wallet",
  "has_bank_account": false,
  "image": {
    "url": "https://admin.kelisto.dev/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbklEIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--7abc80872defc19b80790bf4f317d6463150ee6c/cybertarjeta-monedero-caixabank.jpg"
  },
  "comments": null,
  "has_deal": false,
  "url": null,
  "payments": {
    "cash": true,
    "month_end": false,
    "split": false,
    "fixed_fee": false,
    "minimum_repayment_percentage": null,
    "minimum_repayment_amount": null
  },
  "atm": {
    "description": "<p>Dado que se trata de una tarjeta diseñada para realizar compras por Internet, con la Cybertarjeta no podrás sacar dinero en cajeros. </p>\n",
    "withdrawals_abroad_description": "<p>Al tratarse de una tarjeta que solo sirve para realizar compras por Internet, con la Cybertarjeta de Caixabank no podrás sacar dinero en cajeros del extranjero. </p>\n",
    "free_atm_all": true,
    "free_atm_all_with_requirements": true,
    "has_free_atm": false
  },
  "advantages": {
    "bank_account_transfers": false,
    "has_discounts": false,
    "discounts_rate": null,
    "discounts_description": null,
    "has_insurances": false,
    "insurances_description": null,
    "has_reimbursement": false,
    "reimbursement_description": null
  },
  "obligations": {
    "salary_obligation": false,
    "min_age": 18,
    "only_online": null
  },
  "costs": {
    "has_renewal": false,
    "additional_card_fee": null,
    "duplicated_card_fee": null,
    "renewal_fee": "0.0",
    "signup_fee": false,
    "signup_fee_rate": "0.0",
    "no_fee_requirements": "<p>La Cybertarjeta de Caixabank no tiene costes de emisión.</p>\n",
    "signup_renewal_fee_description": "<p>La Cybertarjeta de Caixabank no tiene costes de emisión y tampoco de mantenimiento. </p>\n"
  },
  "has_interest": false,
  "has_promo": true,
  "promo": {
    "started_at": "2019-05-01T00:00:00.000+02:00",
    "expired_at": "2019-06-30T00:00:00.000+02:00",
    "claim": "¡Consigue 5€ de regalo!",
    "description": "<p>Si contratas la Cybertarjeta de Caixabank antes del 30 de junio de 2019 y acumulas, como mínimo, 20€ en compras antes del 31 de julio de 2019, la entidad te hará un regalo de 5€, que serán recargados en tu tarjeta.</p>\n"
  },
  "bank": {
    "id": 14,
    "name": "Caixabank",
    "slug": "caixabank",
    "image": {
      "url": "https://admin.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBZDg9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--c34c1c2a4366540ed8005f7a1409a231e597663e/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--5c21d2c8d7b8ee99f78f00fcc4fc823d68c0fddd/caixabank-s.jpg",
      "url_square": "https://admin.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBZDg9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--c34c1c2a4366540ed8005f7a1409a231e597663e/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--5c21d2c8d7b8ee99f78f00fcc4fc823d68c0fddd/caixabank-s.jpg",
      "url_rectangular": "https://admin.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBZUE9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--b43d6d89e583b90b137ec3a28220e1c8d0b7c582/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRERNMk5IZzVObDRHT2daRlZEb01aM0poZG1sMGVVa2lDMk5sYm5SbGNnWTdCMVE2Q1dOeWIzQkpJZzh6TmpSNE9UWXJNQ3N3QmpzSFZBPT0iLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--783036a5e2330c32c5d4f12339ec42bef9849156/caixabank-w.jpg"
    }
  },
  "ratings": {
    "rating": 7.8,
    "signup_fee": 8,
    "renewal_fee": 10,
    "insurances": 4
  },
  "has_review": true,
  "review": {
    "title": "Recargas demasiado caras",
    "description": "Las recargas de saldo de la Cybertarjeta Caixabank tienen un coste que, además, es muy elevado: un 1% de la cantidad que recargues, con un mínimo de 1€. Pese a ofrecerte ventajas como las medidas de seguridad del servicio Caixabank Protect, debes sopesar si te merece la pena tener que pagar tanto cada vez que quieras tener más saldo en este medio de pago, sobre todo si lo usas para realizar recargas pequeñas. ",
    "author": {
      "name": "Estefanía Gonzalez",
      "firstname": "Estefanía",
      "lastname": "Gonzalez",
      "title": "Experta en Finanzas Personales",
      "image": {
        "url": "https://admin.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaDRCIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--ca39844e50aedbb0d02e1d674b0e3aa445e2c2e8/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--5c21d2c8d7b8ee99f78f00fcc4fc823d68c0fddd/experta_estefania.jpg"
      }
    }
  }
}
Attribute Description
id integer Unique identifier for the resource.
name string Offer name.
slug string  Offer slug.
product_name string The specific product name. Can be credit_card, debit_card, credit_debit_card or wallet_card.
product_type string  Product type identifier (card).
claim string Short offer description.
best_buy boolean Returns true if the offer is a best buy, elsewhere false.
sponsored boolean Returns true if the offer is sponsored, elsewhere false.
updated_at timestamp Last update time.
status string Status of the offer. Can be active, inactive or discontinue.
description string Description using HTML format.
card_type string The specific card type. Can be credit, debit, credit_debit or wallety.
has_bank_account boolean Return trueif you have a bank account otherwise false.
has_deal boolean Return true if Kelisto has a deal for this offer with its provider.
url string Offer landing page URL.
paymentshash Payments object.
atm hash Atm object.
advantages hash Advantages object.
obligations hash Obligations object.
costs hash Costs object.
has_interest boolean Returns true if the current offer has interest.
has_promo boolean Returns true if the current offer has promo hash attributes.
promo optional, hash Promo object.
bank hash Bank object.
ratings hash Rating object.
has_review boolean Returns true if the current offer has review hash attributes.
review optional, hash Review object.

The card payments object

Attributes

# Example object

"payments": {
  "cash": true,
  "month_end": false,
  "split": false,
  "fixed_fee": false,
}
Attribute Description
cash boolean Returns true if you receive cash payments, elsewhere false.
month_end boolean Defines if the client is able to pay at the end of the month.
split boolean Defines if the card has installment payment mode.
fixed_fee boolean Defines whether the card has a fixed payment mode. Default false.

The card ATM object

Attributes

# Example object

"atm": {
  "description": "<p>Dado que se trata de una tarjeta diseñada para realizar compras por Internet, con la Cybertarjeta no podrás sacar dinero en cajeros. </p>\n",
  "withdrawals_abroad_description": "<p>Al tratarse de una tarjeta que solo sirve para realizar compras por Internet, con la Cybertarjeta de Caixabank no podrás sacar dinero en cajeros del extranjero. </p>\n",
  "free_atm_all": true,
  "free_atm_all_with_requirements": true,
  "has_free_atm": false
}
Attribute Description
description string Description using HTML format.
withdrawals_abroad_description string Description using HTML format.
free_atm_all boolean Defines whether all atms are free of charge
free_atm_all_with_requirements boolean Defines if all ATMs meet the requirements
has_free_atm boolean Defines whether the card can be used at atms

The card advantages object

Attributes

# Example object

"advantages": {
  "bank_account_transfers": false,
  "has_discounts": false,
  "has_insurances": false,
  "insurances_description": null,
  "has_reimbursement": false,
  "reimbursement_description": null
}
Attribute Description
bank_account_transfers boolean Defines whether the card can transfer money to an account.
has_discounts boolean Defines if the card offers discounts or back on purchases.
has_insurances boolean Defines if the card offers insurance (travel, purchase).
insurances_description string Description the card offers insurance using HTML format.
has_reimbursement boolean Defines if the card offers cash back on purchases.
reimbursement_description string Description using HTML format.

The card obligation object

Attributes

# Example object

"obligations": {
  "salary_obligation": false,
  "min_age": 18,
}
Attribute Description
salary_obligation boolean Define if you want to direct debit income. Default false.
min_age integer Define the minimum age.

The card costs object

Attributes

# Example object

"costs": {
  "has_renewal": false,
  "additional_card_fee": null,
  "duplicated_card_fee": null,
  "renewal_fee": "0.0",
  "signup_fee": false,
  "no_fee_requirements": "<p>La Cybertarjeta de Caixabank no tiene costes de emisión.</p>\n",
  "signup_renewal_fee_description": "<p>La Cybertarjeta de Caixabank no tiene costes de emisión y tampoco de mantenimiento. </p>\n"
}
Attribute Description
has_renewal boolean Define if the customer allows renewal. Default true.
additional_card_fee decimal Define if the card has an additional cost.
duplicated_card_fee decimal Defines if there is a cost for the duplicate of the card.
renewal_fee decimal Defines if there is a renewal fee.
signup_fee boolean Defines if there is an issuance fee.
no_fee_requirements string Defines the requirements for not paying commission.
signup_renewal_fee_description string Description using HTML format.

Retrieve a card offer

# Definition
GET https://api.kelisto.es/api/v3/finances/offers/cards/:slug?bank_slug=:bank_slug

# Example request
$ curl https://api.kelisto.es/api/v3/finances/offers/cards/tarjeta-monedero-cybertarjeta?bank_slug=caixabank
# Example response

{
  "data": {
    "id": 161,
    "name": "Cybertarjeta Caixabank",
    "slug": "tarjeta-monedero-cybertarjeta",
    "product_name": "wallet_card",
    "product_type": "card",
    "claim": "",
    "starred": false,
    "best_buy": false,
    "sponsored": false,
    "updated_at": "2021-04-12T11:09:42.082+02:00",
    "status": "active",
    "description": "<p>La Cybertarjeta de Caixabank es una <strong>tarjeta monedero</strong>, es decir, un medio de pago que solo podrás utilizar para pagar con el dinero que previamente hayas cargado en él, en lugar de estar vinculado al dinero que tengas en una cuenta bancaria, como ocurriría con una tarjeta de débito. Además, tiene la particularidad de que solo puede usarse para realizar compras por Internet, por lo que es una solución muy práctica para realizar pagos online con total seguridad. </p>\n\n<p>Por lo que respecta a su <strong>coste</strong>, debes tener en cuenta que la Cybertarjeta de Caixabank es totalmente gratuita. Por tanto, no deberás pagar nada por su emisión ni por su mantenimiento, aunque sí deberás ser cliente de la entidad para poder conseguirla. Eso sí, esto no te eximirá de tener que pagar *<em>otras comisiones</em>: Por ejemplo:</p>\n\n<ul>\n<li>Cada vez que quieras <strong>recargar</strong> la Cybertarjeta de Caixabank deberás abonar un 1% de la cantidad que recargues, con un mínimo de 1€.</li>\n<li>Determinados servicios, como la recuperación de saldo (10€), la gestión de saldo (10€/año) o la inoperancia (10€/año) sí supondrán un gasto para ti. </li>\n</ul>\n\n<p>Para poder <strong>solicitar la Cybertarjeta de Caixabank</strong>, la entidad te ofrece varias vías:</p>\n\n<ul>\n<li>La banca online de Caixabank.</li>\n<li>Las oficinas de la entidad. </li>\n</ul>\n\n<p>Para poder conseguirla, solo tendrás que ser cliente de Caixabank, tener más de 18 años y disponer del servicio de banca digital de la entidad o de una de sus tarjetas convencionales (Visa Electron, Visa Classic, etc.). Una vez obtenida, para recargarla solo tendrás que activarla y efectuar un primer ingreso de dinero a través de la banca online o los cajeros y oficinas de Caixabank. </p>\n\n<p>En lo que respecta a su <strong>operativa</strong>, cada cliente de Caixabank puede tener un total de cinco Cybertarjetas. Además, esta tarjeta monedero de Caixabank no tiene límite de gasto: podrás utilizarla hasta que se agote todo el dinero que hayas recargado en ella. </p>\n\n<p>En cuanto a las <strong>ventajas adicionales</strong> de la Cybertarjeta de Caixabank, esta tarjeta monedero dispone de  un servicio especial para proteger las compras denominado CaixaBankProtect. Con este sistema:</p>\n\n<ul>\n<li> Contarás con protección en caso de robo o fraude con tarjeta: no tendrás que asumir ninguna de las cantidades que pudieran gastar sin tu permiso. Es más, podrás reclamar todas las compras o disposiciones en efectivo fraudulentas que se hubieran realizado el día que bloqueaste tu tarjeta y los trece meses anteriores a esa fecha. </li>\n<li>Recibirás alertas en tu móvil cuando efectúes una operación por un importe elevado o desde otro país. </li>\n<li>Tendrás la opción de limitar el uso de tu tarjeta: por ejemplo, elegir que solo sirva para compras online o para operaciones en comercios físicos. </li>\n</ul>\n",
    "card_type": "wallet",
    "has_bank_account": false,
    "image": {
      "url": "https://admin.kelisto.dev/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbklEIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--7abc80872defc19b80790bf4f317d6463150ee6c/cybertarjeta-monedero-caixabank.jpg"
    },
    "comments": null,
    "has_deal": false,
    "url": null,
    "payments": {
      "cash": true,
      "month_end": false,
      "split": false,
      "fixed_fee": false,
      "minimum_repayment_percentage": null,
      "minimum_repayment_amount": null
    },
    "atm": {
      "description": "<p>Dado que se trata de una tarjeta diseñada para realizar compras por Internet, con la Cybertarjeta no podrás sacar dinero en cajeros. </p>\n",
      "withdrawals_abroad_description": "<p>Al tratarse de una tarjeta que solo sirve para realizar compras por Internet, con la Cybertarjeta de Caixabank no podrás sacar dinero en cajeros del extranjero. </p>\n",
      "free_atm_all": true,
      "free_atm_all_with_requirements": true,
      "has_free_atm": false
    },
    "advantages": {
      "bank_account_transfers": false,
      "has_discounts": false,
      "discounts_rate": null,
      "discounts_description": null,
      "has_insurances": false,
      "insurances_description": null,
      "has_reimbursement": false,
      "reimbursement_description": null
    },
    "obligations": {
      "salary_obligation": false,
      "min_age": 18,
      "only_online": null
    },
    "costs": {
      "has_renewal": false,
      "additional_card_fee": null,
      "duplicated_card_fee": null,
      "renewal_fee": "0.0",
      "signup_fee": false,
      "signup_fee_rate": "0.0",
      "no_fee_requirements": "<p>La Cybertarjeta de Caixabank no tiene costes de emisión.</p>\n",
      "signup_renewal_fee_description": "<p>La Cybertarjeta de Caixabank no tiene costes de emisión y tampoco de mantenimiento. </p>\n"
    },
    "has_interest": false,
    "has_promo": true,
    "promo": {
      "started_at": "2019-05-01T00:00:00.000+02:00",
      "expired_at": "2019-06-30T00:00:00.000+02:00",
      "claim": "¡Consigue 5€ de regalo!",
      "description": "<p>Si contratas la Cybertarjeta de Caixabank antes del 30 de junio de 2019 y acumulas, como mínimo, 20€ en compras antes del 31 de julio de 2019, la entidad te hará un regalo de 5€, que serán recargados en tu tarjeta.</p>\n"
    },
    "bank": {
      "id": 14,
      "name": "Caixabank",
      "slug": "caixabank",
      "image": {
        "url": "https://admin.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBZDg9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--c34c1c2a4366540ed8005f7a1409a231e597663e/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--5c21d2c8d7b8ee99f78f00fcc4fc823d68c0fddd/caixabank-s.jpg",
        "url_square": "https://admin.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBZDg9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--c34c1c2a4366540ed8005f7a1409a231e597663e/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--5c21d2c8d7b8ee99f78f00fcc4fc823d68c0fddd/caixabank-s.jpg",
        "url_rectangular": "https://admin.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBZUE9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--b43d6d89e583b90b137ec3a28220e1c8d0b7c582/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRERNMk5IZzVObDRHT2daRlZEb01aM0poZG1sMGVVa2lDMk5sYm5SbGNnWTdCMVE2Q1dOeWIzQkpJZzh6TmpSNE9UWXJNQ3N3QmpzSFZBPT0iLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--783036a5e2330c32c5d4f12339ec42bef9849156/caixabank-w.jpg"
      }
    },
    "ratings": {
      "rating": 7.8,
      "signup_fee": 8,
      "renewal_fee": 10,
      "insurances": 4
    },
    "has_review": true,
    "review": {
      "title": "Recargas demasiado caras",
      "description": "Las recargas de saldo de la Cybertarjeta Caixabank tienen un coste que, además, es muy elevado: un 1% de la cantidad que recargues, con un mínimo de 1€. Pese a ofrecerte ventajas como las medidas de seguridad del servicio Caixabank Protect, debes sopesar si te merece la pena tener que pagar tanto cada vez que quieras tener más saldo en este medio de pago, sobre todo si lo usas para realizar recargas pequeñas. ",
      "author": {
        "name": "Estefanía Gonzalez",
        "firstname": "Estefanía",
        "lastname": "Gonzalez",
        "title": "Experta en Finanzas Personales",
        "image": {
          "url": "https://admin.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaDRCIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--ca39844e50aedbb0d02e1d674b0e3aa445e2c2e8/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--5c21d2c8d7b8ee99f78f00fcc4fc823d68c0fddd/experta_estefania.jpg"
        }
      }
    }
  }
}

Arguments

Parameter Description
slug Required string The slug of the offer to retrieve.
bank_slug Required string The slug of the bank related to the offer.
status optional string Retrieve offers by status (active, inactive or discontinue). It can be an array of statuses. Default: active.
product_name optional string Retrieve offers by product name.

Multiproduct card list request

# Definition
GET https://api.kelisto.es/api/v3/finances/multiproduct/:bank_slug/cards

# Example request
$ curl https://api.kelisto.es/api/v3/finances/multiproduct/bbva/cards
# Example response

{
  "data": {
    "id": 13,
    "name": "BBVA",
    "slug": "bbva",
    "status": "active",
    "image": {
      "url": "https://admin.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcXdDIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--48deb57f1e5c5b5bc3d84227240e75b468e628c8/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpQ3pnd2VEZ3dYZ1k3QmxRNkRHZHlZWFpwZEhsSklndGpaVzUwWlhJR093WlVPZ2xqY205d1NTSU9PREI0T0RBck1Dc3dCanNHVkE9PSIsImV4cCI6bnVsbCwicHVyIjoidmFyaWF0aW9uIn19--87c92c14039a123855a7f8b8b1b31e0257631374/Logo%20(1).jpg",
      "url_square": "https://admin.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcXdDIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--48deb57f1e5c5b5bc3d84227240e75b468e628c8/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpQ3pnd2VEZ3dYZ1k3QmxRNkRHZHlZWFpwZEhsSklndGpaVzUwWlhJR093WlVPZ2xqY205d1NTSU9PREI0T0RBck1Dc3dCanNHVkE9PSIsImV4cCI6bnVsbCwicHVyIjoidmFyaWF0aW9uIn19--87c92c14039a123855a7f8b8b1b31e0257631374/Logo%20(1).jpg",
      "url_rectangular": "https://admin.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcTRDIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--c48f907d948e04dd0922b19abdc845af76471950/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpRERNMk5IZzVObDRHT3daVU9neG5jbUYyYVhSNVNTSUxZMlZ1ZEdWeUJqc0dWRG9KWTNKdmNFa2lEek0yTkhnNU5pc3dLekFHT3daVSIsImV4cCI6bnVsbCwicHVyIjoidmFyaWF0aW9uIn19--df9185946beb326f0006a2ed79b9cabbd69d6639/bbvanew-w-min.jpg"
    },
    "product_names": [
      "credit_card",
      "debit_card",
      "wallet_card"
    ],
    "products": [
    {
    "product_name": "credit_card",
    "offers": [
    {
      "id": 1889,
      "name": "Tarjeta A Tu Ritmo Revolving",
      "slug": "tarjeta-a-tu-ritmo-revolving",
      "product_name": "credit_card",
      "product_type": "card",
      "claim": "",
      "starred": false,
      "best_buy": false,
      "sponsored": false,
      "updated_at": "2022-10-01T08:51:32.023+02:00",
      "status": "active",
      "description": "<p>La <strong>Tarjeta A Tu Ritmo Revolving de BBVA</strong> es una tarjeta de crédito, es decir, un medio de pago que te permitirá <strong>aplazar tus compras</strong> a cambio de pagar un interés por ello. Sin embargo, este <em>plástico</em> de BBVA tiene una importante particularidad: <strong>solo tiene una forma de pago (la modalidad &quot;revolving&quot; o &quot;pago con cuota fija&quot;</strong>, cuando lo habitual es que este tipo de tarjetas tengan tres:</p>\n\n<ul>\n<li><p><strong>Pago a fin de mes:</strong> los pagos se pasan a final de mes o principios del mes siguiente. Normalmente esta forma de pago no tiene intereses ni comisiones, por lo que su TIN (Tipo de Interés Nominal) es del 0% y su TAE (Tasa Anual Equivalente) también.</p></li>\n<li><p><strong>Pago fraccionado o aplazado:</strong> los pagos se aplazan durante varios meses, como si se tratara de un préstamo personal. Este método de pago sí suele estar sujeto al pago de intereses.</p></li>\n<li><p><strong>Pago &quot;revolving&quot; o &quot;con cuota fija&quot;:</strong> el cliente debe elegir qué cantidad quiere ir pagando cada mes hasta dar por finiquitada su deuda con la entidad. Esa cantidad puede ser una cifra en euros o un porcentaje de su deuda. Normalmente, esta forma de pago también te obligará a abonar intereses.</p></li>\n</ul>\n\n<p>En el caso de la Tarjeta A Tu Ritmo Revolving de BBVA, cuando la uses para aplazar tus compras debes tener en cuenta que:</p>\n\n<ul>\n<li><p>Tendrás que abonar un <strong>TIN del 15%.</strong></p></li>\n<li><p>Podrás elegir qué cantidad en euros (o qué porcentaje de tu deuda) quieres devolver al mes, pero como <strong>mínimo deberá ser de 20€</strong>.</p></li>\n</ul>\n\n<p>En lo que respecta a sus comisiones, la Tarjeta A Tu Ritmo Revolving de BBVA <strong>no tiene comisión de emisión ni de renovación</strong> , por lo que es una tarjeta de crédito gratuita. Ahora bien, para poder hacerte con ella tendrás que tener una cuenta bancaria en BBVA y superar el análisis de riesgo que te hará la entidad para concedértela.</p>\n\n<p>En lo que respecta a su contratación, podrás <strong>hacerte con ella a través de Internet</strong> –en la web o app de BBVA-, pero también está disponible para su contratación <strong>en oficinas</strong>.</p>\n\n<p>Además de aplazar tus compras, con esta tarjeta de crédito de BBVA también podrás:</p>\n\n<ul>\n<li><p><strong>Sacar dinero en cajeros</strong> , pero al igual que sucede con la mayoría de tarjetas de crédito del mercado- esta operación siempre estará sujeta al pago de comisiones (ya que estarás recibiendo dinero &quot;a crédito&quot;, en lugar de sacarlo de tu cuenta, como sucedería con una tarjeta débito).</p></li>\n<li><p><strong>Traspasar dinero a tu cuenta</strong> bancaria (operación que también está sujeta al pago de intereses).</p></li>\n</ul>\n\n<p>La Tarjeta A Tu Ritmo Revolving de BBVA incluye un <strong>seguro de atraco</strong> en cajeros sin coste y te permite pedir una tarjeta adicional para un segundo beneficiario de forma totalmente gratuita.</p>\n",
      "card_type": "credit",
      "has_bank_account": false,
      "image": {
        "url": "https://admin.kelisto.dev/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBZzBRIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--570f2c63414df93d9da53aec4f237764832a9313/tarjeta-a-tu-ritmo-revolving.jpg"
      },
      "comments": "",
      "has_deal": false,
      "url": null,
      "payments": {
        "cash": false,
        "month_end": true,
        "interest_end_month": null,
        "apr_end_month": null,
        "apr_end_month_description": null,
        "split": true,
        "interest_split": null,
        "apr_split": null,
        "apr_split_description": null,
        "fixed_fee": true,
        "interest_revolving": null,
        "apr_revolving": null,
        "apr_revolving_description": null,
        "minimum_repayment_percentage": null,
        "minimum_repayment_amount": "20.0",
        "other_payment_forms_and_costs": null
      },
      "atm": {
        "description": "<p>Con la Tarjeta A Tu Ritmo Revolving de BBVA puedes sacar dinero en cualquier cajero, pero la operación siempre tendrá un coste para ti, aunque la realices en dispensadores de BBVAA.  En motivo es que, al tratarse de una tarjeta de crédito (que te presta dinero a cambio de que pagues unos intereses), siempre te tocaría pagar un interés  o gastos a la entidad por esta operación.</p>\n",
        "withdrawals_abroad_description": null,
        "free_atm_all": true,
        "free_atm_all_with_requirements": true,
        "has_free_atm": false
      },
      "advantages": {
        "bank_account_transfers": true,
        "has_discounts": false,
        "discounts_rate": null,
        "discounts_description": null,
        "fuel_discounts": false,
        "max_percentage_fuel_discounts": null,
        "shopping_discounts": false,
        "max_percentage_shopping_discounts": null,
        "supermarket_discounts": false,
        "max_percentage_supermarket_discounts": null,
        "travel_discounts": false,
        "max_percentage_travel_discounts": null,
        "has_insurances": true,
        "insurances_description": "<p>La Tarjeta A Tu Ritmo Revolving de BBVA cuenta con un seguro de atraco en cajeros gratuito. </p>\n",
        "has_reimbursement": false,
        "reimbursement_description": null
      },
      "obligations": {
        "salary_obligation": true,
        "min_age": 18,
        "only_online": false
      },
      "costs": {
        "has_renewal": true,
        "additional_card_fee": null,
        "duplicated_card_fee": null,
        "renewal_fee": "0.0",
        "renewal_fee_rate": null,
        "signup_fee": false,
        "signup_fee_rate": null,
        "no_fee_requirements": null,
        "signup_renewal_fee_description": "<p>La Tarjeta A Tu Ritmo Revolving de BBVA no tiene costes de emisión ni de renovación, por lo que es gratuita para siempre. </p>\n"
      },
      "has_interest": true,
      "interests": {
        "interest": "15.0",
        "description": "<p>Tanto si usas el <strong>pago aplazado o fraccionado</strong>, como si optas por la modalidad <strong>revolving o pago con cuota fija</strong>, la Tarjeta A Tu Ritmo Revolving de BBVA te cobrará un interés del 15% TIN. </p>\n",
        "nominal_interest": [
        {
        "period": 1,
        "interest": "0.0",
        "fixed_repayment_fee": null
        },
        {
        "period": 3,
        "interest": "15.0",
        "fixed_repayment_fee": null
        },
        {
        "period": 12,
        "interest": "15.0",
        "fixed_repayment_fee": null
        },
        {
        "period": 36,
        "interest": "15.0",
        "fixed_repayment_fee": null
        }
        ]
      },
      "has_promo": false,
      "bank": {
        "id": 13,
        "name": "BBVA",
        "slug": "bbva",
        "status": "active",
        "image": {
          "url": "https://admin.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcXdDIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--48deb57f1e5c5b5bc3d84227240e75b468e628c8/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpQ3pnd2VEZ3dYZ1k3QmxRNkRHZHlZWFpwZEhsSklndGpaVzUwWlhJR093WlVPZ2xqY205d1NTSU9PREI0T0RBck1Dc3dCanNHVkE9PSIsImV4cCI6bnVsbCwicHVyIjoidmFyaWF0aW9uIn19--87c92c14039a123855a7f8b8b1b31e0257631374/Logo%20(1).jpg",
          "url_square": "https://admin.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcXdDIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--48deb57f1e5c5b5bc3d84227240e75b468e628c8/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpQ3pnd2VEZ3dYZ1k3QmxRNkRHZHlZWFpwZEhsSklndGpaVzUwWlhJR093WlVPZ2xqY205d1NTSU9PREI0T0RBck1Dc3dCanNHVkE9PSIsImV4cCI6bnVsbCwicHVyIjoidmFyaWF0aW9uIn19--87c92c14039a123855a7f8b8b1b31e0257631374/Logo%20(1).jpg",
          "url_rectangular": "https://admin.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcTRDIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--c48f907d948e04dd0922b19abdc845af76471950/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpRERNMk5IZzVObDRHT3daVU9neG5jbUYyYVhSNVNTSUxZMlZ1ZEdWeUJqc0dWRG9KWTNKdmNFa2lEek0yTkhnNU5pc3dLekFHT3daVSIsImV4cCI6bnVsbCwicHVyIjoidmFyaWF0aW9uIn19--df9185946beb326f0006a2ed79b9cabbd69d6639/bbvanew-w-min.jpg"
        }
      },
      "ratings": {
        "rating": 9.9,
        "interest": 10,
        "signup_fee": 10,
        "renewal_fee": 10,
        "insurances": 10,
        "discounts": 7
      },
      "has_review": false
    }
  }
},
...

Arguments

Parameter Description
bank_slug URL segment string The slug of the bank related to the offer (as part of the url)

Returns

Returns basic bank information with a list of deposit offer objects products grouped by product_name and ordered by rating

# Definition
GET https://api.kelisto.es/api/v3/finances/related_offers/cards/:slug?:bank_slug&:product_name

# Example request
$ curl https://admin.kelisto.es/api/v3/finances/related_offers/cards/tarjeta-monedero-cybertarjeta?bank_slug=caixabank&product_name=wallet_card
{
  "data": [
    {
      "id": 52,
      "name": "Tarjeta Prepago eCommerce",
      "slug": "tarjeta-ecard",
      "product_name": "wallet_card",
      "product_type": "card",
      "claim": "",
      "starred": false,
      "best_buy": false,
      "sponsored": false,
      "updated_at": "2023-06-19T03:00:00.767+02:00",
      "status": "active",
      "description": "<p>La Tarjeta Prepago eCommerce de Openbank es una <strong>tarjeta monedero</strong> que podrás recargar con el saldo que quieras y llevar un mejor control sobre tus gastos. </p>\n\n<p>Pensada para realizar compras por Internet con mayor seguridad y control, la Tarjeta Prepago eCommerce de Openbank es un medio de pago <strong>virtual</strong>, lo que significa que no recibirás una tarjeta como tal, sino una numeración y un código para que puedas realizar compras por Internet. </p>\n\n<p>Esta tarjeta prepago virtual de Openbank es <strong>gratuita</strong>, ya que no tiene comisiones ni de emisión ni renovación. Para poder solicitarla, debe estar asociada a una de las cuentas de Openbank, como la Cuenta Corriente Open o la Cuenta Nómina Open. </p>\n\n<p>En cuanto a las <strong>recargas</strong>, puedes añadir saldo a la Tarjeta Prepago eCommerce  desde 0,01 euros hasta un límite de 3.000 euros en:<br>\n- La página web de Openbank<br>\n- Cajeros automáticos de Banco Santander</p>\n\n<p>Entre sus <strong>ventajas más destacadas</strong>, esta tarjeta prepago de Openbank incluye un seguro gratuito que cubre cualquier accidente, tanto si te encuentras de viaje como si vas en transporte público.</p>\n",
      "card_type": "wallet",
      "has_bank_account": true,
      "bank_account": {
        "name": "Cuenta Corriente Openbank",
        "slug": "cuenta-sin-comisiones"
      },
      "image": {
        "url": "https://admin.kelisto.us/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdlVCIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--b4941b6616b0562ca3fd7caebc19724bfa0d8a40/tarjeta-prepago-ecard-openbank.jpg"
      },
      "comments": "",
      "has_deal": true,
      "url": "https://clk.tradedoubler.com/click?p=277709&a=3100728&g=25427730",
      "payments": {
        "cash": true,
        "month_end": false,
        "interest_end_month": null,
        "apr_end_month": null,
        "apr_end_month_description": "",
        "split": false,
        "interest_split": null,
        "apr_split": null,
        "apr_split_description": "",
        "fixed_fee": false,
        "interest_revolving": null,
        "apr_revolving": null,
        "apr_revolving_description": "",
        "minimum_repayment_percentage": null,
        "minimum_repayment_amount": null,
        "other_fee": false,
        "other_payment_forms_and_costs": ""
      },
      "atm": {
        "description": "<p>La Tarjeta Prepago eCommerce de Openbank no puede usarse para sacar dinero de cajeros. Esta tarjeta sirve para hacer compras de bienes y servicios en establecimientos comerciales a través de Internet.</p>\n",
        "withdrawals_abroad_description": null,
        "free_atm_all": false,
        "free_atm_all_with_requirements": false,
        "has_free_atm": false
      },
      "advantages": {
        "bank_account_transfers": false,
        "has_discounts": true,
        "discounts_rate": "50.0",
        "discounts_description": "<p>Con la tarjeta Prepago eCommerce tendrás <strong>descuentos de hasta el 50%</strong> en varios comercios, restauración, moda, hoteles, ocio, transporte, belleza y salud. Consulta todas las tiendas donde podrás beneficiarte de estos descuentos en la página web de Openbank.</p>\n",
        "fuel_discounts": false,
        "max_percentage_fuel_discounts": null,
        "shopping_discounts": false,
        "max_percentage_shopping_discounts": null,
        "supermarket_discounts": false,
        "max_percentage_supermarket_discounts": null,
        "travel_discounts": false,
        "max_percentage_travel_discounts": null,
        "has_insurances": false,
        "insurances_description": null,
        "has_reimbursement": false,
        "reimbursement_description": null
      },
      "obligations": {
        "salary_obligation": false,
        "min_age": 18,
        "only_online": false
      },
      "costs": {
        "has_renewal": true,
        "additional_card_fee": null,
        "duplicated_card_fee": null,
        "renewal_fee": "0.0",
        "renewal_fee_rate": null,
        "signup_fee": false,
        "signup_fee_rate": "0.0",
        "no_fee_requirements": "<p>La tarjeta de Prepago eCommerce de Openbank no tiene comisiones de emisión ni de renovación.</p>\n",
        "signup_renewal_fee_description": "<p>Para renovar tu tarjeta Prepago eCommerce no tendrás que hacer nada: se renueva automáticamente y es gratuita.</p>\n"
      },
      "has_interest": false,
      "has_promo": false,
      "bank": {
        "id": 29,
        "name": "Openbank",
        "slug": "openbank",
        "status": "active",
        "background_color": "#E9004C",
        "product_types": [
          "bank_account",
          "card",
          "deposit",
          "mortgage",
          "loan"
        ],
        "product_names": {
          "bank_account": [
            "payroll_account",
            "checking_account",
            "savings_account",
            "without_costs"
          ],
          "card": [
            "credit_card",
            "wallet_card",
            "debit_card"
          ],
          "deposit": [
            "deposit"
          ],
          "mortgage": [
            "variable_mortgage",
            "fixed_mortgage"
          ],
          "loan": [
            "personal_loan"
          ]
        },
      },
      "image": {
        "url": "https://assets.kelisto.us/e8q4h16wf3ex2ocgcta9iymxwnlm",
        "url_square": "https://assets.kelisto.us/e8q4h16wf3ex2ocgcta9iymxwnlm",
        "url_rectangular": "https://assets.kelisto.us/hs2gfmrkawh5k62tlchx02z2s5vb",
        "url_big": "https://assets.kelisto.us/ha5euvd8oatsz5wcpfb7gtznnlqn"
      },
      "ratings": {
        "rating": 7.8,
        "signup_fee": 8,
        "renewal_fee": 10,
        "insurances": 4
      },
      "has_review": false
    },
    # another card offer
    # another card offer
  ]
}

Arguments

Parameter Description
bank_slug Required string The slug of the bank related to the offers (as part of the url).
slug Required string The slug of the offer which we need to retrieve their related offers (as part of the url).
product_name Required string The product name of the offer which we need to retrieve their related offers (as part of the url).

Returns

Returns a list of related card offer objects sorted by relevance

Mortgage offers

The mortgage offer object

Attributes

# Example object

{
  "id": 15,
  "name": "Hipoteca Ahora Tipo Fijo",
  "slug": "hipoteca-fija-ahora",
  "product_name": "fixed_mortgage",
  "product_type": "mortgage",
  "claim": null,
  "best_buy": true,
  "sponsored": false,
  "updated_at": "2020-09-28T15:48:29.093+02:00",
  "status": "active",
  "description": "<p>Al adquirir la <strong>Hipoteca Ahora a Tipo Fijo de Liberbank</strong> podrás conseguir la financiación que necesitas para convertirte en propietario de una vivienda. Eso sí, este préstamo solo cubre <strong>hasta un 80%</strong> del valor de tasación del inmueble –o un 90% del valor de compra, aunque el límite entre las dos lo pondrá la cifra más baja-. </p>\n\n<p>Esta cantidad, además, tendrá que estar <strong>entre 50.000 euros y un millón</strong>. Podrás ir devolviendo el dinero en las cuotas mensuales que acuerdes con la entidad. El plazo es muy importante, porque el TIN (Tipo de Interés Nominal) varía según el período de amortización que elijas. La ventaja es que, al ser esta una <strong>hipoteca fija</strong>, este se mantendrá igual –independientemente de los cambios del euríbor- todos los años, siempre cumpliendo estas condiciones:</p>\n\n<ul>\n<li>Hasta 10 años de plazo: 1,65% </li>\n<li>De 10 a 15 años: 1,90% </li>\n<li>De 15 a 20 años: 1,99% </li>\n<li>De 20 a 25 años: 2,30% </li>\n<li>De 25 a 30 años: 2,40% </li>\n</ul>\n\n<p>Estos diferenciales solo se aplicarán si el cliente cumple algunas condiciones: la primera, <strong>abrir una cuenta bancaria con Liberbank</strong> y usarla para <strong>domiciliar tu nómina</strong>, con unos ingresos que entre todos los titulares del préstamo tendrán que sumar <strong>al menos 2.000 euros</strong>.  </p>\n\n<p>Además, te pedirán que te hagas un <strong>seguro multirriesgo de hogar y otro de vida</strong>, que solicites una <strong>tarjeta de crédito de la entidad</strong> y que contrates un <strong>plan de pensiones</strong>, en el que tendrás que hacer una <strong>aportación mínima de 1.200 euros al año</strong>. Estos requisitos no son obligatorios, pero de no cumplirse el banco te subirá el tipo de interés, lo que encarecerá el préstamo. Lo que sí te pedirán es que tu edad, sumada al plazo de la hipoteca, <strong>no supere los 75 años</strong>.</p>\n\n<p>A estos costes extra tendrás que añadirle la conocida <strong>comisión de apertura</strong>, un coste asociado a la activación del préstamo y que para esta oferta tiene un precio del <strong>0,7% de la cuantía solicitada</strong>.</p>\n\n<p>¿Y si recibieras una cantidad de dinero inesperada que te permitiera liquidar tu deuda antes de tiempo? En este caso podrás pedir la <strong>amortización anticipada</strong> y pactar con Liberbank las condiciones para devolver el dinero. Por ejemplo, tendrás opción a adelantar la fecha de vencimiento con cuotas más grandes, a adelantar una parte y reducir las cuotas o a pedir que te guarden esa cuantía como carencia por si un mes no pudieras pagar la hipoteca. Este cambio de condiciones conlleva una <strong>penalización</strong>, que está regulada por ley y que <strong>no podrá ser superior al 2% (dentro de los 10 primeros años)</strong> y al <strong>1,5% (si se solicitara a partir del undécimo año)</strong>.</p>\n",
  "has_deal": false,
  "url": null,
  "typ_description": null,
    "comments": "",
    "remortgage_status": "unavailable",
    "starred": false,
    "starred_order": null,
    "free_featured_label": "",
    "free_featured_label_description": "",
    "recommended": false,
    "most_popular": false,
    "cheapest": false,
  "obligations": {
    "max_granted": 80.0,
    "min_age": 18,
    "max_age": 75,
    "min_amount": 50000,
    "max_amount": 1000000,
    "primary_residence": true,
    "second_home": false,
    "remortgage": false
  },
  "has_vinculation": true,
  "vinculations": {
    "domicile_payroll": true,
    "min_payroll": 2000.0,
    "domicile_receipts": false,
    "home_insurance": true,
    "life_insurance": true,
    "payment_protection_insurance": false,
    "other_insurances": false,
    "use_of_cards": true,
    "pension_plan": true,
    "vinculation_number": 5,
    "other_insurances_description": null,
    "vinculations_description": "<p>Para conseguir el diferencial más bajo con tu <strong>Hipoteca Ahora a Tipo Fijo</strong> tendrás que cumplir una serie de requisitos:</p>\n"
  },
  "terms": [
    {
      "status": "active",
      "min_value": 5,
      "value": 10,
      "term_type": "fixed",
      "costs": {
        "interest": 1.65,
        "interest_max": 2.75,
        "initial_interest": 1.35,
        "initial_interest_max": 1.99,
        "initial_interest_period": 12,
        "from_euribor": null,
        "from_euribor_max": null,
        "apr": 3.15,
        "apr_max": 3.42,
        "apr_description": "Para que todos los gastos asociados a la **Hipoteca Ahora a Tipo Fijo** no te pillen por sorpresa es fundamental tener calculada la **TAE (Tasa Anual Equivalente)**. Esta no es la misma para todos los clientes, pero desde Liberbank ponen un ejemplo para los que planeen pedir un préstamo a 10 años. Si la cuantía que solicitaran fuera de 150.000 euros, se encontrarían con un TIN del 1,65% y una **TAE del 3,15%**, si cumples con los requisitos de vinculación. Si no lo haces, el TIN ascenderá a 2,75 y la TAE al 3,42.",
        "euribor": -0.415,
        "has_opening": true,
        "opening": {
          "fee": null,
          "percentage_fee": 0.7
        }
      },
      "amortizations": {
        "total_early": {
          "rate": 2.0,
          "term": 10
        },
        "partial_early": {
          "rate": 2.0,
          "term": 10
        },
        "remainig_years": {
          "since_year": 11,
          "total_early_rate": 1.5,
          "partial_early_rate": 1.5
        },
        "description": "<p>Si en los años a los que se extienda tu hipoteca consiguieras reunir una cantidad que te permitiera <strong>amortizar anticipadamente</strong> el préstamo, podrás anular tu deuda. Esto lleva aparejada una comisión que, de acuerdo con la ley, no podrá ser superior a un <strong>2% en los primeros 10 años</strong> de contratación del préstamo y un <strong>1,5% a partir del undécimo año</strong>.</p>\n"
      },
      "ratings": {
        "rating": 8.2,
        "interest_max": 8.75,
        "initial_interest": 0,
        "opening": 6,
        "from_euribor_max": 0
      }
    },
    {
      # related mortgage term object
    },
    {
      # related mortgage term object
    },
    {
      # related mortgage term object
    }
  ],
  "has_promo": false,
  "bank": {
    "id": 25,
    "name": "Liberbank",
    "slug": "liberbank",
    "status": "active",
    "image": {
      "url": "https://admin.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBZlU9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--087cdf300908e140af5b0d90f6dce231af326a18/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--9bf916c83f9ea8616ecddb3dafca36d672ce853d/liberbank-s.jpg",
      "url_square": "https://admin.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBZlU9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--087cdf300908e140af5b0d90f6dce231af326a18/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--9bf916c83f9ea8616ecddb3dafca36d672ce853d/liberbank-s.jpg",
      "url_rectangular": "https://admin.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBZlk9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--0c58223e09302508f5a85d8f2ef1bd6628583290/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRERNMk5IZzVObDRHT2daRlZEb01aM0poZG1sMGVVa2lDMk5sYm5SbGNnWTdCMVE2Q1dOeWIzQkpJZzh6TmpSNE9UWXJNQ3N3QmpzSFZBPT0iLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--71541c942d6acfdb5ef992871bf12a0b051cb1a6/liberbank-w.jpg"
    }
  },
  "ratings": {
    "rating": 7.8
  },
  "has_review": false
}
Attribute Description
id integer Unique identifier for the resource.
name string Offer name.
slug string  Offer slug.
product_name string  The specific product name (fixed_mortgage ,mixed_mortgage or variable_mortgage).
product_type string  Product type identifier (mortgage).
claim string Short offer description.
starred boolean Returns the label that has been sponsored.
best_buy boolean Returns true if the offer is a best buy, elsewhere false.
sponsored boolean Returns true if the offer is sponsored, elsewhere false.
updated_at timestamp Last update time.
status string Status of the offer. Can be active, inactive, snapshot or discontinue.
description string Description using HTML format.
has_deal boolean Return true if Kelisto has a deal for this offer with its provider.
url string Offer landing page URL.
typ_description string additional info for Thank You Page cards.
remortgage_status string Status of the offer remortgage. Can be unavailable, available or exclusive.

starred_order integer returns the order of the sponsorship. free_featured_label string | Returns a free label created by the PM, for special occasions, example: Promo blackfriday. free_featured_label_description free_featured_label_description text | Returns the description of the free label. recommended boolean | Returns the recommended mortgage, sorted by rating. most_popular boolean |Returns the most popular mortgage, sorted by number of searches. cheapest boolean | Returns the cheapest mortgage, sorted by price. obligations hash | Mortgage Obligations object has_vinculation boolean | Returns true if the current mortgage has vinculations hash attributes. vinculations optional, hash | Mortgage Vinculations object terms array | Mortgage Term objects has_promo boolean | Returns true if the current offer has promo hash attributes. promo optional, hash | Promo object. bank hash | Bank object. ratings hash | Rating object. has_review boolean | Returns true if the current offer has review hash attributes. review optional, hash | Review object.

The mortgage obligations object

Attributes

# Example object

{
  "max_granted": 80.0,
  "min_age": 18,
  "max_age": 75,
  "min_amount": 50000,
  "max_amount": 1000000,
  "primary_residence": true,
  "second_home": false,
  "remortgage": false
}
Attribute Description
max_granted float max mortgage percentage granted
min_age integer min client age allowed
max_age integer max client age allowed
min_amount integer minimum financing amount
max_amount integer maximum financing amount
primary_residence boolean Defines if the mortgage is available for primary residences.
second_home boolean Defines if the mortgage is available for second homes.
remortgage boolean Defines if the mortgage is available for remortgages.

The mortgage vinculations object

Attributes

# Example object

{
  "domicile_payroll": true,
  "min_payroll": 2000.0,
  "domicile_receipts": false,
  "home_insurance": true,
  "life_insurance": true,
  "payment_protection_insurance": false,
  "other_insurances": false,
  "use_of_cards": true,
  "pension_plan": true,
  "vinculation_number": 5,
  "other_insurances_description": null,
  "vinculations_description": "<p>Para conseguir el diferencial más bajo con tu <strong>Hipoteca Ahora a Tipo Fijo</strong> tendrás que cumplir una serie de requisitos:</p>\n"
}

Attribute Description
domicile_payroll boolean Defines if require payroll domiciliations.
min_payroll float Minimum payroll amount required.
domicile_receipts boolean Defines if require receipts domiciliations.
home_insurance boolean Defines if require a home insurance.
life_insurance boolean Defines if require a life insurance.
payment_protection_insurance boolean Defines if require a payment protection insurance.
other_insurances boolean Defines if require other insurances.
use_of_cards boolean Defines if require the usage of cards.
pension_plan boolean Defines if require a pension plan.
vinculation_number integer The minimum vinculations required.
other_insurances_description string Description using HTML format.
vinculations_description string Description using HTML format.

The mortgage term object

Attributes

# Example object

{
  "status": "active",
  "min_value": 5,
  "value": 10,
  "term_type": "fixed",
  "costs": {
    "interest": 1.65,
    "interest_max": 2.75,
    "initial_interest": 1.25,
    "initial_interest_max": 1.99,
    "initial_interest_period": 12,
    "from_euribor": null,
    "from_euribor_max": null,
    "apr": 3.15,
    "apr_max": 3.42,
    "apr_description": "Para que todos los gastos asociados a la **Hipoteca Ahora a Tipo Fijo** no te pillen por sorpresa es fundamental tener calculada la **TAE (Tasa Anual Equivalente)**. Esta no es la misma para todos los clientes, pero desde Liberbank ponen un ejemplo para los que planeen pedir un préstamo a 10 años. Si la cuantía que solicitaran fuera de 150.000 euros, se encontrarían con un TIN del 1,65% y una **TAE del 3,15%**, si cumples con los requisitos de vinculación. Si no lo haces, el TIN ascenderá a 2,75 y la TAE al 3,42.",
    "euribor": -0.415,
    "has_opening": true,
    "opening": {
      "fee": null,
      "percentage_fee": 0.7
    }
  },
  "amortizations": {
    "total_early": {
      "rate": 2.0,
      "term": 10
    },
    "partial_early": {
      "rate": 2.0,
      "term": 10
    },
    "remainig_years": {
      "since_year": 11,
      "total_early_rate": 1.5,
      "partial_early_rate": 1.5
    },
    "description": "<p>Si en los años a los que se extienda tu hipoteca consiguieras reunir una cantidad que te permitiera <strong>amortizar anticipadamente</strong> el préstamo, podrás anular tu deuda. Esto lleva aparejada una comisión que, de acuerdo con la ley, no podrá ser superior a un <strong>2% en los primeros 10 años</strong> de contratación del préstamo y un <strong>1,5% a partir del undécimo año</strong>.</p>\n"
  },
  "ratings": {
    "rating": 8.2,
    "interest_max": 8.75,
    "initial_interest": 0,
    "opening": 6,
    "from_euribor_max": 0
  },
    "starred": false,
    "free_featured_label": "",
    "free_featured_label_description": "",
    "recommended": false,
    "most_popular": false,
    "cheapest": false
}
Attribute Description
status string Status of the offer. Can be active, inactive, snapshot or discontinue.
min_value integer min years for which the term is valid
value integer max years for which the term is valid
term_type string  The specific term type, realted to mortgages product names (fixed ,mixed or variable).
costs hash Mortgage Terms Costs object
costs.interest float minimun interest accomplishing conditions (spanish TIN value).
costs.interest_max float maximum interest without accomplishing the conditions.
costs.initial_interest float initial interest.
costs.initial_interest_max float maximum initial interest without accomplishing the conditions.
costs.initial_interest_period integer Defines the time the interest is lower (defined by initial_interest).
costs.from_euribor float minimum percentage added to mortage plus euribor when the user accomplish all the conditions.
costs.from_euribor_max float maximum percentage added to mortage plus euribor when the user don't accomplish the conditions.
costs.apr float minimum APR (spanish TAE) accomplishing the conditions.
costs.apr_max float maximum APR (spanish TAE) without accomplishing the conditions.
costs.apr_description string Description using HTML format.
costs.euribor float Defines the actual euribor value for the mortgage term (for snapshots this value reflect the euribor value when the snapshot was taken).
costs.has_opening boolean Returns true if the current offer has opening hash attributes.
costs.opening.fee float Defines opening commisions fee.
costs.opening.percentage_fee float Defines opening commisions percentage fee.
amortizations hash Mortgage Terms Amortizations object
amortizations.total_early.rate float Defines total early amortization percentage commisions.
amortizations.total_early.term integer Defines the first years in which we apply the total early amortization commision.
amortizations.partial_early.rate float Defines partial early amortization percentage commisions.
amortizations.partial_early.term integer Defines the first years in which we apply the partial early amortization commision.
amortizations.remainig_years.since_year integer Defines the year when applies the new early rate commisions.
amortizations.remainig_years.total_early_rate float Defines the total early amortization commisions for the remaining years.
amortizations.remainig_years.partial_early_rate float Defines the partial early amortization commisions for the remaining years.
amortizations.description string Description using HTML format.
ratings hash Rating object.
starred string It will take the value of this field from mortgage, but only if this is the main term (ATM: first active term with value >= 25y).
free_featured_label string It will take the value of this field from mortgage, but only if this is the main term (ATM: first active term with value >= 25y)
free_featured_label_description string It will take the value of this field from mortgage, but only if this is the main term (ATM: first active term with value >= 25y)
recommended string It will take the value of this field from mortgage, but only if this is the main term (ATM: first active term with value >= 25y)
most_popular string It will take the value of this field from mortgage, but only if this is the main term (ATM: first active term with value >= 25y)
cheapest string It will take the value of this field from mortgage, but only if this is the main term (ATM: first active term with value >= 25y)

Retrieve a mortgage offer

# Definition
GET https://api.kelisto.es/api/v3/finances/offers/mortgages/:slug?bank_slug=:bank_slug&product_name=:product_name

# Example request
$ curl https://api.kelisto.es/api/v3/finances/offers/mortgages/hipoteca-fija-ahora?bank_slug=liberbank&product_name=fixed_mortgage
# Example response
{
  "data": {
    "id": 15,
    "name": "Hipoteca Ahora Tipo Fijo",
    "slug": "hipoteca-fija-ahora",
    "product_name": "fixed_mortgage",
    "product_type": "mortgage",
    "claim": null,
    "starred": false,
    "best_buy": true,
    "sponsored": false,
    "updated_at": "2020-09-28T15:48:29.093+02:00",
    "status": "active",
    "description": "<p>Al adquirir la <strong>Hipoteca Ahora a Tipo Fijo de Liberbank</strong> podrás conseguir la financiación que necesitas para convertirte en propietario de una vivienda. Eso sí, este préstamo solo cubre <strong>hasta un 80%</strong> del valor de tasación del inmueble –o un 90% del valor de compra, aunque el límite entre las dos lo pondrá la cifra más baja-. </p>\n\n<p>Esta cantidad, además, tendrá que estar <strong>entre 50.000 euros y un millón</strong>. Podrás ir devolviendo el dinero en las cuotas mensuales que acuerdes con la entidad. El plazo es muy importante, porque el TIN (Tipo de Interés Nominal) varía según el período de amortización que elijas. La ventaja es que, al ser esta una <strong>hipoteca fija</strong>, este se mantendrá igual –independientemente de los cambios del euríbor- todos los años, siempre cumpliendo estas condiciones:</p>\n\n<ul>\n<li>Hasta 10 años de plazo: 1,65% </li>\n<li>De 10 a 15 años: 1,90% </li>\n<li>De 15 a 20 años: 1,99% </li>\n<li>De 20 a 25 años: 2,30% </li>\n<li>De 25 a 30 años: 2,40% </li>\n</ul>\n\n<p>Estos diferenciales solo se aplicarán si el cliente cumple algunas condiciones: la primera, <strong>abrir una cuenta bancaria con Liberbank</strong> y usarla para <strong>domiciliar tu nómina</strong>, con unos ingresos que entre todos los titulares del préstamo tendrán que sumar <strong>al menos 2.000 euros</strong>.  </p>\n\n<p>Además, te pedirán que te hagas un <strong>seguro multirriesgo de hogar y otro de vida</strong>, que solicites una <strong>tarjeta de crédito de la entidad</strong> y que contrates un <strong>plan de pensiones</strong>, en el que tendrás que hacer una <strong>aportación mínima de 1.200 euros al año</strong>. Estos requisitos no son obligatorios, pero de no cumplirse el banco te subirá el tipo de interés, lo que encarecerá el préstamo. Lo que sí te pedirán es que tu edad, sumada al plazo de la hipoteca, <strong>no supere los 75 años</strong>.</p>\n\n<p>A estos costes extra tendrás que añadirle la conocida <strong>comisión de apertura</strong>, un coste asociado a la activación del préstamo y que para esta oferta tiene un precio del <strong>0,7% de la cuantía solicitada</strong>.</p>\n\n<p>¿Y si recibieras una cantidad de dinero inesperada que te permitiera liquidar tu deuda antes de tiempo? En este caso podrás pedir la <strong>amortización anticipada</strong> y pactar con Liberbank las condiciones para devolver el dinero. Por ejemplo, tendrás opción a adelantar la fecha de vencimiento con cuotas más grandes, a adelantar una parte y reducir las cuotas o a pedir que te guarden esa cuantía como carencia por si un mes no pudieras pagar la hipoteca. Este cambio de condiciones conlleva una <strong>penalización</strong>, que está regulada por ley y que <strong>no podrá ser superior al 2% (dentro de los 10 primeros años)</strong> y al <strong>1,5% (si se solicitara a partir del undécimo año)</strong>.</p>\n",
    "has_deal": false,
    "url": null,
    "typ_description": null,
    "obligations": {
      "max_granted": 80.0,
      "min_age": 18,
      "max_age": 75,
      "min_amount": 50000,
      "max_amount": 1000000,
      "primary_residence": true,
      "second_home": false,
      "remortgage": false
    },
    "has_vinculation": true,
    "vinculations": {
      "domicile_payroll": true,
      "min_payroll": 2000.0,
      "domicile_receipts": false,
      "home_insurance": true,
      "life_insurance": true,
      "payment_protection_insurance": false,
      "other_insurances": false,
      "use_of_cards": true,
      "pension_plan": true,
      "vinculation_number": 5,
      "other_insurances_description": null,
      "vinculations_description": "<p>Para conseguir el diferencial más bajo con tu <strong>Hipoteca Ahora a Tipo Fijo</strong> tendrás que cumplir una serie de requisitos:</p>\n"
    },
    "terms": [
      {
        "status": "active",
        "min_value": 5,
        "value": 10,
        "term_type": "fixed",
        "costs": {
          "interest": 1.65,
          "interest_max": 2.75,
          "initial_interest": 1.25,
          "initial_interest_max": 1.99,
          "initial_interest_period": 12,
          "from_euribor": null,
          "from_euribor_max": null,
          "apr": 3.15,
          "apr_max": 3.42,
          "apr_description": "Para que todos los gastos asociados a la **Hipoteca Ahora a Tipo Fijo** no te pillen por sorpresa es fundamental tener calculada la **TAE (Tasa Anual Equivalente)**. Esta no es la misma para todos los clientes, pero desde Liberbank ponen un ejemplo para los que planeen pedir un préstamo a 10 años. Si la cuantía que solicitaran fuera de 150.000 euros, se encontrarían con un TIN del 1,65% y una **TAE del 3,15%**, si cumples con los requisitos de vinculación. Si no lo haces, el TIN ascenderá a 2,75 y la TAE al 3,42.",
          "euribor": -0.415,
          "has_opening": true,
          "opening": {
            "fee": null,
            "percentage_fee": 0.7
          }
        },
        "amortizations": {
          "total_early": {
            "rate": 2.0,
            "term": 10
          },
          "partial_early": {
            "rate": 2.0,
            "term": 10
          },
          "remainig_years": {
            "since_year": 11,
            "total_early_rate": 1.5,
            "partial_early_rate": 1.5
          },
          "description": "<p>Si en los años a los que se extienda tu hipoteca consiguieras reunir una cantidad que te permitiera <strong>amortizar anticipadamente</strong> el préstamo, podrás anular tu deuda. Esto lleva aparejada una comisión que, de acuerdo con la ley, no podrá ser superior a un <strong>2% en los primeros 10 años</strong> de contratación del préstamo y un <strong>1,5% a partir del undécimo año</strong>.</p>\n"
        },
        "ratings": {
          "rating": 8.2,
          "interest_max": 8.75,
          "initial_interest": 0,
          "opening": 6,
          "from_euribor_max": 0
        }
      },
      {
        # related mortgage term object
      },
      {
        # related mortgage term object
      },
      {
        # related mortgage term object
      }
    ],
    "has_promo": false,
    "bank": {
      "id": 25,
      "name": "Liberbank",
      "slug": "liberbank",
      "status": "active",
      "image": {
        "url": "https://admin.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBZlU9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--087cdf300908e140af5b0d90f6dce231af326a18/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--9bf916c83f9ea8616ecddb3dafca36d672ce853d/liberbank-s.jpg",
        "url_square": "https://admin.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBZlU9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--087cdf300908e140af5b0d90f6dce231af326a18/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--9bf916c83f9ea8616ecddb3dafca36d672ce853d/liberbank-s.jpg",
        "url_rectangular": "https://admin.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBZlk9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--0c58223e09302508f5a85d8f2ef1bd6628583290/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRERNMk5IZzVObDRHT2daRlZEb01aM0poZG1sMGVVa2lDMk5sYm5SbGNnWTdCMVE2Q1dOeWIzQkpJZzh6TmpSNE9UWXJNQ3N3QmpzSFZBPT0iLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--71541c942d6acfdb5ef992871bf12a0b051cb1a6/liberbank-w.jpg"
      }
    },
    "ratings": {
      "rating": 7.8
    },
    "has_review": false
  }
}

Arguments

Parameter Description
slug Required string The slug of the offer to retrieve.
bank_slug Required string The slug of the bank related to the offer.
product_name Required string The product name of the offer. Can be fixed_mortgage, mixed_mortgage, variable_mortgage or remortgage.

 Returns

Returns a Mortgage offer object if a valid slug, bank_slug and product_name were provided.

List all mortgages offers

# Definition
GET https://api.kelisto.es/api/v3/finances/offers/mortgages?<criteria>

# Example request
$ curl https://api.kelisto.es/api/v3/finances/offers/mortgages?sort_by=+apr&term_value=30
# Example response
{
    "pagination": {
        "links": {
            "first": "https://admin.kelisto.us/api/v3/finances/offers/mortgages?sort_by=+apr&term_value=30&apikey=e315aea65e846c13f9b711ca99475ab5&page=1",
            "next": "https://admin.kelisto.us/api/v3/finances/offers/mortgages?sort_by=+apr&term_value=30&apikey=e315aea65e846c13f9b711ca99475ab5&page=2",
            "last": "https://admin.kelisto.us/api/v3/finances/offers/mortgages?sort_by=+apr&term_value=30&apikey=e315aea65e846c13f9b711ca99475ab5&page=3"
            },
        "current_page": "1",
        "page_items": "25",
        "total_count": "69",
        "total_pages": "3"
},
    "data": [
        {
            "id": 4089,
            "name": "Hipoteca Joven a tipo fijo",
            "slug": "hipoteca-joven-santander-fija",
            "product_name": "fixed_mortgage",
            "product_type": "mortgage",
            "starred": false,
            "best_buy": false,
            "sponsored": false,
            "status": "active",
            "claim": "¡Hasta el 95% del valor de tasación si tienes 35 años o menos!",
            "updated_at": "2024-01-03T17:30:44.990+01:00",
            "description": "<p>La <strong>Hipoteca Joven del Santander a tipo fijo</strong> es una hipoteca diseñada para <strong>clientes de 35 años o menos</strong> , que tiene una particularidad con respecto a la Hipoteca Fija Bonificada de <a href=\"https://www.kelisto.es/finanzas/bancos/banco-santander\">Banco Santander</a>: en lugar de <strong>permitirte pedir</strong> hasta un 80% del valor de tasación de tu futura vivienda, amplía ese porcentaje <strong>hasta el 95%,</strong> con lo que se queda muy cerca de ser una <a href=\"https://www.kelisto.es/hipotecas/consejos-y-analisis/en-que-banco-puedo-conseguir-hipotecas-100-5464\">hipoteca al 100%</a>.</p>\n\n<p>Para conseguir esta cifra, la hipoteca joven del Santander a tipo fijo te pedirá cumplir con dos exigencias, además de la relacionada con tu edad:</p>\n\n<ul>\n<li>Que destines el dinero a la <strong>compra de tu vivienda habitual</strong>.</li>\n<li>Que aportes un <strong>aval</strong> , que se extinguirá pasados los <strong>primeros cinco años de vida de la hipoteca</strong>.</li>\n</ul>\n\n<p>Igual que sucedería con cualquier otro préstamo de este tipo, con la Hipoteca Joven del Santander a tipo fijo <strong>siempre pagarás el mismo interés</strong> y, por tanto, la misma cuota, aunque con una pequeña variación durante los seis primeros meses:</p>\n\n<ul>\n<li><strong>Durante los seis primeros meses</strong> tras su contratación, esta hipoteca del Santander al 95% tendrá un interés del <strong>2,9% TIN</strong> (Tipo de Interés Nominal).</li>\n<li><strong>A partir del séptimo mes</strong> , puedes conseguir un interés bonificado del <strong>2,8% TIN</strong>. Eso sí, para conseguirlo tendrás que <strong>cumplir con varios requisitos</strong> que puedes combinar como quieras hasta sumar un máximo de 1 punto porcentual.</li>\n</ul>\n\n<p>En concreto, los requisitos que puedes combinar para conseguir la Hipoteca Joven del Santander a tipo fijo con el TIN más bajo posible son:</p>\n\n<ul>\n<li><strong>Domiciliar la nómina</strong> o ingresos regulares (0,50 pp)</li>\n<li>Usar de la <strong>tarjeta de crédito seis veces</strong> al año (0,05 pp)</li>\n<li><strong>Contratar seguros de hogar, vida, accidentes o incapacidad</strong> (máximo 1 pp): 0,10pp por cada 100€ de prima en cualquiera de los seguros.</li>\n<li><strong>Contratación de una alarma</strong> (0,20 pp)</li>\n<li><strong>Disponer de Certificado A+, A, B o vivienda sostenible</strong> (0,10 pp)</li>\n</ul>\n\n<p>En caso de que no respetes estas estas exigencias, a partir del séptimo mes tendrás que abonar un interés fijo del 3,9% con esta hipoteca del Santander al 95%.</p>\n\n<p>En lo relativo al resto de sus condiciones, es importante que tengas en cuenta que:</p>\n\n<ul>\n<li>La Hipoteca Joven del Santander a tipo fijo tiene un <strong>plazo máximo de amortización de 30 años</strong>.</li>\n<li>En cuanto a sus <strong>comisiones</strong> , <strong>no cobra nada por apertura</strong>. En caso de amortización anticipada, eso sí, la entidad te aplicará el máximo que permite la ley: 2% los 10 primeros años y una del 1,5% a partir del undécimo.</li>\n</ul>\n\n<p>Si te planteas pedir <a href=\"https://www.kelisto.es/hipotecas/bancos/banco-santander\">hipotecas el Santander</a>, pero la Hipoteca Joven del Santander a tipo fijo no encaja con lo que buscas, recuerda que en la entidad también puedes encontrar otras ofertas para financiar la compra de tu futura casa:</p>\n\n<ul>\n<li>Hipoteca Joven del Santander a tipo variable</li>\n<li>Hipoteca Fija Bonificada de Banco Santander</li>\n<li>Hipoteca Variable Bonificada de Banco Santander</li>\n</ul>\n",
            "has_deal": true,
            "url": "https://finanzas.kelisto.es/proceso-hipoteca-ayuda",
            "typ_description": null,
            "comments": "",
            "remortgage_status": "unavailable",
            "starred_order": null,
            "starred_remortgage": false,
            "starred_order_remortgage": null,
            "free_featured_label": "",
            "free_featured_label_description": "",
            "free_featured_label_remortgage": "",
            "free_featured_label_description_remortgage": "",
            "recommended": false,
            "recommended_remortgage": false,
            "most_popular": false,
            "most_popular_remortgage": false,
            "cheapest": false,
            "cheapest_remortgage": false,
            "obligations": {
                "signup_online": true,
                "max_granted": 95,
                "min_age": 18,
                "max_age": 35,
                "min_amount": null,
                "max_amount": null,
                "primary_residence": true,
                "second_home": false
            },
            "has_vinculation": true,
            "has_bonuses": true,
            "vinculations": {
                "domicile_payroll": true,
                "bonus_domicile_payroll": null,
                "domicile_payroll_description": null,
                "min_payroll": 600,
                "domicile_receipts": true,
                "bonus_domicile_receipts": null,
                "domicile_receipts_description": null,
                "home_insurance": true,
                "bonus_home_insurance": null,
                "home_insurance_description": null,
                "life_insurance": true,
                "bonus_life_insurance": null,
                "life_insurance_description": null,
                "payment_protection_insurance": true,
                "bonus_payment_protection_insurance": null,
                "payment_protection_insurance_description": null,
                "other_insurances": true,
                "bonus_other_insurances": null,
                "use_of_cards": true,
                "bonus_use_of_cards": null,
                "use_of_cards_description": null,
                "pension_plan": true,
                "bonus_pension_plan": null,
                "pension_plan_description": null,
                "vinculation_number": 6,
                "bonus_number": 6,
                "other_insurances_description": "<p>Una de las opciones que te ofrece la Hipoteca Joven del Santander a tipo fijo para rebajar su interés es contratar seguros de hogar, vida, accidentes o incapacidad. Por cada uno de ellos podrás descontar 0,10 puntos porcentuales por cada 100€, hasta sumar un máximo de 1 punto. </p>\n",
                "vinculations_description": "<p>Para conseguir la Hipoteca Joven del Santander a tipo fijo en las mejores condiciones tendrás que cumplir con varios requisitos que puedes combinar como quieras hasta sumar un máximo de 1 punto porcentual. </p>\n\n<p>En concreto, los requisitos que puedes combinar para conseguir la Hipoteca Joven del Santander a tipo fijo con el TIN más bajo posible son: </p>\n\n<ul>\n<li>Domiciliar la nómina o ingresos regulares (0,50 pp)</li>\n<li>Usar de la tarjeta de crédito seis veces al año (0,05 pp)</li>\n<li>Contratar seguros de hogar, vida, accidentes o incapacidad (máximo 1 pp): 0,10pp por cada 100€ de prima en cualquiera de los seguros.</li>\n<li>Alarma: arrendamiento (renting) contratado con Banco Santander de un sistema de seguridad, y una vez finalizado éste, mantener contratado el servicio de mantenimiento con Movistar Prosegur Alarmas, S.L. (0,20 pp)</li>\n<li>Disponer de Certificado A+, A, B o vivienda sostenible (0,10 pp)</li>\n</ul>\n",
                "bonus_description": "<p>Para conseguir la Hipoteca Joven del Santander a tipo fijo en las mejores condiciones tendrás que cumplir con varios requisitos que puedes combinar como quieras hasta sumar un máximo de 1 punto porcentual. </p>\n\n<p>En concreto, los requisitos que puedes combinar para conseguir la Hipoteca Joven del Santander a tipo fijo con el TIN más bajo posible son: </p>\n\n<ul>\n<li>Domiciliar la nómina o ingresos regulares (0,50 pp)</li>\n<li>Usar de la tarjeta de crédito seis veces al año (0,05 pp)</li>\n<li>Contratar seguros de hogar, vida, accidentes o incapacidad (máximo 1 pp): 0,10pp por cada 100€ de prima en cualquiera de los seguros.</li>\n<li>Alarma: arrendamiento (renting) contratado con Banco Santander de un sistema de seguridad, y una vez finalizado éste, mantener contratado el servicio de mantenimiento con Movistar Prosegur Alarmas, S.L. (0,20 pp)</li>\n<li>Disponer de Certificado A+, A, B o vivienda sostenible (0,10 pp)</li>\n</ul>\n"
            },
            "has_promo": false,
            "terms": [
                {
                    "status": "active",
                    "min_value": 21,
                    "value": 30,
                    "term_type": "fixed",
                    "costs": {
                        "interest": 2.8,
                        "interest_max": 3.9,
                        "initial_interest": 2.9,
                        "initial_interest_max": 2.9,
                        "initial_interest_period": 36,
                        "from_euribor": null,
                        "from_euribor_max": null,
                        "apr": 3.39,
                        "apr_max": 4.1,
                        "apr_description": null,
                        "apr_description_no_requirement": null,
                        "euribor": 3.679,
                        "has_opening": false
                    },
                    "amortizations": {
                        "total_early": {
                            "rate": 2,
                            "term": 10
                        },
                        "partial_early": {
                            "rate": 2,
                            "term": 10
                        },
                        "remainig_years": {
                            "since_year": 11,
                            "total_early_rate": 1.5,
                            "partial_early_rate": 1.5
                        },
                        "description": "<p>Para amortizar anticipadamente la Hipoteca Joven del Santander a tipo fijo, tendrás que pagar una comisión del 2% los 10 primeros años y del 1,5% a partir del undécimo. </p>\n"
                    },
                    "ratings": {
                        "rating": 7,
                        "apr_max": 8,
                        "promo": 8,
                        "vinculation_number": 5.2,
                        "bonus_number": 5.2
                    },
                    "starred": false,
                    "free_featured_label": "",
                    "free_featured_label_description": "",
                    "recommended": false,
                    "most_popular": false,
                    "cheapest": false
                }
            ],
            "bank": {
                "id": 8,
                "name": "Banco Santander",
                "slug": "banco-santander",
                "status": "active",
                "background_color": "#EC0000",
                "product_types": [
                    "bank_account",
                    "card",
                    "mortgage",
                    "loan"
                ],
                "product_names": {
                    "bank_account": [
                        "payroll_account",
                        "checking_account",
                        "without_costs"
                    ],
                    "card": [
                        "credit_card",
                        "debit_card"
                    ],
                    "deposit": [],
                    "mortgage": [
                        "fixed_mortgage",
                        "variable_mortgage",
                        "mixed_mortgage"
                    ],
                    "loan": [
                        "personal_loan"
                    ]
                },
                "image": {
                    "url": "https://assets.kelisto.us/nnkmcju22duy44l9wmplg3zbi5zj",
                    "url_square": "https://assets.kelisto.us/nnkmcju22duy44l9wmplg3zbi5zj",
                    "url_rectangular": "https://assets.kelisto.us/r1ymzsnnb1yg7je0ghqzrpn0fnyi",
                    "url_big": "https://assets.kelisto.us/zcctjuy3qb9hvgyngm44ptcb9e1m"
                }
            },
            "ratings": {
                "rating": 7
            },
            "has_review": false
        },
    # mortgage object matching criteria,
    # mortgage object matching criteria,
    # mortgage object matching criteria,
    # ...
  ],
    "filters": {
        "available_banks": [
            {
                "name": "ABANCA",
                "slug": "abanca"
            },
            {
                "name": "Banco Santander",
                "slug": "banco-santander"
            },
            {
                "name": "Banco Sabadell",
                "slug": "banc-sabadell"
            },
            {
                "name": "Bankinter",
                "slug": "bankinter"
            },
            {
                "name": "BBVA",
                "slug": "bbva"
            },
            {
                "name": "Caixabank",
                "slug": "caixabank"
            },
            {
                "name": "Caixa Guissona ",
                "slug": "caixa-guissona"
            },
            {
                "name": "Caixa Popular ",
                "slug": "caixa_popular"
            },
            {
                "name": "Caja Ingenieros",
                "slug": "caja-de-ingenieros"
            },
            {
                "name": "Cajamar",
                "slug": "cajamar"
            },
            {
                "name": "Cajasiete",
                "slug": "caja-siete"
            },
            {
                "name": "CajaSur",
                "slug": "cajasur"
            },
            {
                "name": "COINC",
                "slug": "coinc"
            },
            {
                "name": "Evo Banco",
                "slug": "evo-banco"
            },
            {
                "name": "Ibercaja",
                "slug": "ibercaja"
            },
            {
                "name": "imagin",
                "slug": "imagin"
            },
            {
                "name": "ING",
                "slug": "ing"
            },
            {
                "name": "Grupo Kutxabank",
                "slug": "kutxabank"
            },
            {
                "name": "Myinvestor",
                "slug": "myinvestor"
            },
            {
                "name": "Openbank",
                "slug": "openbank"
            },
            {
                "name": "Pibank",
                "slug": "pibank"
            },
            {
                "name": "Unicaja",
                "slug": "unicaja"
            }
        ]
    }
}

Arguments

Parameter Description
banks optional string Retrieve offers by bank slugs. Eg: banks=bbva; banks=bbva,abanca.
status optional string Retrieve terms by status (active, inactive, snapshot or discontinue). It can be an array of statuses. Default: active.
term_value optional integer Retrieve the number of years to pay off the mortgage.
term_contains optional integer Retrieves mortgage terms valid for specified years, based on min_value-value term range
property_type optional string Retrieve the type of house, can be primary_residence or second_home.
product_name optional string Retrieve offers by product name (fixed_mortgage, mixed_mortgage or variable_mortgage). Eg: product_name=fixed_mortgage; product_name=fixed_mortgage,mixed_mortgage.
sort_by optional string The field that defines the order. Use suffix - to define descending order and + for ascending order. (i.e. +apr). Multiple sorting values can be specified (+apr,-rating)
saving_percentage optional integer Retrieve the savings percentage

 Returns

Returns a list with the mortgages offer objects excluding those with remortgage_status: exclusive and matching the specified criteria. Returns a filters' list with available active banks for the desired product_name.

Retrieve mortgages top offers

# Definition
GET https://api.kelisto.es/api/v3/finances/top_offers/mortgages/\(:product_name\)

# Example request
$ curl https://api.kelisto.es/api/v3/finances/top_offers/mortgages/fixed_mortgage
# Example response

{
    "data": [
        {
            "id": 31,
            "name": "Hipoteca Fija",
            "slug": "hipoteca-fija",
            "product_name": "fixed_mortgage",
            "product_type": "mortgage",
            "starred": false,
            "best_buy": true,
            "sponsored": false,
            "status": "active",
            "claim": null,
            "updated_at": "2024-01-29T01:00:04.210+01:00",
            "description": "<p>La <strong>Hipoteca Fija de COINC</strong> es un préstamo para financiar la compra de una vivienda que te otorgará <strong>hasta el 80% del valor de tasación o el de compra de una primera vivienda</strong> (el menor de los dos) y <strong>hasta un 60% en caso de segunda vivienda</strong>. Para ello, la entidad te cobrará un <strong>interés fijo</strong> del 3,2%.</p>\n\n<p>Al contrario de lo que sucede en muchas otras hipotecas fijas, con la de COINC solo tendrás que contratar la Cuenta Nómina, la Cuenta Profesional o la Cuenta No-Nómina con Bankinter para beneficiarte de una reducción de 0,40 pp del tipo de interés. Eso sí, COINC te pedirá que contrates un seguro de hogar (con la compañía que tú quieras) en el que el beneficiario sea Bankinter. Este préstamo hipotecario te concederá <strong>desde 30.000 hasta 800.000 euros</strong> para adquirir tu vivienda, que podrá tener un precio de <strong>entre 37.500 hasta el millón de euros</strong>. Además, el plazo de amortización que elijas puede ser de <strong>3 a 30 años</strong>. </p>\n\n<p>Con respecto a las comisiones, no tendrás comisión de apertura. Si decides <strong>cancelar tu hipoteca de manera anticipada</strong>, la comisión que tendrás  que abonar -en caso de que exista una pérdida financiera para la entidad- dependerá del tiempo que te quede por amortizar tu hipoteca:</p>\n\n<ul>\n<li>Comisión de un 2% en el caso de los 10 primeros años de la hipoteca.</li>\n<li>Comisión de un 1,5% a partir del undécimo año.</li>\n</ul>\n",
            "has_deal": true,
            "url": "https://finanzas.kelisto.es/proceso-hipoteca-ayuda",
            "typ_description": "<ul>\n<li><strong>TIN desde 3,20%</strong> </li>\n<li>TAE desde 3,49%</li>\n<li>Hasta 30 años</li>\n<li>Sin comisión de apertura</li>\n</ul>\n",
            "comments": "Cambia URL 01/04/2021. La vieja https://clk.tradedoubler.com/click?p=301361&a=2924858&g=24874094",
            "remortgage_status": "unavailable",
            "starred_order": null,
            "starred_remortgage": false,
            "starred_order_remortgage": null,
            "free_featured_label": "",
            "free_featured_label_description": "",
            "free_featured_label_remortgage": "",
            "free_featured_label_description_remortgage": "",
            "recommended": true,
            "recommended_remortgage": false,
            "most_popular": false,
            "most_popular_remortgage": false,
            "cheapest": false,
            "cheapest_remortgage": false,
            "obligations": {
                "signup_online": true,
                "max_granted": 80.0,
                "min_age": 18,
                "max_age": 75,
                "min_amount": 30000,
                "max_amount": 800000,
                "primary_residence": true,
                "second_home": false
            },
            "has_vinculation": true,
            "has_bonuses": true,
            "vinculations": {
                "domicile_payroll": true,
                "bonus_domicile_payroll": null,
                "domicile_payroll_description": "",
                "min_payroll": null,
                "domicile_receipts": false,
                "bonus_domicile_receipts": null,
                "domicile_receipts_description": "",
                "home_insurance": false,
                "bonus_home_insurance": null,
                "home_insurance_description": "",
                "life_insurance": false,
                "bonus_life_insurance": null,
                "life_insurance_description": "",
                "payment_protection_insurance": false,
                "bonus_payment_protection_insurance": null,
                "payment_protection_insurance_description": "",
                "other_insurances": false,
                "bonus_other_insurances": null,
                "use_of_cards": false,
                "bonus_use_of_cards": null,
                "use_of_cards_description": "",
                "pension_plan": false,
                "bonus_pension_plan": null,
                "pension_plan_description": "",
                "vinculation_number": 1,
                "bonus_number": 1,
                "other_insurances_description": null,
                "vinculations_description": "<p>Contratación con Bankinter de la Cuenta Nómina, Cuenta Profesional o Cuenta No-Nómina (-0,40 pp). </p>\n",
                "bonus_description": "<p>Contratación con Bankinter de la Cuenta Nómina, Cuenta Profesional o Cuenta No-Nómina (-0,40 pp). </p>\n"
            },
            "has_promo": false,
            "terms": [
                {
                    "status": "active",
                    "value": 25,
                    "term_type": "fixed",
                    "costs": {
                        "interest": 3.2,
                        "interest_max": 3.6,
                        "initial_interest": 3.2,
                        "initial_interest_max": 3.6,
                        "initial_interest_period": 300,
                        "from_euribor": null,
                        "from_euribor_max": null,
                        "apr": 3.45,
                        "apr_max": 3.91,
                        "apr_description": null,
                        "apr_description_no_requirement": null,
                        "euribor": 3.679,
                        "has_opening": false
                    },
                    "amortizations": {
                        "total_early": {
                            "rate": 2.0,
                            "term": 10
                        },
                        "partial_early": {
                            "rate": 2.0,
                            "term": 10
                        },
                        "remainig_years": {
                            "since_year": 11,
                            "total_early_rate": 1.5,
                            "partial_early_rate": 1.5
                        },
                        "description": "<p>La <strong>Hipoteca Fija de COINC</strong> se puede cancelar de manera anticipada, pero tendrás que pagar una comisión en caso de que se produzca una pérdida financiera para la entidad. Esta, según lo establecido por ley, dependerá del tiempo que te quede por pagar tu hipoteca:</p>\n\n<ul>\n<li>Si estás dentro de los 10 primeros años, la comisión será del 2%.</li>\n<li>A partir de ahí, la comisión será del 1,5%.</li>\n</ul>\n"
                    },
                    "ratings": {
                        "rating": 8.7,
                        "apr_max": 8.0,
                        "promo": 8.0,
                        "vinculation_number": 9.9,
                        "bonus_number": 9.9
                    },
                    "starred": false,
                    "free_featured_label": "",
                    "free_featured_label_description": "",
                    "recommended": true,
                    "most_popular": false,
                    "cheapest": false
                }
            ],
            "bank": {
                "id": 17,
                "name": "COINC",
                "slug": "coinc",
                "status": "active",
                "background_color": "#FF821C",
                "product_types": [
                    "mortgage"
                ],
                "product_names": {
                    "bank_account": [],
                    "card": [],
                    "deposit": [],
                    "mortgage": [
                        "fixed_mortgage",
                        "variable_mortgage"
                    ],
                    "loan": []
                },
                "image": {
                    "url": "https://assets.kelisto.us/4ds5gu05x9m9sbednatd7wf6mw3b",
                    "url_square": "https://assets.kelisto.us/4ds5gu05x9m9sbednatd7wf6mw3b",
                    "url_rectangular": "https://assets.kelisto.us/pzc9tf9def7u28zgjbr36sn252he",
                    "url_big": "https://assets.kelisto.us/jfgkfwatxz8hy7jgfsdmj4um4ww2"
                }
            },
            "ratings": {
                "rating": 8.7
            },
            "has_review": false
        },
        {...},
        {...}
    ]
}

Arguments

Parameter Description
product_name optional string Specific mortgage product_name. Value should be one of these: fixed_mortgage, mixed_mortgage, variable_mortgage or empty to get global top offers.

 Returns

Returns a list with 3 mortgage term offer objects: Mortgage offer object

# Definition
GET https://api.kelisto.es/api/v3/finances/related_offers/mortgages/:slug?:bank_slug

# Example request
$ curl https://admin.kelisto.es/api/v3/finances/related_offers/mortgages/hipoteca-naranja-fija-de-ing?bank_slug=ing&product_name=variable_mortgage

{
    "data": [
        {
            "id": 2429,
            "name": "Hipoteca Variable para subrogación",
            "slug": "hipoteca-variable-subrogacion",
            "product_name": "variable_mortgage",
            "product_type": "mortgage",
            "claim": "",
            "starred": false,
            "best_buy": false,
            "sponsored": false,
            "updated_at": "2023-06-20T03:00:00.848+02:00",
            "status": "active",
            "description": "<p>Con la <strong>Hipoteca Variable para subrogación de Openbank</strong> podrás cambiar el préstamos hipotecario que tenías con otro banco y traerlo a Openbank para mejorar tus actuales condiciones de financiación.           </p>\n\n<p>La cantidad máxima que puedes solicitar con esta hipoteca es del <strong>80% del valor de tasación de tu primera vivienda</strong>, o <strong>hasta el 70% del de la segunda</strong>. Y el <strong>plazo para amortizar tu deuda</strong> será hasta <strong>30 años</strong>, y 25 años si es para segunda residencia. </p>\n\n<p>Para poder acceder a la Hipoteca Variable Open para subrogación en las mejores condiciones, la entidad te exigirá que <strong>contrates varios productos y servicios extra</strong>. Con cada uno irás rebajando en interés máximo de esta oferta, hasta llegar a la propuesta más barata disponible en  cada momento:</p>\n\n<ul>\n<li><strong>Domiciliar ingresos</strong> (-0,30 puntos de bonificación): Openbank exige domiciliar una nómina igual o superior a 900€ en el caso de un titular, o de 1.800€ en el caso de dos titulares. Si es para segunda residencia </li>\n<li><strong>Contratar el seguro de hogar con Openbank</strong> (-0,10 puntos)</li>\n<li><strong>Contratar el seguro de vida con Openbank</strong> (-0,10 puntos si se asegura el 100% del capital financiado)</li>\n<li><strong>Contratar la luz con Repsol</strong> (-0,05 puntos)</li>\n<li><strong>Contratar el gas con Repsol</strong> (-0,05 puntos)</li>\n<li><strong>Contratar una tarjeta de crédito y usarla una vez al mes</strong> (-0,10 puntos)</li>\n<li><strong>Realizar suscripciones, aportaciones o traspasos externos en fondos de inversión o planes de pensiones comercializados por Openbank</strong> por un importe mínimo de 600€ netos anuales (-0,10 puntos)</li>\n<li><strong>Financiar más de 150.000€</strong> (-0,10 puntos)</li>\n</ul>\n\n<p>Cumpliendo con estos requisitos de vinculación, pagarías:</p>\n\n<ul>\n<li>El primer año el TIN (Tipo de Interés Nominal) será de un  1,6% fijo. Después, el interés pasa a ser de euríbor a un año más 0,60%, contando que se cumplen las vinculaciones que exige la entidad (nómina y seguro de hogar). De lo contrario, al no cumplirse las condiciones establecidas no se aplican las bonificaciones y  el primer año tendrás que pagar un interés inicial del 2,40%, y el resto de años euríbor más 1,40%.</li>\n</ul>\n\n<p>También, con esta <strong>Hipoteca Variable de subrogación</strong> tendrás las siguientes <strong>ventajas</strong> añadidas:     </p>\n\n<ul>\n<li>  Los costes de notaría, gestoría y registro por cancelar tu hipoteca con el otro banco serán asumidos por Openbank.</li>\n<li>  No tendrás que pagar ninguna comisión de apertura de Hipoteca, ni por amortización parcial. Lo único, si realizas una amortización total la comisión los tres primeros años será de 0,25%, el resto sin comisión.</li>\n</ul>\n\n<p>Por último, ten en cuenta que al eliminar la Hipoteca Variable con tu otro banco, tendrás que hacer frente a la <strong>comisión de amortización anticipada</strong>, que podrás financiar a través de Openbank. </p>\n",
            "has_deal": true,
            "url": "https://clk.tradedoubler.com/click?p=284641&a=2924858&g=24928988",
            "typ_description": null,
            "comments": "",
            "remortgage_status": "unavailable",
            "obligations": {
                "max_granted": 80,
                "min_age": 18,
                "max_age": 75,
                "min_amount": null,
                "max_amount": null,
                "primary_residence": true,
                "second_home": true
            },
            "has_vinculation": true,
            "vinculations": {
                "domicile_payroll": true,
                "min_payroll": 900,
                "domicile_receipts": false,
                "home_insurance": true,
                "life_insurance": true,
                "payment_protection_insurance": false,
                "other_insurances": false,
                "use_of_cards": true,
                "pension_plan": false,
                "vinculation_number": 7,
                "other_insurances_description": null,
                "vinculations_description": "<p>Para poder acceder a la Hipoteca Variable Open para subrogación en las mejores condiciones, la entidad te exigirá que <strong>contrates varios productos y servicios extra</strong>. Con cada uno irás rebajando en interés máximo de esta oferta, hasta llegar a la propuesta más barata disponible en  cada momento:</p>\n\n<ul>\n<li><strong>Domiciliar ingresos</strong> (-0,30 puntos de bonificación): Openbank exige domiciliar una nómina igual o superior a 900€ en el caso de un titular, o de 1.800€ en el caso de dos titulares. Si es para segunda residencia </li>\n<li><strong>Contratar el seguro de hogar con Openbank</strong> (-0,10 puntos)</li>\n<li><strong>Contratar el seguro de vida con Openbank</strong> (-0,10 puntos si se asegura el 100% del capital financiado)</li>\n<li><strong>Contratar la luz con Repsol</strong> (-0,05 puntos)</li>\n<li><strong>Contratar el gas con Repsol</strong> (-0,05 puntos)</li>\n<li><strong>Contratar una tarjeta de crédito y usarla una vez al mes</strong> (-0,10 puntos)</li>\n<li><strong>Realizar suscripciones, aportaciones o traspasos externos en fondos de inversión o planes de pensiones comercializados por Openbank</strong> por un importe mínimo de 600€ netos anuales (-0,10 puntos)</li>\n</ul>\n"
            },
            "has_promo": false,
            "terms": [
                {
                    "status": "active",
                    "value": 30,
                    "term_type": "variable",
                    "costs": {
                        "interest": 1.6,
                        "interest_max": 2.4,
                        "initial_interest": 1.6,
                        "initial_interest_max": 2.4,
                        "initial_interest_period": 12,
                        "from_euribor": 0.6,
                        "from_euribor_max": 1.4,
                        "apr": 4.62,
                        "apr_max": 5,
                        "apr_description": "Para que sepas a cuánto ascenderán las cuotas mensuales en las que tendrás que ir devolviendo tu **Hipoteca Open Variable (80% VT)** necesitarás conocer la TAE (Tasa Anual Equivalente). Esta no es una cifra igual en todos los casos, porque depende de las condiciones con las que hayas configurado el préstamo.\r\n \r\n",
                        "euribor": 3.862,
                        "has_opening": false
                    },
                    "amortizations": {
                        "total_early": {
                            "rate": 2,
                            "term": 10
                      },
                        "partial_early": {
                            "rate": 0,
                            "term": 0
                        },
                        "remainig_years": {
                            "since_year": 0,
                            "total_early_rate": 1.5,
                            "partial_early_rate": 0
                        },
                        "description": "<p>La comisión por amortización anticipada total que se aplica es de 2% los diez primeros años y el resto a 1,50%</p>\n"
                    },
                    "ratings": {
                        "rating": 9.4,
                        "interest_max": 0,
                        "initial_interest": 7,
                        "opening": 10,
                        "from_euribor_max": 10
                    }
                }
            ],
            "bank": {
                "id": 29,
                "name": "Openbank",
                "slug": "openbank",
                "status": "active",
                "background_color": "#E9004C",
                "product_types": [
                    "bank_account",
                    "card",
                    "deposit",
                    "mortgage",
                    "loan"
                ],
                "product_names": {
                    "bank_account": [
                        "payroll_account",
                        "savings_account",
                        "checking_account",
                        "without_costs"
                    ],
                    "card": [
                        "debit_card",
                        "credit_card",
                        "wallet_card"
                    ],
                    "deposit": [
                        "deposit"
                    ],
                    "mortgage": [
                        "variable_mortgage",
                        "fixed_mortgage"
                    ],
                    "loan": [
                        "personal_loan"
                    ]
                },
                "image": {
                    "url": "https://assets.kelisto.us/e8q4h16wf3ex2ocgcta9iymxwnlm",
                    "url_square": "https://assets.kelisto.us/e8q4h16wf3ex2ocgcta9iymxwnlm",
                    "url_rectangular": "https://assets.kelisto.us/hs2gfmrkawh5k62tlchx02z2s5vb",
                    "url_big": "https://assets.kelisto.us/ha5euvd8oatsz5wcpfb7gtznnlqn"
                }
            },
            "ratings": {
                "rating": 9.4
            },
            "has_review": false
        },
        # another mortgage offer
    # another mortgage offer
    ]
}

Arguments

Parameter Description
bank_slug Required string The slug of the bank related to the offers (as part of the url).
slug Required string The slug of the offer which we need to retrieve their related offers (as part of the url).
product_name Required string The product name of the offer which we need to retrieve their related offers (as part of the url).

Returns

Returns a list of related mortgage offer objects sorted by relevance

List mortgages multiproduct

# Definition
GET https://api.kelisto.es/api/v3/finances/multiproduct/:bank_slug/mortgages

# Example request
$ curl https://api.kelisto.es/api/v3/finances/multiproduct/bbva/cards
# Example response

{
    "data": {
        "id": 13,
        "name": "BBVA",
        "slug": "bbva",
        "status": "active",
        "image": {
            "url": "https://assets.kelisto.us/mi7g249ch3yxmzqqn8zmjr8f3s7g",
            "url_square": "https://assets.kelisto.us/mi7g249ch3yxmzqqn8zmjr8f3s7g",
            "url_rectangular": "https://assets.kelisto.us/2s3glcoqq0nmyelhkkxt0fdql03b"
        },
        "product_names": [
            "fixed_mortgage",
            "variable_mortgage",
            "remortgage"
        ],
        "products": [
            {
                "product_name": "fixed_mortgage",
                "offers": [
                    {
                        "id": 20,
                        "name": "Hipoteca Fija BBVA",
                        "slug": "hipoteca-fija",
                        "product_name": "fixed_mortgage",
                        "product_type": "mortgage",
                        "claim": "",
                        "starred": false,
                        "best_buy": true,
                        "sponsored": false,
                        "updated_at": "2023-01-04T16:58:34.751+01:00",
                        "status": "active",
                        "description": "<p>La <strong>Hipoteca Fija BBVA</strong> te servirá para conseguir un adelanto de dinero que cubra <strong>hasta un 80% del valor de tasación</strong> de la casa que quieras comprar –hasta un 70% si fuera segunda residencia-. Este préstamo, destinado exclusivamente a la adquisición de un inmueble, tendrá que irse devolviendo en cuotas mensuales a decidir por el propio cliente. De hecho, tendrás <strong>de 10 a 30 años</strong> para saldar tu deuda, con una restricción: al terminar de pagar el dinero, no podrás superar los 70 años. Eso quiere decir que si, por ejemplo, tuvieras 50 años en el momento de la contratación, el plazo máximo a escoger será de 20 años. </p>\n\n<p>Como indica su nombre, esta es una <strong>hipoteca a plazo fijo</strong>, por lo que los intereses que tendrás que pagar al banco –en definitiva, el precio de la oferta- no cambiarán de un año para otro ni dependerán de valores variables como el euríbor. Según el periodo que establezcas, este es el <strong>TIN (Tipo de Interés Nominal)</strong> de esta oferta:</p>\n\n<ul>\n<li>Hasta 15 años: 2,8%.</li>\n<li>Entre 16 y 30 años: 3,15%</li>\n</ul>\n\n<p>Este TIN es el más bajo asociado a esta oferta, pero tiene truco ya que tendrás que cumplir algunos requisitos de vinculación: <strong>domiciliar tu nómina en una cuenta de BBVA, con un importe mínimo de 600 euros</strong> -300 euros en caso de que ingreses una pensión-, contratar un <strong>seguro de hogar multirriesgo a través de la entidad</strong> y que <strong>un 50% -o un mínimo de 150.00 euros- de la hipoteca esté cubierto por una póliza de amortización de préstamos</strong>, un tipo de seguro de vida. Si no se dieran estas condiciones, el TIN subirá un punto porcentual, aunque la entidad te dejará un plazo de seis meses para que puedas cumplir con todos estos requisitos. </p>\n\n<p>Aunque los costes de los productos vinculados son un requisito a tener en cuenta, una de las ventajas de la Hipoteca Fija BBVA es que <strong>no tendrás que abonar ninguna comisión</strong> por la apertura de la <strong>Hipoteca Fija de BBVA</strong>. Sin embargo, si qué tendrás que pagar en caso de que decidieras amortizar tu deuda anticipadamente y, por tanto, solicites la cancelación sin que haya cumplido el vencimiento del préstamo.</p>\n",
                        "has_deal": false,
                        "url": null,
                        "typ_description": "<ul>\n<li><strong>TAE desde 2,81%</strong> </li>\n<li>TIN desde 1,95%</li>\n<li>Sin gastos de notaria, gestoría ni registro</li>\n<li>Sin comisión de apertura</li>\n</ul>\n",
                        "comments": "URL antigua 12/11 https://clk.tradedoubler.com/click?p=304300&a=2924858&g=24730652",
                        "remortgage_status": "unavailable",
                        "obligations": {
                            "max_granted": 80.0,
                            "min_age": 18,
                            "max_age": 70,
                            "min_amount": 20000,
                            "max_amount": 1600000,
                            "primary_residence": true,
                            "second_home": false
                        },
                        "has_vinculation": true,
                        "vinculations": {
                            "domicile_payroll": true,
                            "min_payroll": 600.0,
                            "domicile_receipts": false,
                            "home_insurance": true,
                            "life_insurance": true,
                            "payment_protection_insurance": true,
                            "other_insurances": false,
                            "use_of_cards": false,
                            "pension_plan": false,
                            "vinculation_number": 4,
                            "other_insurances_description": null,
                            "vinculations_description": "<p>Tu TIN puede reducirse en un punto porcentual si estás dispuesto a <strong>abrir una cuenta de BBVA y domiciliar tu nómina</strong>. Esta debe tener un importe mínimo de <strong>600 euros al mes</strong>. Si lo que ingresas es una pensión, el tope más bajo está en 300 euros. Además, la rebaja depende de que contrates una <strong>póliza multirriesgo de hogar</strong> y <strong>otra de amortización de préstamos</strong> -un seguro de vida que cubra al menos el 50% de la hipoteca, o menos de la mitad pero al menos 150.000 euros-.</p>\n\n<p>BBVA te dejará un plazo de seis meses para que cumplas con estos requisitos. De no hacerlo, el interés de su hipoteca fija subiría un punto porcentual. </p>\n"
                        },
                        "has_promo": false,
                        "terms": [
                            {
                                "status": "active",
                                "value": 15,
                                "term_type": "fixed",
                                "costs": {
                                    "interest": 2.8,
                                    "interest_max": 3.8,
                                    "initial_interest": 2.8,
                                    "initial_interest_max": 3.8,
                                    "initial_interest_period": 5400,
                                    "from_euribor": null,
                                    "from_euribor_max": null,
                                    "apr": 3.73,
                                    "apr_max": 4.47,
                                    "apr_description": "Como la **TAE (Tasa Anual Equivalente)** es el factor más importante para calcular el precio real de tu hipoteca, en Kelisto te mostramos un ejemplo representativo que calca el que BBVA muestra a sus clientes.\r\n \r\n Así, si quisieras pedir un préstamo de 150.000 euros a tipo fijo y para devolver en 15 años, te aplicarán un **TIN del 2,8%** y una **TAE del 3,73%**. Estas cifras tienen en cuenta que el cliente ha conseguido la máxima bonificación gracias a la vinculación mediante una cuenta con nómina domiciliada, un seguro de hogar y otro de amortización de préstamos (es decir, una póliza de vida que cubra la cuantía que te ha dejado el banco). En caso de que no aceptes la vinculación adicional ofrecida por el banco, la TAE alcanzará el 4,47%.",
                                    "euribor": 2.828,
                                    "has_opening": false
                                },
                                "amortizations": {
                                    "total_early": {
                                        "rate": 2.0,
                                        "term": 10
                                    },
                                    "partial_early": {
                                        "rate": 2.0,
                                        "term": 10
                                    },
                                    "remainig_years": {
                                        "since_year": 11,
                                        "total_early_rate": 1.5,
                                        "partial_early_rate": 1.5
                                    },
                                    "description": null
                                },
                                "ratings": {
                                    "rating": 7.9,
                                    "interest_max": 7.25,
                                    "initial_interest": 0,
                                    "opening": 10,
                                    "from_euribor_max": 0
                                }
                            },
                            {
                                "status": "active",
                                "value": 20,
                                "term_type": "fixed",
                                "costs": {
                                    "interest": 2.9,
                                    "interest_max": 3.9,
                                    "initial_interest": 2.9,
                                    "initial_interest_max": 3.9,
                                    "initial_interest_period": 20,
                                    "from_euribor": null,
                                    "from_euribor_max": null,
                                    "apr": 3.82,
                                    "apr_max": 4.55,
                                    "apr_description": "En Kelisto hemos decidido mostrarte la **TAE (Tasa Anual Equivalente)** representativa que BBVA ofrece a sus clientes para esta oferta.\r\n",
                                    "euribor": 2.828,
                                    "has_opening": false
                                },
                                "amortizations": {
                                    "total_early": {
                                        "rate": 2.0,
                                        "term": 10
                                    },
                                    "partial_early": {
                                        "rate": 2.0,
                                        "term": 10
                                    },
                                    "remainig_years": {
                                        "since_year": 11,
                                        "total_early_rate": 1.5,
                                        "partial_early_rate": 1.5
                                    },
                                    "description": null
                                },
                                "ratings": {
                                    "rating": 7.8,
                                    "interest_max": 7.0,
                                    "initial_interest": 0,
                                    "opening": 10,
                                    "from_euribor_max": 0
                                }
                            },
                            {
                                "status": "active",
                                "value": 25,
                                "term_type": "fixed",
                                "costs": {
                                    "interest": 2.9,
                                    "interest_max": 3.9,
                                    "initial_interest": 2.9,
                                    "initial_interest_max": 3.9,
                                    "initial_interest_period": 25,
                                    "from_euribor": null,
                                    "from_euribor_max": null,
                                    "apr": 3.86,
                                    "apr_max": 4.52,
                                    "apr_description": "Para ayudarte a conseguir una idea aproximada del precio final de tu hipoteca, en Kelisto te mostraoms la misma **TAE (Tasa Anual Equivalente)** que da BBVA a sus clientes.\r\n \r\n",
                                    "euribor": 2.828,
                                    "has_opening": false
                                },
                                "amortizations": {
                                    "total_early": {
                                        "rate": 2.0,
                                        "term": 10
                                    },
                                    "partial_early": {
                                        "rate": 2.0,
                                        "term": 10
                                    },
                                    "remainig_years": {
                                        "since_year": 11,
                                        "total_early_rate": 1.5,
                                        "partial_early_rate": 1.5
                                    },
                                    "description": null
                                },
                                "ratings": {
                                    "rating": 7.8,
                                    "interest_max": 7.0,
                                    "initial_interest": 0,
                                    "opening": 10,
                                    "from_euribor_max": 0
                                }
                            },
                            {
                                "status": "active",
                                "value": 30,
                                "term_type": "fixed",
                                "costs": {
                                    "interest": 2.9,
                                    "interest_max": 3.9,
                                    "initial_interest": 2.9,
                                    "initial_interest_max": 3.9,
                                    "initial_interest_period": 30,
                                    "from_euribor": null,
                                    "from_euribor_max": null,
                                    "apr": 3.96,
                                    "apr_max": 4.5,
                                    "apr_description": "Tienes que saber la **TAE (Tasa Anual Equivalente)** para poder calcular el precio total de tu hipoteca. Esta depende de todos los costes adicionales y del TIN (Tipo de Interés Nominal) que te apliquen. \r\n \r\n",
                                    "euribor": 2.828,
                                    "has_opening": false
                                },
                                "amortizations": {
                                    "total_early": {
                                        "rate": 2.0,
                                        "term": 10
                                    },
                                    "partial_early": {
                                        "rate": 2.0,
                                        "term": 10
                                    },
                                    "remainig_years": {
                                        "since_year": 11,
                                        "total_early_rate": 1.5,
                                        "partial_early_rate": 1.5
                                    },
                                    "description": null
                                },
                                "ratings": {
                                    "rating": 7.8,
                                    "interest_max": 7.0,
                                    "initial_interest": 0,
                                    "opening": 10,
                                    "from_euribor_max": 0
                                }
                            }
                        ],
                        "bank": {
                            "id": 13,
                            "name": "BBVA",
                            "slug": "bbva",
                            "status": "active",
                            "image": {
                                "url": "https://assets.kelisto.us/mi7g249ch3yxmzqqn8zmjr8f3s7g",
                                "url_square": "https://assets.kelisto.us/mi7g249ch3yxmzqqn8zmjr8f3s7g",
                                "url_rectangular": "https://assets.kelisto.us/2s3glcoqq0nmyelhkkxt0fdql03b"
                            }
                        },
                        "ratings": {
                            "rating": 7.8
                        },
                        "has_review": false
                    },
                    {
                        "id": 2136,
                        "name": "Hipoteca Casa Eficiente",
                        "slug": "hipoteca-casa-eficiente-bbva",
                        "product_name": "fixed_mortgage",
                        "product_type": "mortgage",
                        "claim": "",
                        "starred": false,
                        "best_buy": false,
                        "sponsored": false,
                        "updated_at": "2023-01-04T17:05:21.810+01:00",
                        "status": "active",
                        "description": "<p>La <strong>Hipoteca Casa Eficiente de BBVA</strong> es un préstamo hipotecario a un interés fijo, lo que quiere decir que pagarás la misma cantidad todos los años.     </p>\n\n<p>Esta Hipoteca solo podrá ser solicitada si la vivienda que vayas a comprar dispone del  <strong>“Certificado de Eficiencia Energética A”</strong>, resides en España, dispones de una cuenta en BBVA y contratas un Seguro de daños sobre la vivienda mientras dure tu hipoteca.</p>\n\n<p>Podrás solicitar hasta el <strong>80 % para tu vivienda habitual</strong> y hasta el <strong>70 % para tu segunda vivienda</strong>.</p>\n\n<p>Al tratarse de una hipoteca a tipo fijo, pagarás un <strong>interés constante</strong> durante el tiempo que tardes en devolver tu deuda hipotecaria. El tipo de interés viene asociado al <strong>plazo de devolución</strong> que elijas: </p>\n\n<ul>\n<li>Hasta 15 años: 3,05%.</li>\n<li>Entre 16 y 20 años: 3,15%</li>\n<li>Entre 21 y 25 años: 3,15%.<br></li>\n<li>Entre 26 y 30 años: 3,15%</li>\n</ul>\n\n<p>Ahora bien, para poder disfrutar de este tipo de interés, tendrás que cumplir con los siguientes <strong>requisitos de vinculación</strong>:</p>\n\n<ul>\n<li>Domiciliar tu nómina: nómina de más de 600 euros o pensión de más de 300 euros; y si eres autónomo, será suficiente con que domicilies tu cuota de autónomos.</li>\n</ul>\n\n<p>-Seguro Multirriesgo Hogar de BBVA Allianz:  tiene que estar vigente y al corriente de pago.</p>\n\n<p>-Seguro de amortización de préstamo de BBVA Seguros: vigente, al corriente de pago y que cubra al menos la mitad del importe de tu hipoteca. Si ese 50% supera los 150.000€, basta con esa cantidad.</p>\n\n<p>Si no cumples con ninguno de estos requisitos, la hipoteca se encarecerá en un 1% para todos los plazos. Eso sí, <strong>BBVA aplicará la máxima bonificación 1% de Tipo de Interés fijo durante los primeros seis meses</strong> contrates o no productos asociados. </p>\n\n<p>Por otro lado, recuerda que para contratar esta hipoteca la edad del titular más joven con ingresos y el plazo de la hipoteca no podrán sumar más de 70 años.</p>\n\n<p>Con la ** Hipoteca Casa Eficiente de BBVA** no tendrás <strong>ninguna comisión de apertura</strong>, ni gastos de notaría y gestoría. Sin embargo, si decides <strong>amortizar tu deuda anticipadamente</strong>, tendrás que pagar una <strong>comisión por amortización anticipada</strong>:<br><br>\n-Durante los 10 primeros años: un 2% del capital reembolsado anticipadamente.<br>\n-A partir del 11º año (inclusive): un 1,5% del capital reembolsado anticipadamente.</p>\n",
                        "has_deal": false,
                        "url": null,
                        "typ_description": null,
                        "comments": "",
                        "remortgage_status": "unavailable",
                        "obligations": {
                            "max_granted": 80.0,
                            "min_age": 18,
                            "max_age": 70,
                            "min_amount": 20000,
                            "max_amount": 1600000,
                            "primary_residence": true,
                            "second_home": true
                        },
                        "has_vinculation": true,
                        "vinculations": {
                            "domicile_payroll": true,
                            "min_payroll": 600.0,
                            "domicile_receipts": false,
                            "home_insurance": true,
                            "life_insurance": true,
                            "payment_protection_insurance": false,
                            "other_insurances": false,
                            "use_of_cards": false,
                            "pension_plan": false,
                            "vinculation_number": 3,
                            "other_insurances_description": null,
                            "vinculations_description": "<p>Tu TIN puede reducirse en un punto porcentual si estás dispuesto a <strong>abrir una cuenta de BBVA y domiciliar tu nómina</strong>. Esta debe tener un importe mínimo de <strong>600 euros al mes</strong>. Si lo que ingresas es una pensión, el tope más bajo está en 300 euros. Además, la rebaja depende de que contrates un <strong>seguro multirriesgo de hogar</strong> de BBVA Allianz y  un <strong>seguro de amortización de préstamos</strong> de BBVA Seguros -un seguro que cubra al menos la mitad  del importe de la hipoteca. Si ese 50% supera los 150.000 €, basta con esa cantidad.</p>\n"
                        },
                        "has_promo": false,
                        "terms": [
                            {
                                "status": "active",
                                "value": 15,
                                "term_type": "fixed",
                                "costs": {
                                    "interest": 3.05,
                                    "interest_max": 4.05,
                                    "initial_interest": 3.05,
                                    "initial_interest_max": 4.05,
                                    "initial_interest_period": 5400,
                                    "from_euribor": null,
                                    "from_euribor_max": null,
                                    "apr": 3.98,
                                    "apr_max": 4.73,
                                    "apr_description": "Para conocer el coste real de la Hipoteca Casa Eficiente de BBVA, en Kelisto te mostramos el ejemplo representativo de la Tasa Anual Equivalente o TAE que el banco azul proporciona a sus clientes. En este caso, la TAE asciende al 3,98% para una hipoteca de 150.000€ a devolver en 15 años, siempre que se respeten los requisitos de vinculación. En caso contrario, subirá al 4,73%.",
                                    "euribor": 2.828,
                                    "has_opening": false
                                },
                                "amortizations": {
                                    "total_early": {
                                        "rate": 2.0,
                                        "term": 10
                                    },
                                    "partial_early": {
                                        "rate": 2.0,
                                        "term": 10
                                    },
                                    "remainig_years": {
                                        "since_year": 11,
                                        "total_early_rate": 1.5,
                                        "partial_early_rate": 1.5
                                    },
                                    "description": "<p>Si decides amortizar antes de tiempo tu Hipoteca Casa Eficiente de BBVA, tendrás que pagar una comisión del 2% durante los 10 primeros años y una del 1,5% a partir del undécimo. </p>\n"
                                },
                                "ratings": {
                                    "rating": 7.6,
                                    "interest_max": 6.75,
                                    "initial_interest": 0,
                                    "opening": 10,
                                    "from_euribor_max": 0
                                }
                            },
                            {
                                "status": "active",
                                "value": 20,
                                "term_type": "fixed",
                                "costs": {
                                    "interest": 3.15,
                                    "interest_max": 4.15,
                                    "initial_interest": 3.15,
                                    "initial_interest_max": 4.15,
                                    "initial_interest_period": 20,
                                    "from_euribor": null,
                                    "from_euribor_max": null,
                                    "apr": 4.07,
                                    "apr_max": 4.8,
                                    "apr_description": "Para que puedas saber cuál es el coste real de la Hipoteca Casa Eficiente de BBVA, te mostramos un ejemplo de la TAE (Tasa Anual Equivalente) que ofrece el propio banco a sus usuarios. En este caso, se trata de un 4,07%, para un ejemplo de un préstamo de 150.000€ a 20 años, sin comisión de apertura y sin coste por el mantenimiento de la cuenta bancaria vinculada la hipoteca. Y si no contratas los productos requeridos por el banco la TAE será del 4,80%.",
                                    "euribor": 2.828,
                                    "has_opening": false
                                },
                                "amortizations": {
                                    "total_early": {
                                        "rate": 2.0,
                                        "term": 10
                                    },
                                    "partial_early": {
                                        "rate": 2.0,
                                        "term": 10
                                    },
                                    "remainig_years": {
                                        "since_year": 11,
                                        "total_early_rate": 1.5,
                                        "partial_early_rate": 1.5
                                    },
                                    "description": "<p>Con la Hipoteca Casa Eficiente de BBVA tendrás que pagar una comisión por amortización anticipada: es decir, un cargo por devolver tu deuda (o parte de ella) antes del tiempo que habías estipulado con la entidad. Esa comisión dependerá  del momento en el que realices la amortización anticipada: un 2% del dinero que devuelvas durante los 10 primeros años, y un 1,5% a partir del undécimo mes.</p>\n"
                                },
                                "ratings": {
                                    "rating": 7.6,
                                    "interest_max": 6.75,
                                    "initial_interest": 0,
                                    "opening": 10,
                                    "from_euribor_max": 0
                                }
                            },
                            {
                                "status": "active",
                                "value": 25,
                                "term_type": "fixed",
                                "costs": {
                                    "interest": 3.15,
                                    "interest_max": 4.15,
                                    "initial_interest": 3.15,
                                    "initial_interest_max": 4.15,
                                    "initial_interest_period": 300,
                                    "from_euribor": null,
                                    "from_euribor_max": null,
                                    "apr": 4.12,
                                    "apr_max": 4.78,
                                    "apr_description": "Para poder analizar el precio de tu **Hipoteca Casa Eficiente de BVVA a un máximo de 25 años** antes necesitas conocer la **TAE (Tasa Anual Equivalente)**.\r\n \r\nEsta varía según las condiciones que pactes con el banco, para ello BBVA pone un ejemplo a sus clientes para que puedan calcular los costes totales del préstamo. Así, si se quisiera pedir una hipoteca con un valor de 150.000 euros a devolver en 25 años, se aplicará una TAE del 3,41%, si cumples con los requisitos de vinculación de la entidad, y una TAE del 4,07%, si no lo haces.",
                                    "euribor": 2.828,
                                    "has_opening": false
                                },
                                "amortizations": {
                                    "total_early": {
                                        "rate": 2.0,
                                        "term": 10
                                    },
                                    "partial_early": {
                                        "rate": 2.0,
                                        "term": 10
                                    },
                                    "remainig_years": {
                                        "since_year": 11,
                                        "total_early_rate": 1.5,
                                        "partial_early_rate": 1.5
                                    },
                                    "description": "<p>Para llevar a cabo la amortización anticipada de tu Hipoteca Casa Eficiente de BBVA, tendrás que pagar una comisión del 2% durante los 10 primeros años y a partir del mes 11 una comisión del 1,5%.</p>\n"
                                },
                                "ratings": {
                                    "rating": 7.6,
                                    "interest_max": 6.75,
                                    "initial_interest": 0,
                                    "opening": 10,
                                    "from_euribor_max": 0
                                }
                            },
                            {
                                "status": "active",
                                "value": 30,
                                "term_type": "fixed",
                                "costs": {
                                    "interest": 3.15,
                                    "interest_max": 4.15,
                                    "initial_interest": 3.15,
                                    "initial_interest_max": 4.15,
                                    "initial_interest_period": 360,
                                    "from_euribor": null,
                                    "from_euribor_max": null,
                                    "apr": 4.22,
                                    "apr_max": 4.75,
                                    "apr_description": "Para que conozcas todos los gastos asociados a la **Hipoteca Casa Eficiente de BBVA** es fundamental tener calculada la **TAE (Tasa Anual Equivalente)**. Esta no es la misma para todos los clientes, por ello BBVA ponen un ejemplo para los que planeen pedir un préstamo a 30 años. Si la cuantía que solicitaras fuera de 150.000 euros, se encontrarían con una **TAE del 4,22%**, en caso de contratar los productos vinculados, y un 4,75% TAE en caso de no hacerlo.",
                                    "euribor": 2.828,
                                    "has_opening": false
                                },
                                "amortizations": {
                                    "total_early": {
                                        "rate": 2.0,
                                        "term": 10
                                    },
                                    "partial_early": {
                                        "rate": 2.0,
                                        "term": 10
                                    },
                                    "remainig_years": {
                                        "since_year": 11,
                                        "total_early_rate": 1.5,
                                        "partial_early_rate": 1.5
                                    },
                                    "description": "<p>La <strong>comisión máxima por amortización anticipada</strong> que cualquier entidad puede cobrar a sus clientes con una hipoteca a tipo fijo se establece de la siguiente manera:  durante los <strong>10 primeros años</strong> conllevará un cargo del  <strong>2% sobre el dinero a devolver</strong> y, <strong>a partir del undécimo año, el tope baja a un 1,5%</strong>.</p>\n"
                                },
                                "ratings": {
                                    "rating": 7.6,
                                    "interest_max": 6.75,
                                    "initial_interest": 0,
                                    "opening": 10,
                                    "from_euribor_max": 0
                                }
                            }
                        ],
                        "bank": {
                            "id": 13,
                            "name": "BBVA",
                            "slug": "bbva",
                            "status": "active",
                            "image": {
                                "url": "https://assets.kelisto.us/mi7g249ch3yxmzqqn8zmjr8f3s7g",
                                "url_square": "https://assets.kelisto.us/mi7g249ch3yxmzqqn8zmjr8f3s7g",
                                "url_rectangular": "https://assets.kelisto.us/2s3glcoqq0nmyelhkkxt0fdql03b"
                            }
                        },
                        "ratings": {
                            "rating": 7.6
                        },
                        "has_review": false
                    }
                ]
            },
            {
                "product_name": "variable_mortgage",
                "offers": [
                    {
                        "id": 19,
                        "name": "Hipoteca Variable BBVA",
                        "slug": "hipoteca-bbva",
                        "product_name": "variable_mortgage",
                        "product_type": "mortgage",
                        "claim": "",
                        "starred": false,
                        "best_buy": true,
                        "sponsored": false,
                        "updated_at": "2023-01-09T16:12:23.171+01:00",
                        "status": "active",
                        "description": "<p>Contratar la <strong>Hipoteca Variable de BBVA</strong> te permitirá solicitar un adelanto de dinero para adquirir una casa e ir comprándola a plazos. Debes tener en cuenta que este préstamo te servirá para <strong>financiar hasta el 80% del valor de tasación (o de compraventa)</strong> de la vivienda. El inmueble que desees comprar podrá tener un coste de entre 25.000 y dos millones de euros, lo que quiere decir que la cuantía de la hipoteca debe entrar en una horquilla <strong>de 20.000 a 1,6 millones de euros</strong>. </p>\n\n<p>Tú mismo podrás configurar el tiempo para devolver el dinero, dentro de un período comprendido <strong>entre 10 y 30 años</strong>. La única limitación relativa al plazo está en tu edad: <strong>al finalizar de pagar la deuda, no podrás tener más de 70 años</strong>. Así para el menor tiempo (10 años), la edad máxima es de 60 años, pero si quisieras alargarlo a 40, no podrás establecer un plazo de devolución de más de 30 años a la hora de pedir la hipoteca. </p>\n\n<p>Esta oferta entra dentro de las clasificadas como <strong>hipotecas variables</strong>, así que no siempre pagarás lo mismo y no podrás calcular en el momento de la contratación su precio final. Durante el primer año, te aplicarán un <strong>TIN (Tipo de Interés Nominal) del 1,49% fijo</strong>, pero a partir de entonces te darán un diferencial del 0,60% al que se le sumará el valor del euríbor (que se actualiza todos los años)*.</p>\n\n<p>Estos porcentajes tienen en cuenta que el cliente esté dispuesto a cumplir una serie de requisitos: <strong>domiciliar una nómina con un importe mínimo de 600 euros</strong> (300 euros si eres pensionista) y adquirir un <strong>seguro multirriesgo de hogar</strong> y otro de <strong>amortización de préstamo</strong> -una póliza de vida que cubra, al menos, el 50% de la hipoteca, o un porcentaje inferior y una cantidad  mínima de 150.000 euros-. Si no cumplieras las condiciones, podrás contratar el préstamo, pero a tu diferencial tendrás que sumarle un punto porcentual más (con lo que quedaría en un 1,60% más euríbor).</p>\n\n<p>Aunque esta vinculación puede suponerte un sobrecoste, la <strong>Hipoteca Variable de BBVA</strong> no tiene comisión de apertura. </p>\n\n<p>En lo que respecta a la amortización anticipada, la entidad te cobrará una comisión del 0,15% durante los cinco primeros años y, a partir del sexto, no te cobrará nada si decides devolver el importe de tu hipoteca (o parte de él) antes de tiempo. La cuantía mínima para devolver tendrá que ser en este caso de 300 euros, y tendrás que notificar la cancelación al banco con al menos un mes de antelación.</p>\n\n<ul>\n<li>Supuesto de cálculo de la TAEVariable para una operación de 150.000 € a 25 años (300 cuotas), de un titular de 31 años en la Comunidad de Madrid y bajo la hipótesis de que no se realiza ninguna amortización anticipada, ni total ni parcial, durante toda la vida del préstamo y de que los índices de referencia no varían, y, por tanto, podría variar con las revisiones del tipo de interés.\n*Cuando el tipo de interés fijo aplicable durante el Periodo de Interés Inicial sea mayor que el resultante de la suma del diferencial pactado y el índice de referencia vigente en la fecha de contratación, se tomará para el cálculo de la TAE dicho tipo de interés fijo para toda la vida de la operación.</li>\n</ul>\n\n<p>Importe préstamo: 150.000 €.<br>\nÍndice de referencia: 2,629% (Euríbor BOE 03/11/2022).<br>\nPlazo: 25 años (300 cuotas).<br>\nSI NO CONTRATAS NINGÚN PRODUCTO<br>\nPrimer año al 0,89% TIN. Cuota mensual 557,87 €.<br>\nResto de años Euríbor + 1,60% .Cuota mensual 800,18 €.<br>\nTAEVariable 4,58%<br>\nCoste total del préstamo: 101.150,58 € (87.144,86 € son intereses). <br>\nImporte total del préstamo (coste total + importe de hipoteca): 251.150,58 €.<br>\nSI CONTRATAS OTROS PRODUCTOS<br>\nSi contratas nómina, Seguro Multirriesgo Hogar con BBVA Allianz Seguros y Seguro de Amortización de Préstamos con BBVA Seguros</p>\n\n<p>Primer año al 0,89% TIN. Cuota mensual 557,87 €.<br>\nResto de años Euríbor + 0,60% Cuota mensual 722,25 €.<br>\n*TAEVariable 3,97%.<br>\nCoste total del préstamo: 83.180,64 € (64.701,25 € son intereses).<br>\nImporte total del préstamo (coste total + importe de hipoteca): 233.180,64 €.<br>\nSi contratas nómina y Seguro Multirriesgo Hogar con BBVA Allianz Seguros:</p>\n\n<p>Primer año al 0,89% TIN. Cuota mensual 557,87 €.<br>\nResto de años Euríbor + 1,10% Cuota mensual: 760,66 €<br>\nTAEVariable 4,13%.<br>\nCoste total del préstamo: 89.769,23 € (75.763,51 € son intereses).<br>\nImporte total del préstamo (coste total + importe de hipoteca): 239.769,23 €.<br>\nSi contratas Seguro de Amortización de préstamos con BBVA Seguros:</p>\n\n<p>Primer año al 0,89% TIN. Cuota mensual 557,87 €.<br>\nResto de años Euríbor + 1,10% Cuota mensual 760,66 €.<br>\nTAEVariable 4,43%.<br>\nCoste total del préstamo: 94.242,90  € (75.763,51 € son intereses).<br>\nImporte total del préstamo (coste total + importe de hipoteca): 244.242,90 €.<br>\nPara tener derecho a estos diferenciales, incluido el euríbor + 0,60 %, es necesario, además, que estés al corriente de tus pagos y no tengas deudas pendientes con el Banco. Si no es así, se te aplicará el diferencial euríbor + 1,60%.</p>\n",
                        "has_deal": true,
                        "url": "https://clk.tradedoubler.com/click?p=311134&a=2924858&g=24886748",
                        "typ_description": "<ul>\n<li><strong>TAE variable desde 4,21%</strong> </li>\n<li>TIN primer año desde 1,49%</li>\n<li>Euríbor desde+0,60%</li>\n<li>Sin comisión de apertura</li>\n</ul>\n",
                        "comments": "URL antigua 12/11 https://clk.tradedoubler.com/click?p=304300&a=2924858&g=24802328\r\nESTA ES LA QUE ACTIVAMOS, FIJA NO LO TENEMOS PERMITIDO",
                        "remortgage_status": "unavailable",
                        "obligations": {
                            "max_granted": 80.0,
                            "min_age": 18,
                            "max_age": 70,
                            "min_amount": 20000,
                            "max_amount": 1600000,
                            "primary_residence": true,
                            "second_home": false
                        },
                        "has_vinculation": true,
                        "vinculations": {
                            "domicile_payroll": true,
                            "min_payroll": 600.0,
                            "domicile_receipts": false,
                            "home_insurance": true,
                            "life_insurance": false,
                            "payment_protection_insurance": true,
                            "other_insurances": false,
                            "use_of_cards": false,
                            "pension_plan": false,
                            "vinculation_number": 3,
                            "other_insurances_description": null,
                            "vinculations_description": "<p>Domiciliación de la nómina: nómina de mínimo 600 euros, pensión de mínimo 300 euros o, en caso de ser autónomo, domiciliar la cuota de autónomos.<br>\nSeguro de protección de pagos: mínimo por un capital de 150.000 euros o el 50% de la hipoteca.</p>\n"
                        },
                        "has_promo": false,
                        "terms": [
                            {
                                "status": "active",
                                "value": 30,
                                "term_type": "variable",
                                "costs": {
                                    "interest": 0.89,
                                    "interest_max": 0.89,
                                    "initial_interest": 0.89,
                                    "initial_interest_max": 0.89,
                                    "initial_interest_period": 12,
                                    "from_euribor": 0.6,
                                    "from_euribor_max": 1.6,
                                    "apr": 4.16,
                                    "apr_max": 4.76,
                                    "apr_description": "Ejemplo representativo sin bonificación para 150.000€ a 25 años (300 pagos): TIN: desde 0,89% durante los doce primeros meses y cuota mensual 768,79€. Tipo de interés resto del plazo: desde Euríbor +1,60%. TAE Variable 4,76%.\r\n\r\n",
                                    "euribor": 2.828,
                                    "has_opening": false
                                },
                                "amortizations": {
                                    "total_early": {
                                        "rate": 0.15,
                                        "term": 5
                                    },
                                    "partial_early": {
                                        "rate": 0.15,
                                        "term": 5
                                    },
                                    "remainig_years": {
                                        "since_year": 6,
                                        "total_early_rate": 0.0,
                                        "partial_early_rate": 0.0
                                    },
                                    "description": "<p>La Hipoteca Variable de BBVA tiene una comisión de amortización anticipada de 0,15% que solo se aplicará durante los cinco primeros años de vida de la hipoteca. A partir del sexto, por lo tanto, no tendrás que pagar nada si deseas devolver tu deuda (o parte de ella) antes de tiempo. </p>\n"
                                },
                                "ratings": {
                                    "rating": 10.0,
                                    "interest_max": 0.0,
                                    "initial_interest": 10,
                                    "opening": 10,
                                    "from_euribor_max": 10
                                }
                            }
                        ],
                        "bank": {
                            "id": 13,
                            "name": "BBVA",
                            "slug": "bbva",
                            "status": "active",
                            "image": {
                                "url": "https://assets.kelisto.us/mi7g249ch3yxmzqqn8zmjr8f3s7g",
                                "url_square": "https://assets.kelisto.us/mi7g249ch3yxmzqqn8zmjr8f3s7g",
                                "url_rectangular": "https://assets.kelisto.us/2s3glcoqq0nmyelhkkxt0fdql03b"
                            }
                        },
                        "ratings": {
                            "rating": 10.0
                        },
                        "has_review": false
                    }
                ]
            },
            {
                "product_name": "remortgage",
                "offers": []
            }
        ]
    }
}

Arguments

Parameter Description
bank_slug URL segment string The slug of the bank related to the offer (as part of the url)

Returns

Returns basic bank information with a list of mortgage offer objects products grouped by product_name and ordered by rating

Loan offers

The loan offer object

Attributes

# Example object

{
    "data": {
        "id": 3,
        "name": "Préstamo Savso",
        "slug": "prestamo-savso",
        "product_name": "microcredit",
        "product_type": "loan",
        "claim": "Admite usuarios en fichero ASNEF",
        "starred": false,
        "best_buy": false,
        "sponsored": false,
        "updated_at": "2021-11-02T15:06:03.505+01:00",
        "description": "<p>El <strong>Préstamo Savso</strong> es un microcrédito, es decir, un producto de financiación similar a un préstamo personal, pero con ciertas particularidades. Por ejemplo:</p>\n\n<ul>\n<li>Solo te permitirá <strong>pedir cantidades pequeñas</strong>: un máximo de 300€ si eres nuevo cliente y de 900€ si eres antiguo y siempre has cumplido puntualmente con tus pagos. </li>\n<li>El <strong>plazo de devolución</strong> también es breve: 13 o 17 semanas. </li>\n<li>En lugar de cobrar un interés en forma de porcentaje (y expresado como un Tipo de Interés Nominal), <strong>te cobrará honorarios</strong>: es decir, una cantidad fija en euros que varía dependiendo de la cantidad que pidas y del plazo de devolución. </li>\n<li>Las letras del Préstamo Savso no se domicilian en una cuenta bancaria, sino que podrás <strong>devolver tu deuda con una  tarjeta de débito o vía transferencia</strong>. </li>\n<li>En caso de <strong>retrasarte en los pagos</strong>, un microcrédito como el Préstamo Savso no te cobra intereses de demora como hacen los préstamos personales, sino que te cobrará una cantidad fija en euros. En concreto, 25€ por cada cuota semanal que dejes de pagar. Además, si el pago retrasado no se realiza en los tres días siguientes a la fecha en la que debía efectuarse, se sumarán otros 25€. </li>\n</ul>\n\n<p>En lo que respecta sus <strong>honorarios</strong>, la cantidad que te cobrará el Préstamo Savso depende de la cantidad que pidas y el plazo de devolución. Por ejemplo, si pides 100€, a devolver en 13 semanas, pagarás 55,74€, pero si subes el plazo a 17 semanas, te tocará abonar 174,42€. Ahora bien, más allá de estos honorarios, el Préstamo Savso <strong>no tiene comisiones</strong> ni de apertura, ni de estudio ni de amortización anticipada.</p>\n\n<p>Entre las particularidades del Préstamo Savso también destaca que <strong>no tendrás que devolver tu deuda, más los honorarios, al final del plazo acordado</strong>, sino que la entidad te irá cobrando cuotas semanales, de una forma parecida a como lo haría un préstamo personal.</p>\n\n<p>En lo que respecta a su <strong>contratación</strong>, el Préstamo Savso solo se puede contratar por Internet. Para poder hacerte con él, tan solo tendrás que ser mayor de 18 años y ser residente en España. Al contrario de lo que sucede con otras entidades, con Savso podrás pedir financiación incluso si formas parte de un fichero de impagos, como el de <strong>ASNEF</strong> o si no tienes trabajo. Eso sí, deberás pasar el examen de solvencia que te realizará la entidad para poder conseguir tu préstamo.</p>\n",
        "has_deal": false,
        "url": null,
        "loan_type": "microcredit",
        "typ_description": "<ul>\n<li>Admite usuarios en ASNEF</li>\n<li>Hasta <strong>300€</strong> a devolver hasta en 119 días</li>\n<li>Sin comisiones </li>\n</ul>\n",
        "comments": "",
        "obligations": {
            "old_clients": true,
            "new_clients": true,
            "min_age": 18,
            "signup_online": true,
            "defaulter": true,
            "must_justify_purpose": false,
            "only_online": false,
            "payroll_required": false,
            "cities_number": null,
            "client_type": "general"
        },
        "purposes": {
            "vehicles": true,
            "studies": true,
            "travels": true,
            "home": true,
            "celebrations": true,
            "others": true,
            "others_description": "<p>Con el <strong>Préstamo Savso</strong> podrás pedir dinero para cualquier finalidad. Eso sí, recuerda que la cantidad que podrás solicitar es limitada, lo que puede limitar también la finalidad a la que quieras destinar tu dinero:</p>\n\n<ul>\n<li>Si eres nuevo cliente, solo podrás pedir hasta 300€.</li>\n<li>Si ya has pedido más préstamos con Savso, podrás solicitar hasta 900€.</li>\n</ul>\n",
            "ecological": false
        },
        "features": {
            "min_amount": 100,
            "max_amount": 300,
            "min_term": 91,
            "max_term": 119,
            "amount_description": "<p>Con el Préstamo Savso podrás pedir un <strong>mínimo de 100€</strong> y hasta un <strong>máximo de 300€, si eres nuevo cliente</strong>. Si ya has pedido más préstamos con Savso y has pagado tus deudas puntualmente, la  entidad podría darte <strong>hasta 900€</strong>.</p>\n"
        },
        "costs": {
            "costs_and_commissions": false,
            "insurance_required": "non_insurable",
            "change_bank_required": false,
            "interest": 0.0,
            "apr": 226.96,
            "apr_description": "<p>Para que puedas entender el coste final del Préstamo Savso, en Kelisto te mostramos el cálculo de la TAE que Savso pone como ejemplo para este producto de financiación: un 222,96%, calculado para una cantidad de 100€, a devolver en 13 semanas.</p>\n",
            "has_assessment": false,
            "has_opening": false,
            "has_total_partial_cancellation": false,
            "has_commissions": true,
            "commissions": {
                "fee": 55.74,
                "description": "<p>En lugar de aplicarte un interés en forma de TIN (Tipo de Interés Nominal, que se expresa como un porcentaje), los microcréditos como el Préstamo Savso te cobran <strong>intereses en forma de honorarios</strong>: es decir, te cobran una cantidad fija en euros que depende de varios factores:</p>\n\n<ul>\n<li>De la cantidad que pidas.</li>\n<li>Del plazo de devolución que elijas.</li>\n<li>De si eres nuevo o antiguo cliente. </li>\n</ul>\n\n<p>A continuación, te contamos algunos ejemplos para que entiendas qué honorarios te cobrará Savos: </p>\n\n<ul>\n<li>Para 100€ a devolver en 13 semanas: 55,74€.</li>\n<li>Para 100€ a devolver en 17 semanas: 74,42€</li>\n<li>Para 300€ a devolver en 13 semanas: 167,09€</li>\n<li>Para 300 a devolver en 17 semanas: 223,09€</li>\n<li>Para 900€ a devolver en 13 semanas: 501,40€</li>\n<li>Para 900€ a devolver en 17 semanas: 669,27€</li>\n</ul>\n"
            }
        },
        "has_promo": false,
        "bank": {
            "id": 93,
            "name": "Savso",
            "slug": "savso",
            "image": {
                "url": "https://admin.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcmdMIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--bc3aa63d69c1976cbb1f2fccc6ce4694ec48bcf2/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpzR1ZEb01aM0poZG1sMGVVa2lDMk5sYm5SbGNnWTdCbFE2Q1dOeWIzQkpJaEF5TlRCNE1qVXdLekFyTUFZN0JsUT0iLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--db8d6025f600d2fa3d295c093cd8faf8a80d78cd/savso-s-min.jpg",
                "url_square": "https://admin.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcmdMIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--bc3aa63d69c1976cbb1f2fccc6ce4694ec48bcf2/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpzR1ZEb01aM0poZG1sMGVVa2lDMk5sYm5SbGNnWTdCbFE2Q1dOeWIzQkpJaEF5TlRCNE1qVXdLekFyTUFZN0JsUT0iLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--db8d6025f600d2fa3d295c093cd8faf8a80d78cd/savso-s-min.jpg",
                "url_rectangular": "https://admin.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcmtMIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--a16a5de1b16139ae89f4c13a09d5da18c738ad68/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpRERNMk5IZzVObDRHT3daVU9neG5jbUYyYVhSNVNTSUxZMlZ1ZEdWeUJqc0dWRG9KWTNKdmNFa2lEek0yTkhnNU5pc3dLekFHT3daVSIsImV4cCI6bnVsbCwicHVyIjoidmFyaWF0aW9uIn19--a2fcbcd5ef415c9684a7286153d10c6fb68a026b/savso-w-min.jpg"
            }
        },
        "ratings": {
            "rating": 9.4,
            "interest": 10,
            "assessment": 10,
            "opening": 10,
            "total_partial_cancellation": 10,
            "commissions": 4
        },
        "has_review": false
    }
}
Attribute Description
id integer Unique identifier for the resource.
name string Offer name.
slug string  Offer slug.
product_name string The specific product name. Can be personal_loan or microcredit.
product_type string  Product type identifier (loan).
claim string Short offer description.
starred boolean Returns true if the offer is promoted, elsewhere false.
best_buy boolean Returns true if the offer is a best buy, elsewhere false.
sponsored boolean Returns true if the offer is sponsored, elsewhere false.
updated_at timestamp Last update time.
status string Status of the offer. Can be active, inactive or discontinue.
description string Description using HTML format.
has_deal boolean Return true if Kelisto has a deal for this offer with its provider.
url string Offer landing page URL.
loan_type string The specific loan type. Can be personal or microcredit.
typ_description string TYP Description text
comments string Additional comments / observations
obligations hash Obligations object.
purposes hash Purposes object.
features hash Features object.
costs hash Costs object.
bank hash Bank object.
ratings hash Rating object.
has_promo boolean Returns true if the current offer has promo hash attributes.
promo optional, hash Promo object.
has_review boolean Returns true if the current offer has review hash attributes.
review optional, hash Review object.

The loan features object

Attributes

# Example object

"features": {
  "min_amount": 100,
  "max_amount": 300,
  "min_term": 91,
  "max_term": 119,
  "amount_description": "<p>Con el Préstamo Savso podrás pedir un <strong>mínimo de 100€</strong> y hasta un <strong>máximo de 300€, si eres nuevo cliente</strong>. Si ya has pedido más préstamos con Savso y has pagado tus deudas puntualmente, la  entidad podría darte <strong>hasta 900€</strong>.</p>\n"
}
Attribute Description
min_amount integer Defines the minimum amount for the loan
max_amount integer Defines the maximum amount for the loan
min_term integer Minimum term (in days) for loan return
max_term integer Maximum term (in days) for loan return
amount_description string Description using HTML format.

The loan obligations object

Attributes

# Example object

"obligations": {
  "old_clients": true,
  "new_clients": true,
  "min_age": 18,
  "signup_online": true,
  "defaulter": true,
  "must_justify_purpose": false,
  "only_online": false,
  "payroll_required": false,
  "cities_number": null,
  "client_type": "general"
}
Attribute Description
old_clients boolean Defines if the loan is available for old clients.
new_clients boolean Defines if the loan is available for new clients.
min_age integer Define the minimum age.
signup_online boolean Defines if the loan can be requested online.
defaulter boolean Defines if the loan if available for defaulters.
must_justify_purpose boolean Defines if the bank will ask you to justify the loan purpose.
only_online boolean Defines if the loan is available only online.
payroll_required boolean Defines if the bank will require to bring payroll with
cities_number integer Number of localities where this offer is available.
client_type string Main public for this loan offer. Can be general, children or teenagers.

The loan assessment object

Attributes

# Example object

"assessment": {
  "fee": 200,
  "percentage_fee": 1.5,
  "description": "<p>El estudio inicial es necesario para ... y requiere .... </p>\n",
}
Attribute Description
fee decimal Fixed amount for the assessment fee
percentage_fee decimal Percentage amount for the assessment fee
description string Description / details for the assessment fee

The loan cancellation costs object

Attributes

# Example object

"total_partial_cancellation": {
  "over_year": 0.75,
  "under_year": 1.15,
  "description": "<p>El estudio inicial es necesario para ... y requiere .... </p>\n",
}
Attribute Description
over_year decimal Cancellation ratio > 12 months
under_year decimal Cancellation ratio < 12 months
description string Description / details for the cancellation fee

The loan purposes object

Attributes

# Example object

"purposes": {
  "vehicles": true,
  "studies": true,
  "travels": true,
  "home": true,
  "celebrations": true,
  "others": true,
  "others_description": "<p>Con el <strong>Préstamo Savso</strong> podrás pedir dinero para cualquier finalidad. Eso sí, recuerda que la cantidad que podrás solicitar es limitada, lo que puede limitar también la finalidad a la que quieras destinar tu dinero:</p>\n\n<ul>\n<li>Si eres nuevo cliente, solo podrás pedir hasta 300€.</li>\n<li>Si ya has pedido más préstamos con Savso, podrás solicitar hasta 900€.</li>\n</ul>\n",
  "ecological": false
}
Attribute Description
vehicles boolean Set to true if the main purpose for the loan is to purchase a new vehicle
studies boolean Set to true if the main purpose is pay for studies
travels boolean Set to true if the main purpose is traveling
home boolean Set to true if the main purpose is related to home
celebrations boolean Set to true if the main purpose is some celebration
others boolean Set to true if it's valid for other purposes (check others_description for details)
others_description string Displays purposes other than generic vehicles/studies/...
ecological boolean Set to true if the loan is green/eco ?¿

The loan costs object

Attributes

# Example object

"costs": {
  "costs_and_commissions": false,
  "insurance_required": "non_insurable",
  "change_bank_required": false,
  "interest": 0.0,
  "apr": 226.96,
  "apr_description": "<p>Para que puedas entender el coste final del Préstamo Savso, en Kelisto te mostramos el cálculo de la TAE que Savso pone como ejemplo para este producto de financiación: un 222,96%, calculado para una cantidad de 100€, a devolver en 13 semanas.</p>\n",
  "has_assessment": false,
  "has_opening": false,
  "has_total_partial_cancellation": false,
  "has_commissions": true,
  "commissions": {
    "fee": 55.74,
    "description": "<p>En lugar de aplicarte un interés en forma de TIN (Tipo de Interés Nominal, que se expresa como un porcentaje), los microcréditos como el Préstamo Savso te cobran <strong>intereses en forma de honorarios</strong>: es decir, te cobran una cantidad fija en euros que depende de varios factores:</p>\n\n<ul>\n<li>De la cantidad que pidas.</li>\n<li>Del plazo de devolución que elijas.</li>\n<li>De si eres nuevo o antiguo cliente. </li>\n</ul>\n\n<p>A continuación, te contamos algunos ejemplos para que entiendas qué honorarios te cobrará Savos: </p>\n\n<ul>\n<li>Para 100€ a devolver en 13 semanas: 55,74€.</li>\n<li>Para 100€ a devolver en 17 semanas: 74,42€</li>\n<li>Para 300€ a devolver en 13 semanas: 167,09€</li>\n<li>Para 300 a devolver en 17 semanas: 223,09€</li>\n<li>Para 900€ a devolver en 13 semanas: 501,40€</li>\n<li>Para 900€ a devolver en 17 semanas: 669,27€</li>\n</ul>\n"
  }
}
Attribute Description
costs_and_commissions boolean Define if it has costs and/or comissions
has_assessment boolean Define if it has previous assessment costs
assessment Assessment object Assessment details (only if has_assessment is true)
has_opening boolean Define if it has initial costs on confirmation
opening Assessment object Initial costs details (only if has_opening is true)
insurance_required string Defines if it requires insurance (non_insurable, insurable, check_with)
change_bank_required boolean Define if it requires to change your bank
interest decimal Define main loan interest (spanish TIN)
apr decimal Define aggregate loan interest (spanish TAE)
apr_description string APR additional information / simulation example
has_total_partial_cancellation boolean Define if the loan has costs on cancelation
total_partial_cancellation cancelation costs object Cancellation costs details (only if has_total_partial_cancellation is true)
has_commissions boolean Define if the loan has comissions
commissions commissions object Commissions details (fee & description). Only if has_commissions is true

Retrieve a loan offer

# Definition
GET https://api.kelisto.es/api/v3/finances/offers/loans/:slug?bank_slug=:bank_slug&product_name=:product_name

# Example request
$ curl https://api.kelisto.es/api/v3/finances/offers/loans/anticipo-nomina?bank_slug=caja-de-ingenieros&product_name=personal_loan
# Example response

{
  "data": {
    "id": 238,
    "name": "Anticipo Nómina",
    "slug": "anticipo-nomina",
    "product_name": "personal_loan",
    "product_type": "loan",
    "claim": null,
    "starred": false,
    "best_buy": false,
    "sponsored": false,
    "updated_at": "2023-03-31T12:08:38.283+02:00",
    "status": "active",
    "description": "<p>El préstamo <strong>Anticipo Nómina de Caja de Ingenieros</strong> es un préstamo personal que te permitirá obtener un importe equivalente a una nómina y que, por tanto, está pensado para clientes que tengan su salario domiciliado en la entidad. La gran ventaja del Anticipo Nómina de Caja de Ingenieros es que es un <strong>préstamo sin intereses</strong>, es decir, un préstamo al 0% TIN (Tipo de Interés Nominal), aunque si tiene <strong>comisiones</strong>: en concreto, pagarás un 0,5% en concepto de comisión de apertura.<br>\nSi quieres solicitar el Anticipo Nómina de Caja de Ingenieros, tendrás que tener una <strong>nómina de al menos 700 euros domiciliada</strong> en la entidad También tendrás que tener asociada a dicha cuenta una tarjeta Mastercard y/o Visa, así como domiciliar un mínimo de tres recibos.<br>\nEste préstamo se puede devolver en un <strong>plazo máximo de 2 meses</strong>. Para contratarlo, podrás acudir a cualquiera de las sucursales de Caja de Ingenieros o realizar los trámites a través de la banca electrónica de la entidad. </p>\n",
    "has_deal": false,
    "url": null,
    "loan_type": "personal",
    "typ_description": null,
    "comments": "CANTIDAD: Te anticipa el importe equivalente a 1 nómina",
    "obligations": {
      "old_clients": true,
      "new_clients": true,
      "min_age": 18,
      "signup_online": true,
      "defaulter": false,
      "must_justify_purpose": false,
      "only_online": false,
      "payroll_required": false,
      "cities_number": 5,
      "client_type": "general"
    },
    "purposes": {
      "vehicles": true,
      "studies": true,
      "travels": true,
      "home": true,
      "celebrations": true,
      "others": true,
      "others_description": "<p>El préstamo Anticipo Nómina de Caja de Ingenieros puede utilizarse para cualquier propósito.</p>\n",
      "ecological": false
    },
    "features": {
      "min_amount": 700,
      "max_amount": 3000,
      "min_term": 60,
      "max_term": 60,
      "amount_description": "<p>Puedes solicitar el adelanto de hasta una nómina</p>\n"
    },
    "costs": {
      "costs_and_commissions": false,
      "insurance_required": "check_with",
      "change_bank_required": true,
      "interest": 0.0,
      "apr": 0.0,
      "apr_description": "<p>La TAE (Tasa Anual Equivalente) que indica Caja de Ingenieros para su préstamo Anticipo Nómina es del 0%, ya que se trata de un préstamo sin intereses y sin gastos ni comisiones.</p>\n",
      "has_assessment": false,
      "has_opening": false,
      "has_total_partial_cancellation": false,
      "has_commissions": false
    },
    "has_promo": false,
    "bank": {
      "id": 41,
      "name": "Caja de Ingenieros",
      "slug": "caja-de-ingenieros",
      "status": "active",
      "background_color": "#0f4d82",
      "image": {
        "url": "https://assets.kelisto.us/g3waiisirm56jgug3maksb1mxtz4",
        "url_square": "https://assets.kelisto.us/g3waiisirm56jgug3maksb1mxtz4",
        "url_rectangular": "https://assets.kelisto.us/q8i973l3xu9aipoc7gduffrdo5dk",
        "url_big": "https://assets.kelisto.us/53zi15iyhhuvfntcglyhr4gss23x"
      }
    },
    "ratings": {
      "rating": 7.8,
      "interest": 8,
      "assessment": 10,
      "opening": 10,
      "total_partial_cancellation": 10,
      "commissions": 10
    },
    "has_review": false
  }
}

Arguments

Parameter Description
slug Required string The slug of the offer to retrieve.
bank_slug Required string The slug of the bank related to the offer.
status optional string Retrieve offers by status (active, inactive or discontinue). It can be an array of statuses. Default: active.
product_name Required string Retrieve offers by product name.

Multiproduct loan list request

# Definition
GET https://api.kelisto.es/api/v3/finances/multiproduct/:bank_slug/loans

# Example request
$ curl https://api.kelisto.es/api/v3/finances/multiproduct/banco-santander/loans
# Example response
{
  "data": {
    "id": 8,
    "name": "Banco Santander",
    "slug": "banco-santander",
    "status": "active",
    "image": {
      "url": "https://api.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaDBMIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--0378974c89a504291d29c6711566cc90f992870a/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpQ3pnd2VEZ3dYZ1k3QmxRNkRHZHlZWFpwZEhsSklndGpaVzUwWlhJR093WlVPZ2xqY205d1NTSU9PREI0T0RBck1Dc3dCanNHVkE9PSIsImV4cCI6bnVsbCwicHVyIjoidmFyaWF0aW9uIn19--cb6dbdeb942b2cec9d8893c07f51de2233e977f4/_0015_santander-s.jpg",
      "url_square": "https://api.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaDBMIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--0378974c89a504291d29c6711566cc90f992870a/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpQ3pnd2VEZ3dYZ1k3QmxRNkRHZHlZWFpwZEhsSklndGpaVzUwWlhJR093WlVPZ2xqY205d1NTSU9PREI0T0RBck1Dc3dCanNHVkE9PSIsImV4cCI6bnVsbCwicHVyIjoidmFyaWF0aW9uIn19--cb6dbdeb942b2cec9d8893c07f51de2233e977f4/_0015_santander-s.jpg",
      "url_rectangular": "https://api.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaDRMIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--ac9c3298e6c7111db9307c4987726d81fdb0a9c2/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpRERNMk5IZzVObDRHT3daVU9neG5jbUYyYVhSNVNTSUxZMlZ1ZEdWeUJqc0dWRG9KWTNKdmNFa2lEek0yTkhnNU5pc3dLekFHT3daVSIsImV4cCI6bnVsbCwicHVyIjoidmFyaWF0aW9uIn19--a2fcbcd5ef415c9684a7286153d10c6fb68a026b/_0015_santander-w.jpg"
    },
    "product_names": [
      "personal_loan",
      "microcredit"
    ],
    "products": [
      {
        "product_name": "personal_loan",
        "offers": [
          {
            "id": 217,
            "name": "Anticipo Nómina",
            "slug": "anticipo-nomina",
            "product_name": "personal_loan",
            "product_type": "loan",
            "claim": "",
            "starred": false,
            "best_buy": false,
            "sponsored": false,
            "updated_at": "2022-08-03T08:31:11.968+02:00",
            "status": "active",
            "description": "<p>El <strong>Préstamo Anticipo Nómina de Banco Santander</strong> te permite disfrutar de hasta dos adelantos de tu sueldo mensual sin tener que pagar intereses (0% Tipo de Interés Nominal o TIN). Eso sí, pese a ser un <strong>préstamo sin intereses</strong>, sí tendrás que pagar comisiones: en concreto, un cargo por apertura del 3,5%. </p>\n\n<p>Para poder disfrutar de este producto, tendrás que <strong>domiciliar tu nómina</strong> en el Banco Santander y pasar los criterios de riesgo establecidos por la entidad para conceder financiación a sus clientes. </p>\n\n<p>En cuanto al resto de características del Anticipo Nómina de Banco Santander, cabe destacar que te permite pedir <strong>hasta 9.000€</strong>, con un <strong>plazo de devolución de hasta 12 meses</strong>. </p>\n",
            "has_deal": false,
            "url": null,
            "loan_type": "personal",
            "typ_description": null,
            "comments": "CONDICIONES: Te anticipa el importe equivalente a 2 mensualidades",
            "obligations": {
              "old_clients": true,
              "new_clients": true,
              "min_age": 18,
              "signup_online": false,
              "defaulter": false,
              "must_justify_purpose": false,
              "only_online": false,
              "payroll_required": false,
              "cities_number": 17,
              "client_type": "general"
            },
            "purposes": {
              "vehicles": true,
              "studies": true,
              "travels": true,
              "home": true,
              "celebrations": true,
              "others": true,
              "others_description": "<p>El Anticipo Nómina de Banco Santander se puede solicitar para cualquier propósito: desde comprar un coche, realizar una reforma del hogar, pagar unos estudios, etc.</p>\n",
              "ecological": false
            },
            "features": {
              "min_amount": 600,
              "max_amount": 9000,
              "min_term": 30,
              "max_term": 240,
              "amount_description": "<p>Podrás solicitar el adelanto de hasta 2 mensualidades, sin superar en ningún mómento los 9.000 euros</p>\n"
            },
            "costs": {
              "costs_and_commissions": true,
              "insurance_required": "check_with",
              "change_bank_required": true,
              "interest": 0,
              "apr": 10.01,
              "apr_description": "<p>Para que puedas entender cuál es el coste real que tendrás que asumir al pedir el Préstamo Anticipo Nómina de Banco Santander, en Kelisto te mostramos el cálculo de la TAE (Tasa Anual Equivalente) que la propia entidad ofrece a sus clientes. En este caso, Banco Santander cifra la TAE de este préstamo en un 10,01% para un importe de 5.000€ a devolver en 8 meses.</p>\n",
              "has_assessment": false,
              "has_opening": true,
              "has_total_partial_cancellation": false,
              "has_commissions": false,
              "opening": {
                "fee": null,
                "percentage_fee": "3.5",
                "description": null
              }
            },
            "has_promo": false,
            "bank": {
              "id": 8,
              "name": "Banco Santander",
              "slug": "banco-santander",
              "status": "active",
              "image": {
                "url": "https://api.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaDBMIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--0378974c89a504291d29c6711566cc90f992870a/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpQ3pnd2VEZ3dYZ1k3QmxRNkRHZHlZWFpwZEhsSklndGpaVzUwWlhJR093WlVPZ2xqY205d1NTSU9PREI0T0RBck1Dc3dCanNHVkE9PSIsImV4cCI6bnVsbCwicHVyIjoidmFyaWF0aW9uIn19--cb6dbdeb942b2cec9d8893c07f51de2233e977f4/_0015_santander-s.jpg",
                "url_square": "https://api.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaDBMIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--0378974c89a504291d29c6711566cc90f992870a/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpQ3pnd2VEZ3dYZ1k3QmxRNkRHZHlZWFpwZEhsSklndGpaVzUwWlhJR093WlVPZ2xqY205d1NTSU9PREI0T0RBck1Dc3dCanNHVkE9PSIsImV4cCI6bnVsbCwicHVyIjoidmFyaWF0aW9uIn19--cb6dbdeb942b2cec9d8893c07f51de2233e977f4/_0015_santander-s.jpg",
                "url_rectangular": "https://api.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaDRMIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--ac9c3298e6c7111db9307c4987726d81fdb0a9c2/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpRERNMk5IZzVObDRHT3daVU9neG5jbUYyYVhSNVNTSUxZMlZ1ZEdWeUJqc0dWRG9KWTNKdmNFa2lEek0yTkhnNU5pc3dLekFHT3daVSIsImV4cCI6bnVsbCwicHVyIjoidmFyaWF0aW9uIn19--a2fcbcd5ef415c9684a7286153d10c6fb68a026b/_0015_santander-w.jpg"
              }
            },
            "ratings": {
              "rating": 8.1,
              "interest": 10,
              "assessment": 10,
              "opening": 4,
              "total_partial_cancellation": 10,
              "commissions": 10
            },
            "has_review": false
          }
        ]
        # another personal loan offer
        # another personal loan offer
        # ....

      },
      {
        "product_name": "microcredit",
        "offers": [
          # microcredit offer
          # microcredit offer
          # ....
        ]
      }
    ]
  }
}

Arguments

Parameter Description
bank_slug URL segment string The slug of the bank related to the offer (as part of the url)

Returns

Returns basic bank information with a list of loan offer objects products grouped by product_name

# Definition
GET https://api.kelisto.es/api/v3/finances/related_offers/loans/:slug?:bank_slug&:product_name

# Example request
$ curl https://api.kelisto.es/api/v3/finances/related_offers/loans/prestamo-evo-sin-nomina?bank_slug=evo-banco&product_name=personal_loan
{
  "data": [
    {
      "id": 2572,
      "name": "Préstamo para vehículos nuevos",
      "slug": "prestamo-oney-vehiculos-nuevos",
      "product_name": "personal_loan",
      "product_type": "loan",
      "claim": "",
      "starred": false,
      "best_buy": false,
      "sponsored": false,
      "updated_at": "2022-11-04T10:13:24.471+01:00",
      "status": "active",
      "description": "<p>El <strong>Préstamo Oney para vehículos nuevos</strong> es un préstamo personal diseñado para ayudarte a financiar la compra de tu coche nuevo. Recibirás tu dinero de forma inmediata a cambio de pagar unos intereses: un <strong>Tipo de Interés Anual (TIN) del 4,95%</strong>, y una Tasa Anual Equivalente (TAE) del 5,06%. Recuerda que esta cifra puede variar en función de tu perfil y de la evaluación del riesgo de la operación que realice Oney. Eso sí, nunca te cobrarán más de 10,90% (TIN).</p>\n\n<p>Podrás solicitar la cantidad que necesites, siempre y cuando <strong>no exceda de los 35.000€</strong>, y con un mínimo de 3.000€. El periodo de <strong>tiempo que establece Oney para que pagues tu deuda</strong> va <strong>desde uno hasta siete años</strong>.</p>\n\n<p>Como ventaja de los préstamos Oney, <strong>no tendrás que pagar ninguna comisión</strong>: ni por apertura, estudio ni por amortización anticipada.</p>\n\n<p>Si deseas contratar el Préstamo Oney para vehículos nuevos solo <strong>tendrás que ser mayor de edad y no tener deudas impagadas</strong>(no formar parte de ningún fichero de morosos).</p>\n\n<p>El <strong>proceso de solicitud se realiza de forma online</strong>, no siendo necesario ni cambiar de banco, ni abrirte una nueva cuenta bancaria.</p>\n",
      "has_deal": true,
      "url": "https://clk.tradedoubler.com/click?p=319723&a=2924858&g=25167886",
      "loan_type": "personal",
      "typ_description": "<ul>\n<li>Desde 4,95% TIN</li>\n<li>Desde <strong>3000€ a 35000€</strong></li>\n<li>Págalo hasta en 7 años</li>\n<li>¡Sin cambiar de banco!</li>\n</ul>\n",
      "comments": "",
      "obligations": {
        "old_clients": true,
        "new_clients": true,
        "min_age": 18,
        "signup_online": true,
        "defaulter": false,
        "must_justify_purpose": true,
        "only_online": true,
        "payroll_required": false,
        "cities_number": -1,
        "client_type": "general"
      },
      "purposes": {
        "vehicles": true,
        "studies": false,
        "travels": false,
        "home": false,
        "celebrations": false,
        "others": false,
        "others_description": null,
        "ecological": false
      },
      "features": {
        "min_amount": 3000,
        "max_amount": 35000,
        "min_term": 365,
        "max_term": 2520,
        "amount_description": null
      },
      "costs": {
        "costs_and_commissions": false,
        "insurance_required": "non_insurable",
        "change_bank_required": false,
        "interest": 4.95,
        "apr": 5.06,
        "apr_description": "<p>Para ayudarte a conocer el coste real del Préstamo Oney vehículos nuevos, te mostramos el ejemplo representativo de la Tasa Anual Equivalente o TAE que la entidad ofrece a sus clientes: una TAE del 6,11% para un préstamo de 25.000€ a devolver en 48 meses.</p>\n",
        "has_assessment": false,
        "has_opening": false,
        "has_total_partial_cancellation": false,
        "has_commissions": false
      },
      "has_promo": false,
      "bank": {
        "id": 221,
        "name": "Oney",
        "slug": "oney",
        "status": "active",
        "image": {
          "url": "https://api.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbmNKIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--8b939bdb62e146596d92f4140cb935365233f9fd/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpQ3pnd2VEZ3dYZ1k3QmxRNkRHZHlZWFpwZEhsSklndGpaVzUwWlhJR093WlVPZ2xqY205d1NTSU9PREI0T0RBck1Dc3dCanNHVkE9PSIsImV4cCI6bnVsbCwicHVyIjoidmFyaWF0aW9uIn19--cb6dbdeb942b2cec9d8893c07f51de2233e977f4/oney_logo_pp.jpg",
          "url_square": "https://api.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbmNKIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--8b939bdb62e146596d92f4140cb935365233f9fd/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpQ3pnd2VEZ3dYZ1k3QmxRNkRHZHlZWFpwZEhsSklndGpaVzUwWlhJR093WlVPZ2xqY205d1NTSU9PREI0T0RBck1Dc3dCanNHVkE9PSIsImV4cCI6bnVsbCwicHVyIjoidmFyaWF0aW9uIn19--cb6dbdeb942b2cec9d8893c07f51de2233e977f4/oney_logo_pp.jpg",
          "url_rectangular": "https://api.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbmdKIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--5cc8e0cc51d0b545a9d2c73ab3facb203595c1c9/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpRERNMk5IZzVObDRHT3daVU9neG5jbUYyYVhSNVNTSUxZMlZ1ZEdWeUJqc0dWRG9KWTNKdmNFa2lEek0yTkhnNU5pc3dLekFHT3daVSIsImV4cCI6bnVsbCwicHVyIjoidmFyaWF0aW9uIn19--a2fcbcd5ef415c9684a7286153d10c6fb68a026b/oney_logo_cal_pp.jpg"
        }
      },
      "ratings": {
        "rating": 10,
        "interest": 10,
        "assessment": 10,
        "opening": 10,
        "total_partial_cancellation": 10,
        "commissions": 10
      },
      "has_review": false
    },
    # another loan offer
    # another loan offer
  ]
}

Arguments

Parameter Description
bank_slug URL segment string The slug of the bank related to the offer (as part of the url)
slug URL segment string The slug of the offer to be used as reference (as part of the url)
product_name Required string The product name of the offer which we need to retrieve their related offers (as part of the url).

Returns

Returns a list of related loan offer objects sorted by relevance

List all loans offers

# Definition
GET https://api.kelisto.es/api/v3/finances/offers/loans?<criteria>

# Example request
$ curl https://api.kelisto.es/api/v3/finances/offers/loans?sort_by=-rating,+allow_redirect
# Example response

{
  "pagination": {
    "links": {
      "first": "https://api.kelisto.us/api/v3/finances/offers/loans?sort_by=-rating%2C%2Ballow_redirect&page=1&product_name=microcredit&apikey=e315aea65e846c13f9b711ca99475ab5",
      "last": "https://api.kelisto.us/api/v3/finances/offers/loans?sort_by=-rating%2C%2Ballow_redirect&page=1&product_name=microcredit&apikey=e315aea65e846c13f9b711ca99475ab5"
    },
    "current_page": "1",
    "page_items": "25",
    "total_count": "18",
    "total_pages": "1"
  },
  "data": [
    {
      "id": 15,
      "name": "Minipréstamo Vivus",
      "slug": "microcredito-vivus",
      "product_name": "microcredit",
      "product_type": "loan",
      "best_buy": false,
      "sponsored": true,
      "status": "active",
      "claim": null,
      "sponsored_order": 1,
      "description": "<p>El <strong>Minipréstamo Vivus</strong> es un producto de financiación con el que cualquier consumidor puede pedir una pequeña cantidad de dinero, a devolver en un plazo corto de tiempo. A cambio, esta entidad cobrará unos intereses que, en lugar de aplicarse en forma de Tipo de Interés Nominal o TIN (como ocurre en los préstamos tradicionales), se aplica en forma de honorarios, que son una cantidad fija en euros. Dicha cifra varía en función de la cantidad que solicite el cliente, el plazo de devolución que escoja e, incluso, de si ya ha pedido anteriormente dinero a Vivus. <br>\nEn cualquier caso, el Minipréstamo Vivus tiene una oferta que permite que los nuevos clientes pidan 300€ a 30 días sin ningún coste: es decir, sin comisiones ni honorarios, lo que equivale a una Tasa Anual Equivalente (TAE) del 0%. Recuerda, eso sí, que esa TAE puede aumentar en otros supuestos: por ejemplo, si pides 100€ a 30 días, los honorarios serían de 32€, lo que equivaldría a una TAE del 2.830,8%.<br>\nRespecto al resto de sus características, el Minipréstamo Vivus permite <strong>solicitar entre 50 y 300€</strong> (aunque la cifra sube hasta 1.400€ si eres antiguo cliente), a devolver en un <strong>plazo de entre siete y 30 días</strong>.  Por lo demás, para poder solicitar uno de estos microcréditos solo debes ser mayor de 21 años, tener una cuenta bancaria y disponer de un dispositivo con conexión a Internet.</p>\n",
      "updated_at": "2024-05-17T02:00:02.786+02:00",
      "created_at": "2019-11-21T11:24:22.159+01:00",
      "has_deal": true,
      "url": "https://clk.tradedoubler.com/click?p=357929&a=2924858&g=25614580",
      "loan_type": "microcredit",
      "typ_description": "<ul>\n<li>Primer préstamo de <strong>300€</strong> sin intereses ni comisiones</li>\n<li>Hasta <strong>1.400€</strong> para ya clientes</li>\n<li>Transferencia en 15 minutos </li>\n<li> Devuélvelo en 30 días</li>\n</ul>\n",
      "comments": "",
      "starred": false,
      "starred_order": null,
      "recommended": true,
      "most_popular": false,
      "cheapest": false,
      "free_featured_label": "",
      "free_featured_label_description": "",
      "obligations": {
        "old_clients": true,
        "new_clients": true,
        "min_age": 21,
        "signup_online": true,
        "defaulter": false,
        "must_justify_purpose": false,
        "only_online": false,
        "payroll_required": false,
        "cities_number": -1,
        "client_type": "general"
      },
      "purposes": {
        "vehicles": true,
        "studies": true,
        "travels": true,
        "home": true,
        "celebrations": true,
        "reunification_loan": false,
        "others": true,
        "others_description": "<p>Con el Minipréstamo Vivus puedes pedir dinero para lo que quieras, aunque al tratarse de cantidades pequeñas, tus opciones para financiar ciertos gastos podrían verse reducidas. </p>\n",
        "ecological": false
      },
      "features": {
        "min_amount": 50,
        "max_amount": 1400,
        "min_term": 7,
        "max_term": 30,
        "amount_description": "<p>El Minipréstamo Vivus pedir entre 50 y 300€, aunque esa cifra puede subir hasta los 1.400€ si eres antiguo cliente de la entidad.</p>\n"
      },
      "costs": {
        "costs_and_commissions": false,
        "insurance_required": "non_insurable",
        "change_bank_required": false,
        "interest": 0,
        "apr": 0,
        "apr_description": "<p>En Kelisto te ofrecemos la información que Vivus proporciona sobre su TAE para que puedas entender cuál es el coste real de pedir financiación con esta compañía. En este sentido, debes saber que si eres nuevo cliente y pides 300€, a devolver en 30 días, no tendrás que pagar gastos ni honorarios. Por tanto, la TAE será del 0%. En cambio, si pidieras 100€ a 30 días, tendrías que pagar 32€ en concepto de honorarios, por lo que la TAE subiría hasta el 2.830,8%. </p>\n",
        "has_assessment": false,
        "has_opening": false,
        "has_total_partial_cancellation": false,
        "has_commissions": true,
        "commissions": {
          "fee": 0,
          "description": "<p>Los honorarios del Minipréstamo Vivus varían en función de la cantidad que pidas y del plazo de devolución que establezcas. No obstante, la compañía dispone de una promoción que permite que los nuevos clientes pidan 300€ a 30 días sin pagar honorarios. </p>\n"
        }
      },
      "has_promo": true,
      "promo": {
        "started_at": "2023-07-01T00:00:00.000+02:00",
        "expired_at": "2024-12-31T23:59:00.000+01:00",
        "claim": "El primer préstamo, de hasta 300€, sin intereses ni comisiones",
        "description": "<p>Tu primer crédito, de hasta 300 €, sin intereses ni comisiones.</p>\n"
      },
      "bank": {
        "id": 99,
        "name": "Vivus",
        "slug": "vivus",
        "status": "active",
        "background_color": "#A6CE39",
        "product_types": [
          "loan"
        ],
        "product_names": {
          "bank_account": [],
          "card": [],
          "deposit": [],
          "mortgage": [],
          "loan": [
            "microcredit"
          ]
        },
        "image": {
          "url": "https://assets.kelisto.us/cf9eoz18b3toueliay774ok63j3o",
          "url_square": "https://assets.kelisto.us/cf9eoz18b3toueliay774ok63j3o",
          "url_rectangular": "https://assets.kelisto.us/04b07jnwxym74rcfq5nndumycw99",
          "url_big": "https://assets.kelisto.us/2o9w4t1czockggv36vpw1tlmj6id"
        }
      },
      "ratings": {
        "rating": 9.3,
        "interest": 8.6,
        "assessment": 10,
        "opening": 10,
        "total_partial_cancellation": 10,
        "commissions": 8.6
      },
      "has_review": false,
      "authors": {
        "created_by": null,
        "updated_by": null
      }
    },
    # mortgage object matching criteria,
    # mortgage object matching criteria,
    # mortgage object matching criteria,
    # ...
  ],
    "filters": {
        "available_banks": [
      {
        "name": "ABANCA",
        "slug": "abanca"
      },
      {
        "name": "Acierto.com",
        "slug": "acierto_com"
      },
      {
        "name": "Banco Caminos ",
        "slug": "banco-caminos"
      },
      {
        "name": "Banco Cetelem",
        "slug": "banco-cetelem"
      },
      {
        "name": "Banco Santander",
        "slug": "banco-santander"
      },
      {
        "name": "Banco Sabadell",
        "slug": "banc-sabadell"
      },
      {
        "name": "Bankinter",
        "slug": "bankinter"
      },
      {
        "name": "BBVA",
        "slug": "bbva"
      },
      {
        "name": "Caixa Guissona ",
        "slug": "caixa-guissona"
      },
      {
        "name": "Caja Ingenieros",
        "slug": "caja-de-ingenieros"
      },
      {
        "name": "Caja Rural Central",
        "slug": "caja-rural"
      },
      {
        "name": "Cajasiete",
        "slug": "caja-siete"
      },
      {
        "name": "Cofidis",
        "slug": "cofidis"
      },
      {
        "name": "Creditea",
        "slug": "creditea"
      },
      {
        "name": "creditstar",
        "slug": "creditstar"
      },
      {
        "name": "CreditYES",
        "slug": "credityes"
      },
      {
        "name": "Deutsche Bank",
        "slug": "deutsche-bank"
      },
      {
        "name": "Ferratum",
        "slug": "ferratum"
      },
      {
        "name": "Fidinda",
        "slug": "fidinda"
      },
      {
        "name": "Financa",
        "slug": "financa"
      },
      {
        "name": "Fintonic",
        "slug": "fintonic"
      },
      {
        "name": "Finzmo",
        "slug": "finzmo"
      },
      {
        "name": "Gedesco",
        "slug": "gedesco"
      },
      {
        "name": "Globalcaja",
        "slug": "globalcaja"
      },
      {
        "name": "Holadinero",
        "slug": "holadinero"
      },
      {
        "name": "Ibancar ",
        "slug": "ibancar"
      },
      {
        "name": "ING",
        "slug": "ing"
      },
      {
        "name": "Kutxabank",
        "slug": "kutxabank"
      },
      {
        "name": "Laboral Kutxa",
        "slug": "laboral-kutxa"
      },
      {
        "name": "Lea Bank",
        "slug": "lea_bank"
      },
      {
        "name": "Money GO",
        "slug": "money-go"
      },
      {
        "name": "Myinvestor",
        "slug": "myinvestor"
      },
      {
        "name": "myKredit",
        "slug": "mykredit"
      },
      {
        "name": "Oney",
        "slug": "oney"
      },
      {
        "name": "Openbank",
        "slug": "openbank"
      },
      {
        "name": "Plazo",
        "slug": "plazo"
      },
      {
        "name": "Prestalo",
        "slug": "prestalo"
      },
      {
        "name": "PréstamoPro",
        "slug": "prestamopro"
      },
      {
        "name": "Revolut",
        "slug": "revolut"
      },
    ]
  }
}

Arguments

Parameter Description
banks optional string Retrieve offers by bank slugs. Eg: banks=bbva; banks=bbva,abanca.
status optional string Retrieve terms by status (active, inactive, snapshot or discontinue). It can be an array of statuses. Default: active.
product_name optional string Retrieve offers by product name (personal_loan or microcredit). Eg: product_name=microcredit.
signup_online optional boolean Retrieve offers that accept online loans.
costs_and_commissions optional boolean Retrieve offers that accept costs and commissions loans.
defaulter optional boolean Retrieve offers that allow ASNEF.
purpose_vehicles optional boolean Retrieve offers that the purpose of the loan is for vehicles.
purpose_studies optional boolean Retrieve offers that the purpose of the loan is for studies.
purpose_home optional boolean Retrieve offers that the purpose of the loan is for home.
purpose_travels optional boolean Retrieve offers that the purpose of the loan is for travels.
reunification_loan optional boolean Retrieve offers with the purpose of the loan is debt reunification.
term_loan optional integer Retrieve the months in which the loan will have to be repaid.
amount_loan optional integer Retrieve the loans containing the amount to be requested.
sort_by optional string The field that defines the order. Use suffix - to define descending order and + for ascending order. (i.e. -rating). Multiple sorting values can be specified (-allow_redirect,-rating)

 Returns

Returns a list with the Loan offer object, that match specified criteria. Returns a filters' list with available active banks for the desired product_name.

Retrieve loans top offers

# Definition
GET https://api.kelisto.es/api/v3/finances/top_offers/loans/\(:product_name\)

# Example request
$ curl https://api.kelisto.es/api/v3/finances/top_offers/loans/personal_loan
# Example response

{
  "data": [
    {
      "id": 1194,
      "name": "Préstamo Wanna",
      "slug": "prestamo-wanna-de-wanna",
      "product_name": "personal_loan",
      "product_type": "loan",
      "best_buy": false,
      "sponsored": false,
      "status": "active",
      "claim": null,
      "description": "<p>El <strong>Préstamo Wanna de Wanna</strong> es un préstamo personal con el que podrás conseguir <strong>entre 750 y 40.000 euros</strong> para cualquier proyecto, siempre que accedas a pagar un <strong>Tipo de Interés Nominal (TIN) del 4,65%</strong>. Eso sí, recuerda que esta cifra podría variar en función del análisis de riesgo que realice esta empresa online especializada en préstamos al consumo, aunque nunca superará el 19,95%. </p>\n\n<p>El <strong>plazo de devolución</strong> del Préstamo Wanna va desde los seis hasta los 60 meses dependiendo de las necesidades del cliente. En cuanto a los <strong>costes</strong>, cabe destacar que este préstamo personal de Wanna <strong>no tiene comisiones</strong>.  Por tanto, no tendrás que pagar nada ni por la apertura, ni por el estudio, ni en caso de devolver tu deuda antes de tiempo (amortización anticipada).</p>\n\n<p>Además, si pides el Préstamo Wanna <strong>no tendrás que justificar el propósito al que quieres destinar el dinero</strong> ni contratar ningún producto adicional o cambiar de banco. Solo hará falta que seas mayor de edad, no formes parte de ningún fichero de morosos como Asnef,  presentes tu solicitud a través de Internet y dispongas de una cuenta en cualquier entidad para que te pasen las cuotas cada mes. </p>\n",
      "updated_at": "2024-05-14T02:00:02.661+02:00",
      "created_at": null,
      "has_deal": true,
      "url": "https://finanzas.kelisto.es/landing_pages/prestamos-a-tu-medida",
      "loan_type": "personal",
      "typ_description": "<ul>\n<li>Hasta <strong>40.000€</strong> </li>\n<li>TAE desde el 7,26% </li>\n<li>100% digital</li>\n<li>Pago flexible</li>\n</ul>\n",
      "comments": "URL cambiada por la del proceso https://clk.tradedoubler.com/click?p=312556&a=2924858&g=24960136",
      "starred": false,
      "starred_order": null,
      "recommended": true,
      "most_popular": false,
      "cheapest": false,
      "free_featured_label": "",
      "free_featured_label_description": "",
      "obligations": {
        "old_clients": true,
        "new_clients": true,
        "min_age": 18,
        "signup_online": true,
        "defaulter": false,
        "must_justify_purpose": false,
        "only_online": true,
        "payroll_required": false,
        "cities_number": -1,
        "client_type": "general"
      },
      "purposes": {
        "vehicles": true,
        "studies": true,
        "travels": true,
        "home": true,
        "celebrations": true,
        "reunification_loan": false,
        "others": true,
        "others_description": "<p>El Préstamo Wanna puede solicitarse para financiar cualquier proyecto sin tener que justificar su propósito a la entidad.</p>\n",
        "ecological": false
      },
      "features": {
        "min_amount": 750,
        "max_amount": 40000,
        "min_term": 180,
        "max_term": 1800,
        "amount_description": "<p>El Préstamo Wanna puede solicitarse a partir de 750€, seas antiguo o nuevo cliente.</p>\n"
      },
      "costs": {
        "costs_and_commissions": false,
        "insurance_required": "non_insurable",
        "change_bank_required": false,
        "interest": 4.65,
        "apr": 4.75,
        "apr_description": "<p>En Kelisto queremos ayudarte a entender el coste real del Préstamo Wanna. Por eso te mostramos los datos de su TAE (Tasa Anual Equivalente) basados en el ejemplo representativo que ofrece esta plataforma online. En este caso, se trata de una TAE del 4,75%, para un préstamo de 6.000€ a 36 meses, con un TIN del 4,65%.</p>\n",
        "has_assessment": false,
        "has_opening": false,
        "has_total_partial_cancellation": false,
        "has_commissions": false
      },
      "has_promo": false,
      "bank": {
        "id": 225,
        "name": "wanna",
        "slug": "wanna",
        "status": "active",
        "background_color": "#FF6C51",
        "product_types": [
          "loan"
        ],
        "product_names": {
          "bank_account": [],
          "card": [],
          "deposit": [],
          "mortgage": [],
          "loan": [
            "personal_loan"
          ]
        },
        "image": {
          "url": "https://assets.kelisto.us/evlr2p68hpifnmssgr2el270clys",
          "url_square": "https://assets.kelisto.us/evlr2p68hpifnmssgr2el270clys",
          "url_rectangular": "https://assets.kelisto.us/70vfv58akdwocgylc2wbakbszj7r",
          "url_big": "https://assets.kelisto.us/s0lupwqfygui14n3p7ujppg3kp6e"
        }
      },
      "ratings": {
        "rating": 8.5,
        "interest": 8.5,
        "assessment": 8.5,
        "opening": 8.5,
        "total_partial_cancellation": 8.5,
        "commissions": 8.5
      },
      "has_review": false,
      "authors": {
        "created_by": null,
        "updated_by": null
      }
    },
    {...},
        {...}
  ]
}

Arguments

Parameter Description
product_name optional string Specific loans product name. Value should be one of these: personal_loan, microcredit or empty to get global top offers.

 Returns

Returns a list with 3 loans offer objects: Loan offer object

Bank account offers

The bank account offer object

Attributes

# Example object

{
  "id": 6225,
  "name": "Cuenta Online",
  "slug": "cuenta-online-santander",
  "product_name": "payroll_account",
  "product_type": "bank_account",
  "best_buy": false,
  "sponsored": false,
  "status": "active",
  "claim": "Acceso a SMusic. +300€ por ingresar nómina o +400€ si es más de 2.500€.",
  "description": "<p>La <strong>Cuenta Online Santander de Banco Santander</strong> es una cuenta corriente 100% digital, con la que podrás realizar tus gestiones bancarias habituales como retirar dinero en efectivo, hacer transferencias o realizar pagos.</p>\n\n<p>En lo que se refiere a las comisiones, la Cuenta Online Santander es una <a href=\"https://www.kelisto.es/cuentas-sin-comisiones\">cuenta sin comisiones</a>: esto es, que no tendrás que pagar nada en concepto de <strong>comisión de mantenimiento y de administración</strong>. Además, esta cuenta del Santander sin comisiones tampoco te aplicará ningún cargo al realizar transferencias tanto nacionales como realizadas en países de la Unión Europea. Eso sí, debes tener en cuenta que si tendrás <strong>que pagar una comisión si realizas transferencias con carácter urgente e inmediatas</strong>.</p>\n\n<p>Al abrir la Cuenta Online del Santander tendrás asociada una Tarjeta de Débito Santander <strong>sin ningún coste</strong>. Con ella, no solo podrás hacer retiradas de efectivo gratis en toda la red de cajeros de Banco Santander en España, donde tienes 7.000 cajeros, sino que también podrás hacerlo en los 30.000 cajeros que la entidad tiene repartidos por todo el mundo. Eso sí, recuerda que cuando hagas las retiradas en cajeros que sean de otro banco tendrás que abonar el 100% de la comisión fijada por el titular del cajero correspondiente.</p>\n\n<p>Por otro lado, esta cuenta del Santander sin comisiones ofrece las siguientes <strong>ventajas</strong>:</p>\n\n<ul>\n<li><strong>Seguro de accidentes</strong> hasta 120.000€</li>\n<li>Acceso gratuito a <strong>Santander Zone</strong>, una plataforma donde puedes encontrar descuentos, promociones, experiencias exclusivas solo por ser cliente del Santander.</li>\n<li>Hasta <strong>dos cuentas por titular</strong>: cada titular podrá tener un máximo de dos Cuentas Online de Santander.</li>\n</ul>\n\n<p>Además, si contratas la Cuenta Online de Santander y solicitas una de las tarjetas de la entidad tendrás acceso a <a href=\"https://www.kelisto.es/cuentas-bancarias/consejos-y-analisis/santander-smusic\"><strong>Santander SMusic</strong></a>, la plataforma de contenidos musicales, venta de entradas y acceso a descuentos y experiencia disponible en exclusiva para clientes de Banco Santander. </p>\n\n<p>Las principales <strong>ventajas</strong> que te ofrece la Cuenta Online de Banco Santander junto con Santander SMusic son:</p>\n\n<ul>\n<li><strong>Preventa de entradas</strong>: los clientes de Banco Santander pueden acceder a la <strong>venta anticipada de entradas de conciertos en exclusiva</strong>.</li>\n<li><strong>Financiación de entradas</strong>: podrás fraccionar el pago de tus entradas sin interés (aunque sí tiene comisiones) en tres meses, gracias a su <strong>Paga en 3</strong>.</li>\n<li><strong>Descuentos y sorteos</strong>: a través de Santander SMusic, la entidad ofrece descuentos y sorteos en tickets para conciertos festivales y otros espectáculos</li>\n<li><strong>Promociones y experiencias exclusivas</strong>: dispone de promociones para eventos musicales que solo están disponibles para sus clientes.</li>\n</ul>\n\n<p>Para abrir la Cuenta Online de Banco Santander debes saber que solo se puede contratar a través de Internet. Además, para que funcione como una cuenta del Santander sin comisiones deberás cumplir con los siguientes requisitos: </p>\n\n<ul>\n<li>Ser un cliente nuevo de Banco Santander.</li>\n<li>Ser mayor de edad.</li>\n<li>Ser residente en España.</li>\n</ul>\n",
  "updated_at": "2024-02-14T15:07:39.523+01:00",
  "created_at": "2021-10-05T14:53:06.797+02:00",
  "has_deal": true,
  "url": "https://clk.tradedoubler.com/click?p=331573&a=2924858&g=25270362",
  "checking_account": true,
  "payroll_account": true,
  "savings_account": false,
  "comments": "",
  "free_transfers": true,
  "transfers_description": "<p>Podrás realizar transferencias gratuitas en euros desde la Banca Online, App Santander y cajeros automáticos, excepto urgentes.</p>\n",
  "starred": true,
  "recommended": false,
  "most_popular": false,
  "free_featured_label": "",
  "free_featured_label_description": "",
  "obligations": {
    "salary_obligation": false,
    "min_payroll": null,
    "new_clients": true,
    "old_clients": false,
    "min_age": 18,
    "max_age": null,
    "signup_online": true,
    "signup_in_branch": false,
    "obligatory_vinculation": false,
    "receipts_vinculation": false,
    "insurances_vinculation": false,
    "card_vinculation": false,
    "use_card_vinculation": false,
    "savings_vinculation": false,
    "pension_vinculation": false,
    "invest_vinculation": false,
    "min_balance_vinculation": false,
    "vinculation_number": 0,
    "client_type": "general",
    "only_online": true,
    "cities_number": -1,
    "signup_description": "<p>Para abrir la Cuenta Online del Santander solo necesitarás tener un dispositivo conectado a Internet, iniciar un proceso digital muy sencillo y facilitar algunos datos personales. </p>\n\n<p>Por lo demás, los únicos requisitos que tendrás que cumplir para abrir esta cuenta del Santander sin comisiones son: </p>\n\n<ul>\n<li>Ser un cliente nuevo de Banco Santander.</li>\n<li>Ser mayor de edad.</li>\n<li>Ser residente en España.</li>\n</ul>\n"
  },
  "has_cards": true,
  "card": {
    "card_obligation": false,
    "without_debit_card": false,
    "debit_card_free": true,
    "debit_card_free_period": -1,
    "without_credit_card": false,
    "credit_card_free": false,
    "credit_card_free_period": null,
    "free_atm_number": 7000,
    "atm_description": "Siempre gratis en los cajeros de Banco Santander.",
    "description": "<p>Tendrás una Tarjeta Débito One sin comisión de emisión ni de mantenimiento.</p>\n"
  },
  "has_interest": false,
  "has_cost": false,
  "has_gift": true,
  "gift": {
    "gift_value": "400.0",
    "months_contract_gift": 24,
    "started_at": null,
    "expired_at": "2024-04-30T00:00:00.000+02:00",
    "claim": "Consigue desde 300€ hasta 400€ brutos al domiciliar tu nómina y cumplir condiciones",
    "description": "<p>Si contratas la cuenta Santander Online obtendrás un regalo de 400€ brutos (324€ netos) a cambio de domiciliar una nómina mínima de 2.500€ y respetar una permanencia de 24 meses. En caso de que tu nómina sea inferior, podrás obtener un regalo de 300€ brutos (243€ netos) si domicilias una nómina mínima de 600€ y respetas una permanencia de 12 meses. </p>\n\n<p>Además, gracias a su plan amigo podrás conseguir otros <strong>500€ extras</strong>. Lo único que tendrás que hacer es traer a tus amigos a que contraten la cuenta y por cada uno que lo hagas te llevarás 50€, hasta un máximo de 10.</p>\n\n<p><strong>Promociones activas hasta el 30 de abril de 2024</strong>.</p>\n"
  },
  "has_reimbursement": false,
  "has_promo": false,
  "bank": {
    "id": 8,
    "name": "Banco Santander",
    "slug": "banco-santander",
    "status": "active",
    "background_color": "#EC0000",
    "product_types": [
      "bank_account",
      "card",
      "mortgage",
      "loan"
    ],
    "product_names": {
      "bank_account": [
        "checking_account",
        "payroll_account",
        "without_costs"
      ],
      "card": [
        "credit_card",
        "debit_card"
      ],
      "deposit": [],
      "mortgage": [
        "variable_mortgage",
        "fixed_mortgage",
        "mixed_mortgage"
      ],
      "loan": [
        "personal_loan"
      ]
    },
    "image": {
      "url": "https://assets.kelisto.us/nnkmcju22duy44l9wmplg3zbi5zj",
      "url_square": "https://assets.kelisto.us/nnkmcju22duy44l9wmplg3zbi5zj",
      "url_rectangular": "https://assets.kelisto.us/r1ymzsnnb1yg7je0ghqzrpn0fnyi",
      "url_big": "https://assets.kelisto.us/zcctjuy3qb9hvgyngm44ptcb9e1m"
    }
  },
  "ratings": {
    "rating": 8.4,
    "interest": 5.4,
    "admin_cost": 9.9,
    "maintenance_cost": 9.9,
    "debit_card_free": 9.9,
    "credit_card_free": 8.6,
    "gift_value": 9.9
  },
  "risk_indicator": {
    "product_risk": null,
    "linked_fund": null
  },
  "has_review": true,
  "review": {
    "title": "Excelente opción para domiciliar la nómina",
    "description": "La Cuenta Online del Santander es una cuenta corriente correcta (sin comisiones y sin exigencias), pero si la usas para domiciliar tu nómina, te ofrece uno de los regalos más atractivos que puedes encontrar actualmente: hasta 350 euros en efectivo. ",
    "author": {
      "name": "Estefanía Gonzalez",
      "firstname": "Estefanía",
      "lastname": "Gonzalez",
      "title": "Experta en Finanzas Personales",
      "profile_url": null,
      "image": {
        "url": "https://api.kelisto.us/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaDRCIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--204168fe9690457a2e261a455298e0fba9581086/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpzR1ZEb01aM0poZG1sMGVVa2lDMk5sYm5SbGNnWTdCbFE2Q1dOeWIzQkpJaEF5TlRCNE1qVXdLekFyTUFZN0JsUT0iLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--03e36b4905fe89451b15cece1fca45de539bf238/experta_estefania.jpg"
      }
    }
  },
  "authors": {
    "created_by": {
      "name": "Estefanía Gonzalez",
      "firstname": "Estefanía",
      "lastname": "Gonzalez",
      "title": "Experta en Finanzas Personales",
      "profile_url": null,
      "image": {
        "url": "https://api.kelisto.us/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaDRCIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--204168fe9690457a2e261a455298e0fba9581086/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpzR1ZEb01aM0poZG1sMGVVa2lDMk5sYm5SbGNnWTdCbFE2Q1dOeWIzQkpJaEF5TlRCNE1qVXdLekFyTUFZN0JsUT0iLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--03e36b4905fe89451b15cece1fca45de539bf238/experta_estefania.jpg"
      }
    },
    "updated_by": {
      "name": "Estefanía Gonzalez",
      "firstname": "Estefanía",
      "lastname": "Gonzalez",
      "title": "Experta en Finanzas Personales",
      "profile_url": null,
      "image": {
        "url": "https://api.kelisto.us/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaDRCIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--204168fe9690457a2e261a455298e0fba9581086/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpzR1ZEb01aM0poZG1sMGVVa2lDMk5sYm5SbGNnWTdCbFE2Q1dOeWIzQkpJaEF5TlRCNE1qVXdLekFyTUFZN0JsUT0iLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--03e36b4905fe89451b15cece1fca45de539bf238/experta_estefania.jpg"
      }
    }
  }
}
Attribute Description
id integer Unique identifier for the resource.
name string Offer name.
slug string  Unique url identifier for the resource.
product_name string  The specific product name. Its value should be one of these: checking_account, payroll_account or savings_account.
product_type string  Product type identifier bank_account.
claim string Short offer description.
starred boolean -
best_buy boolean Returns true if the offer is a best buy, elsewhere false.
sponsored boolean Returns true if the offer is sponsored, elsewhere false.
sponsored_orderinteger Only present if sponsored is true.
updated_at timestamp Last update time.
status string Status of the offer. Can be active, inactive, snapshot or discontinue.
description string Description using HTML format.
has_deal boolean Return true if Kelisto has a deal for this offer with its provider.
url string Offer landing page URL (only if has_deal is true).
checking_account boolean true if product_name is checking_account.
payroll_account boolean true if product_name is payroll_account.
savings_account boolean true if product_name is savings_account.
free_transfers: boolean Returns true if current bank account has free transfers.
transfers_description: string Description using HTML format.
comments string Comments using HTML format.
obligations hash Bank Account Obligations object
has_cards boolean Returns true if the current bank account has cards associated with it.
card optional, hash Bank Account Card object
has_interest boolean Returns true if the current bank account has interests hash attributes.
interests optional, hash Bank Account Interests object
has_cost boolean Returns true if the current bank account has cost hash attributes.
costs optional, hash Bank Account Costs object
has_gift boolean Returns true if the offer has a gift.
gifts optional, hash Bank Account Gifts object
has_reimbursement boolean Returns true if the current bank account has reimbursement hash attributes.
reimbursements optional, hash Bank Account Reimbursements object
has_promo boolean Returns true if the offer has a promotion.
promo optional, hash Promo object.
bank hash Bank object.
ratings hash Rating object.
has_review boolean Returns true if the offer has a review.
review hash Review object. Only if has_review is true.
bank_account_type Required string Specific bank account type. Value should be one of these: checking_account, payroll_account, savings_account or without_costs.
recommended boolean Returns true on recommended bank accounts.
most_popular boolean Return true on most_popular bank accounts.
free_featured_label string Product defined featured label name.
free_featured_label_description boostringlean Product defined featured label description.

The bank account card object

Attributes

# Example object

{
  "card_obligation": true,
  "debit_card_free": false,
  "debit_card_free_period": null,
  "credit_card_free": false,
  "credit_card_free_period": -1,
  "free_atm_number": 14000,
  "atm_description": "Con la tarjeta de débito asociada a la Cuenta Nómina de Bankinter podrás sacar gratis en más de 14.000 cajeros. En concreto, en los de Bankinter, Caja Rural, Deutsche Bank, Grupo Cooperativo Cajamar, Laboral Kutxa, Targo Bank y Banca March, Cajeros de la red EURO 6000 (Kutxabank, Abanca, Liberbank, Unicaja…).",
  "description": "<p>Con la Cuenta Nómina de Bankinter recibirás una Tarjeta Combo gratis. Esta tarjeta dispone de dos caras, una destinada a las operaciones que decidas pagar a final de mes (sin intereses) y otra para efectuar compras aplazadas. Todo sin comisión ni de emisión ni de mantenimiento. Para aplazar tus gastos, esta tarjeta de crédito te ofrece distintas modalidades, aunque todas ellas cobran un interés del 17,52% TIN. </p>\n"
}
Attribute Description
card_obligation boolean true if the card is required.
debit_card_free boolean true if the offer includes a free debit card.
debit_card_free_period integer Period during which the debit card is free. -1 means it will always be free.
credit_card_free boolean true if the offer includes a free credit card.
credit_card_free_period integer Period during which the credit card is free. -1 means it will always be free.
free_atm_number integer Number of atms where using the card is free.
atm_description string Atm description.
description string Card description.

The bank account interests object

Attributes

# Example object

{
  "initial_interest": "2.0",
  "initial_apr": "0.25",
  "initial_interest_period": 12,
  "followon_interest": "2.2",
  "followon_apr": "1.25",
  "followon_interest_period": 0,
  "max_amount_with_interest": "15000.0",
  "min_amount_with_interest": "0.0",
  "apr_description": "ejemplo representativo"
}
Attribute Description
initial_interest decimal Initial TIN.
initial_apr decimal Initial TAE.
initial_interest_period integer Term of initial interest required in months.
followon_interest decimal Continued TIN.
followon_apr decimal Continued TAE.
followon_interest_period integer Term of subsequent interest required in months.
max_amount_with_interest decimal Max amount with interest.
min_amount_with_interest decimal Min amount with interest.
apr_description text representative example.

The bank account gifts object

Attributes

# Example object

{
  "gift_value": "100.0",
  "months_contract_gift": 0,
  "description": "<p>Si abres la Cuenta Online Sin Comisiones de BBVA o la Cuenta Nómina Va Contigo con dos titulares y ambos domiciliáis una nómina mínima de 800 euros, recibiréis un regalo en efectivo: 100 euros para cada uno (81 euros después de pagar impuestos). A cambio, tendrás que respetar una permanencia mínima de 12 meses .</p>\n"
}
Attribute Description
gift_value float The value of the gift.
months_contract_gift integer Permanence period in months required to get the gift.
description string Gift description

The bank account obligations object

Attributes

# Example object

{
  "salary_obligation": true,
  "min_payroll": 800.0,
  "new_clients": true,
  "old_clients": true,
  "min_age": null,
  "max_age": null,
  "signup_online": true,
  "signup_in_branch": true,
  "obligatory_vinculation": true,
  "receipts_vinculation": true,
  "insurances_vinculation": false,
  "card_vinculation": false,
  "use_card_vinculation": true,
  "savings_vinculation": false,
  "pension_vinculation": false,
  "invest_vinculation": false,
  "min_balance_vinculation": false,
  "vinculation_number": 3,
  "client_type": "general",
  "only_online": false,
  "cities_number": 17,
}
Attribute Description

The bank account costs object

Attributes

# Example object

{
  "maintenance_cost": "16.9",
  "admin_cost": "0.0",
  "cheque_cost": "0.0",
}
Attribute Description

The bank account reimbursements object

Attributes

# Example object

{
  "percentage": "0.1",
  "description": "<p>Recibirás el 0,1% de todas las compras que pagues con tarjeta.</p>\n"

}
Attribute Description

Retrieve a bank account offer

# Definition
GET https://api.kelisto.es/api/v3/finances/offers/bank_accounts/:slug?bank_slug=:bank_slug&product_name=:product_name

# Example request
$ curl https://api.kelisto.es/api/v3/finances/offers/bank_accounts/cuenta-nomina?bank_slug=bankinter&product_name=payroll_account
# Example response
{
  "data": {
    "id": 32,
    "name": "Cuenta de Ahorro Bienvenida con Nómina",
    "slug": "cuenta-de-ahorro-bienvenida-nomina",
    "product_name": "payroll_account",
    "product_type": "bank_account",
    "best_buy": true,
    "sponsored": false,
    "status": "inactive",
    "claim": "Remunera hasta 5.000€",
    "description": "<p>La <strong>Cuenta de Ahorro Bienvenida con Nómina de Openbank</strong> es una cuenta remunerada de la banca online de Banco Santander con la que podrás conseguir rentabilidad por tus ahorros, pero con tu dinero siempre disponible. </p>\n\n<p>La Cuenta de Ahorro Bienvenida con Nómina de Openbank es una cuenta <strong>sin comisiones</strong>: es decir, no tendrás que pagar nada por mantenimiento, ni administración, y podrás cerrarla siempre que quieras, sin tener que abonar ningún tipo de penalización. </p>\n\n<p>En lo que respecta a su <strong>rentabilidad</strong>, debes tener en cuenta que estará ligada a varios factores: el tiempo que haya transcurrido desde que contrataste la cuenta, el saldo que mantengas y las condiciones que estés dispuesto a cumplir. Partiendo de esta base, la rentabilidad que conseguirás con la Cuenta de Ahorro Bienvenida con Nómina de Openbank será de: </p>\n\n<p><strong>DURANTE LOS 12 PRIMEROS MESES</strong></p>\n\n<ul>\n<li><strong>Si cumples condiciones</strong>, es decir, si domicilias una nómina o pensión de, como mínimo, 900€/mes, recibirás un 5,12% TAE anual (5% TIN anual) para los primeros 5.000€, desde el primer día.</li>\n<li><strong>Si no cumples condiciones</strong> recibirás un 0,05% TIN anual sin importar la cantidad que tengas. </li>\n</ul>\n\n<p><strong>A PARTIR DEL SEGUNDO AÑO MES</strong></p>\n\n<ul>\n<li><strong>Si cumples condiciones</strong>, es decir, si domicilias una nómina o pensión de, como mínimo, 900€/mes, recibirás un 0,20% TIN anual.</li>\n<li><strong>Si no cumples condiciones</strong> recibirás un 0,05% TIN anual. </li>\n</ul>\n\n<p>Consulta condiciones en openbank.es </p>\n\n<p><strong>Con la confianza de un gran banco. Con el respaldo y la solvencia de Grupo Santander.</strong></p>\n",
    "updated_at": "2024-02-20T02:00:00.265+01:00",
    "created_at": "2018-12-12T13:29:11.474+01:00",
    "has_deal": false,
    "url": null,
    "checking_account": false,
    "payroll_account": true,
    "savings_account": true,
    "comments": "",
    "free_transfers": true,
    "transfers_description": null,
    "starred": false,
    "recommended": false,
    "most_popular": false,
    "free_featured_label": "",
    "free_featured_label_description": "",
    "obligations": {
      "salary_obligation": true,
      "min_payroll": 900.0,
      "new_clients": true,
      "old_clients": true,
      "min_age": null,
      "max_age": null,
      "signup_online": true,
      "signup_in_branch": true,
      "obligatory_vinculation": true,
      "receipts_vinculation": false,
      "insurances_vinculation": false,
      "card_vinculation": false,
      "use_card_vinculation": false,
      "savings_vinculation": false,
      "pension_vinculation": false,
      "invest_vinculation": false,
      "min_balance_vinculation": false,
      "vinculation_number": 1,
      "client_type": "general",
      "only_online": true,
      "cities_number": -1,
      "signup_description": "<p>Puedes contratar la Cuenta de Ahorro Bienvenida con Nómina por teléfono, por Internet o en la oficina principal de Openbank (Paseo de la Castellana, 134, Madrid).  </p>\n\n<p>Para disfrutar de la máxima remuneración que ofrece la Cuenta de Ahorro Bienvenida Con Nómina de Openbank tendrás que domiciliar una nómina mínima de 900 euros al mes y mantenerla durante, por lo menos, 6 meses. </p>\n"
    },
    "has_cards": true,
    "card": {
      "card_obligation": false,
      "without_debit_card": false,
      "debit_card_free": true,
      "debit_card_free_period": -1,
      "without_credit_card": false,
      "credit_card_free": true,
      "credit_card_free_period": -1,
      "free_atm_number": 7000,
      "atm_description": "Siempre gratis en los cajeros de Banco Santander.",
      "description": "<p>La Cuenta de Ahorro Bienvenida Con Nómina de Openbank no tiene tarjetas vinculadas. Ahora bien, debes tener en cuenta que, para poder contratar esta oferta, debes domiciliar tu nómina en una Cuenta Nómina Open de la entidad. Esta cuenta sí tiene tarjeta de débito y crédito asociadas, pero ninguna de las dos tiene coste para el primer titular.</p>\n"
    },
    "has_interest": true,
    "interests": {
      "initial_interest": "2.0",
      "initial_apr": "0.25",
      "initial_interest_period": 12,
      "followon_interest": "2.2",
      "followon_apr": "1.25",
      "followon_interest_period": 0,
      "max_amount_with_interest": "15000.0",
      "min_amount_with_interest": "0.0",
      "apr_description": "ejemplo representativo"
    },
    "has_cost": false,
    "has_gift": false,
    "has_reimbursement": false,
    "has_promo": false,
    "bank": {
      "id": 29,
      "name": "Openbank",
      "slug": "openbank",
      "status": "active",
      "background_color": "#E9004C",
      "product_types": [
        "bank_account",
        "card",
        "deposit",
        "mortgage",
        "loan"
      ],
      "product_names": {
        "bank_account": [
          "savings_account",
          "checking_account",
          "payroll_account",
          "without_costs"
        ],
        "card": [
          "debit_card",
          "credit_card",
          "wallet_card"
        ],
        "deposit": [
          "deposit"
        ],
        "mortgage": [
          "mixed_mortgage",
          "fixed_mortgage",
          "variable_mortgage",
          "remortgage"
        ],
        "loan": [
          "personal_loan"
        ]
      },
      "image": {
        "url": "https://assets.kelisto.us/e8q4h16wf3ex2ocgcta9iymxwnlm",
        "url_square": "https://assets.kelisto.us/e8q4h16wf3ex2ocgcta9iymxwnlm",
        "url_rectangular": "https://assets.kelisto.us/hs2gfmrkawh5k62tlchx02z2s5vb",
        "url_big": "https://assets.kelisto.us/ha5euvd8oatsz5wcpfb7gtznnlqn"
      }
    },
    "ratings": {
      "rating": 7.4,
      "interest": 8.1,
      "admin_cost": 8.1,
      "maintenance_cost": 8.1,
      "debit_card_free": 8.1,
      "credit_card_free": 8.1,
      "gift_value": 3.6
    },
    "risk_indicator": {
      "product_risk": "1/6",
      "linked_fund": "<p>Entidad adherida al Fondo de Garantía de Depósitos de Entidades de Crédito Español. Para depósitos en dinero, el importe máximo garantizado es de 100.000€ por depositante en cada entidad de crédito.</p>\n"
    },
    "has_review": true,
    "review": {
      "title": "",
      "description": "Con la Cuenta Ahorro Bienvenida con Nómina podrás conseguir uno de los intereses más altos del mercado, pero con dos limitaciones: deberás domiciliar tu nómina y no tener más de 5.000 euros (el dinero restante cobra un interés inferior).",
      "author": {
        "name": "Estefanía Gonzalez",
        "firstname": "Estefanía",
        "lastname": "Gonzalez",
        "title": "Experta en Finanzas Personales",
        "profile_url": "https://www.kelisto.es/autor/estefania-gonzalez",
        "image": {
          "url": "https://api.kelisto.us/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaDRCIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--204168fe9690457a2e261a455298e0fba9581086/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpzR1ZEb01aM0poZG1sMGVVa2lDMk5sYm5SbGNnWTdCbFE2Q1dOeWIzQkpJaEF5TlRCNE1qVXdLekFyTUFZN0JsUT0iLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--03e36b4905fe89451b15cece1fca45de539bf238/experta_estefania.jpg"
        }
      }
    },
    "authors": {
      "created_by": {
        "name": "Estefanía Gonzalez",
        "firstname": "Estefanía",
        "lastname": "Gonzalez",
        "title": "Experta en Finanzas Personales",
        "profile_url": "https://www.kelisto.es/autor/estefania-gonzalez",
        "image": {
          "url": "https://api.kelisto.us/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaDRCIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--204168fe9690457a2e261a455298e0fba9581086/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpzR1ZEb01aM0poZG1sMGVVa2lDMk5sYm5SbGNnWTdCbFE2Q1dOeWIzQkpJaEF5TlRCNE1qVXdLekFyTUFZN0JsUT0iLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--03e36b4905fe89451b15cece1fca45de539bf238/experta_estefania.jpg"
        }
      },
      "updated_by": {
        "name": "Estefanía Gonzalez",
        "firstname": "Estefanía",
        "lastname": "Gonzalez",
        "title": "Experta en Finanzas Personales",
        "profile_url": "https://www.kelisto.es/autor/estefania-gonzalez",
        "image": {
          "url": "https://api.kelisto.us/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaDRCIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--204168fe9690457a2e261a455298e0fba9581086/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpzR1ZEb01aM0poZG1sMGVVa2lDMk5sYm5SbGNnWTdCbFE2Q1dOeWIzQkpJaEF5TlRCNE1qVXdLekFyTUFZN0JsUT0iLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--03e36b4905fe89451b15cece1fca45de539bf238/experta_estefania.jpg"
        }
      }
    }
  },
  "filters": {
    "available_banks": [
      {
        "name": "ABANCA",
        "slug": "abanca"
      },
      {
        "name": "Banco Santander",
        "slug": "banco-santander"
      }
    ]
  }
}

Arguments

Parameter Description
slug Required string The slug of the offer to retrieve.
bank_slug Required string The slug of the bank related to the offer.
product_name Required string The product name of the offer. Can be checking_account, payroll_account or savings_account.
section optional string The 'tab' we're on, offer labels will be calculated based on that value. Can be without_costs, checking_account, payroll_account or savings_account.

 Returns

Returns a Bank Account offer object if a valid slug, bank_slug and product_name were provided. Will also return a list of available banks with active & has_deal offers, which can be used to build filter forms.

List all bank account offers

# Definition
GET https://api.kelisto.es/api/v3/finances/offers/bank_accounts?<criteria>

# Example request
$ curl https://api.kelisto.es/api/v3/finances/offers/bank_accounts?banks=banca-sistema
# Example response

{
  "pagination": {
    "links": {
      "first": "https://api.kelisto.dev/api/v3/finances/offers/bank_accounts?page=1",
      "next": "https://api.kelisto.dev/api/v3/finances/offers/bank_accounts?page=2",
      "last": "https://api.kelisto.dev/api/v3/finances/offers/bank_accounts?page=4"
    },
    "current_page": 1,
    "page_items": 25,
    "total_count": 77,
    "total_pages": 4
  },
  "data": [
  {
    "id": 32,
    "name": "Cuenta de Ahorro Bienvenida con Nómina",
    "slug": "cuenta-de-ahorro-bienvenida-nomina",
    "product_name": "payroll_account",
    "product_type": "bank_account",
    "best_buy": true,
    "sponsored": false,
    "status": "inactive",
    "claim": "Remunera hasta 5.000€",
    "description": "<p>La <strong>Cuenta de Ahorro Bienvenida con Nómina de Openbank</strong> es una cuenta remunerada de la banca online de Banco Santander con la que podrás conseguir rentabilidad por tus ahorros, pero con tu dinero siempre disponible. </p>\n\n<p>La Cuenta de Ahorro Bienvenida con Nómina de Openbank es una cuenta <strong>sin comisiones</strong>: es decir, no tendrás que pagar nada por mantenimiento, ni administración, y podrás cerrarla siempre que quieras, sin tener que abonar ningún tipo de penalización. </p>\n\n<p>En lo que respecta a su <strong>rentabilidad</strong>, debes tener en cuenta que estará ligada a varios factores: el tiempo que haya transcurrido desde que contrataste la cuenta, el saldo que mantengas y las condiciones que estés dispuesto a cumplir. Partiendo de esta base, la rentabilidad que conseguirás con la Cuenta de Ahorro Bienvenida con Nómina de Openbank será de: </p>\n\n<p><strong>DURANTE LOS 12 PRIMEROS MESES</strong></p>\n\n<ul>\n<li><strong>Si cumples condiciones</strong>, es decir, si domicilias una nómina o pensión de, como mínimo, 900€/mes, recibirás un 5,12% TAE anual (5% TIN anual) para los primeros 5.000€, desde el primer día.</li>\n<li><strong>Si no cumples condiciones</strong> recibirás un 0,05% TIN anual sin importar la cantidad que tengas. </li>\n</ul>\n\n<p><strong>A PARTIR DEL SEGUNDO AÑO MES</strong></p>\n\n<ul>\n<li><strong>Si cumples condiciones</strong>, es decir, si domicilias una nómina o pensión de, como mínimo, 900€/mes, recibirás un 0,20% TIN anual.</li>\n<li><strong>Si no cumples condiciones</strong> recibirás un 0,05% TIN anual. </li>\n</ul>\n\n<p>Consulta condiciones en openbank.es </p>\n\n<p><strong>Con la confianza de un gran banco. Con el respaldo y la solvencia de Grupo Santander.</strong></p>\n",
    "updated_at": "2024-02-20T02:00:00.265+01:00",
    "created_at": "2018-12-12T13:29:11.474+01:00",
    "has_deal": false,
    "url": null,
    "checking_account": false,
    "payroll_account": true,
    "savings_account": true,
    "comments": "",
    "free_transfers": true,
    "transfers_description": null,
    "starred": false,
    "recommended": false,
    "most_popular": false,
    "free_featured_label": "",
    "free_featured_label_description": "",
    "obligations": {
      "salary_obligation": true,
      "min_payroll": 900.0,
      "new_clients": true,
      "old_clients": true,
      "min_age": null,
      "max_age": null,
      "signup_online": true,
      "signup_in_branch": true,
      "obligatory_vinculation": true,
      "receipts_vinculation": false,
      "insurances_vinculation": false,
      "card_vinculation": false,
      "use_card_vinculation": false,
      "savings_vinculation": false,
      "pension_vinculation": false,
      "invest_vinculation": false,
      "min_balance_vinculation": false,
      "vinculation_number": 1,
      "client_type": "general",
      "only_online": true,
      "cities_number": -1,
      "signup_description": "<p>Puedes contratar la Cuenta de Ahorro Bienvenida con Nómina por teléfono, por Internet o en la oficina principal de Openbank (Paseo de la Castellana, 134, Madrid).  </p>\n\n<p>Para disfrutar de la máxima remuneración que ofrece la Cuenta de Ahorro Bienvenida Con Nómina de Openbank tendrás que domiciliar una nómina mínima de 900 euros al mes y mantenerla durante, por lo menos, 6 meses. </p>\n"
    },
    "has_cards": true,
    "card": {
      "card_obligation": false,
      "without_debit_card": false,
      "debit_card_free": true,
      "debit_card_free_period": -1,
      "without_credit_card": false,
      "credit_card_free": true,
      "credit_card_free_period": -1,
      "free_atm_number": 7000,
      "atm_description": "Siempre gratis en los cajeros de Banco Santander.",
      "description": "<p>La Cuenta de Ahorro Bienvenida Con Nómina de Openbank no tiene tarjetas vinculadas. Ahora bien, debes tener en cuenta que, para poder contratar esta oferta, debes domiciliar tu nómina en una Cuenta Nómina Open de la entidad. Esta cuenta sí tiene tarjeta de débito y crédito asociadas, pero ninguna de las dos tiene coste para el primer titular.</p>\n"
    },
    "has_interest": true,
    "interests": {
      "initial_interest": "2.0",
      "initial_apr": "0.25",
      "initial_interest_period": 12,
      "followon_interest": "2.2",
      "followon_apr": "1.25",
      "followon_interest_period": 0,
      "max_amount_with_interest": "15000.0",
      "min_amount_with_interest": "0.0",
      "apr_description": "ejemplo representativo"
    },
    "has_cost": false,
    "has_gift": false,
    "has_reimbursement": false,
    "has_promo": false,
    "bank": {
      "id": 29,
      "name": "Openbank",
      "slug": "openbank",
      "status": "active",
      "background_color": "#E9004C",
      "product_types": [
        "bank_account",
        "card",
        "deposit",
        "mortgage",
        "loan"
      ],
      "product_names": {
        "bank_account": [
          "savings_account",
          "checking_account",
          "payroll_account",
          "without_costs"
        ],
        "card": [
          "debit_card",
          "credit_card",
          "wallet_card"
        ],
        "deposit": [
          "deposit"
        ],
        "mortgage": [
          "mixed_mortgage",
          "fixed_mortgage",
          "variable_mortgage",
          "remortgage"
        ],
        "loan": [
          "personal_loan"
        ]
      },
      "image": {
        "url": "https://assets.kelisto.us/e8q4h16wf3ex2ocgcta9iymxwnlm",
        "url_square": "https://assets.kelisto.us/e8q4h16wf3ex2ocgcta9iymxwnlm",
        "url_rectangular": "https://assets.kelisto.us/hs2gfmrkawh5k62tlchx02z2s5vb",
        "url_big": "https://assets.kelisto.us/ha5euvd8oatsz5wcpfb7gtznnlqn"
      }
    },
    "ratings": {
      "rating": 7.4,
      "interest": 8.1,
      "admin_cost": 8.1,
      "maintenance_cost": 8.1,
      "debit_card_free": 8.1,
      "credit_card_free": 8.1,
      "gift_value": 3.6
    },
    "risk_indicator": {
      "product_risk": "1/6",
      "linked_fund": "<p>Entidad adherida al Fondo de Garantía de Depósitos de Entidades de Crédito Español. Para depósitos en dinero, el importe máximo garantizado es de 100.000€ por depositante en cada entidad de crédito.</p>\n"
    },
    "has_review": true,
    "review": {
      "title": "",
      "description": "Con la Cuenta Ahorro Bienvenida con Nómina podrás conseguir uno de los intereses más altos del mercado, pero con dos limitaciones: deberás domiciliar tu nómina y no tener más de 5.000 euros (el dinero restante cobra un interés inferior).",
      "author": {
        "name": "Estefanía Gonzalez",
        "firstname": "Estefanía",
        "lastname": "Gonzalez",
        "title": "Experta en Finanzas Personales",
        "profile_url": "https://www.kelisto.es/autor/estefania-gonzalez",
        "image": {
          "url": "https://api.kelisto.us/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaDRCIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--204168fe9690457a2e261a455298e0fba9581086/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpzR1ZEb01aM0poZG1sMGVVa2lDMk5sYm5SbGNnWTdCbFE2Q1dOeWIzQkpJaEF5TlRCNE1qVXdLekFyTUFZN0JsUT0iLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--03e36b4905fe89451b15cece1fca45de539bf238/experta_estefania.jpg"
        }
      }
    },
    "authors": {
      "created_by": {
        "name": "Estefanía Gonzalez",
        "firstname": "Estefanía",
        "lastname": "Gonzalez",
        "title": "Experta en Finanzas Personales",
        "profile_url": "https://www.kelisto.es/autor/estefania-gonzalez",
        "image": {
          "url": "https://api.kelisto.us/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaDRCIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--204168fe9690457a2e261a455298e0fba9581086/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpzR1ZEb01aM0poZG1sMGVVa2lDMk5sYm5SbGNnWTdCbFE2Q1dOeWIzQkpJaEF5TlRCNE1qVXdLekFyTUFZN0JsUT0iLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--03e36b4905fe89451b15cece1fca45de539bf238/experta_estefania.jpg"
        }
      },
      "updated_by": {
        "name": "Estefanía Gonzalez",
        "firstname": "Estefanía",
        "lastname": "Gonzalez",
        "title": "Experta en Finanzas Personales",
        "profile_url": "https://www.kelisto.es/autor/estefania-gonzalez",
        "image": {
          "url": "https://api.kelisto.us/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaDRCIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--204168fe9690457a2e261a455298e0fba9581086/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpzR1ZEb01aM0poZG1sMGVVa2lDMk5sYm5SbGNnWTdCbFE2Q1dOeWIzQkpJaEF5TlRCNE1qVXdLekFyTUFZN0JsUT0iLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--03e36b4905fe89451b15cece1fca45de539bf238/experta_estefania.jpg"
        }
      }
    }
  },
    # bank account object matching criteria,
    # bank account object matching criteria,
    # bank account object matching criteria,
    # ...
  ]
}

Arguments

Parameter Description
bank_slug optional string The slug of the bank related to the offer.
banks optional string Retrieve offers by bank slugs.
Eg: banks=bbva; banks=bbva,abanca.
status optional string Retrieve offers by status (active, inactive, snapshot or discontinue). It can be an array of statuses. Default: active.
interest optional boolean Retrieve offers that have interests.
salary_obligation optional boolean Retrieve offers that have salary obligations.
welcome_gift optional boolean Retrieve offers that have a gift.
free_transfers optional boolean Retrieve offers with free transfers.
cards_free optional boolean Retrieve offers that have no cards requisites.
cost optional boolean Retrieve offers that have costs.
checking_account optional boolean Retrieve checking account offers.
savings_account optional boolean Retrieve savings account offers.
payroll_account optional boolean Retrieve payroll account offers.
section optional string. Helps to manage internal logics, to decide values to display on some fields, like labels (recommended, most_popular, etc). Posible values checking_account, payroll_account, savings_account or without_costs, or blank for the general tab.
sort_by optional string The field that defines the order. Use suffix - to define descending order and + for ascending order. (i.e. +name). Multiple sorting values can be specified ('+name,-slug')

 Returns

Returns a list with the bank account offer objects that match specified criteria.

Retrieve bank accounts top offers

# Definition
GET https://api.kelisto.es/api/v3/finances/top_offers/bank_accounts/:bank_account_type

# Example request
$ curl https://api.kelisto.es/api/v3/finances/top_offers/bank_accounts/checking_account
# Example response

{
  "data": [
    {
      "id": 52,
      "name": "Cuenta Clara de ABANCA",
      "slug": "cuenta-clara",
      "product_name": "payroll_account",
      "product_type": "bank_account",
      "claim": "",
      "starred": false,
      "best_buy": true,
      "sponsored": true,
      "updated_at": null,
      "status": "active",
      "sponsored_order": 1,
      "description": "<p>La Cuenta Clara de Abanca es una cuenta online sin comisiones que funciona como una cuenta corriente, pero que también puede utilizarse como cuenta nómina. </p>\n\n<p>Con la <a href=\"https://www.kelisto.es/cuentas-bancarias/ofertas/cuenta-clara-abanca\">Cuenta Clara de Abanca</a> disfrutarás de una serie de <strong>ventajas</strong>: </p>\n\n<ul>\n<li>No pagarás comisiones por los servicios más habituales, como el mantenimiento y la administración de la cuenta. Además, las <strong>transferencias son gratis</strong>. </li>\n<li>Disfrutarás de una <strong>tarjeta de débito gratis</strong> (es decir, sin comisión de emisión ni mantenimiento), con la que podrás sacar dinero gratis en cualquier cajero de Abanca. Además, fuera de Galicia, tendrás cinco extracciones gratis al mes en una red de cajeros compuesta por todas las entidades de Euro 6000, Sabadell, Bankinter, Caja de Arquitectos y Caja Ingenieros.</li>\n<li>Podrás añadir un titular extra a la cuenta. </li>\n<li>Contarás con un servicio de avisos sin coste y una tarifa plana para aplazar el coste de los seguros que contrates con Abanca en 12 meses y sin intereses ni comisiones (0% TAE). </li>\n</ul>\n\n<p>Para disfrutar de todas estas ventajas, la Cuenta Clara de Abanca <strong>no te pide que domicilies tu nómina</strong> ni otro tipo de ingresos, aunque puedes hacerlo si, además de usarla como cuenta corriente, quieres utilizarla como cuenta nómina. </p>\n\n<p>Las únicas condiciones que pone Abanca para contratar su Cuenta Clara y poder disfrutar de sus <strong>beneficios</strong> son: </p>\n\n<ul>\n<li>Ser mayor de edad.</li>\n<li>Facilitar a Abanca tu teléfono móvil y tu email</li>\n<li>Estar al día de tus pagos, en caso de que tengas contratado con Abanca algún préstamo o producto de financiación. </li>\n<li>Realizar todas tus operaciones habituales a través de banca online</li>\n</ul>\n\n<p>En caso de tener que <strong>acudir a alguna sucursal de Abanca</strong>, recuerda que podrás realizar ingresos, extracciones o transferencias de menos de 600€  sin importar la cantidad. Eso sí, se lo haces durante dos meses seguidos, dejarías de tener una Cuenta Clara y pasarías a tener una Cuenta a la Vista, que sí tiene comisiones. </p>\n\n<p>En cuanto a su contratación, la Cuenta Clara de Abanca solo se puede abrir por Internet. </p>\n",
      "has_deal": true,
      "url": "https://clk.tradedoubler.com/click?p=283480&a=2924858&g=24917808",
      "checking_account": true,
      "payroll_account": true,
      "savings_account": false,
      "comments": "REGALO: si se domicilia la nómina, 300€ de regalo",
      "free_transfers": true,
      "transfers_description": "<p>La Cuenta Clara de Abanca te ofrece transferencias gratuitas, siempre que se realicen a través de banca electrónica o de forma telefónica.<br>\nAdemás cuenta con Bizum para que traspases dinero en segundos. </p>\n",
      "starred_order": null,
      "recommended": true,
      "free_featured_label": "verano",
      "free_featured_label_description": "",
      "most_popular": false,
      "obligations": {
        "salary_obligation": false,
        "min_payroll": null,
        "new_clients": true,
        "old_clients": false,
        "min_age": 18,
        "max_age": null,
        "signup_online": true,
        "signup_in_branch": true,
        "obligatory_vinculation": false,
        "receipts_vinculation": false,
        "insurances_vinculation": false,
        "card_vinculation": false,
        "use_card_vinculation": false,
        "savings_vinculation": false,
        "pension_vinculation": false,
        "invest_vinculation": false,
        "min_balance_vinculation": false,
        "vinculation_number": 0,
        "client_type": "general",
        "only_online": true,
        "cities_number": 17,
        "signup_description": "<p>Si quieres contratar la Cuenta Clara de Abanca, podrá hacerlo por teléfono o por Internet.</p>\n\n<p>Para hacerte con la Cuenta Clara de Abanca solo debes ser mayor de edad, facilitar tu teléfono móvil e e-mail a Abanca y realizar todas tus operaciones por Internet.</p>\n"
      },
      "has_cards": true,
      "card": {
        "card_obligation": false,
        "debit_card_free": true,
        "debit_card_free_period": -1,
        "credit_card_free": false,
        "credit_card_free_period": null,
        "free_atm_number": 23000,
        "atm_description": "Siempre gratis en cajeros de Abanca. En el resto de entidades asociadas, 5 disposiciones gratis al mes. ",
        "description": "<p>Al abrir la Cuenta Clara de Abanca recibirás una tarjeta de débito gratis para siempre (si tienes menos de 35 años,  también te permitirá realizar 5 retiradas al mes gratis en cajeros del extranjero)</p>\n\n<p>Con la tarjeta de débito asociada a la Cuenta Clara  tendrás extracciones gratuitas en todos los cajeros de Abanca. Si estás fuera de Galicia, también podrás sacar cinco veces al mes gratis en cajeros de la red EURO 6000, Bankia, Banco Sabadell, Bankinter y Caja de Ingenieros.</p>\n\n<p>Con las tarjetas de débito de Abanca también podrás sacar dinero gratis con el móvil en los más de 12.000 cajeros de la red Hal Cash repartido por todo el país. </p>\n"
      },
      "has_interest": false,
      "has_cost": false,
      "has_gift": true,
      "gift": {
        "gift_value": "300.0",
        "months_contract_gift": 24,
        "description": "<p>La Cuenta Clara de Abanca ofrece 300€ de regalo si decides domiciliar tu nómina. Para ello, el cliente debe cumplir varias exigencias<br>\n- Domiciliar una nómina o pensión de, al menos, 1.200€ al mes (si es de entre 800 y 1.200€, el regalo será de 150€)<br>\n- Respetar una permanencia de 24 meses<br>\n- No realizar operaciones en oficina<br>\n- Darte de alta en el servicio de e-correspondencia de Abanca<br>\n- Facilitar tu teléfono móvil e e-mail a Abanca</p>\n"
      },
      "has_reimbursement": false,
      "has_promo": true,
      "promo": {
        "started_at": null,
        "expired_at": "2022-12-31T23:01:00.000+01:00",
        "claim": "¡300€ por domiciliar tu nómina!",
        "description": "<p>La Cuenta Clara de Abanca te regala 300€ en efectivo por domiciliar tu nómina. Para ello, tendrás que cumplir con algunos requisitos:</p>\n\n<ul>\n<li><p>Domiciliar una nómina o pensión de, al menos, 1.200€ al mes (si es de entre 800 y 1.200€, el regalo será de 150€)</p></li>\n<li><p>Respetar una permanencia de 24 meses</p></li>\n<li><p>No realizar operaciones en oficina</p></li>\n<li><p>Darte de alta en el servicio de e-correspondencia de Abanca</p></li>\n<li><p>Facilitar tu teléfono móvil e e-mail a Abanca</p></li>\n</ul>\n"
      },
      "bank": {
        "id": 1,
        "name": "Abanca",
        "slug": "abanca",
        "status": "active",
        "image": {
          "url": "https://admin.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdmNLIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--d3b2cd120dc93b3958889b293a5df7f010916470/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpQ3pnd2VEZ3dYZ1k3QmxRNkRHZHlZWFpwZEhsSklndGpaVzUwWlhJR093WlVPZ2xqY205d1NTSU9PREI0T0RBck1Dc3dCanNHVkE9PSIsImV4cCI6bnVsbCwicHVyIjoidmFyaWF0aW9uIn19--87c92c14039a123855a7f8b8b1b31e0257631374/_0020_abanca-s.jpg",
          "url_square": "https://admin.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdmNLIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--d3b2cd120dc93b3958889b293a5df7f010916470/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpQ3pnd2VEZ3dYZ1k3QmxRNkRHZHlZWFpwZEhsSklndGpaVzUwWlhJR093WlVPZ2xqY205d1NTSU9PREI0T0RBck1Dc3dCanNHVkE9PSIsImV4cCI6bnVsbCwicHVyIjoidmFyaWF0aW9uIn19--87c92c14039a123855a7f8b8b1b31e0257631374/_0020_abanca-s.jpg",
          "url_rectangular": "https://admin.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdmdLIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--9f22612a15708fd6a72bc2790c8d0aca7a4a46d6/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpRERNMk5IZzVObDRHT3daVU9neG5jbUYyYVhSNVNTSUxZMlZ1ZEdWeUJqc0dWRG9KWTNKdmNFa2lEek0yTkhnNU5pc3dLekFHT3daVSIsImV4cCI6bnVsbCwicHVyIjoidmFyaWF0aW9uIn19--df9185946beb326f0006a2ed79b9cabbd69d6639/_0020_abanca-w.jpg"
        }
      },
      "ratings": {
        "rating": 8.1,
        "interest": 5,
        "costs": 10,
        "cards": 7,
        "gift_value": 10,
        "reimbursement": 0,
        "accessibility": 8
      },
      "has_review": true,
      "review": {
        "title": "La mejor cuenta corriente",
        "description": "La Cuenta Clara de Abanca es una de las mejores cuentas corrientes del mercado ya que permite hacer operaciones básicas, pero no cobra comisiones ni obliga a cumplir con ningún requisito. Por si eso fuera poco, es la única de su categoría que premia el ahorro, ya que te paga intereses por el saldo que supere los 3.000 euros. ",
        "author": {
          "name": "Estefanía Gonzalez",
          "firstname": "Estefanía",
          "lastname": "Gonzalez",
          "title": "Experta en Finanzas Personales",
          "image": {
            "url": "https://admin.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaDRCIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--527815aeff889198719f9f20d4cbbaeaefd39e59/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpzR1ZEb01aM0poZG1sMGVVa2lDMk5sYm5SbGNnWTdCbFE2Q1dOeWIzQkpJaEF5TlRCNE1qVXdLekFyTUFZN0JsUT0iLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--816bfb2b327437522dc15e6fcdffe8b5ca7b29cf/experta_estefania.jpg"
          }
        }
      }
    },
    {...}
  ]
}

Arguments

Parameter Description
bank_account_type optional string Specific bank account type. Value should be one of these: checking_account, payroll_account, savings_account or without_costs, or blank for the general tab
section optional string. Helps to manage internal logics, to decide values to display on some fields, like labels (recommended, most_popular, etc). Posible values checking_account, payroll_account, savings_account or without_costs, or blank for the general tab.

 Returns

Returns a list with 3 bank account offer objects: Bank Account offer object

# Definition
GET https://api.kelisto.es/api/v3/finances/related_offers/bank_accounts/:slug?:provider_slug&:product_name

# Example request
$ curl https://api.kelisto.es/api/v3/finances/related_offers/bank_accounts/cuenta-360?provider_slug=cajamar&product_name=payroll_account
# Example response

{
  "data": [
  {
    "id": 32,
    "name": "Cuenta de Ahorro Bienvenida con Nómina",
    "slug": "cuenta-de-ahorro-bienvenida-nomina",
    "product_name": "payroll_account",
    "product_type": "bank_account",
    "best_buy": true,
    "sponsored": false,
    "status": "inactive",
    "claim": "Remunera hasta 5.000€",
    "description": "<p>La <strong>Cuenta de Ahorro Bienvenida con Nómina de Openbank</strong> es una cuenta remunerada de la banca online de Banco Santander con la que podrás conseguir rentabilidad por tus ahorros, pero con tu dinero siempre disponible. </p>\n\n<p>La Cuenta de Ahorro Bienvenida con Nómina de Openbank es una cuenta <strong>sin comisiones</strong>: es decir, no tendrás que pagar nada por mantenimiento, ni administración, y podrás cerrarla siempre que quieras, sin tener que abonar ningún tipo de penalización. </p>\n\n<p>En lo que respecta a su <strong>rentabilidad</strong>, debes tener en cuenta que estará ligada a varios factores: el tiempo que haya transcurrido desde que contrataste la cuenta, el saldo que mantengas y las condiciones que estés dispuesto a cumplir. Partiendo de esta base, la rentabilidad que conseguirás con la Cuenta de Ahorro Bienvenida con Nómina de Openbank será de: </p>\n\n<p><strong>DURANTE LOS 12 PRIMEROS MESES</strong></p>\n\n<ul>\n<li><strong>Si cumples condiciones</strong>, es decir, si domicilias una nómina o pensión de, como mínimo, 900€/mes, recibirás un 5,12% TAE anual (5% TIN anual) para los primeros 5.000€, desde el primer día.</li>\n<li><strong>Si no cumples condiciones</strong> recibirás un 0,05% TIN anual sin importar la cantidad que tengas. </li>\n</ul>\n\n<p><strong>A PARTIR DEL SEGUNDO AÑO MES</strong></p>\n\n<ul>\n<li><strong>Si cumples condiciones</strong>, es decir, si domicilias una nómina o pensión de, como mínimo, 900€/mes, recibirás un 0,20% TIN anual.</li>\n<li><strong>Si no cumples condiciones</strong> recibirás un 0,05% TIN anual. </li>\n</ul>\n\n<p>Consulta condiciones en openbank.es </p>\n\n<p><strong>Con la confianza de un gran banco. Con el respaldo y la solvencia de Grupo Santander.</strong></p>\n",
    "updated_at": "2024-02-20T02:00:00.265+01:00",
    "created_at": "2018-12-12T13:29:11.474+01:00",
    "has_deal": false,
    "url": null,
    "checking_account": false,
    "payroll_account": true,
    "savings_account": true,
    "comments": "",
    "free_transfers": true,
    "transfers_description": null,
    "starred": false,
    "recommended": false,
    "most_popular": false,
    "free_featured_label": "",
    "free_featured_label_description": "",
    "obligations": {
      "salary_obligation": true,
      "min_payroll": 900.0,
      "new_clients": true,
      "old_clients": true,
      "min_age": null,
      "max_age": null,
      "signup_online": true,
      "signup_in_branch": true,
      "obligatory_vinculation": true,
      "receipts_vinculation": false,
      "insurances_vinculation": false,
      "card_vinculation": false,
      "use_card_vinculation": false,
      "savings_vinculation": false,
      "pension_vinculation": false,
      "invest_vinculation": false,
      "min_balance_vinculation": false,
      "vinculation_number": 1,
      "client_type": "general",
      "only_online": true,
      "cities_number": -1,
      "signup_description": "<p>Puedes contratar la Cuenta de Ahorro Bienvenida con Nómina por teléfono, por Internet o en la oficina principal de Openbank (Paseo de la Castellana, 134, Madrid).  </p>\n\n<p>Para disfrutar de la máxima remuneración que ofrece la Cuenta de Ahorro Bienvenida Con Nómina de Openbank tendrás que domiciliar una nómina mínima de 900 euros al mes y mantenerla durante, por lo menos, 6 meses. </p>\n"
    },
    "has_cards": true,
    "card": {
      "card_obligation": false,
      "without_debit_card": false,
      "debit_card_free": true,
      "debit_card_free_period": -1,
      "without_credit_card": false,
      "credit_card_free": true,
      "credit_card_free_period": -1,
      "free_atm_number": 7000,
      "atm_description": "Siempre gratis en los cajeros de Banco Santander.",
      "description": "<p>La Cuenta de Ahorro Bienvenida Con Nómina de Openbank no tiene tarjetas vinculadas. Ahora bien, debes tener en cuenta que, para poder contratar esta oferta, debes domiciliar tu nómina en una Cuenta Nómina Open de la entidad. Esta cuenta sí tiene tarjeta de débito y crédito asociadas, pero ninguna de las dos tiene coste para el primer titular.</p>\n"
    },
    "has_interest": true,
    "interests": {
      "initial_interest": "2.0",
      "initial_apr": "0.25",
      "initial_interest_period": 12,
      "followon_interest": "2.2",
      "followon_apr": "1.25",
      "followon_interest_period": 0,
      "max_amount_with_interest": "15000.0",
      "min_amount_with_interest": "0.0",
      "apr_description": "ejemplo representativo"
    },
    "has_cost": false,
    "has_gift": false,
    "has_reimbursement": false,
    "has_promo": false,
    "bank": {
      "id": 29,
      "name": "Openbank",
      "slug": "openbank",
      "status": "active",
      "background_color": "#E9004C",
      "product_types": [
        "bank_account",
        "card",
        "deposit",
        "mortgage",
        "loan"
      ],
      "product_names": {
        "bank_account": [
          "savings_account",
          "checking_account",
          "payroll_account",
          "without_costs"
        ],
        "card": [
          "debit_card",
          "credit_card",
          "wallet_card"
        ],
        "deposit": [
          "deposit"
        ],
        "mortgage": [
          "mixed_mortgage",
          "fixed_mortgage",
          "variable_mortgage",
          "remortgage"
        ],
        "loan": [
          "personal_loan"
        ]
      },
      "image": {
        "url": "https://assets.kelisto.us/e8q4h16wf3ex2ocgcta9iymxwnlm",
        "url_square": "https://assets.kelisto.us/e8q4h16wf3ex2ocgcta9iymxwnlm",
        "url_rectangular": "https://assets.kelisto.us/hs2gfmrkawh5k62tlchx02z2s5vb",
        "url_big": "https://assets.kelisto.us/ha5euvd8oatsz5wcpfb7gtznnlqn"
      }
    },
    "ratings": {
      "rating": 7.4,
      "interest": 8.1,
      "admin_cost": 8.1,
      "maintenance_cost": 8.1,
      "debit_card_free": 8.1,
      "credit_card_free": 8.1,
      "gift_value": 3.6
    },
    "risk_indicator": {
      "product_risk": "1/6",
      "linked_fund": "<p>Entidad adherida al Fondo de Garantía de Depósitos de Entidades de Crédito Español. Para depósitos en dinero, el importe máximo garantizado es de 100.000€ por depositante en cada entidad de crédito.</p>\n"
    },
    "has_review": true,
    "review": {
      "title": "",
      "description": "Con la Cuenta Ahorro Bienvenida con Nómina podrás conseguir uno de los intereses más altos del mercado, pero con dos limitaciones: deberás domiciliar tu nómina y no tener más de 5.000 euros (el dinero restante cobra un interés inferior).",
      "author": {
        "name": "Estefanía Gonzalez",
        "firstname": "Estefanía",
        "lastname": "Gonzalez",
        "title": "Experta en Finanzas Personales",
        "profile_url": "https://www.kelisto.es/autor/estefania-gonzalez",
        "image": {
          "url": "https://api.kelisto.us/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaDRCIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--204168fe9690457a2e261a455298e0fba9581086/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpzR1ZEb01aM0poZG1sMGVVa2lDMk5sYm5SbGNnWTdCbFE2Q1dOeWIzQkpJaEF5TlRCNE1qVXdLekFyTUFZN0JsUT0iLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--03e36b4905fe89451b15cece1fca45de539bf238/experta_estefania.jpg"
        }
      }
    },
    "authors": {
      "created_by": {
        "name": "Estefanía Gonzalez",
        "firstname": "Estefanía",
        "lastname": "Gonzalez",
        "title": "Experta en Finanzas Personales",
        "profile_url": "https://www.kelisto.es/autor/estefania-gonzalez",
        "image": {
          "url": "https://api.kelisto.us/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaDRCIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--204168fe9690457a2e261a455298e0fba9581086/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpzR1ZEb01aM0poZG1sMGVVa2lDMk5sYm5SbGNnWTdCbFE2Q1dOeWIzQkpJaEF5TlRCNE1qVXdLekFyTUFZN0JsUT0iLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--03e36b4905fe89451b15cece1fca45de539bf238/experta_estefania.jpg"
        }
      },
      "updated_by": {
        "name": "Estefanía Gonzalez",
        "firstname": "Estefanía",
        "lastname": "Gonzalez",
        "title": "Experta en Finanzas Personales",
        "profile_url": "https://www.kelisto.es/autor/estefania-gonzalez",
        "image": {
          "url": "https://api.kelisto.us/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaDRCIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--204168fe9690457a2e261a455298e0fba9581086/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpzR1ZEb01aM0poZG1sMGVVa2lDMk5sYm5SbGNnWTdCbFE2Q1dOeWIzQkpJaEF5TlRCNE1qVXdLekFyTUFZN0JsUT0iLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--03e36b4905fe89451b15cece1fca45de539bf238/experta_estefania.jpg"
        }
      }
    }
  },
    { ## Another bank account offer },
    { ## Another bank account offer }
  ]
}

Arguments

Parameter Description
slug Required string The slug of the offer which we need to retrieve their related offers.
provider_slug Required string The slug of the bank.
product_name Required string The product name of the offer which we need to retrieve their related offers (as part of the url).
limit optional string Number of related offers to retrieve Default/Max: 3.

 Returns

Returns a list of bank account offer objects.

List bank account multiproduct

# Definition
GET https://api.kelisto.es/api/v3/finances/multiproduct/:bank_slug/bank_accounts/

# Example request
$ curl https://api.kelisto.es/api/v3/finances/multiproduct/bbva/bank_accounts/
{
  "data": {
    "id": 13,
    "name": "BBVA",
    "slug": "bbva",
    "status": "active",
    "image": {
      "url": "https://admin.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcXdDIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--60f4286f3d6c2355904cae99cb7d10e5c7a02bf1/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--cb96773ecffd0ce7be38522cdfdd1bf61a714422/Logo%20(1).jpg",
      "url_square": "https://admin.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcXdDIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--60f4286f3d6c2355904cae99cb7d10e5c7a02bf1/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--cb96773ecffd0ce7be38522cdfdd1bf61a714422/Logo%20(1).jpg",
      "url_rectangular": "https://admin.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcTRDIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--44951db2086a139c92962b7eefa81a17e14540f9/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRERNMk5IZzVObDRHT2daRlZEb01aM0poZG1sMGVVa2lDMk5sYm5SbGNnWTdCMVE2Q1dOeWIzQkpJZzh6TmpSNE9UWXJNQ3N3QmpzSFZBPT0iLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--63e6e5ed3e0719b70531c8f01c9e7401a8c77e54/bbvanew-w-min.jpg"
    },
    "product_names": [
      "checking_account",
      "payroll_account",
      "without_costs"
    ],
    "products": [
      {
        "product_name": "checking_account",
        "offers": [
          { ## bank account offer },
          { ## bank account offer }
        ]
      },
      {
        "product_name": "payroll_account",
        "offers": [
          { ## bank account offer },
          { ## bank account offer }
        ]
      },
      {
        "product_name": "without_costs",
        "offers": [
          { ## bank account offer },
          { ## bank account offer }
        ]
      }
    ]
  }
}

Arguments

Parameter Description
bank_slug Required string The slug of the provider to retrieve.

 Returns

Returns a bunch of bank accounts objects grouped by their product_names. The actual posible groups are: checking_account, payroll_account, savings_account and without_costs.

Banks

The bank object

Attributes

# Example object

{
  "id": 7,
  "name": "Banco Popular",
  "slug": "banco-popular",
  "status": "acquired",
  "product_types": [
    "bank_account",
    "card",
    "mortgage",
    "loan"
  ],
  "image": {
    "url": "https://admin.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBZEU9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--e91df87e610650b32c726577783c66e1777adcf8/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--5c21d2c8d7b8ee99f78f00fcc4fc823d68c0fddd/banco-popular-s.jpg",
    "url_square": "https://admin.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBZEU9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--e91df87e610650b32c726577783c66e1777adcf8/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--5c21d2c8d7b8ee99f78f00fcc4fc823d68c0fddd/banco-popular-s.jpg",
    "url_rectangular": "https://admin.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBZEk9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--24829590dcae3ee4419dbe17ff503cb70653aa8a/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRERNMk5IZzVObDRHT2daRlZEb01aM0poZG1sMGVVa2lDMk5sYm5SbGNnWTdCMVE2Q1dOeWIzQkpJZzh6TmpSNE9UWXJNQ3N3QmpzSFZBPT0iLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--783036a5e2330c32c5d4f12339ec42bef9849156/banco-popular-w.jpg"
  },
  "acquisitor_bank": {
    "id": 8,
    "name": "Banco Santander",
    "slug": "banco-santander",
    "status": "active",
    "image": {
      "url": "https://admin.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBZE09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--d4024536ef4e54f17753ab35f27489b7d76bec08/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--5c21d2c8d7b8ee99f78f00fcc4fc823d68c0fddd/banco-santander-s.jpg",
      "url_square": "https://admin.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBZE09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--d4024536ef4e54f17753ab35f27489b7d76bec08/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--5c21d2c8d7b8ee99f78f00fcc4fc823d68c0fddd/banco-santander-s.jpg",
      "url_rectangular": "https://admin.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBZFE9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--3141ecb41f40dbb1d09e88712add143af3c754ea/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRERNMk5IZzVObDRHT2daRlZEb01aM0poZG1sMGVVa2lDMk5sYm5SbGNnWTdCMVE2Q1dOeWIzQkpJZzh6TmpSNE9UWXJNQ3N3QmpzSFZBPT0iLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--783036a5e2330c32c5d4f12339ec42bef9849156/banco-santander-w.jpg"
    }
  }
}
Attribute Description
id integer Unique identifier for the resource.
name string Bank name.
slug string Bank slug.
status string Bank status.
product_types string Product types for which the bank has active offers. Can include bank_account, card, mortgage, deposit and loan. It will only appear when the argument with_product_types is true and you are retrieving a bank.
image hash Image object.
acquisitor_bank string Will only appear when the status of the initial bank is acquired and will show you the object of the acquiring bank.

Retrieve a bank

# Definition
GET https://api.kelisto.es/api/v3/finances/banks/:slug?:with_product_types

# Example request
$ curl https://api.kelisto.es/api/v3/finances/banks/banco-mediolanum?with_product_types=true
# Example response

{
  "data": {
    "id": 5,
    "name": "Banco Mediolanum",
    "slug": "banco-mediolanum",
    "status": "active",
    "product_types": [
      "bank_account",
      "card",
      "mortgage",
      "loan"
    ],
    "image": {
      "url": "https://api.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBYzA9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--1bca8c03b3ada83171f47daf0924e389b5c11fa1/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--e4438123782b514c5dd2c7ccc53000c045a02e84/banco-mediolanum-s.jpg",
      "url_square": "https://api.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBYzA9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--1bca8c03b3ada83171f47daf0924e389b5c11fa1/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--e4438123782b514c5dd2c7ccc53000c045a02e84/banco-mediolanum-s.jpg",
      "url_rectangular": "https://api.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBYzQ9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--006b80a619c2253241139317d0c020a95205ba6e/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRERNMk5IZzVObDRHT2daRlZEb01aM0poZG1sMGVVa2lDMk5sYm5SbGNnWTdCMVE2Q1dOeWIzQkpJZzh6TmpSNE9UWXJNQ3N3QmpzSFZBPT0iLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--145c204ed502b2f8bd6b1400501ac239797de85e/banco-mediolanum-w.jpg"
    }
  }
}

Arguments

Parameter Description
slug Required string The slug of the provider to retrieve.
with_product_types Optional boolean List the product type of the bank. It will only show the product_types field when the value is true.
product_name Optional Product name for which the bank has active offers. Can include savings_account, payroll_account, checking_account or without_costs.

List banks

# Definition
GET https://api.kelisto.es/api/v3/finances/banks?<criteria>

# Example request
$ curl https://api.kelisto.es/api/v3/finances/banks?status=active&sort_by=+name
# Example response
{
  "pagination": {
    "links": {
      "first": "https://api.kelisto.dev/api/v3/finances/banks?status=active&page=1",
      "next": "https://api.kelisto.dev/api/v3/finances/banks?status=active&page=2",
      "last": "https://api.kelisto.dev/api/v3/finances/banks?status=active&page=4"
    },
    "current_page": 1,
    "page_items": 25,
    "total_count": 77,
    "total_pages": 4
  },
  "data": [
    {
      "id": 5,
      "name": "Banco Mediolanum",
      "slug": "banco-mediolanum",
      "status": "active",
      "image": {
        "url": "https://api.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBYzA9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--1bca8c03b3ada83171f47daf0924e389b5c11fa1/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--e4438123782b514c5dd2c7ccc53000c045a02e84/banco-mediolanum-s.jpg",
        "url_square": "https://api.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBYzA9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--1bca8c03b3ada83171f47daf0924e389b5c11fa1/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--e4438123782b514c5dd2c7ccc53000c045a02e84/banco-mediolanum-s.jpg",
        "url_rectangular": "https://api.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBYzQ9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--006b80a619c2253241139317d0c020a95205ba6e/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRERNMk5IZzVObDRHT2daRlZEb01aM0poZG1sMGVVa2lDMk5sYm5SbGNnWTdCMVE2Q1dOeWIzQkpJZzh6TmpSNE9UWXJNQ3N3QmpzSFZBPT0iLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--145c204ed502b2f8bd6b1400501ac239797de85e/banco-mediolanum-w.jpg"
      }
    },
    # bank object matching criteria,
    # bank object matching criteria,
    # bank object matching criteria,
    # ...
  ]
}

Arguments

Parameter Description
status optional string The status of the bank. Values can be active, inactive or discontinue.
product_type optional string - Retrieves banks with specific product type offers. Value should be one of these: mortgage, loan, bank_account, deposit or card.
has_deal Optional boolean Combined with previous product_type will check offers with deal (banks without deal will be excluded)
sort_by optional string The field that defines the order. Use suffix - to define descending order and + for ascending order. (i.e. +name). Multiple sorting values can be specified ('+name,-slug')

 Returns

Returns a list with the bank objects that match specified criteria.

Finances related objects

Some API requests returns related objects depending of offer type.

The finances rating object

the finances rating objects have a common rating attribute, and a bunch of attributes that usually are differen for each kind of product_type, ie, for deposits, mortgages, loans, cards or bank_accounts and for related mortgage_terms. The first one,rating` attribute is calculated based on the value of the other given attributes.

Attributes

# Example object for the deposit offers

{
  "rating": 7.9,
  "interest": 7,
  "max_amount": 4,
  "min_amount": 10,
  "partial_cancellation": 10,
  "other_cancellation": 10
}
Attribute Description
rating float Global offer rating. This value is calculated based on the value given to the other attributes.
interest integer Rating based on the interest.
max_amount integer Rating based on the max amount.
min_amount integer Rating based on the min amount.
partial_cancellation integer Rating based on the conditions of partial cancellation.
other_cancellation integer Rating based on the conditions of other types of cancellation.
other_rating_attribute integer Rating based on the conditions defined by the finances Product Team based on the particularities of the product_types, the name of theses attributes differs from one product_type to others.

 API Insurances

Provider insurance

The provider insurance object

Attributes

# Example object
{
  "id": 4,
  "name": "Mapfre",
  "slug": "mapfre",
  "status": "active",
  "phone_number": null,
  "image": {
    "url": "https://assets.kelisto.us/ds1umbh4zmr7foojts3qy56ex7eo"
  },
  "colors": {
    "brand": "#d70812"
  },
  "product_types": [
    "car",
    "moto",
    "home",
    "life"
  ]
}
Attribute Description
id integer Unique identifier for the resource.
name string provider name.
slug string provider slug.
status string Status of the offer. Can be active, inactive or discontinue.
phone_number string provider's phone number.
image hash providers' logo.
colors hash providers' corporative colors.
product_types string Product types for which the provider has available multiproduct pages. Can include car, moto, home, life, health, death.

Multiproduct provider insurance offers list request

# Definition
GET https://api.kelisto.es/api/v3/insurances/multiproduct/:provider_slug

# Example request
$ curl https://api.kelisto.es/api/v3/insurances/multiproduct/axa
# Example response

{
  "data": {
    "id": 2,
    "name": "Axa",
    "slug": "axa",
    "status": "active",
    "image": {
    "url": "https://assets.kelisto.es/m4oppbeb6w63zrhyw9ctxuw718c6"
  },
  "colors": {
    "brand": "#00008f"
  },
  "product_types": [
  "car",
  "moto",
  "home",
  "life"
  ]
}

Arguments

Parameter Description
provider_slug URL segment string Insurance provider slug.

Car offers

Multiproduct cars list request

# Definition
GET https://api.kelisto.es/api/v3/insurances/multiproduct/:provider_slug/car

# Example request
$ curl https://api.kelisto.es/api/v3/insurances/multiproduct/axa/car
# Example response

  {
    "data": {
      "id": 2,
      "name": "Axa",
      "slug": "axa",
      "status": "active",
      "image": {
      "url": "https://assets.kelisto.es/m4oppbeb6w63zrhyw9ctxuw718c6"
    },
    "colors": {
      "brand": "#00008f"
    },
    "products": [
      {
        "product_name": "third_party_only",
        "offers": [
          {
            "id": 5,
            "name": "Seguro a terceros de Axa",
            "slug": "seguro-a-terceros-de-axa",
            "product_name": "third_party_only",
            "product_type": "car_insurance",
            "updated_at": "2023-12-20T08:38:29.304+01:00",
            "status": "active",
            "min_price": "140.0",
            "profile_price": null,
            "provider": {
              "id": 2,
              "name": "Axa",
              "slug": "axa",
              "status": "active",
              "image": {
                "url": "https://assets.kelisto.es/m4oppbeb6w63zrhyw9ctxuw718c6"
              },
              "colors": {
                "brand": "#00008f"
              }
            },
            "coverages": [
              {
                "type": "lunas_robo_e_incendio",
                "available": true
              },
              {
                "type": "danos_propios",
                "available": false
              },
              {
                "type": "asistencia_en_viaje_completa",
                "available": true
              },
              {
                "type": "libre_eleccion_de_taller",
                "available": true
              },
              {
                "type": "vehiculo_de_sustitucion",
                "available": false
              }
            ]
         }
       ]
     },
    {
      "product_name": "third_party_fire_and_theft",
      "offers": [
      {
        "id": 6,
        "name": "Seguro a terceros ampliado de Axa",
        "slug": "seguro-a-terceros-ampliado-de-axa",
        "product_name": "third_party_fire_and_theft",
        "product_type": "car_insurance",
        "updated_at": "2023-12-20T08:38:29.319+01:00",
        "status": "active",
        "min_price": "152.0",
        "profile_price": null,
        "provider": {
          "id": 2,
          "name": "Axa",
          "slug": "axa",
          "status": "active",
          "image": {
            "url": "https://assets.kelisto.es/m4oppbeb6w63zrhyw9ctxuw718c6"
          },
          "colors": {
            "brand": "#00008f"
          }
        },
        "coverages": [
          {
            "type": "lunas_robo_e_incendio",
            "available": true
          },
          {
            "type": "danos_propios",
            "available": false
          },
          {
            "type": "asistencia_en_viaje_completa",
            "available": true
          },
          {
            "type": "libre_eleccion_de_taller",
            "available": true
          },
          {
            "type": "vehiculo_de_sustitucion",
            "available": false
          }
        ]
      }
    ]
  },
    {
      "product_name": "comprehensive_with_excess",
      "offers": [
        {
          "id": 7,
          "name": "Seguro todo riesgo con franquicia de Axa",
          "slug": "seguro-todo-riesgo-con-franquicia-de-axa",
          "product_name": "comprehensive_with_excess",
          "product_type": "car_insurance",
          "updated_at": "2023-12-20T08:38:29.326+01:00",
          "status": "active",
          "min_price": "198.0",
          "profile_price": null,
          "excess": 3000,
          "provider": {
            "id": 2,
            "name": "Axa",
            "slug": "axa",
            "status": "active",
            "image": {
              "url": "https://assets.kelisto.es/m4oppbeb6w63zrhyw9ctxuw718c6"
            },
            "colors": {
              "brand": "#00008f"
            }
          },
          "coverages": [
            {
              "type": "lunas_robo_e_incendio",
              "available": true
            },
            {
              "type": "danos_propios",
              "available": true
            },
            {
              "type": "asistencia_en_viaje_completa",
              "available": true
            },
            {
              "type": "libre_eleccion_de_taller",
              "available": true
            },
            {
              "type": "vehiculo_de_sustitucion",
              "available": false
            }
          ]
        }
      ]
    },
    {
      "product_name": "comprehensive_0_excess",
      "offers": [
        {
          "id": 8,
          "name": "Seguro todo riesgo completo de Axa",
          "slug": "seguro-todo-riesgo-completo-de-axa",
          "product_name": "comprehensive_0_excess",
          "product_type": "car_insurance",
          "updated_at": "2023-12-20T08:38:29.333+01:00",
          "status": "active",
          "min_price": "433.0",
          "profile_price": null,
          "provider": {
            "id": 2,
            "name": "Axa",
            "slug": "axa",
            "status": "active",
            "image": {
              "url": "https://assets.kelisto.es/m4oppbeb6w63zrhyw9ctxuw718c6"
            },
            "colors": {
              "brand": "#00008f"
            }
          },
          "coverages": [
            {
              "type": "lunas_robo_e_incendio",
              "available": true
            },
            {
              "type": "danos_propios",
              "available": true
            },
            {
              "type": "asistencia_en_viaje_completa",
              "available": true
            },
            {
              "type": "libre_eleccion_de_taller",
              "available": true
            },
            {
              "type": "vehiculo_de_sustitucion",
              "available": false
            }
          ]
        }
      ]
    }
  }

Arguments

Parameter Description
provider_slug URL segment string Insurance provider slug.

Moto offers

Multiproduct moto list request

# Definition
GET https://api.kelisto.es/api/v3/insurances/multiproduct/:provider_slug/moto

# Example request
$ curl https://api.kelisto.es/api/v3/insurances/multiproduct/axa/moto
# Example response

  {
    "data": {
      "id": 2,
      "name": "Axa",
      "slug": "axa",
      "status": "active",
      "image": {
      "url": "https://assets.kelisto.es/m4oppbeb6w63zrhyw9ctxuw718c6"
    },
    "colors": {
      "brand": "#00008f"
    },
    "products": []
    }
  }

Arguments

Parameter Description
provider_slug URL segment string Insurance provider slug.

Health offers

List all health offers

# Definition
GET https://api.kelisto.es/api/v3/insurances/offers/health?<criteria>

# Example request
$ curl https://api.kelisto.es/api/v3/insurances/offers/health?sort_by=+price
# Example response

{
    "pagination": {
        "links": {
            "first": "https://admin.kelisto.dev/api/v3/insurances/offers/healths?apikey=e315aea65e846c13f9b711ca99475ab5&page=1",
            "last": "https://admin.kelisto.dev/api/v3/insurances/offers/healths?apikey=e315aea65e846c13f9b711ca99475ab5&page=1"
        },
        "current_page": "1",
        "page_items": "25",
        "total_count": "3",
        "total_pages": "1"
    },
    "data": [
    {
      "id": 1,
      "name": "El seguro de salud",
      "slug": "el-seguro-de-salud-2",
      "product_name": "health_copayment",
      "product_type": "health",
      "updated_at": "2024-02-16T14:08:13.929+01:00",
      "status": "active",
      "claim": null,
      "copayment": "low",
      "dental_insurance": "basic",
      "hospitalization": "full",
      "monthly_price": 29.99,
      "physiotherapy": false,
      "reimbursement": null,
      "starred": false,
      "starred_order": null,
      "video_chat": false,
      "has_deal": false,
      "url": null,
      "has_promo": false,
    },
    {
      "id": 2,
      "name": "El seguro de salud",
      "slug": "el-seguro-de-salud-4",
      "product_name": "health_without_hospitalization",
      "product_type": "health",
      "updated_at": "2024-02-16T14:08:13.929+01:00",
      "status": "active",
      "claim": null,
      "copayment": "low",
      "dental_insurance": "basic",
      "hospitalization": "full",
      "monthly_price": 29.99,
      "physiotherapy": false,
      "reimbursement": null,
      "starred": false,
      "starred_order": null,
      "video_chat": false,
      "has_deal": false,
      "url": null,
      "has_promo": true,
      "promo": {
        "starts_at": null,
        "expires_at": "2020-01-31T23:59:00.000+01:00",
        "claim": "¡Instalación y router gratis!",
      },
    }
  ]
}

Arguments

Parameter Description
providers optional string Insurances providers' slugs. . Eg: providers=axa; providers=axa,reale.
status optional string Offers status to retrive (active, inactive, snapshot or discontinue). Default: active.
product_name optional string Retrieve offers by product name (health_without_hospitalization health_copayment health_without_copayment health_reimbursement). Support multiple product_names. Eg: product_name=health_copayment, product_name=health_copayment,health_reimbursement.
dental_insurance optional string Offers by dental insurance type (no basic full).
copayment optional stringOffers by dental copayment type (no low medium high).
sort_by optional string The field that defines the order. Use suffix - to define descending order and + for ascending order. (i.e. +monthly_price). You can also specify multiple sorting values.

Multiproduct health list request

# Definition
GET https://api.kelisto.es/api/v3/insurances/multiproduct/:provider_slug/health

# Example request
$ curl https://api.kelisto.es/api/v3/insurances/multiproduct/axa/health
# Example response

  {
    "data": {
      "id": 2,
      "name": "Axa",
      "slug": "axa",
      "status": "active",
      "image": {
      "url": "https://assets.kelisto.es/m4oppbeb6w63zrhyw9ctxuw718c6"
    },
    "colors": {
      "brand": "#00008f"
    },
    "products": [
      {
        "product_name": "health_copayment",
        "offers": [
          {
            "id": 1,
            "name": "El seguro de salud",
            "slug": "el-seguro-de-salud-2",
            "product_name": "health_copayment",
            "product_type": "health",
            "updated_at": "2024-02-16T14:08:13.929+01:00",
            "status": "active",
            "claim": null,
            "copayment": "low",
            "dental_insurance": "basic",
            "hospitalization": "full",
            "monthly_price": 29.99,
            "physiotherapy": false,
            "reimbursement": null,
            "starred": false,
            "starred_order": null,
            "video_chat": false,
            "has_deal": false,
            "url": null,
            "has_promo": false,
         }
       ]
     },
    {
      "product_name": "health_without_hospitalization",
      "offers": [
        {
          "id": 2,
          "name": "El seguro de salud",
          "slug": "el-seguro-de-salud-4",
          "product_name": "health_without_hospitalization",
          "product_type": "health",
          "updated_at": "2024-02-16T14:08:13.929+01:00",
          "status": "active",
          "claim": null,
          "copayment": "low",
          "dental_insurance": "basic",
          "hospitalization": "full",
          "monthly_price": 29.99,
          "physiotherapy": false,
          "reimbursement": null,
          "starred": false,
          "starred_order": null,
          "video_chat": false,
          "has_deal": false,
          "url": null,
          "has_promo": true,
          "promo": {
            "starts_at": null,
            "expires_at": "2020-01-31T23:59:00.000+01:00",
            "claim": "¡Instalación y router gratis!",
          },
        }
      ]
    },
  }

Arguments

Parameter Description
provider_slug URL segment string Insurance provider slug.

Death offers

List all death offers

# Definition
GET https://api.kelisto.es/api/v3/insurances/offers/death?<criteria>

# Example request
$ curl https://api.kelisto.es/api/v3/insurances/offers/death?
# Example response

{
  "pagination": {
    "links": {
      "first": "https://admin.kelisto.us/api/v3/insurances/offers/deaths?apikey=e315aea65e846c13f9b711ca99475ab5&page=1",
      "last": "https://admin.kelisto.us/api/v3/insurances/offers/deaths?apikey=e315aea65e846c13f9b711ca99475ab5&page=1"
    },
    "current_page": "1",
    "page_items": "25",
    "total_count": "10",
    "total_pages": "1"
  },
  "data": [
    {
      "id": 1,
      "name": "Decesos Dolores voluptatem est ullam.",
      "slug": "decesos-dolores-voluptatem-est-ullam",
      "product_name": "death_decease",
      "product_type": "death",
      "updated_at": "2024-02-26T09:08:51.449+01:00",
      "status": "active",
      "claim": null,
      "administrative_paperwork": false,
      "body_relocation": false,
      "annual_price": 29,
      "online_testament": false,
      "psychological_care": false,
      "starred": false,
      "starred_order": null,
      "has_deal": false,
      "url": null,
      "has_promo": false,
      "provider": {
        "id": 4,
        "name": "Mapfre",
        "slug": "mapfre",
        "status": "active",
        "phone_number": null,
        "image": {
          "url": "https://assets.kelisto.us/ds1umbh4zmr7foojts3qy56ex7eo"
        },
        "colors": {
          "brand": "#d70812"
        }
      }
    }, ...
  ]
}

Arguments

Parameter Description
providers optional string Insurances providers' slugs. . Eg: providers=cleverea; providers=cleverea,reale.
status optional string Offers status to retrive (active, inactive, snapshot or discontinue). Default: active.
product_name optional string Retrieve offers by product name (death_decease).
sort_by optional string The field that defines the order. Use suffix - to define descending order and + for ascending order. (i.e.+annual_price).

You can also specify multiple sorting values.

Multiproduct death list request

# Definition
GET https://api.kelisto.es/api/v3/insurances/multiproduct/:provider_slug/death

# Example request
$ curl https://api.kelisto.es/api/v3/insurances/multiproduct/cleverea/death
# Example response

{
  "data": {
    "id": 9,
    "name": "Cleverea",
    "slug": "cleverea",
    "status": "active",
    "phone_number": null,
    "image": {
      "url": "https://assets.kelisto.us/fx0lkziao9ztyvptukf7vzt6g76i"
    },
    "colors": {
      "brand": "#46e19d"
    },
    "products": [
      {
        "product_name": "death_decease",
        "offers": [
          {
            "id": 10,
            "name": "Decesos Officiis consequatur voluptas nihil.",
            "slug": "decesos-officiis-consequatur-voluptas-nihil",
            "product_name": "death_decease",
            "product_type": "death",
            "updated_at": "2024-02-26T09:08:51.564+01:00",
            "status": "active",
            "claim": null,
            "administrative_paperwork": false,
            "body_relocation": false,
            "annual_price": 29,
            "online_testament": false,
            "psychological_care": false,
            "starred": false,
            "starred_order": null,
            "has_deal": false,
            "url": null,
            "has_promo": false,
            "provider": {
              "id": 9,
              "name": "Cleverea",
              "slug": "cleverea",
              "status": "active",
              "phone_number": null,
              "image": {
                "url": "https://assets.kelisto.us/fx0lkziao9ztyvptukf7vzt6g76i"
              },
              "colors": {
                "brand": "#46e19d"
              }
            }
          }
        ]
      }
    ]
  }
}

Arguments

Parameter Description
provider_slug URL segment string Insurance provider slug.

Life offers

List all life offers

# Definition
GET https://api.kelisto.es/api/v3/insurances/offers/life?<criteria>

# Example request
$ curl https://api.kelisto.es/api/v3/insurances/offers/life?
# Example response

{
  "pagination": {
    "links": {
      "first": "https://admin.kelisto.us/api/v3/insurances/offers/lifes?apikey=e315aea65e846c13f9b711ca99475ab5&page=1",
      "last": "https://admin.kelisto.us/api/v3/insurances/offers/lifes?apikey=e315aea65e846c13f9b711ca99475ab5&page=1"
    },
    "current_page": "1",
    "page_items": "25",
    "total_count": "20",
    "total_pages": "1"
  },
  "data": [
    {
      "id": 1,
      "name": "Fallecimiento Ducimus voluptatem recusandae voluptatem.",
      "slug": "fallecimiento-ducimus-voluptatem-recusandae-voluptatem",
      "product_name": "life_decease",
      "product_type": "life",
      "updated_at": "2024-02-26T09:08:45.800+01:00",
      "status": "active",
      "claim": null,
      "administrative_paperwork": false,
      "advance_payment": false,
      "annual_price": 100,
      "max_renewal_age": 70,
      "online_testament": false,
      "permanent_disability": false,
      "starred": false,
      "starred_order": null,
      "has_deal": false,
      "url": null,
      "has_promo": false,
      "provider": {
        "id": 11,
        "name": "Verti",
        "slug": "verti",
        "status": "active",
        "phone_number": null,
        "image": {
          "url": "https://assets.kelisto.us/d4g5jc1v1oyezjyzh67oeezg0dc0"
        },
        "colors": {
          "brand": "#f25004"
        }
      }
    },
  ]
}

Arguments

Parameter Description
providers optional string Insurances providers' slugs. . Eg: providers=axa; providers=axa,reale.
status optional string Offers status to retrive (active, inactive, snapshot or discontinue). Default: active.
product_name optional string Retrieve offers by product name (life_decease life_disability). Support multiple product_names. Eg: product_name=life_disability, product_name=life_disability,life_decease.
sort_by optional string The field that defines the order. Use suffix - to define descending order and + for ascending order. (i.e. +annual_price). You can also specify multiple sorting values.

Multiproduct life list request

# Definition
GET https://api.kelisto.es/api/v3/insurances/multiproduct/:provider_slug/life

# Example request
$ curl https://api.kelisto.es/api/v3/insurances/multiproduct/cleverea/life
# Example response

{
  "data": {
    "id": 9,
    "name": "Cleverea",
    "slug": "cleverea",
    "status": "active",
    "phone_number": null,
    "image": {
      "url": "https://assets.kelisto.us/fx0lkziao9ztyvptukf7vzt6g76i"
    },
    "colors": {
      "brand": "#46e19d"
    },
    "products": [
      {
        "product_name": "life_decease",
        "offers": [
          {
            "id": 10,
            "name": "Fallecimiento Tempore sunt porro et.",
            "slug": "fallecimiento-tempore-sunt-porro-et",
            "product_name": "life_decease",
            "product_type": "life",
            "updated_at": "2024-02-26T09:08:45.905+01:00",
            "status": "active",
            "claim": null,
            "administrative_paperwork": false,
            "advance_payment": false,
            "annual_price": 226,
            "max_renewal_age": 70,
            "online_testament": false,
            "permanent_disability": false,
            "starred": false,
            "starred_order": null,
            "has_deal": false,
            "url": null,
            "has_promo": false,
            "provider": {
              "id": 9,
              "name": "Cleverea",
              "slug": "cleverea",
              "status": "active",
              "phone_number": null,
              "image": {
                "url": "https://assets.kelisto.us/fx0lkziao9ztyvptukf7vzt6g76i"
              },
              "colors": {
                "brand": "#46e19d"
              }
            }
          }
        ]
      },
      {
        "product_name": "life_disability",
        "offers": [
          {
            "id": 16,
            "name": "Con incapacidad Velit officia quisquam modi.",
            "slug": "con-incapacidad-velit-officia-quisquam-modi",
            "product_name": "life_disability",
            "product_type": "life",
            "updated_at": "2024-02-26T09:08:45.966+01:00",
            "status": "active",
            "claim": null,
            "administrative_paperwork": false,
            "advance_payment": false,
            "annual_price": 134,
            "max_renewal_age": 60,
            "online_testament": false,
            "permanent_disability": true,
            "starred": false,
            "starred_order": null,
            "has_deal": false,
            "url": null,
            "has_promo": false,
            "provider": {
              "id": 9,
              "name": "Cleverea",
              "slug": "cleverea",
              "status": "active",
              "phone_number": null,
              "image": {
                "url": "https://assets.kelisto.us/fx0lkziao9ztyvptukf7vzt6g76i"
              },
              "colors": {
                "brand": "#46e19d"
              }
            }
          }
        ]
      }
    ]
  }
}

Arguments

Parameter Description
provider_slug URL segment string Insurance provider slug.

Home offers

List all home offers

# Definition
GET https://api.kelisto.es/api/v3/insurances/offers/home?<criteria>

# Example request
$ curl https://api.kelisto.es/api/v3/insurances/offers/home
# Example response

{
  "pagination": {
    "links": {
      "first": "https://admin.kelisto.dev/api/v3/insurances/offers/homes?page=1",
      "last": "https://admin.kelisto.dev/api/v3/insurances/offers/homes?page=1"
    },
    "current_page": "1",
    "page_items": "25",
    "total_count": "2",
    "total_pages": "1"
  },
  "data": [
    {
      "id": 1,
      "name": "Seguros de hogar de mapfre",
      "slug": "seguros-de-hogar-mapfre",
      "product_name": "home_high",
      "product_type": "home",
      "updated_at": "2024-04-02T12:49:24.472+02:00",
      "status": "active",
      "claim": "",
      "annual_price": 800,
      "starred": false,
      "starred_order": null,
      "civil_liability": 100,
      "fire_protection": true,
      "theft": 300,
      "handyman_services": 3,
      "mugging_street": 500,
      "all_risks": 500,
      "has_deal": false,
      "url": null,
      "has_promo": false,
      "provider": {
        "id": 4,
        "name": "Mapfre",
        "slug": "mapfre",
        "status": "active",
        "phone_number": null,
        "image": {
          "url": "https://admin.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdHNYIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--28d6cfcbd26609f3636dec6a01f004f7f1d45c88/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJY0c1bkJqb0dSVlE2QzNKbGMybDZaVWtpRFRFeE1uZ3hNVEplQmpzR1ZEb01aM0poZG1sMGVVa2lDMk5sYm5SbGNnWTdCbFE2Q1dOeWIzQkpJaEF4TVRKNE1URXlLekFyTUFZN0JsUT0iLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--795d6b2be6afb9976ffa954391a95af0ce0a5d94/provider.png"
        },
        "colors": {
          "brand": "#CCCCCC"
        },
        "product_types": [
          "car",
          "motorcycle",
          "home",
          "life"
        ]
      }
    },
    {
      "id": 2,
      "name": "Seguros de hogar Axa",
      "slug": "seguros-de-hogar-axa",
      "product_name": "home_medium",
      "product_type": "home",
      "updated_at": "2024-04-03T12:45:03.889+02:00",
      "status": "active",
      "claim": "",
      "annual_price": 680,
      "starred": true,
      "starred_order": 1,
      "civil_liability": 200,
      "fire_protection": true,
      "theft": 150,
      "handyman_services": 2,
      "mugging_street": 100,
      "all_risks": null,
      "has_deal": false,
      "url": null,
      "has_promo": false,
      "provider": {
        "id": 2,
        "name": "Axa",
        "slug": "axa",
        "status": "active",
        "phone_number": null,
        "image": {
          "url": "https://admin.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdGtYIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--1f936b25eb3bb5a487b598bec8d358147d850069/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJY0c1bkJqb0dSVlE2QzNKbGMybDZaVWtpRFRFeE1uZ3hNVEplQmpzR1ZEb01aM0poZG1sMGVVa2lDMk5sYm5SbGNnWTdCbFE2Q1dOeWIzQkpJaEF4TVRKNE1URXlLekFyTUFZN0JsUT0iLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--795d6b2be6afb9976ffa954391a95af0ce0a5d94/provider.png"
        },
        "colors": {
          "brand": "#CCCCCC"
        },
        "product_types": [
          "car",
          "motorcycle"
        ]
      }
    }
  ],
  "filters": {
    "available_providers": [
      {
        "name": "Axa",
        "slug": "axa"
      },
      {
        "name": "Mapfre",
        "slug": "mapfre"
      }
    ]
  }
}

Arguments

Parameter Description
providers optional string Insurances providers' slugs. . Eg: providers=axa; providers=axa,reale.
status optional string Offers status to retrive (active, inactive, snapshot or discontinue). Default: active.
product_name optional string Retrieve offers by product name (home_basic home_medium home_high). Support multiple product_names. Eg: product_name=home_medium, product_name=home_medium,home_high.
sort_by optional string The field that defines the order. Use suffix - to define descending order and + for ascending order. (i.e. +annual_price). You can also specify multiple sorting values

Multiproduct home list request

# Definition
GET https://api.kelisto.es/api/v3/insurances/multiproduct/:provider_slug/home

# Example request
$ curl https://api.kelisto.es/api/v3/insurances/multiproduct/mapfre/home
# Example response

  {
  "data": {
    "id": 4,
    "name": "Mapfre",
    "slug": "mapfre",
    "status": "active",
    "phone_number": null,
    "image": {
      "url": "https://admin.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdHNYIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--28d6cfcbd26609f3636dec6a01f004f7f1d45c88/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJY0c1bkJqb0dSVlE2QzNKbGMybDZaVWtpRFRFeE1uZ3hNVEplQmpzR1ZEb01aM0poZG1sMGVVa2lDMk5sYm5SbGNnWTdCbFE2Q1dOeWIzQkpJaEF4TVRKNE1URXlLekFyTUFZN0JsUT0iLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--795d6b2be6afb9976ffa954391a95af0ce0a5d94/provider.png"
    },
    "colors": {
      "brand": "#CCCCCC"
    },
    "product_types": [
      "car",
      "motorcycle",
      "home",
      "life"
    ],
    "products": [
      {
        "product_name": "home_high",
        "offers": [
          {
            "id": 1,
            "name": "Seguros de hogar de mapfre",
            "slug": "seguros-de-hogar-mapfre",
            "product_name": "home_high",
            "product_type": "home",
            "updated_at": "2024-04-02T12:49:24.472+02:00",
            "status": "active",
            "claim": "",
            "annual_price": 800,
            "starred": false,
            "starred_order": null,
            "civil_liability": 100,
            "fire_protection": true,
            "theft": 300,
            "handyman_services": 3,
            "mugging_street": 500,
            "all_risks": 500,
            "has_deal": false,
            "url": null,
            "has_promo": false,
            "provider": {
              "id": 4,
              "name": "Mapfre",
              "slug": "mapfre",
              "status": "active",
              "phone_number": null,
              "image": {
                "url": "https://admin.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdHNYIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--28d6cfcbd26609f3636dec6a01f004f7f1d45c88/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDVG9MWm05eWJXRjBTU0lJY0c1bkJqb0dSVlE2QzNKbGMybDZaVWtpRFRFeE1uZ3hNVEplQmpzR1ZEb01aM0poZG1sMGVVa2lDMk5sYm5SbGNnWTdCbFE2Q1dOeWIzQkpJaEF4TVRKNE1URXlLekFyTUFZN0JsUT0iLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--795d6b2be6afb9976ffa954391a95af0ce0a5d94/provider.png"
              },
              "colors": {
                "brand": "#CCCCCC"
              },
              "product_types": [
                "car",
                "motorcycle",
                "home",
                "life"
              ]
            }
          }
        ]
      }
    ]
  }
}

Arguments

Parameter Description
provider_slug URL segment string Insurance provider slug.

 API Energy

Electricity offers

List all electricity offers

# Definition
GET https://api.kelisto.es/api/v3/energy/offers/electricity?<criteria>

# Example request
$ curl https://api.kelisto.es/api/v3/energy/offers/electricity?sort_by=+price
# Example response

{
  "pagination": {
    "links": {
      "first": "https://admin.kelisto.dev/api/v3/energy/offers/electricity?page=1",
      "next": "https://admin.kelisto.dev/api/v3/energy/offers/electricity?page=",
      "last": "https://admin.kelisto.dev/api/v3/energy/offers/electricity?page=1"
    },
    "current_page": "1",
    "page_items": "25",
    "total_count": "5",
    "total_pages": "1"
  },
  "data": [
    {
      "id": 7,
      "name": "Energya VM",
      "slug": "energia_vm",
      "updated_at": "2024-10-08T14:01:43.710+02:00",
      "status": "active",
      "energy_type": "electricity",
      "claim": "",
      "electricity_type": "indexada",
      "starred": true,
      "starred_order": 1,
      "power_top_price": "0.089",
      "power_unique_price": "0.0",
      "power_valley_price": "0.069",
      "energy_flat_price": "0.236",
      "energy_top_price": "1.369",
      "energy_valley_price": "0.965",
      "energy_unique_price": "0.0",
      "solar_excess_price": "1.05",
      "maintenance_cost": "0.0",
      "monthly_price": "48.99",
      "self_supply": true,
      "green_energy": true,
      "virtual_battery": true,
      "contract_lenght": false,
      "has_deal": false,
      "url": null,
      "has_promo": true,
      "promo": {
        "started_at": "2024-10-08T13:00:00.000+02:00",
        "expired_at": "2024-10-10T00:00:00.000+02:00",
        "claim": "Super promo"
      },
      "provider": {
        "id": 5,
        "name": "Energya VM",
        "slug": "energya_vm",
        "status": "active",
        "phone_number": "600123123",
        "image": {
          "url": "https://admin.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsiZGF0YSI6NzQ0NiwicHVyIjoiYmxvYl9pZCJ9fQ==--2b62779db73cd62c9b7caf351ac19a0d7ceb7061/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJqcGciLCJyZXNpemUiOiIxMTJ4MTEyXiIsImdyYXZpdHkiOiJjZW50ZXIiLCJjcm9wIjoiMTEyeDExMiswKzAifSwicHVyIjoidmFyaWF0aW9uIn19--60f8d940a57cf959c4d2e697c2fa437a8a3cca93/energya-vm.jpg"
        }
      }
    },
  ]
}

Arguments

Parameter Description
providers optional string Energy providers' slugs. . Eg: providers=repsol; providers=repsol,energy_vm.
status optional string Offers status to retrive (active, inactive, snapshot or discontinue). Default: active.
electricity_type optional string Retrieve offers by electricity type (indexada discriminacion_horaria precio_fijo). Support multiple type. Eg: electricity_type=indexada, electricity_type=indexada,precio_fijo.
self_supply optional boolean Retrieve offers that have self supply.
contract_lenght optional boolean Retrieve offers that have contract lenght.
green_energy optional boolean Retrieve offers that have green energy.
virtual_battery optional boolean Retrieve offers that have virtual battery.
sort_by optional string The field that defines the order. Use suffix - to define descending order and + for ascending order. (i.e. +monthly_price). You can also specify multiple sorting values.

Multiproduct electricity list request

# Definition
GET https://api.kelisto.es/api/v3/energy/multiproduct/:provider_slug/electricity

# Example request
$ curl https://api.kelisto.es/api/v3/energy/multiproduct/energya_vm/electricity
# Example response

{
  "data": {
    "id": 5,
    "name": "Energya VM",
    "slug": "energya_vm",
    "status": "active",
    "phone_number": "600123123",
    "image": {
      "url": "https://admin.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsiZGF0YSI6NzQ0NiwicHVyIjoiYmxvYl9pZCJ9fQ==--2b62779db73cd62c9b7caf351ac19a0d7ceb7061/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJqcGciLCJyZXNpemUiOiIxMTJ4MTEyXiIsImdyYXZpdHkiOiJjZW50ZXIiLCJjcm9wIjoiMTEyeDExMiswKzAifSwicHVyIjoidmFyaWF0aW9uIn19--60f8d940a57cf959c4d2e697c2fa437a8a3cca93/energya-vm.jpg"
    },
    "products": [
      {
        "electricity_type": "indexada",
        "offers": [
          {
            "id": 7,
            "name": "Energya VM",
            "slug": "energia_vm",
            "updated_at": "2024-10-08T14:01:43.710+02:00",
            "status": "active",
            "energy_type": "electricity",
            "claim": "",
            "electricity_type": "indexada",
            "starred": true,
            "starred_order": 1,
            "power_top_price": "0.089",
            "power_unique_price": "0.0",
            "power_valley_price": "0.069",
            "energy_flat_price": "0.236",
            "energy_top_price": "1.369",
            "energy_valley_price": "0.965",
            "energy_unique_price": "0.0",
            "solar_excess_price": "1.05",
            "maintenance_cost": "0.0",
            "monthly_price": "48.99",
            "self_supply": true,
            "green_energy": true,
            "virtual_battery": true,
            "contract_lenght": false,
            "has_deal": false,
            "url": null,
            "has_promo": true,
            "promo": {
              "started_at": "2024-10-08T13:00:00.000+02:00",
              "expired_at": "2024-10-10T00:00:00.000+02:00",
              "claim": "Super promo"
            },
            "provider": {
              "id": 5,
              "name": "Energya VM",
              "slug": "energya_vm",
              "status": "active",
              "phone_number": "600123123",
              "image": {
                "url": "https://admin.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsiZGF0YSI6NzQ0NiwicHVyIjoiYmxvYl9pZCJ9fQ==--2b62779db73cd62c9b7caf351ac19a0d7ceb7061/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJqcGciLCJyZXNpemUiOiIxMTJ4MTEyXiIsImdyYXZpdHkiOiJjZW50ZXIiLCJjcm9wIjoiMTEyeDExMiswKzAifSwicHVyIjoidmFyaWF0aW9uIn19--60f8d940a57cf959c4d2e697c2fa437a8a3cca93/energya-vm.jpg"
              }
            }
          },
        ]
      }
    ]
  }
}

Arguments

Parameter Description
provider_slug URL segment string Energy provider slug.

Gas offers

List all gas offers

# Definition
GET https://api.kelisto.es/api/v3/energy/offers/gas?<criteria>

# Example request
$ curl https://api.kelisto.es/api/v3/energy/offers/gas?sort_by=+price
# Example response

{
  "pagination": {
    "links": {
      "first": "https://admin.kelisto.dev/api/v3/energy/offers/gas?page=1",
      "next": "https://admin.kelisto.dev/api/v3/energy/offers/gas?page=",
      "last": "https://admin.kelisto.dev/api/v3/energy/offers/gas?page=1"
    },
    "current_page": "1",
    "page_items": "25",
    "total_count": "3",
    "total_pages": "1"
  },
  "data": [
    {
      "id": 11,
      "name": "Gas y mas",
      "slug": "gas_mas",
      "updated_at": "2024-10-08T14:10:42.555+02:00",
      "status": "active",
      "energy_type": "gas",
      "claim": "",
      "gas_type": "RL1",
      "starred": true,
      "starred_order": 1,
      "fix_gas_term": "1.236",
      "variable_gas_term": "1.654",
      "monthly_price": "56.26",
      "contract_lenght": false,
      "has_deal": false,
      "url": null,
      "has_promo": true,
      "promo": {
        "started_at": "2024-10-08T13:00:00.000+02:00",
        "expired_at": "2024-10-10T00:00:00.000+02:00",
        "claim": "100 en saldo waylet"
      },
      "provider": {
        "id": 1,
        "name": "Endesa",
        "slug": "endesa",
        "status": "active",
        "phone_number": null,
        "image": {
          "url": "https://admin.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsiZGF0YSI6NzQ0MiwicHVyIjoiYmxvYl9pZCJ9fQ==--6671b5f58aea783dcbd84ebd9af8401038cd6837/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJwbmciLCJyZXNpemUiOiIxMTJ4MTEyXiIsImdyYXZpdHkiOiJjZW50ZXIiLCJjcm9wIjoiMTEyeDExMiswKzAifSwicHVyIjoidmFyaWF0aW9uIn19--002893d9be24ce79483669ab0cacdb52b66c1b82/endesa.png"
        }
      }
    },
  ]
}

Arguments

Parameter Description
providers optional string Energy providers' slugs. . Eg: providers=endesa; providers=endesa,repsol.
status optional string Offers status to retrive (active, inactive, snapshot or discontinue). Default: active.
gas_type optional string Retrieve offers by gas type (RL1 RL2). Support multiple type. Eg: gas_type=RL1, gas_type=RL1, RL2.
contract_lenght optional boolean Retrieve offers that have contract lenght.
sort_by optional string The field that defines the order. Use suffix - to define descending order and + for ascending order. (i.e. +monthly_price). You can also specify multiple sorting values.

Multiproduct gas list request

# Definition
GET https://api.kelisto.es/api/v3/energy/multiproduct/:provider_slug/gas

# Example request
$ curl https://api.kelisto.es/api/v3/energy/multiproduct/endesa/gas
# Example response

{
  "data": {
    "id": 1,
    "name": "Endesa",
    "slug": "endesa",
    "status": "active",
    "phone_number": null,
    "image": {
      "url": "https://admin.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsiZGF0YSI6NzQ0MiwicHVyIjoiYmxvYl9pZCJ9fQ==--6671b5f58aea783dcbd84ebd9af8401038cd6837/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJwbmciLCJyZXNpemUiOiIxMTJ4MTEyXiIsImdyYXZpdHkiOiJjZW50ZXIiLCJjcm9wIjoiMTEyeDExMiswKzAifSwicHVyIjoidmFyaWF0aW9uIn19--002893d9be24ce79483669ab0cacdb52b66c1b82/endesa.png"
    },
      "products": [
        {
        "gas_type": "RL1",
        "offers": [
          {
            "id": 13,
            "name": "Super gas",
            "slug": "super_gas",
            "updated_at": "2024-10-08T14:13:26.197+02:00",
            "status": "active",
            "energy_type": "gas",
            "claim": "",
            "gas_type": "RL1",
            "starred": false,
            "starred_order": null,
            "fix_gas_term": "1.236",
            "variable_gas_term": "1.365",
            "monthly_price": "56.14",
            "contract_lenght": false,
            "has_deal": false,
            "url": null,
            "has_promo": true,
            "promo": {
              "started_at": "2024-10-08T13:00:00.000+02:00",
              "expired_at": "2024-10-10T00:00:00.000+02:00",
              "claim": "100 en saldo waylet"
            },
            "provider": {
              "id": 1,
              "name": "Endesa",
              "slug": "endesa",
              "status": "active",
              "phone_number": null,
              "image": {
              "url": "https://admin.kelisto.dev/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsiZGF0YSI6NzQ0MiwicHVyIjoiYmxvYl9pZCJ9fQ==--6671b5f58aea783dcbd84ebd9af8401038cd6837/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJwbmciLCJyZXNpemUiOiIxMTJ4MTEyXiIsImdyYXZpdHkiOiJjZW50ZXIiLCJjcm9wIjoiMTEyeDExMiswKzAifSwicHVyIjoidmFyaWF0aW9uIn19--002893d9be24ce79483669ab0cacdb52b66c1b82/endesa.png"
            }
          }
        ]
      }
    ]
  }
}

Arguments

Parameter Description
provider_slug URL segment string Energy provider slug.

 API Shared

Categories

The category object

Attributes

# Example object

{
  "slug": "internet-movil-tv",
  "name": "Internet, móvil y TV",
  "url": "https://comunicacion.kelisto.es/adsl-tv-movil",
  "product_name": "internet_tv_mobile",
  "product_type": "internet",
  "offers": [
    {
      "id": 542,
      "name": "Movistar Fusión 0 100 MB -2 líneas",
      "slug": "movistar-fusion-0-100-mb",
      "product_name": "internet_tv_mobile",
      "product_type": "internet",
      "claim": "Incluye 2 líneas móviles",
      "starred": false,
      "best_buy": true,
      "sponsored": false,
      "updated_at": "2020-06-23T13:37:17.893+02:00",
      "description": "<p>La tarifa <strong>Movistar Fusión 0 con 100 Mb de fibra óptica</strong> constituye el pack más básico del operador de Telefónica: además de disfrutar de Internet a una velocidad de <strong>100 Mb</strong>, tendrás una <strong>línea de teléfono fijo con llamadas ilimitadas y una línea de telefonía móvil con 200 minutos</strong> para hablar y <strong>5GB de datos</strong> para navegar por Internet. Y como extra, con la oferta de Movistar te llevas una <strong>línea adicional gratis</strong>, con cero céntimos el minuto y 5 GB. </p>\n\n<p>También podrás acceder desde la <strong>plataforma de Movistar+</strong> a los canales en abierto de la TDT y a los de pago de la propia compañía: <strong>#0 y Movistar eSports</strong>. Fusión #0 <strong>vuelve a estar disponible con descodificador</strong>, lo que te permitirá disfrutar de la mejor experiencia en tu TV con todas las funcionalidades de Movistar+. </p>\n\n<p>A esta tarifa de Internet y móvil puedes añadirle otros servicios del operador: por ejemplo, tienes la posibilidad de ampliar el catálogo televisivo añadiendo los packs de canales de televisión en <em>streaming</em> de Movistar o contratar una segunda línea de móvil por un extra en tu cuota. Aunque <strong>no está sujeta a compromisos de permanencia</strong>, <strong>no te cobrarán nada ni por el alta ni por la instalación de la línea y, además, te regalan el router</strong>.</p>\n",
      "contract_length": 0,
      "has_deal": true,
      "url": "https://promomovistar.es/comparadores/fusion_0_50.php?scapa=C2C2016050416",
      "prices": {
        "price": "53.0",
        "line_rental": "0.0",
        "router_price": "0.0",
        "router_delivery_cost": "0.0",
        "installation_price": "0.0",
        "line_installation_price": "0.0",
        "annual_price": "636.0",
        "current_monthly_price": "53.0"
      },
      "internet": {
        "speed_download": 100,
        "speed_upload": 100,
        "internet_type": "optical_fiber",
        "symmetric": true
      },
      "landing": {
        "title": null,
        "legal": null
      },
      "has_landline": true,
      "landline": {
        "line_rental": "0.0",
        "minutes_to_mobile": 0,
        "minutes_to_landline": 999999999,
        "connection_charge": "40.0"
      },
      "has_mobile": true,
      "mobile": {
        "minutes": 200,
        "included_lines": 2,
        "data": 10000,
        "minutes_excess": "0 cent/min, establecimiento de llamada 40 cent",
        "data_excess": "la velocidad se reduce",
        "connection_charge": "40.0",
        "network": "Movistar",
        "roaming": "Si viajas por cualquier país de la Unión Europea, Islandia, Liechtenstein o Noruega podrás llamar, enviar mensajes o utilizar tu  bono de datos como si estuvieras en España, porque te aplicaran las mismas condiciones de tu plan nacional, ya sea de contrato o de tarjeta. ",
        "coverage": "4g",
        "additional_lines": [
          {
            "id": 160,
            "name": "Movistar Línea adicional #2",
            "data": "2 GB",
            "minutes": "50",
            "price": "7.5",
            "created_at": "2019-12-11T17:54:25.652+01:00",
            "updated_at": "2019-12-11T17:54:25.652+01:00"
          },
          {
            "id": 161,
            "name": "Movistar Línea adicional #5",
            "data": "5 GB",
            "minutes": "150",
            "price": "12.5",
            "created_at": "2019-12-11T17:56:00.479+01:00",
            "updated_at": "2019-12-11T17:56:00.479+01:00"
          },
          {
            "id": 162,
            "name": "Movistar Línea adicional #5 Plus",
            "data": "5 GB",
            "minutes": "ilimitados",
            "price": "15.0",
            "created_at": "2019-12-11T17:57:19.975+01:00",
            "updated_at": "2019-12-11T17:57:19.975+01:00"
          },
          {
            "id": 163,
            "name": "Movistar Línea adicional #20 Plus",
            "data": "20 GB",
            "minutes": "ilimitados",
            "price": "22.5",
            "created_at": "2019-12-11T17:58:02.785+01:00",
            "updated_at": "2019-12-11T17:58:02.785+01:00"
          },
          {
            "id": 200,
            "name": "Movistar línea adicional infinita",
            "data": "ilimitados",
            "minutes": "ilimitados",
            "price": "22.5",
            "created_at": "2020-04-20T16:27:09.190+02:00",
            "updated_at": "2020-04-20T16:27:09.190+02:00"
          }
        ]
      },
      "has_tv": true,
      "tv": {
        "description": "<p>Disfruta de dos canales exclusivos de Movistar+ con los que puedes ver deportes y los estrenos más esperados de la temporada</p>\n",
        "claim": "Canales Movistar+ (#0, #vamos)",
        "tv_channels": [
          {
            "name": "M eSports",
            "type": "Deportes",
            "image": {
              "url": "http://api.kelisto.es/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBOQT09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--a7208f19d503717e05828103418c3c018729157c/m-esports.jpg"
            }
          },
          {
            "name": "Canal 0",
            "type": "Varios",
            "image": {
              "url": "http://api.kelisto.es/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBjdz09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--fa981367cdb352f842de8f93494dfe4c455b1ca9/canal-0.jpg"
            }
          },
          {
            "name": "#Vamos",
            "type": "Deportes",
            "image": {
              "url": "http://api.kelisto.es/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBYmM9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--8c7507c07de13a0ba0e76028e5b9277a6d990cc9/1200px-Vamos.svg.png"
            }
          }
        ]
      },
      "has_promo": false,
      "provider": {
        "id": 18,
        "name": "Movistar",
        "network": "Movistar",
        "roaming": "Si viajas por cualquier país de la Unión Europea, Islandia, Liechtenstein o Noruega podrás llamar, enviar mensajes o utilizar tu  bono de datos como si estuvieras en España, porque te aplicaran las mismas condiciones de tu plan nacional, ya sea de contrato o de tarjeta. ",
        "slug": "movistar",
        "title": null,
        "phone_number": "900200636",
        "image": {
          "url": "http://api.kelisto.es/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBGdz09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--bbd388d2e10a7a3737cd5df08ae83f96a616b208/movistar.jpg"
        },
        "description": null
      },
      "ratings": {
        "rating": 8.2,
        "price": 10,
        "speed": 6,
        "minutes": 8,
        "data": 8
      },
      "has_review": true,
      "review": {
        "title": "Internet, TV y móvil más barato",
        "description": "La tarifa de Movistar Fusión más básica es también la opción más económica para contratar televisión de pago: por menos de 50 euros (sin subidas de precio) tendrás fibra, teléfono fijo, móvil y acceso a algunos canales de pago del operador. Si no miramos promociones, te sale más barato que contratar solo Internet con Movistar, pero la oferta de televisión se te puede quedar algo corta (solo incluye tres canales fuera de los gratuitos de la TDT).",
        "author": {
          "name": "Sara Perales",
          "firstname": "Sara",
          "lastname": "Perales",
          "title": "Experta en telecomunicaciones",
          "image": {
            "url": "http://api.kelisto.es/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaHdCIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--8902aa49beb643b29a15c77180ad96c8785b6a25/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--0347ba86f55403d966d523f5ca9b4394cf130337/experta_sara.jpg"
          }
        }
      }
    },
    {...}
  ]
}

Attribute Description
slug string  Unique url identifier for the resource.
name string Offer name.
url string URL to the comparison site where we show related offers.
product_name string  The specific product name.
product_type string  Product type identifier.
offers array  Array of offers.

Retrieve a category

# Definition
GET https://api.kelisto.es/api/v3/categories/:slug

# Example request
$ curl https://api.kelisto.es/api/v3/categories/internet-movil-tv
# Example response

{
  "data": {
    "slug": "internet-movil-tv",
    "name": "Internet, móvil y TV",
    "url": "https://comunicacion.kelisto.es/adsl-tv-movil",
    "product_name": "internet_tv_mobile",
    "product_type": "internet",
    "offers": [
      {
        "id": 542,
        "name": "Movistar Fusión 0 100 MB -2 líneas",
        "slug": "movistar-fusion-0-100-mb",
        "product_name": "internet_tv_mobile",
        "product_type": "internet",
        "claim": "Incluye 2 líneas móviles",
        "starred": false,
        "best_buy": true,
        "sponsored": false,
        "updated_at": "2020-06-23T13:37:17.893+02:00",
        "description": "<p>La tarifa <strong>Movistar Fusión 0 con 100 Mb de fibra óptica</strong> constituye el pack más básico del operador de Telefónica: además de disfrutar de Internet a una velocidad de <strong>100 Mb</strong>, tendrás una <strong>línea de teléfono fijo con llamadas ilimitadas y una línea de telefonía móvil con 200 minutos</strong> para hablar y <strong>5GB de datos</strong> para navegar por Internet. Y como extra, con la oferta de Movistar te llevas una <strong>línea adicional gratis</strong>, con cero céntimos el minuto y 5 GB. </p>\n\n<p>También podrás acceder desde la <strong>plataforma de Movistar+</strong> a los canales en abierto de la TDT y a los de pago de la propia compañía: <strong>#0 y Movistar eSports</strong>. Fusión #0 <strong>vuelve a estar disponible con descodificador</strong>, lo que te permitirá disfrutar de la mejor experiencia en tu TV con todas las funcionalidades de Movistar+. </p>\n\n<p>A esta tarifa de Internet y móvil puedes añadirle otros servicios del operador: por ejemplo, tienes la posibilidad de ampliar el catálogo televisivo añadiendo los packs de canales de televisión en <em>streaming</em> de Movistar o contratar una segunda línea de móvil por un extra en tu cuota. Aunque <strong>no está sujeta a compromisos de permanencia</strong>, <strong>no te cobrarán nada ni por el alta ni por la instalación de la línea y, además, te regalan el router</strong>.</p>\n",
        "contract_length": 0,
        "has_deal": true,
        "url": "https://promomovistar.es/comparadores/fusion_0_50.php?scapa=C2C2016050416",
        "prices": {
          "price": "53.0",
          "line_rental": "0.0",
          "router_price": "0.0",
          "router_delivery_cost": "0.0",
          "installation_price": "0.0",
          "line_installation_price": "0.0",
          "annual_price": "636.0",
          "current_monthly_price": "53.0"
        },
        "internet": {
          "speed_download": 100,
          "speed_upload": 100,
          "internet_type": "optical_fiber",
          "symmetric": true
        },
        "landing": {
          "title": null,
          "legal": null
        },
        "has_landline": true,
        "landline": {
          "line_rental": "0.0",
          "minutes_to_mobile": 0,
          "minutes_to_landline": 999999999,
          "connection_charge": "40.0"
        },
        "has_mobile": true,
        "mobile": {
          "minutes": 200,
          "included_lines": 2,
          "data": 10000,
          "minutes_excess": "0 cent/min, establecimiento de llamada 40 cent",
          "data_excess": "la velocidad se reduce",
          "connection_charge": "40.0",
          "network": "Movistar",
          "roaming": "Si viajas por cualquier país de la Unión Europea, Islandia, Liechtenstein o Noruega podrás llamar, enviar mensajes o utilizar tu  bono de datos como si estuvieras en España, porque te aplicaran las mismas condiciones de tu plan nacional, ya sea de contrato o de tarjeta. ",
          "coverage": "4g",
          "additional_lines": [
            {
              "id": 160,
              "name": "Movistar Línea adicional #2",
              "data": "2 GB",
              "minutes": "50",
              "price": "7.5",
              "created_at": "2019-12-11T17:54:25.652+01:00",
              "updated_at": "2019-12-11T17:54:25.652+01:00"
            },
            {
              "id": 161,
              "name": "Movistar Línea adicional #5",
              "data": "5 GB",
              "minutes": "150",
              "price": "12.5",
              "created_at": "2019-12-11T17:56:00.479+01:00",
              "updated_at": "2019-12-11T17:56:00.479+01:00"
            },
            {
              "id": 162,
              "name": "Movistar Línea adicional #5 Plus",
              "data": "5 GB",
              "minutes": "ilimitados",
              "price": "15.0",
              "created_at": "2019-12-11T17:57:19.975+01:00",
              "updated_at": "2019-12-11T17:57:19.975+01:00"
            },
            {
              "id": 163,
              "name": "Movistar Línea adicional #20 Plus",
              "data": "20 GB",
              "minutes": "ilimitados",
              "price": "22.5",
              "created_at": "2019-12-11T17:58:02.785+01:00",
              "updated_at": "2019-12-11T17:58:02.785+01:00"
            },
            {
              "id": 200,
              "name": "Movistar línea adicional infinita",
              "data": "ilimitados",
              "minutes": "ilimitados",
              "price": "22.5",
              "created_at": "2020-04-20T16:27:09.190+02:00",
              "updated_at": "2020-04-20T16:27:09.190+02:00"
            }
          ]
        },
        "has_tv": true,
        "tv": {
          "description": "<p>Disfruta de dos canales exclusivos de Movistar+ con los que puedes ver deportes y los estrenos más esperados de la temporada</p>\n",
          "claim": "Canales Movistar+ (#0, #vamos)",
          "tv_channels": [
            {
              "name": "M eSports",
              "type": "Deportes",
              "image": {
                "url": "http://api.kelisto.es/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBOQT09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--a7208f19d503717e05828103418c3c018729157c/m-esports.jpg"
              }
            },
            {
              "name": "Canal 0",
              "type": "Varios",
              "image": {
                "url": "http://api.kelisto.es/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBjdz09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--fa981367cdb352f842de8f93494dfe4c455b1ca9/canal-0.jpg"
              }
            },
            {
              "name": "#Vamos",
              "type": "Deportes",
              "image": {
                "url": "http://api.kelisto.es/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBYmM9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--8c7507c07de13a0ba0e76028e5b9277a6d990cc9/1200px-Vamos.svg.png"
              }
            }
          ]
        },
        "has_promo": false,
        "provider": {
          "id": 18,
          "name": "Movistar",
          "network": "Movistar",
          "roaming": "Si viajas por cualquier país de la Unión Europea, Islandia, Liechtenstein o Noruega podrás llamar, enviar mensajes o utilizar tu  bono de datos como si estuvieras en España, porque te aplicaran las mismas condiciones de tu plan nacional, ya sea de contrato o de tarjeta. ",
          "slug": "movistar",
          "title": null,
          "phone_number": "900200636",
          "image": {
            "url": "http://api.kelisto.es/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBGdz09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--bbd388d2e10a7a3737cd5df08ae83f96a616b208/movistar.jpg"
          },
          "description": null
        },
        "ratings": {
          "rating": 8.2,
          "price": 10,
          "speed": 6,
          "minutes": 8,
          "data": 8
        },
        "has_review": true,
        "review": {
          "title": "Internet, TV y móvil más barato",
          "description": "La tarifa de Movistar Fusión más básica es también la opción más económica para contratar televisión de pago: por menos de 50 euros (sin subidas de precio) tendrás fibra, teléfono fijo, móvil y acceso a algunos canales de pago del operador. Si no miramos promociones, te sale más barato que contratar solo Internet con Movistar, pero la oferta de televisión se te puede quedar algo corta (solo incluye tres canales fuera de los gratuitos de la TDT).",
          "author": {
            "name": "Sara Perales",
            "firstname": "Sara",
            "lastname": "Perales",
            "title": "Experta en telecomunicaciones",
            "image": {
              "url": "http://api.kelisto.es/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaHdCIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--8902aa49beb643b29a15c77180ad96c8785b6a25/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--0347ba86f55403d966d523f5ca9b4394cf130337/experta_sara.jpg"
            }
          }
        }
      },
      {...}
    ]
  }
}

Arguments

Parameter Description
slug Required string The slug of the category to retrieve.
section Optional Integer The defines which provider’s phone number is going to be displayed. The value must be one of these: Compare, Offer_detail, Compare_top, Compare_sem, process_help_results, process_help_results_sem, article, article_podium, article_opinion_card, newsletter. In case we don’t receive the section param, we will provide the default section phone number.
source Optional Integer Defines el source the phone number displayed. the value must be: idealista, default. In case we do not receive no parameters the default will be taken.

 Returns

Returns a category object if a valid slug is provided.

Retrieve a category group

# Definition
GET https://api.kelisto.es/api/v3/categories/groups/:slug


# Example request
$ curl https://api.kelisto.es/api/v3/categories/groups/telefonia-movil
# Example response

{
  "data": [
    {
      "slug": "contrato",
      "name": "Contrato",
      "url": "https://comunicacion.kelisto.es/telefonia-movil",
      "product_name": "contract",
      "product_type": "mobile",
      "offers": [
        {
          "id": 229,
          "name": "Simyo Ilimitadas-25 GB",
          "slug": "ilimitadas-10-gb",
          "product_name": "contract",
          "product_type": "mobile",
          "claim": "Acumula los megas que te sobran",
          "starred": false,
          "best_buy": false,
          "sponsored": false,
          "updated_at": "2020-04-27T18:19:31.879+02:00",
          "description": "<p>La tarifa <strong>Simyo Ilimitadas 25 GB</strong> incluye <strong>llamadas ilimitadas</strong> para hablar desde el móvil y <strong>25 GB</strong> de datos para navegar por Internet. Además, tendrás conexión a Internet ** 4G** a través de la <strong>red de Orange</strong>. Como la oferta tiene muchos datos, si un mes no llegas a gastarlos <strong>Simyo te guarda los gigas para que los gastes en los tres meses siguientes</strong>. En cualquier caso, como <strong>ninguna de las tarifas de Simyo exigen compromisos de permanencia</strong>, puedes cancelarlas  o cambiar las condiciones de un mes para otro sin penalizaciones.</p>\n",
          "contract_length": 0,
          "has_deal": true,
          "url": "https://www.awin1.com/awclick.php?gid=337647&mid=11138&awinaffid=326679&linkid=2299138&clickref=&p=https://simyo2.solution.weborama.fr/fcgi-bin/dispatch.fcgi?a.A=cl&a.si=519&a.te=9401&a.ra=[RANDOM]&URL=https://media.adrcdn.com/ads/Weborama/3136323833/66367/zanoxwebservice.html?urldest=https://www.simyo.es/landing-comparador.html?datos=25600&llamadas=43200&utm_medium=affiliated-comparadores&utm_source=xaw&utm_campaign=all-devices&utm_content=cc&utm_term=kelisto",
          "prices": {
            "price": "20.0",
            "annual_price": "240.0",
            "current_monthly_price": "20.0"
          },
          "internet": {
            "internet_type": "4g"
          },
          "mobile": {
            "minutes": 999999999,
            "included_lines": null,
            "data": 25000,
            "minutes_excess": "",
            "data_excess": "3,63 cént/MB",
            "connection_charge": "0.0",
            "network": "Orange",
            "roaming": null
          },
          "has_promo": true,
          "promo": {
            "starts_at": null,
            "expires_at": null,
            "claim": "Regalo de bienvenida de 10€",
            "description": null,
            "months": 0,
            "monthly_price": null,
            "type": "others"
          },
          "provider": {
            "id": 2,
            "name": "Simyo",
            "network": "Orange",
            "roaming": null,
            "slug": "simyo",
            "title": null,
            "phone_number": null,
            "image": {
              "url": "http://api.kelisto.es/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCdz09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--691d2932cfefdbbae0216743157c2eea4ce30dc9/simyo.jpg"
            },
            "description": null
          },
          "ratings": {
            "rating": 9.1,
            "price": 8,
            "minutes": 10,
            "data": 10
          },
          "has_review": false
        },
        {
          "id": 411,
          "name": "Pepephone La Tarifa Inimitable",
          "slug": "pephone-la-tarifa-inimitables",
          "product_name": "contract",
          "product_type": "mobile",
          "claim": "Acumula tus gigas de sobra para el mes siguiente",
          "starred": false,
          "best_buy": true,
          "sponsored": false,
          "updated_at": "2020-06-12T10:30:50.460+02:00",
          "description": "<p><strong>La Inimitable</strong>de <strong>Pepephone</strong> ofrece <strong>25 GB</strong> a todos aquellos que necesiten contratar  muchos datos para navegar por Internet y, además, quieran disponer de <strong>llamadas ilimitadas</strong> a fijos y  móviles nacionales, sin coste de establecimiento. Además, también incluye SMSs a móviles nacionales y servicio <em>roaming</em> en los países de la Unión Europea.</p>\n\n<p>La tarifa tiene 25 GB que se renovarán cada mes y ofrece <strong>cobertura wifi 4G</strong>. Para que puedas conectarte desde cualquier sitio, <strong>Pepephone utiliza la banda ancha de Yoigo</strong> pero, en los sitios en los que no haya cobertura, sus clientes podrán conectarse a la red de Orange y contarán de forma adicional con la de Movistar, así que tendrán acceso a tres redes diferentes.</p>\n\n<p>Si se te acabasen los datos, tendrías dos opciones: seguir navegando a velocidad reducida sin coste adicional o activar los <strong>bonos por días</strong> que ofrece el operador, y que tienen un precio de 1€/día por 1 GB/día.</p>\n\n<p>Uno de los puntos fuertes de esta tarifa es que <strong>no exige ningún compromiso de permanencia</strong>. De esta forma, si un mes crees que no necesitas tantos datos, puedes cambiar de tarifa a otra que se adapte mejor a tu consumo sin que el operador te penalice económicamente.  </p>\n",
          "contract_length": 0,
          "has_deal": true,
          "url": "https://www.pepephone.com/tarifas-moviles/la-inimitable?utm_source=kelisto&utm_medium=comparador&utm_campaign=performance-conversion_tmoviles&utm_content=PaidLink_MO_tarifa_inimitable&tc_alt=43200&n_o_pst=n_o_pst",
          "prices": {
            "price": "19.9",
            "annual_price": "238.8",
            "current_monthly_price": "19.9"
          },
          "internet": {
            "internet_type": "4g"
          },
          "mobile": {
            "minutes": 999999999,
            "included_lines": null,
            "data": 25000,
            "minutes_excess": null,
            "data_excess": "la velocidad se reduce hasta 128 Kbps",
            "connection_charge": "0.0",
            "network": "Yoigo",
            "roaming": ""
          },
          "has_promo": false,
          "provider": {
            "id": 16,
            "name": "Pepephone",
            "network": "Yoigo",
            "roaming": "",
            "slug": "pepephone",
            "title": null,
            "phone_number": "900622804",
            "image": {
              "url": "http://api.kelisto.es/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBakFEIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--7c30139ff3d1fd38cfdc6137eea20bf01973201e/Pepephone-logo.jpg"
            },
            "description": null
          },
          "ratings": {
            "rating": 9.1,
            "price": 8,
            "minutes": 10,
            "data": 10
          },
          "has_review": true,
          "review": {
            "title": "Precio inimitable",
            "description": "La tarifa más completa de Pepephone es también una de las mejores en relación calidad/precio: por menos de 20 euros no tendrás tope de minutos y hasta los que más utilizan Internet lo tendrán difícil para quedarse sin datos. Además, no te cobrarán si gastas megas de más y no hay compromisos de permanencia, así que podrás modificar tus condiciones sin penalizaciones.\r\n",
            "author": {
              "name": "Sara Perales",
              "firstname": "Sara",
              "lastname": "Perales",
              "title": "Experta en telecomunicaciones",
              "image": {
                "url": "http://api.kelisto.es/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaHdCIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--8902aa49beb643b29a15c77180ad96c8785b6a25/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--0347ba86f55403d966d523f5ca9b4394cf130337/experta_sara.jpg"
              }
            }
          }
        },
      ]
    },
    {
      "slug": "prepago",
      "name": "Prepago",
      "url": "https://comunicacion.kelisto.es/telefonia-movil-prepago",
      "product_name": "prepaid",
      "product_type": "mobile",
      "offers": [
        {
          "id": 715,
          "name": "Simyo- 25 GB",
          "slug": "simyo-24gb-prepago",
          "product_name": "prepaid",
          "product_type": "mobile",
          "claim": "Acumula los megas que te sobran",
          "starred": false,
          "best_buy": false,
          "sponsored": false,
          "updated_at": "2020-05-26T11:44:19.309+02:00",
          "description": "<p>Para aquellos que solo necesiten conexión  a Internet, <strong>Simyo</strong> ofrece <strong>Simyo 25 GB</strong>. La tarifa incluye <strong>25 GB</strong> de datos móviles para ver contenidos en <em>streaming</em>, usar aplicaciones móviles o navegar por Internet a alta velocidad. Ahora bien, aunque esta tarifa no incluye llamadas gratuitas, el operador te permitirá hacer uso de este servicio con un coste de <strong>6 céntimos</strong> por minuto más <strong>18,15 céntimos</strong> de establecimiento de llamada. </p>\n\n<p>Por otra parte, entre las principales ventajas de esta operadora están que <strong>Simyo</strong> te <strong>regala 10 euros</strong> que se te aplicarán en la primera cuota de la tarifa. Además, si contratas esta <strong>tarifa de prepago</strong> tendrás un <strong>mayor control de tu consumo</strong> y <strong>no tendrás permanencia</strong>. La cobertura que utiliza Simyo es la misma que la de Orange, que se conecta a su red a través del <strong>4 G</strong></p>\n",
          "contract_length": 0,
          "has_deal": true,
          "url": "https://www.awin1.com/awclick.php?gid=337647&mid=11138&awinaffid=326679&linkid=2299138&clickref=prepago&p=https://simyo2.solution.weborama.fr/fcgi-bin/dispatch.fcgi?a.A=cl&a.si=519&a.te=9401&a.ra=[RANDOM]&URL=https://media.adrcdn.com/ads/Weborama/3136323833/66367/zanoxwebservice.html?urldest=https://www.simyo.es/landing-comparador.html?datos=25600&utm_medium=affiliated-comparadores&utm_source=xaw&utm_campaign=all-devices&utm_content=cc&utm_term=kelisto",
          "prices": {
            "price": "15.5",
            "annual_price": "186.0",
            "current_monthly_price": "15.5"
          },
          "internet": {
            "internet_type": "4g"
          },
          "mobile": {
            "minutes": 0,
            "included_lines": null,
            "data": 25000,
            "minutes_excess": "6 cént/ min, 18,15 cént de establecimiento llamada",
            "data_excess": "3,63 cént/MB",
            "connection_charge": "0.0",
            "network": "Orange",
            "roaming": null
          },
          "has_promo": true,
          "promo": {
            "starts_at": null,
            "expires_at": null,
            "claim": "Regalo de bienvenida de 10€",
            "description": "<p>Todos los clientes de Simyo tienen <strong>10€ de descuento</strong> a partir de tu primera factura. El descuento restante se acumula para aplicarse en posteriores facturas hasta que se gaste completamente, no caduca.</p>\n",
            "months": 0,
            "monthly_price": null,
            "type": "others"
          },
          "provider": {
            "id": 2,
            "name": "Simyo",
            "network": "Orange",
            "roaming": null,
            "slug": "simyo",
            "title": null,
            "phone_number": null,
            "image": {
              "url": "http://api.kelisto.es/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCdz09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--691d2932cfefdbbae0216743157c2eea4ce30dc9/simyo.jpg"
            },
            "description": null
          },
          "ratings": {
            "rating": 8.0,
            "price": 8,
            "minutes": 6,
            "data": 10
          },
          "has_review": false
        },
        {
          "id": 423,
          "name": "República Móvil Tarifa Única Ilimitada",
          "slug": "rep-movil-tarifa-unica-ilimitada-prepago",
          "product_name": "prepaid",
          "product_type": "mobile",
          "claim": "",
          "starred": false,
          "best_buy": false,
          "sponsored": false,
          "updated_at": "2020-06-16T16:34:27.911+02:00",
          "description": "<p>La <strong>Tarifa Única Ilimitada de República Móvil</strong> es el plan más completo que podrás contatar con este operador.</p>\n\n<p>Para empezar, tu tarifa Única ilimitada incluirá <strong>25 GB</strong> de datos móviles, es decir, una cantidad más que suficiente para ver películas y series en tus plataformas de <em>streaming</em> preferidas, subir contenido a las redes sociales, escuchar música online y mucho más. Aunque con esta oferta tendrás bastantes datos para navegar, si llegaras a consumir todos los datos de tu tarifa, el operador te permitirá seguir navegado a velocidad reducida sin costes extra. Aunque también podrás seguir navegando a máxima velocidad sin contratas alguno de los bonos extra que ofrece este operador. Para completar este plan, República Móvil ofrece <strong>llamadas ilimitadas</strong> para hablar desde tu <em>smartphone</em> tanto con fijos como con móviles nacionales.</p>\n\n<p>Como la cobertura que utiliza este operador es la misma que la de <strong>Orange</strong>, te conectarás a la misma <strong>red 4G</strong> que utiliza la teleco naranja para hablar y navegar a máxima velocidad. Una de las ventajas de República Móvil es que <strong>no exige ningún compromiso de permanencia</strong> en ninguna de sus tarifas, por lo que podrás probar diferentes ofertas y cambiar de condiciones sin penalizaciones económicas. Por otro lado, te incluye <strong>la tarjeta SIM totalmente gratis</strong>.</p>\n",
          "contract_length": 0,
          "has_deal": true,
          "url": "https://www.republicamovil.es/tarifas/?voice=VOICE_ILIMITADA_V5&data=DATA_UNICA_2019_V5&provider=kelisto",
          "prices": {
            "price": "20.0",
            "annual_price": "240.0",
            "current_monthly_price": "20.0"
          },
          "internet": {
            "internet_type": "4g"
          },
          "mobile": {
            "minutes": 999999999,
            "included_lines": null,
            "data": 25000,
            "minutes_excess": "",
            "data_excess": "1,5 cént/MB",
            "connection_charge": "0.0",
            "network": "Orange",
            "roaming": null
          },
          "has_promo": true,
          "promo": {
            "starts_at": null,
            "expires_at": null,
            "claim": "30GB extra gratis para este verano",
            "description": "<p>Aprovecha esta promoción de verano y llévate un bono de <strong>30GB gratis</strong> que podrás disfrutar hasta el 31 de agosto. Además, con el Plan Pioneros República Móvil te paga todos los meses por cada amigo y amigo de tus amigo, sin límite, sólo por ser cliente. Con este plan tu factura puede llegar a salirte gratis.</p>\n",
            "months": null,
            "monthly_price": null,
            "type": "others"
          },
          "provider": {
            "id": 4,
            "name": "República Móvil",
            "network": "Orange",
            "roaming": null,
            "slug": "republica-movil",
            "title": null,
            "phone_number": null,
            "image": {
              "url": "http://api.kelisto.es/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBDUT09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--9831c2fc772b9f673c4a77c463d9bfbda7146d50/republica-movil.jpg"
            },
            "description": null
          },
          "ratings": {
            "rating": 9.1,
            "price": 8,
            "minutes": 10,
            "data": 10
          },
          "has_review": false
        }
      ]
    }
  ]
}

Arguments

Parameter Description
slug Required string The slug of the category group to retrieve.
section Optional Integer The defines which provider’s phone number is going to be displayed. The value must be one of these: Compare, Offer_detail, Compare_top, Compare_sem, process_help_results, process_help_results_sem, article, article_podium, article_opinion_card, newsletter. In case we don’t receive the section param, we will provide the default section phone number.
source Optional Integer Defines el source the phone number displayed. the value must be: idealista, default. In case we do not receive no parameters the default will be taken.

 Returns

Returns a list of category objects if a valid slug is provided.

The podium object

Attributes

# Example object
{
  "total_count": 3,
  "type": "available",
  "offers": [
    {
      # offer object,
      # offer object,
    }
  ]
}
Attribute Description
total_count integer The number of offers returned.
type string The podium type, it's always real (deprecated attribute).
offers array  Array of offers.

Retrieve a category podium

# Definition
GET https://api.kelisto.es/api/v3/categories/podiums/:slug&limit=:limit


# Example request
$ curl https://api.kelisto.es/api/v3/categories/podiums/fbb3634?limit=3
# Example response
{
  "data": {
    "total_count": 3,
    "type": "available",
    "offers": [
      {
        "id": 511,
        "name": "Minipréstamo Vivus",
        "slug": "microcredito-vivus",
        "product_name": "microcredit",
        "product_type": "loan",
        "claim": "",
        "starred": false,
        "best_buy": false,
        "sponsored": true,
        "updated_at": "2020-03-11T10:50:15.380+01:00",
        "sponsored_order": 1,
        "description": "<p>El <strong>Minipréstamo Vivus</strong> es un producto de financiación con el que cualquier consumidor puede pedir una pequeña cantidad de dinero, a devolver en un plazo corto de tiempo. A cambio, esta entidad cobrará unos intereses que, en lugar de aplicarse en forma de Tipo de Interés Nominal o TIN (como ocurre en los préstamos tradicionales), se aplica en forma de honorarios, que son una cantidad fija en euros. Dicha cifra varía en función de la cantidad que solicite el cliente, el plazo de devolución que escoja e, incluso, de si ya ha pedido anteriormente dinero a Vivus. <br>\nEn cualquier caso, el Minipréstamo Vivus tiene una oferta que permite que los nuevos clientes pidan 300€ a 30 días sin ningún coste: es decir, sin comisiones ni honorarios, lo que equivale a una Tasa Anual Equivalente (TAE) del 0%. Recuerda, eso sí, que esa TAE puede aumentar en otros supuestos: por ejemplo, si pides 100€ a 30 días, los honorarios serían de 32€, lo que equivaldría a una TAE del 2.830,8%.<br>\nRespecto al resto de sus características, el Minipréstamo Vivus permite <strong>solicitar entre 50 y 300€</strong> (aunque la cifra sube hasta 1.000€ si eres antiguo cliente), a devolver en un <strong>plazo de entre siete y 30 días</strong>.  Por lo demás, para poder solicitar uno de estos microcréditos solo debes ser mayor de 21 años, tener una cuenta bancaria y disponer de un dispositivo con conexión a Internet.</p>\n",
        "has_deal": true,
        "url": "https://clk.tradedoubler.com/click?p=301933&a=2924858&g=24660442",
        "loan_type": "microcredit",
        "typ_description": "<ul>\n<li>Hasta <strong>300€</strong> a devolver en 30 días</li>\n<li>Transferencia en 15 minutos, 100% online</li>\n<li> ¡Sin letra pequeña!</li>\n</ul>\n",
        "comments": null,
        "obligations": {
          "old_clients": true,
          "new_clients": true,
          "min_age": 21,
          "signup_online": true,
          "defaulter": false,
          "must_justify_purpose": false,
          "only_online": null,
          "cities_number": null,
          "client_type": "general"
        },
        "purposes": {
          "vehicles": true,
          "studies": true,
          "travels": true,
          "home": true,
          "celebrations": true,
          "others": true,
          "others_description": "<p>Con el Minipréstamo Vivus puedes pedir dinero para lo que quieras, aunque al tratarse de cantidades pequeñas, tus opciones para financiar ciertos gastos podrían verse reducidas. </p>\n",
          "ecological": null
        },
        "features": {
          "min_amount": 50,
          "max_amount": 300,
          "min_term": 7,
          "max_term": 30,
          "amount_description": "<p>El Minipréstamo Vivus pedir entre 50 y 300€, aunque esa cifra puede subir hasta los 1.000€ si eres antiguo cliente de la entidad.</p>\n"
        },
        "costs": {
          "costs_and_commissions": false,
          "insurance_required": "non_insurable",
          "change_bank_required": false,
          "interest": 0.0,
          "apr": 0.0,
          "apr_description": "<p>En Kelisto te ofrecemos la información que Vivus proporciona sobre su TAE para que puedas entender cuál es el coste real de pedir financiación con esta compañía. En este sentido, debes saber que si eres nuevo cliente y pides 300€, a devolver en 30 días, no tendrás que pagar gastos ni honorarios. Por tanto, la TAE será del 0%. En cambio, si pidieras 100€ a 30 días, tendrías que pagar 32€ en concepto de honorarios, por lo que la TAE subiría hasta el 2.830,8%. </p>\n",
          "has_assessment": false,
          "has_opening": false,
          "has_total_partial_cancellation": false,
          "has_commissions": true,
          "commissions": {
            "fee": 0.0,
            "description": "<p>Los honorarios del Minipréstamo Vivus varían en función de la cantidad que pidas y del plazo de devolución que establezcas. No obstante, la compañía dispone de una promoción que permite que los nuevos clientes pidan 300€ a 30 días sin pagar honorarios. </p>\n"
          }
        },
        "has_promo": false,
        "bank": {
          "id": 99,
          "name": "Vivus",
          "slug": "vivus",
          "image": {
            "url": "https://admin.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaFVFIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--86ae042a05844320a641a1cfbac0a28196e07c56/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--bc312bd58021bbff684addb7e55e5aa904a5358a/vivus-s-min.jpg",
            "url_square": "https://admin.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaFVFIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--86ae042a05844320a641a1cfbac0a28196e07c56/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--bc312bd58021bbff684addb7e55e5aa904a5358a/vivus-s-min.jpg",
            "url_rectangular": "https://admin.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaFlFIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--8279554178cbe1d4f4436ef037e5c6187b735a3c/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRERNMk5IZzVObDRHT2daRlZEb01aM0poZG1sMGVVa2lDMk5sYm5SbGNnWTdCMVE2Q1dOeWIzQkpJZzh6TmpSNE9UWXJNQ3N3QmpzSFZBPT0iLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--cefecec422de2b27eb5902526d0c300a6b93f1e4/vivus-w-min.jpg"
          }
        },
        "ratings": {
          "rating": 9.4,
          "interest": 10,
          "assessment": 10,
          "opening": 10,
          "total_partial_cancellation": 10,
          "commissions": 4
        },
        "has_review": false
      },
      {
        "id": 515,
        "name": "Minicrédito MoneyMan",
        "slug": "microprestamo-moneyman",
        "product_name": "microcredit",
        "product_type": "loan",
        "claim": "",
        "starred": false,
        "best_buy": false,
        "sponsored": true,
        "updated_at": "2020-03-11T10:50:15.435+01:00",
        "sponsored_order": 2,
        "description": "<p>El <strong>Minicrédito Moneyman</strong> es un producto de financiación que te permitirá conseguir dinero de forma rápida, sencilla y sin apenas dar explicaciones. En concreto, este minicrédito <strong>te permitirá solicitar entre 100 y 400€</strong> (o hasta 1.300€ si eres antiguo cliente), a devolver en un plazo de entre cinco y 62 días.<br><br>\nEn lo que respecta a sus costes, el Minicrédito Moneyman <strong>no tiene comisiones</strong>. Además, a diferencia de lo que ocurre con los préstamos personales tradicionales, este microcrédito no aplica un Tipo de Interés Nominal (TIN) en forma de porcentaje; en lugar de eso, te cobrará unos honorarios, o lo que es lo mismo, una cantidad fija en euros. Esa cantidad dependerá de la cantidad que pidas, el plazo de devolución o, incluso, de si eres nuevo o antiguo cliente. Así, por ejemplo, si fueras nuevo cliente y pidieras 300€ a devolver en 30 días, no tendrías que pagar nada: es decir, conseguirías dinero gratis (0%TAE). En cambio, si eres antiguo cliente y, por ejemplo, pides 100€ a devolver en 30 días, tendrías que pagar unos honorarios de 33€, lo que equivaldría a una TAE (Tasa Anual Equivalente) del 3.112,64%. <br>\nEn cuanto a los <strong>requisitos y exigencias del Minicrédito Moneyman</strong>, debes saber que no te exige contratar productos vinculados, ni tampoco cambiar de banco. Para poder solicitar este microcrédito solo tendrás que ser mayor de edad, disponer de una cuenta bancaria (que será donde te ingresen el dinero) y de un dispositivo con conexión a Internet para poder realizar tu solicitud. </p>\n",
        "has_deal": true,
        "url": "https://clk.tradedoubler.com/click?p=303287&a=2924858&g=24704896",
        "loan_type": "microcredit",
        "typ_description": "<ul>\n<li>Hasta <strong>300€</strong> </li>\n<li>Hasta 62 días de plazo de devolución </li>\n<li>Transferencia en 15 minutos </li>\n</ul>\n",
        "comments": null,
        "obligations": {
          "old_clients": true,
          "new_clients": true,
          "min_age": 18,
          "signup_online": true,
          "defaulter": true,
          "must_justify_purpose": false,
          "only_online": null,
          "cities_number": null,
          "client_type": "general"
        },
        "purposes": {
          "vehicles": true,
          "studies": true,
          "travels": true,
          "home": true,
          "celebrations": true,
          "others": true,
          "others_description": "<p>El Minicrédito Moneyman te permite financiar cualquier compra o pago que necesites realizar. Ahora bien, recuerda que, como solo te dejará pedir hasta 400€ (o 1.300€ si eres antiguo cliente), las posibles finalidades a las que quieras destinar el dinero podrían verse reducidas. </p>\n",
          "ecological": null
        },
        "features": {
          "min_amount": 100,
          "max_amount": 400,
          "min_term": 5,
          "max_term": 62,
          "amount_description": "<p>En caso de que seas antiguo cliente, con el Minicrédito Moneyman podrás pedir hasta 1.300€, en lugar de los 400€ que esta entidad pone como tope para los recién llegados.</p>\n"
        },
        "costs": {
          "costs_and_commissions": false,
          "insurance_required": "non_insurable",
          "change_bank_required": false,
          "interest": 0.0,
          "apr": 0.0,
          "apr_description": "<p>Para nuevos clientes, la TAE del Minicrédito Moneyman es del 0%, ya que te permite pedir 300€, a devolver en 300 días, sin pagar nada a cambio: ni comisiones ni honorarios. En cambio, si eres antiguo cliente sí tendrás que pagar: por ejemplo, si pidieras 100€ a devolver en 30 días, tendrías que pagar unos honorarios de 33€, lo que equivale a una TAE del 3.112,64%. </p>\n",
          "has_assessment": false,
          "has_opening": false,
          "has_total_partial_cancellation": false,
          "has_commissions": true,
          "commissions": {
            "fee": 0.0,
            "description": "<p>Si eres nuevo cliente, el Minicrédito Moneyman te saldrá gratis, ya que no tendrás que pagar honorarios ni comisiones. En cambio, si eres antiguo cliente, la cosa cambiar: por ejemplo, si pidieras 100€, a devolver en 30 días, tendrías que pagar unos honorarios de 33€.</p>\n"
          }
        },
        "has_promo": false,
        "bank": {
          "id": 90,
          "name": "Moneyman",
          "slug": "moneyman",
          "image": {
            "url": "https://admin.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBZ01FIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--0f93041a79fd79d9e8eab311660ed83aad07e83b/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--bc312bd58021bbff684addb7e55e5aa904a5358a/moneyman-s-min.jpg",
            "url_square": "https://admin.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBZ01FIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--0f93041a79fd79d9e8eab311660ed83aad07e83b/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--bc312bd58021bbff684addb7e55e5aa904a5358a/moneyman-s-min.jpg",
            "url_rectangular": "https://admin.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBZ1FFIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--1ac08ef8b3eb66916f99a4cf327830a1041baf36/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRERNMk5IZzVObDRHT2daRlZEb01aM0poZG1sMGVVa2lDMk5sYm5SbGNnWTdCMVE2Q1dOeWIzQkpJZzh6TmpSNE9UWXJNQ3N3QmpzSFZBPT0iLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--cefecec422de2b27eb5902526d0c300a6b93f1e4/moneyman-w-min.jpg"
          }
        },
        "ratings": {
          "rating": 9.4,
          "interest": 10,
          "assessment": 10,
          "opening": 10,
          "total_partial_cancellation": 10,
          "commissions": 4
        },
        "has_review": false
      },
      {
        "id": 517,
        "name": "Microprestamo Credy",
        "slug": "microcredito-credy",
        "product_name": "microcredit",
        "product_type": "loan",
        "claim": "",
        "starred": false,
        "best_buy": false,
        "sponsored": false,
        "updated_at": "2020-03-11T10:50:15.468+01:00",
        "description": "<p>El <strong>Micropréstamo Credy</strong> es el nombre que designa los productos de financiación que ofrece Credy, un servicio que permite que el consumidor localice el microcrédito que mejor se adapte a sus necesidades entre distintas ofertas. <br>\nCon el Micropréstamo Credy podrás solicitar una pequeña cantidad de dinero, de forma rápida y sin apenas dar explicaciones. A cambio, tendrás que abonar <strong>un interés del 365% TIN</strong> (Tipo de Interés Nominal), aunque esta cifra puede variar dependiendo del producto que finalmente elijas, el plazo de devolución, la cantidad que solicites o, incluso, si eres nuevo o antiguo cliente. Con los micropréstamos de Credy podrás solicitar <strong>entre 50 y 750€</strong>, a devolver en un plazo de entre uno y 30 días. <br>\nEl Micropréstamo Credy <strong>no tiene comisiones</strong> ni tampoco te exige cumplir con ningún requisito. Es más, entre las ofertas de Credy podrás encontrar algunas que ofrecen financiación a clientes que figuren en listados de morosidad, como el de ASNEF. Para solicitar uno de estos microcréditos solo tendrás que ser mayor de 18 años, tener un dispositivo con el que conectarte a Internet –la solicitud solo se puede realizar online- y disponer de una cuenta bancaria en la que se te ingresará el dinero. </p>\n",
        "has_deal": true,
        "url": "https://clk.tradedoubler.com/click?p=305620&a=2924858&g=24765796",
        "loan_type": "microcredit",
        "typ_description": null,
        "comments": null,
        "obligations": {
          "old_clients": true,
          "new_clients": true,
          "min_age": 18,
          "signup_online": true,
          "defaulter": true,
          "must_justify_purpose": false,
          "only_online": null,
          "cities_number": null,
          "client_type": "general"
        },
        "purposes": {
          "vehicles": true,
          "studies": true,
          "travels": true,
          "home": true,
          "celebrations": true,
          "others": true,
          "others_description": "<p>El <strong>Micropréstamo Credy</strong> te permitirá solicitar dinero para cualquier finalidad. No obstante, recuerda que las cantidades que permite pedir (entre 50 y 750€) podrían limitar las finalidades a las que deseas destinar el dinero. </p>\n",
          "ecological": null
        },
        "features": {
          "min_amount": 50,
          "max_amount": 750,
          "min_term": 1,
          "max_term": 30,
          "amount_description": null
        },
        "costs": {
          "costs_and_commissions": false,
          "insurance_required": "non_insurable",
          "change_bank_required": false,
          "interest": 365.0,
          "apr": 365.0,
          "apr_description": "<p>Recuerda que los intereses que tendrás que abonar con el Micropréstamo Credy dependerán del proveedor con el que finalmente elijas trabajar. Además, la cantidad que solicites o el plazo de devolución también podrían hacer que los intereses que pagues terminen variando.</p>\n",
          "has_assessment": false,
          "has_opening": false,
          "has_total_partial_cancellation": false,
          "has_commissions": false
        },
        "has_promo": false,
        "bank": {
          "id": 84,
          "name": "Credy",
          "slug": "credy",
          "image": {
            "url": "https://admin.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdmNEIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--4feeecf6c52c9a034c659436c58f11df8c52e70e/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--bc312bd58021bbff684addb7e55e5aa904a5358a/credy-s-min.jpg",
            "url_square": "https://admin.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdmNEIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--4feeecf6c52c9a034c659436c58f11df8c52e70e/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--bc312bd58021bbff684addb7e55e5aa904a5358a/credy-s-min.jpg",
            "url_rectangular": "https://admin.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdmdEIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--0ea65e39e14c0676a9ad8c9c7503c2bbc2799b6b/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRERNMk5IZzVObDRHT2daRlZEb01aM0poZG1sMGVVa2lDMk5sYm5SbGNnWTdCMVE2Q1dOeWIzQkpJZzh6TmpSNE9UWXJNQ3N3QmpzSFZBPT0iLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--cefecec422de2b27eb5902526d0c300a6b93f1e4/credy-w-min.jpg"
          }
        },
        "ratings": {
          "rating": 7.8,
          "interest": 4,
          "assessment": 10,
          "opening": 10,
          "total_partial_cancellation": 10,
          "commissions": 10
        },
        "has_review": false
      }
    ]
  }
}

Arguments

Parameter Description
slug Required string The slug of the category to retrieve.
limit Required string The max. number of offers to retrieve.
source Optional Integer Defines el source the phone number displayed. the value must be: idealista, default. In case we do not receive no parameters the default will be taken.

 Returns

Returns a list of offers from a category slug. The offers are always sorted by the category list order, and only returns the desired amount (limit) of offers.

The country object

Attributes

# Example object

{
  "name": "Spain",
  "continent": "Europe",
  "currency": "EUR",
  "translations": {
    "en": "Spain",
    "es": "España"
  }
}
Attribute Description
name string Name of the country.
continent string Continent of the country.
currency string Currency code used in the country.
translations hash Translation object

The translation object

Attributes

# Example object

{
  "en": "Spain",
  "es": "España"
}
Attribute Description
en string Name of the country in english.
es string Name of the country in spanish.

The image object

Attributes

# Example object

{
  "url": "https://api.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBYzA9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--1bca8c03b3ada83171f47daf0924e389b5c11fa1/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--e4438123782b514c5dd2c7ccc53000c045a02e84/banco-mediolanum-s.jpg",
  "url_square": "https://api.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBYzA9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--1bca8c03b3ada83171f47daf0924e389b5c11fa1/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRFRJMU1IZ3lOVEJlQmpvR1JWUTZER2R5WVhacGRIbEpJZ3RqWlc1MFpYSUdPd2RVT2dsamNtOXdTU0lRTWpVd2VESTFNQ3N3S3pBR093ZFUiLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--e4438123782b514c5dd2c7ccc53000c045a02e84/banco-mediolanum-s.jpg",
  "url_big": "https://assets.kelisto.us/1lyol30c6jac17cf08pi11l4seqr",
  "url_rectangular": "https://api.kelisto.dev/rails/active_storage/representations/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBYzQ9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--006b80a619c2253241139317d0c020a95205ba6e/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdCam9VWTI5dFltbHVaVjl2Y0hScGIyNXpld2c2QzNKbGMybDZaVWtpRERNMk5IZzVObDRHT2daRlZEb01aM0poZG1sMGVVa2lDMk5sYm5SbGNnWTdCMVE2Q1dOeWIzQkpJZzh6TmpSNE9UWXJNQ3N3QmpzSFZBPT0iLCJleHAiOm51bGwsInB1ciI6InZhcmlhdGlvbiJ9fQ==--145c204ed502b2f8bd6b1400501ac239797de85e/banco-mediolanum-w.jpg",
  "url_profile": "https://assets.kelisto.us/1lyol30c6jac17cf08pi11l4seqr",
  "url_positive": "https://assets.kelisto.us/ta5e4ccky6wzcuf1kuzb2xs1b3un",
  "url_negative": "https://assets.kelisto.us/ta5e4ccky6wzcuf1kuzb2xs1b3un"
  },
}
Attribute Description
url string Url of the image.
url_square optional, string PF bank PNG square-cropped image.
url_big optional, string PF bank PNG square-cropped image.
url_rectangular optional, string PF bank or Comms porvider PNG square-cropped image..
url_profile optional, string Comms provider PNG profile Url image.
url_positive optional, string Comms provider SVG positive Url image.
url_negative optional, string Comms provider SVG negative Url image.

The promo object

Attributes

# Example object

{
  "starts_at": "2017-01-08T23:55:00+01:00",
  "expires_at": "2017-02-15T23:55:00+01:00",
  "claim": "Precio más barato hasta final de mes.",
  "description": "Se aplica este precio reducido hasta el día 30-09-2020 y luego se aplica el precio habitual.",
  "months": 1,
  "monthly_price": 42.4,
  "type": "price"
}
Attribute Description
starts_at datetime Promo starts date.
expires_at datetime Promo ends date.
claim string Promo short description.
description string Promo description.
months integer Number of promo months.
monthly_price float Monthly offer price during the months of active promo.
type integer Promo type. Value should be one of these: price, others.

The review object

Attributes

# Example object

{
  "title": "Oferta recomendable",
  "description": "Contraté este producto y me parece una buena inversión",
  "author": {
    "name": "Juanita",
    "firstname": "Pérez",
    "lastname": "Roma",
    "title": "Inversora"
  },
  "image": {
    "url": "https://api.kelisto.dev/rails/active_storage/representations/.../fotoreview.jpg"
  }
}
Attribute Description
title string Title of the review.
description string Review text.
author hash Author object.
image hash Image object.

The author object

Attributes

# Example object

{
  "name": "Juanita",
  "firstname": "Pérez",
  "lastname": "Roma",
  "title": "Inversora"
}
Attribute Description
name string Name of the author.
firstname string Firstname of the author.
lastname string Lastname of the author.
title string Title of the author.

Operators

Operators can be used along with some arguments to specify conditions.

#  Definition
GET https://api.kelisto.es/api/v3/.../attribute[operator]=value

# Example use case
$ curl https://api.kelisto.es/api/v3/finances/offers/deposits?fixed_term[gt]=100&fixed_term[lt]=130

Supported values

Parameter Description
gt Means "greater than".
lt Means "lower than".
gte Means "greater than or equal to".
lte Means "lower than or equal to".
eq Means "equal to".

 API Ratings

Company ratings

The rating object

Attributes

# Example object

{
  "count": "4894",
  "average": "7.69",
  "seal": "standard"
}
Attribute Description
count string Number of rates performed to the company.
average string Average values of the rates (from 1 to 10).
seal string  Offer slug.

Retrieve a company rating

# Definition
GET https://mi.kelisto.es/api/v3/ratings/?apikey=YOUR_API_TOKEN

# Example request
$ curl https://mi.kelisto.es/api/v3/ratings/?apikey=YOUR_API_TOKEN
# Example response

{
  "count": "4894",
  "average": "7.69",
  "seal": "standard"
}

Arguments

N/A

 Returns

Returns a Company rating object.

 API Customers

Customers

The customer object

Attributes

# Example object

{
    "email": "[email protected]",
    "name": "Test name",
    "newsletter_accepted": "1",
    "source": "",
    "section": "",
    "product_type": ""
}
Attribute Description
email string The customer email address.
name string The customer name.
newsletter_accepted string  true (accepted) or false (declined) based on the customer prefferences.
source string Defines the customer source. posible values: idealista, default. (If we don't recive any value we store de default value)
section string Defines the customer procedence section. posible values: Compare, Offer_detail, Compare_top, Compare_sem, process_help_results, process_help_results_sem, article, article_podium, article_opinion_card, newsletter. (If we don't recive any value we store de default value)
product_type string The customer product type procedence (empty for newsletter subscription).

add a customer to the newsletter

# Definition
GET https://chronicle.kelisto.es/api/v1/customers/?apikey=YOUR_API_TOKEN

# Example request
$ curl --request POST \
  --url 'https://chronicle.kelisto.es/api/v1/customers?apikey=YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "email":"[email protected]",
    "name": "Test name",
    "newsletter_accepted": "true",
    "source": "default",
    "section": "Home",
    "product_type": ""
}'
# Example response

{
    "message": "updated customer"
}

Arguments

Parameter Description
email Required string The customer email address.
newsletter_accepted Required string true (accepted) or false (declined) based on the customer prefferences.
name Optional string The customer name.
source Optional string Defines the customer source. posible values: idealista, default. (If we don't recive any value we store de default value)
section Optional string Defines the customer procedence section. posible values: Compare, Offer_detail, Compare_top, Compare_sem, process_help_results, process_help_results_sem, article, article_podium, article_opinion_card, newsletter. (If we don't recive any value we store de default value)
product_type Optional string The customer product type procedence (empty for newsletter subscription).

 Returns

Returns 200 status code response, with a human readable message specifying if the object was created or update, e.g.:

Returns an error if create parameters are invalid (e.g. specifying an invalid email).