{"openapi":"3.1.0","info":{"title":"API de DatosBolivia.com","version":"1.0.0","description":"Las series, los lugares y el cupo de la propia llave. Cada consulta cuenta una vez contra el cupo mensual del plan. Documentación: https://datosbolivia.com/servicios/api"},"servers":[{"url":"https://datosbolivia.com"}],"security":[{"llave":[]}],"paths":{"/api/v1/uso":{"get":{"summary":"Plan, cupo y consultas usadas por la llave","responses":{"200":{"description":"El uso del mes. Esta consulta ya está contada.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"plan":{"type":"string","enum":["analista","profesional","institucional"]},"nombre":{"type":"string"},"estado":{"type":"string"},"pagado_hasta":{"type":["string","null"]},"cupo_mensual":{"type":"integer"},"usadas":{"type":"integer"},"restantes":{"type":"integer"},"reinicio":{"type":"string","format":"date"}}},"siguiente":{"type":"null"},"fuente":{"type":"string"},"actualizado":{"type":"string"}}}}}},"400":{"description":"Un parámetro no es válido.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Falta la llave, no tiene la forma obs_live_… o fue revocada.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan de la llave no está vigente o no incluye la API.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Se agotó el cupo del mes o se pasó de 60 consultas por minuto.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}},"Retry-After":{"schema":{"type":"integer"},"description":"Segundos de espera."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"El servicio de cuentas o la base no respondieron.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/series":{"get":{"summary":"Catálogo de series","description":"Sin `fuente`: las series diarias (dólar oficial y paralelo, UFV), las anuales de Bolivia y el panel del Banco Mundial. Con `fuente=bcb`: las estadísticas del Banco Central, de a 40 por página.","parameters":[{"name":"fuente","in":"query","schema":{"type":"string","enum":["diario","macro","panel","bcb"]}},{"name":"buscar","in":"query","description":"Palabras en el código o el nombre.","schema":{"type":"string"}},{"name":"familia","in":"query","description":"Solo con fuente=bcb: la familia de cuadros.","schema":{"type":"string"}},{"name":"pageSize","in":"query","description":"Filas por página, de 1 a 5000.","schema":{"type":"integer","minimum":1,"maximum":5000,"default":1000}},{"name":"cursor","in":"query","description":"El valor de `siguiente` de la página anterior.","schema":{"type":"string"}},{"name":"formato","in":"query","description":"`csv` devuelve la página en CSV (UTF-8 con BOM); el cursor de la siguiente va en el encabezado `X-Siguiente`.","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"Una página de filas.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","siguiente","fuente","actualizado"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Serie"}},"siguiente":{"type":["string","null"],"description":"Cursor de la página siguiente; null en la última."},"fuente":{"type":"string"},"actualizado":{"type":["string","null"]}}}},"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"Un parámetro no es válido.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Falta la llave, no tiene la forma obs_live_… o fue revocada.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan de la llave no está vigente o no incluye la API.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Se agotó el cupo del mes o se pasó de 60 consultas por minuto.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}},"Retry-After":{"schema":{"type":"integer"},"description":"Segundos de espera."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"El servicio de cuentas o la base no respondieron.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/series/{codigo}":{"get":{"summary":"Observaciones de una serie","parameters":[{"name":"codigo","in":"path","required":true,"description":"El código del catálogo, p. ej. `diario.FX_OFFICIAL_USD_BOB`.","schema":{"type":"string"}},{"name":"desde","in":"query","description":"AAAA, AAAA-MM o AAAA-MM-DD, inclusive.","schema":{"type":"string"}},{"name":"hasta","in":"query","description":"AAAA, AAAA-MM o AAAA-MM-DD, inclusive.","schema":{"type":"string"}},{"name":"pageSize","in":"query","description":"Filas por página, de 1 a 5000.","schema":{"type":"integer","minimum":1,"maximum":5000,"default":1000}},{"name":"cursor","in":"query","description":"El valor de `siguiente` de la página anterior.","schema":{"type":"string"}},{"name":"formato","in":"query","description":"`csv` devuelve la página en CSV (UTF-8 con BOM); el cursor de la siguiente va en el encabezado `X-Siguiente`.","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"Una página de filas.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","siguiente","fuente","actualizado"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"fecha":{"type":"string","description":"Series diarias."},"periodo":{"type":"string","description":"Series anuales y del BCB."},"valor":{"type":"number"},"unidad":{"type":["string","null"]}},"additionalProperties":true}},"siguiente":{"type":["string","null"],"description":"Cursor de la página siguiente; null en la última."},"fuente":{"type":"string"},"actualizado":{"type":["string","null"]}}}},"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"Un parámetro no es válido.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Falta la llave, no tiene la forma obs_live_… o fue revocada.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan de la llave no está vigente o no incluye la API.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Se agotó el cupo del mes o se pasó de 60 consultas por minuto.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}},"Retry-After":{"schema":{"type":"integer"},"description":"Segundos de espera."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"El servicio de cuentas o la base no respondieron.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/lugares":{"get":{"summary":"Lugares por ciudad y familia","parameters":[{"name":"ciudad","in":"query","required":true,"description":"Una o varias, separadas por coma (hasta 12).","schema":{"type":"string"}},{"name":"familia","in":"query","description":"Una o varias, separadas por coma.","schema":{"type":"string"}},{"name":"pageSize","in":"query","description":"Filas por página, de 1 a 5000.","schema":{"type":"integer","minimum":1,"maximum":5000,"default":1000}},{"name":"cursor","in":"query","description":"El valor de `siguiente` de la página anterior.","schema":{"type":"string"}},{"name":"formato","in":"query","description":"`csv` devuelve la página en CSV (UTF-8 con BOM); el cursor de la siguiente va en el encabezado `X-Siguiente`.","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"Una página de filas.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","siguiente","fuente","actualizado"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Lugar"}},"siguiente":{"type":["string","null"],"description":"Cursor de la página siguiente; null en la última."},"fuente":{"type":"string"},"actualizado":{"type":["string","null"]}}}},"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"Un parámetro no es válido.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Falta la llave, no tiene la forma obs_live_… o fue revocada.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan de la llave no está vigente o no incluye la API.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Se agotó el cupo del mes o se pasó de 60 consultas por minuto.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}},"Retry-After":{"schema":{"type":"integer"},"description":"Segundos de espera."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"El servicio de cuentas o la base no respondieron.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/prensa":{"get":{"summary":"Notas del archivo de prensa","description":"De la más nueva a la más vieja. Cada filtro acepta varios valores separados por coma.","parameters":[{"name":"anio","in":"query","schema":{"type":"string"}},{"name":"tono","in":"query","schema":{"type":"string"}},{"name":"tema","in":"query","schema":{"type":"string"}},{"name":"region","in":"query","schema":{"type":"string"}},{"name":"medio","in":"query","schema":{"type":"string"}},{"name":"termino","in":"query","schema":{"type":"string"}},{"name":"buscar","in":"query","description":"Texto que tiene que aparecer en la nota.","schema":{"type":"string"}},{"name":"pageSize","in":"query","description":"Filas por página, de 1 a 5000.","schema":{"type":"integer","minimum":1,"maximum":5000,"default":1000}},{"name":"cursor","in":"query","description":"El valor de `siguiente` de la página anterior.","schema":{"type":"string"}},{"name":"formato","in":"query","description":"`csv` devuelve la página en CSV (UTF-8 con BOM); el cursor de la siguiente va en el encabezado `X-Siguiente`.","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"Una página de filas.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","siguiente","fuente","actualizado"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"fecha":{"type":"string","format":"date"},"medio":{"type":"string"},"seccion":{"type":"string"},"tema":{"type":"string"},"tono":{"type":"string"},"region":{"type":"string"},"titular":{"type":"string"},"entradilla":{"type":["string","null"]},"enlace":{"type":"string"},"obtencion":{"type":["string","null"]},"evidencia_sha256":{"type":["string","null"]}}}},"siguiente":{"type":["string","null"],"description":"Cursor de la página siguiente; null en la última."},"fuente":{"type":"string"},"actualizado":{"type":["string","null"]}}}},"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"Un parámetro no es válido.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Falta la llave, no tiene la forma obs_live_… o fue revocada.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan de la llave no está vigente o no incluye la API.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Se agotó el cupo del mes o se pasó de 60 consultas por minuto.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}},"Retry-After":{"schema":{"type":"integer"},"description":"Segundos de espera."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"El servicio de cuentas o la base no respondieron.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/empresas":{"get":{"summary":"Directorio de empresas (subconjunto público del SEPREC)","parameters":[{"name":"departamento","in":"query","schema":{"type":"string"}},{"name":"municipio","in":"query","schema":{"type":"string"}},{"name":"buscar","in":"query","description":"Texto en el nombre.","schema":{"type":"string"}},{"name":"pageSize","in":"query","description":"Filas por página, de 1 a 5000.","schema":{"type":"integer","minimum":1,"maximum":5000,"default":1000}},{"name":"cursor","in":"query","description":"El valor de `siguiente` de la página anterior.","schema":{"type":"string"}},{"name":"formato","in":"query","description":"`csv` devuelve la página en CSV (UTF-8 con BOM); el cursor de la siguiente va en el encabezado `X-Siguiente`.","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"Una página de filas.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","siguiente","fuente","actualizado"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"registro":{"type":"string"},"nombre":{"type":"string"},"departamento":{"type":["string","null"]},"municipio":{"type":["string","null"]},"direccion":{"type":["string","null"]},"actividad":{"type":["string","null"]},"licencia":{"type":["string","null"]},"fecha_de_corte":{"type":["string","null"]}}}},"siguiente":{"type":["string","null"],"description":"Cursor de la página siguiente; null en la última."},"fuente":{"type":"string"},"actualizado":{"type":["string","null"]}}}},"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"Un parámetro no es válido.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Falta la llave, no tiene la forma obs_live_… o fue revocada.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan de la llave no está vigente o no incluye la API.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Se agotó el cupo del mes o se pasó de 60 consultas por minuto.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}},"Retry-After":{"schema":{"type":"integer"},"description":"Segundos de espera."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"El servicio de cuentas o la base no respondieron.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/aduana":{"get":{"summary":"Base aduanera del INE sumada por una dimensión","description":"Como en el panel, el filtro de la misma dimensión no recorta su propio desglose. Una combinación que el INE no publica vuelve como 400 con el motivo.","parameters":[{"name":"por","in":"query","required":true,"schema":{"type":"string","enum":["year","month","section","chapter","heading","subheading","nandina","country","zone","department","activity","activityGroup","traditional","traditionalGroup","use","useGroup","kind"]}},{"name":"flujo","in":"query","schema":{"type":"string","enum":["X","M"],"default":"X"}},{"name":"desde","in":"query","description":"Año inicial (AAAA).","schema":{"type":"integer"}},{"name":"hasta","in":"query","description":"Año final (AAAA).","schema":{"type":"integer"}},{"name":"meses","in":"query","description":"Tramo de meses de cada año, p. ej. 1-7.","schema":{"type":"string"}},{"name":"producto","in":"query","description":"Códigos NANDINA de 2 a 10 dígitos, separados por coma.","schema":{"type":"string"}},{"name":"seccion","in":"query","schema":{"type":"string"}},{"name":"pais","in":"query","description":"Códigos de país del INE.","schema":{"type":"string"}},{"name":"departamento","in":"query","description":"Códigos de departamento del INE.","schema":{"type":"string"}},{"name":"actividad","in":"query","schema":{"type":"string"}},{"name":"tradicional","in":"query","schema":{"type":"string"}},{"name":"uso","in":"query","schema":{"type":"string"}},{"name":"tipo","in":"query","schema":{"type":"string"}},{"name":"pageSize","in":"query","description":"Filas por página, de 1 a 5000.","schema":{"type":"integer","minimum":1,"maximum":5000,"default":1000}},{"name":"cursor","in":"query","description":"El valor de `siguiente` de la página anterior.","schema":{"type":"string"}},{"name":"formato","in":"query","description":"`csv` devuelve la página en CSV (UTF-8 con BOM); el cursor de la siguiente va en el encabezado `X-Siguiente`.","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"Una página de filas.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","siguiente","fuente","actualizado"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"codigo":{"type":["string","null"]},"nombre":{"type":"string"},"usd":{"type":"number"},"kg":{"type":"number"},"kg_finos":{"type":["number","null"]},"usd_ultimo_anio":{"type":["number","null"]},"usd_anio_anterior":{"type":["number","null"]}}}},"siguiente":{"type":["string","null"],"description":"Cursor de la página siguiente; null en la última."},"fuente":{"type":"string"},"actualizado":{"type":["string","null"]}}}},"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"Un parámetro no es válido.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Falta la llave, no tiene la forma obs_live_… o fue revocada.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan de la llave no está vigente o no incluye la API.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Se agotó el cupo del mes o se pasó de 60 consultas por minuto.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}},"Retry-After":{"schema":{"type":"integer"},"description":"Segundos de espera."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"El servicio de cuentas o la base no respondieron.","headers":{"X-Cupo-Limite":{"description":"Consultas por mes del plan de la llave.","schema":{"type":"integer"}},"X-Cupo-Restante":{"description":"Consultas que quedan este mes, contando la actual.","schema":{"type":"integer"}},"X-Cupo-Reinicio":{"description":"Día en que el cupo vuelve a cero (primer día del mes siguiente, UTC).","schema":{"type":"string","format":"date"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"llave":{"type":"http","scheme":"bearer","description":"La llave de la cuenta: `Authorization: Bearer obs_live_…`. Se crea en /cuenta."}},"schemas":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"planes":{"type":"string"}}},"Serie":{"type":"object","properties":{"codigo":{"type":"string"},"nombre":{"type":"string"},"fuente":{"type":"string","enum":["diario","macro","panel","bcb"]},"rubro":{"type":["string","null"]},"unidad":{"type":["string","null"]},"frecuencia":{"type":"string"},"desde":{"type":["string","null"]},"hasta":{"type":["string","null"]},"observaciones":{"type":"integer"},"editor":{"type":["string","null"]}}},"Lugar":{"type":"object","properties":{"id":{"type":"string"},"ciudad":{"type":"string"},"nombre":{"type":"string"},"grupo":{"type":"string"},"familia":{"type":"string"},"barrio":{"type":["string","null"]},"direccion":{"type":["string","null"]},"marca":{"type":["string","null"]},"latitud":{"type":"number"},"longitud":{"type":"number"},"actividad_regulada":{"type":"boolean"},"registro_que_lo_confirmaria":{"type":["string","null"]},"confianza":{"type":["number","null"]},"grado_de_calidad":{"type":["string","null"]},"metodo_de_ubicacion":{"type":["string","null"]}}}}}}