Api Colombia

    View Repository

    https://github.com/Mteheran/api-colombia

    View Swagger

    https://api-colombia.com/swagger/index.html
                

API Colombia is a public RESTful API that enable users to obtain a variety of public information about the country "Colombia".

Project Support Features

  • Minimal API's endpoints to get information about :
    1. General information about the country.
    2. Departments/States.
    3. Region.
    4. Cities.
    5. Presidents.
    6. Tourist attractions.
  • Swagger documentation.
  • Does not requiere authentications.
  • You can obtain the pageList endpoints that return
    the paged information.
    add to the end of each endpoint /pagedList

    example:
    /api/{version}/city/pagedList

Get info Colombia

      Get info Colombia
              
  {
  "id": 1,
  "name": "Colombia",
  "description": "Colombia, officially the Republic of Colombia, 
  is a country in South America with insular regions in North 
  America—near Nicaragua's Caribbean coast—as well as in the 
  Pacific Ocean. The Colombian mainland is bordered by the 
  Caribbean Sea to the north,Venezuela to the east and northeast,
  Brazil to the southeast, Ecuador and Peru to the south and 
  southwest,the Pacific Ocean to the west, and Panama to the northwest. 
  Colombia is divided into 32 departments and the Capital District 
  of Bogotá, the country's largest city. It covers an area of 1,141,748 
  square kilometers (440,831 sq mi), and has a population of 52 million.
  Colombia's cultural heritage—including language, religion, cuisine, and 
  art—reflects its history as a Spanish colony, fusing cultural elements 
  brought by immigration from Europe and the Middle East, with those brought 
  by enslaved Africans, as well as with those of the various Indigenous 
  civilizations that predate colonization. Spanish is the official state 
  language,although English and 64 other languages are 
  recognized regional languages.",
  "stateCapital": "Bogotá",
  "surface": 1141748,
  "population": 52235050,
  "languages": [
  "Spanish",
  "English"
  ],
  "timeZone": "UTC-5",
  "currency": "Colombian Peso",
  "currencyCode": "COP",
  "isoCode": "CO",
  "internetDomain": ".co",
  "phonePrefix": "+57",
  "radioPrefix": "HK",
  "aircraftPrefix": "HK",
  "departments": null,
  "presidents": null
  }        
  
                  

Get the information of Colombia
/api/{version}/country/Colombia

Get departament

      Get departament
  

Get the list of all the departments in Colombia
/api/{version}/Department



  {
  "id": 9,
  "name": "Caquetá",
  "description": "Caquetá es uno de los treinta y dos departamentos que, 
  junto con Bogotá, Distrito Capital, forman la República de Colombia.
  Su capital es Florencia. Está ubicado al sur del país, en la región 
  Amazonia, limitando al norte con Meta y Guaviare, al noreste con 
  Vaupés, al sur con Amazonas y Putumayo, y al oeste con Cauca y Huila.
  Con 88 965 km² es el tercer departamento más extenso —por detrás 
  de Amazonas y Vichada—. Todos sus municipios forman parte de 
  los territorios focalizados",
  "cityCapitalId": 364,
  "municipalities": 16,
  "surface": 88965,
  "population": 419275,
  "phonePrefix": "8",
  "countryId": 1,
  "cityCapital": null,
  "country": null,
  "cities": null
  }

          

Get Region

      Get Region
  

Get the list of all regions in Colombia
/api/{version}/Region



{
"id": 1,
"name": "Caribe",
"description": null,
"departments": null
}

          

Get touristic attraction

      Get touristic attraction
  
                  

Get the list of all the touristic attractions in Colombia
/api/{version}/TouristicAttraction


 
{
"id": 1,
"name": "Museo del oro",
"description": "El Museo del Oro del Banco de la República de Colombia
es una institución pública la cual su fin es la adquisición, 
conservación y exposición de piezas de orfebrería y alfarería 
de culturas indígenas del periodo precolombino de la actual 
Colombia, cuenta con más de 30 000 piezas hechas en oro, 20 000 
de objetos líticos, cerámicos, piedras y textiles pertenecientes a
las culturas Quimbaya, Calima, Tairona, Zenú, Muisca, Tolima, 
Tumaco entre otros. Este museo se encuentra en el costado oriental
del parque Santander, en el centro histórico de Bogotá cerca de 
la estación de TransMilenio Museo del Oro.",
"images": [
"https://upload.wikimedia.org/wikipedia/commons/thumb/d/dc/BOG_Museo_del_Oro.JPG/800px-BOG_Museo_del_Oro.JPG"
],
"latitude": "4.601919",
"longitude": "-74.072",
"cityId": 167,
"city": null
}
            
            

Get president

      Get Presidents
  
                  

Get the list of all the presidents in Colombia
/api/{version}/President



{
"id": 1,
"image": "https://upload.wikimedia.org/wikipedia/commons/thumb/6/63/Jos%C3%A9_Mar%C3%ADa_Campo_Serrano_1.jpg/500px-Jos%C3%A9_Mar%C3%ADa_Campo_Serrano_1.jpg",
"name": "José María",
"lastName": "Campo Serrano",
"startPeriodDate": "1886-08-05",
"endPeriodDate": "1887-01-06",
"politicalParty": "Partido Nacional",
"description": "José María Campo Serrano (Santa Marta, 8 de septiembre
de 1832-Santa Marta, 24 de febrero de 1915) fue un político, abogado
y militar colombiano, miembro del extinto Partido Nacional 
Colombiano. Ocupó varios cargos de importancia, siendo congresista, 
gobernador en varias ocasiones del Estado Soberano del Magdalena 
y jefe civil y militar de Antioquia durante la revolución de 1885. 
También ejerció como ministro durante los gobiernos de Francisco 
Javier Zaldúa, Ezequiel Hurtado y Rafael Núñez. Concurrió por 
Antioquia al Consejo Nacional de Delegatarios. Campo fue elegido 
designado presidencial para el período 1886-1888, siendo nombrado 
presidente ante la ausencia del titular Rafael Núñez, de 1886 a 
enero de 1887. En su corto mandato, Campo fue el encargado de 
sancionar la nueva constitución de 1886, que estuvo vigente hasta 
1991.",
"cityId": 709,
"city": null
}

            

GET Natural Area

      GET Natural Area
  
                  

This endpoint returns a list of natural areas in Colombia
/api/{version}/NaturalArea



{ "id": 1, 
"areaGroupId": 6, 
"categoryNaturalAreaId": 7, 
"name": "Cueva de los Guácharos", 
"departmentId": 18, 
"daneCode": 41, 
"landArea": 4873.0575943204, 
"maritimeArea": null, 
"department": { "id": 18, "name": "Huila", 
"description": "Huila es uno de los treinta y dos 
departamentos que junto con Bogotá, Distrito Capital, 
conforman la República de Colombia. Su capital y ciudad 
más poblada es Neiva. Está ubicado al suroeste del país,
en la región andina, limitando al norte con Tolima y 
Cundinamarca, al este con Meta, al sur con Caquetá y al 
oeste con Cauca.", 
"cityCapitalId": 657, 
"municipalities": 37, 
"surface": 19890, 
"population": 1140932, 
"phonePrefix": "8", 
"countryId": 1, 
"cityCapital": null, 
"country": null, 
"cities": null, 
"regionId": 5, 
"region": null, 
"naturalAreas": [ null ] }, 
"categoryNaturalArea": { "id": 7, 
"name": "Parque Nacional Natural", 
"description": "La declaración de Áreas Protegidas del Sistema 
de Parques corresponde al Ministerio de Ambiente y su 
administración y manejo a Parques Nacionales Naturales.", 
"naturalAreas": [ null ] 
} }

            

GET Category Natural Area

      GET Category Natural Area
  
                  

This endpoint returns a list of category natural areas in Colombia
/api/{version}/CategoryNaturalArea



{
  "id": 1,
  "name": "Área Natural Única",
  "description": "Área geográfica que, por poseer condiciones especiales 
  de flora o gea es un escenario natural raro.",
  "naturalAreas": null
},
{
  "id": 2,
  "name": "Reserva Natural",
  "description": "Área geográfica en la cual existen condiciones primitivas 
  de flora, fauna y gea, y está destinada a la conservación, investigación 
  y estudio de sus riquezas naturales.",
  "naturalAreas": null
}

            

GET Map

      GET Map
  
                  

This endpoint returns a list of Map
/api/{version}/Map



{
"id": 2,
"name": "Mapa Oficial Político Administrativo de Colombia",
"description": "Este mapa muestra la división territorial y
administrativa del país. 
En él se pueden visualizar los diferentes estados, provincias, regiones, 
municipios y sus respectivas capitales.",
"departamentId": null,
"urlImages": [
  "https://apicolombiastorage.blob.core.windows.net/maps/2-politicio-administrativo.jpg"
],
"urlSource": "https://geoportal.igac.gov.co/contenido/mapas-nacionales",
"departament": null
}

            

GET Invasive Specie

      GET Invasive Specie
  
                  

This endpoint returns a list of Invasive Specie
/api/{version}/Invasivespecie



{
  "id": 1,
  "name": "Acacia negra, gris",
  "scientificName": "Acacia decurrens Willd",
  "commonNames": "acacia ceniza, acacia",
  "impact": "Esta especie forma periódicamente capas de hojarasca en el suelo que detiene o desvían procesos sucesionales, inhibiendo la expresión de bancos de semillas y limitando la oferta de recursos, lo que genera una exclusión de la flora y fauna nativa, además de alteraciones edáficas e hidrológicas que en conjunto no permiten la dinamización de los procesos funcionales de los ecosistemas",
  "manage": "A pesar de que la especie presenta una alta producción de semillas y tasa de germinación, un alto porcentaje de plántulas no sobreviven hasta llegar a individuos jóvenes, por lo que se recomiendan intervenciones de control enfocadas en las plántulas exitosas, con el fin de disminuir costos en los recursos usados para este fin",
  "riskLevel": 2,
  "urlImage": "https://apicolombiastorage.blob.core.windows.net/invasivespecies/1- Acacia negra, gris.png"
},

            

GET Native Community

      GET Native Community
  
                  

This endpoint returns a list of Native Community
/api/{version}/NativeCommunity



{
  "id": 1,
  "name": "Achagua Piapoco",
  "description": "Achagua es un pueblo indígena, que hasta el siglo XVIII habitó en la cuenca de los ríos Casanare, Meta y Apure y del que actualmente sobreviven las comunidades de los resguardos de Humapo y El Turpial, en el municipio colombiano de Puerto López y algunas familias en La Primavera (Vichada), Puerto Gaitán (Meta) y La Hermosa (Casanare).",
  "languages": "Achagua, Piapoco, Castellano",
  "images": null
}

            

GET Airport

      GET Airport
  
                  

This endpoint returns a list of Airports
/api/{version}/Airport



    {
    "id": 1,
    "name": "Aeropuerto Internacional El Edén",
    "iataCode": "AXM",
    "oaciCode": "SKAR",
    "type": "Internacional",
    "deparmentId": 25,
    "department": {
    "id": 25,
    "name": "Quindío",
    "description": "Quindío, también llamado El Quindío, es uno de los treinta y dos departamentos que, junto con Bogotá, Distrito Capital, forman la República de Colombia. Su capital es Armenia. Está ubicado en el centro-oeste del país, en la región andina, limitando al norte con Risaralda, al este con Tolima y al oeste con Valle del Cauca. Con 1845 km² es el segundo departamento menos extenso —por delante de San Andrés y Providencia— y con 306 hab/km², el tercero más densamente poblado, por detrás de San Andrés y Providencia y Atlántico. Pertenece al eje cafetero y a la región paisa",
    "cityCapitalId": 885,
    "municipalities": 12,
    "surface": 1845,
    "population": 569569,
    "phonePrefix": "6",
    "countryId": 1,
    "cityCapital": null,
    "country": null,
    "cities": null,
    "regionId": 5,
    "region": null,
    "naturalAreas": null,
    "maps": null,
    "indigenousReservations": null,
    "airports": [
    null
    ]
    },
    "cityId": 885,
    "city": {
    "id": 885,
    "name": "Armenia",
    "description": "Armenia es un municipio colombiano, capital del departamento del Quindío y núcleo económico de su área metropolitana. Es una de las principales ciudades del eje cafetero colombiano, la región paisa y el Paisaje Cultural Cafetero.4​ Fundada en 1889 durante la colonización antioqueña, basó su economía en la agricultura",
    "surface": 121,
    "population": 316926,
    "postalCode": "630001",
    "departmentId": 25,
    "department": null,
    "touristAttractions": null,
    "presidents": null,
    "indigenousReservations": null,
    "airports": [
    null
    ]
    },
    "latitude": -75.7659806671205,
    "longitude": 4.4532428642135
    }

            

GET Constitution Article

      GET Constitution Article
  
                  

This endpoint returns a list of Article in the constitution
/api/{version}/constitutionarticle



    {
    "id": 1,
    "titleNumber": 1,
    "title": "DE LOS PRINCIPIOS FUNDAMENTALES",
    "chapterNumber": 1,
    "chapter": "DE LOS PRINCIPIOS FUNDAMENTALES",
    "articleNumber": 1,
    "content": "Colombia es un Estado social de derecho, organizado en forma de República unitaria, descentralizada, con autonomía de sus entidades territoriales, democrática, participativa y pluralista, fundada en el respeto de la dignidad humana, en el trabajo y la solidaridad de las personas que la integran y en la prevalencia del interés general."
    }

Contributors

Thanks goes to these wonderful people

Rina Plata
Rina Plata
Mario Botero
Mario Botero
Miguel Teheran
Miguel Teheran
Veronica Guaman
Vero Guaman
Veronica Guaman
Alejandro Herreño
Lili Valencia
Lili Valencia