Getting Started Using the Covid19.go.id web Vaccination Health Facility API

    API Endpoint

    https://kipi.covid19.go.id/api
                

The Vaccination Health Facility API data used on the Covid19.go.id website is obtained from the KPCPEN Control Tower which is updated regularly (not realtime) visit https://covid19.go.id/faskesvaksin to find out more

Getting Province List

# Here is a curl example
curl \
-X POST https://kipi.covid19.go.id/api/get-province
                

To get a list of provinces, you can access the url with the POST method:
https://kipi.covid19.go.id/api/get-province

Result example :

{
    "curr_val": "Provinsi",
    "message": "No message returned",
    "results": [
        {
            "key": "ACEH",
            "value": "ACEH"
        },
        {
            "key": "BALI",
            "value": "BALI"
        },
        {
            "key": "BANTEN",
            "value": "BANTEN"
        },
        {
            "key": "BENGKULU",
            "value": "BENGKULU"
        },
        {
            "key": "DKI JAKARTA",
            "value": "DKI JAKARTA"
        }
    ]
}
                

Getting a City List

# Here is a curl example
curl \
-X POST https://kipi.covid19.go.id/api/get-city
-F 'start_id=BALI'
                

To get a list of cities / districts, you can access the url with the POST method:
https://kipi.covid19.go.id/api/get-city

Result example :

{
    "curr_val": "Pilih Kabupaten / Kota",
    "message": "No message returned",
    "results": [
        {
            "key": "KAB. TABANAN",
            "value": "KAB. TABANAN"
        },
        {
            "key": "KAB. GIANYAR",
            "value": "KAB. GIANYAR"
        },
        {
            "key": "KAB. BADUNG",
            "value": "KAB. BADUNG"
        },
        {
            "key": "KOTA DENPASAR",
            "value": "KOTA DENPASAR"
        }
    ]
}
                

QUERY PARAMETERS

Field	Type	Description
start_id	String	(mandatory) Key from Province

Getting Vaccine Facilities

# Here is a curl example
curl \
-X POST https://kipi.covid19.go.id/api/get-faskes-vaksinasi?skip=0&province=JAWA+BARAT&city=KAB.+BOGOR
                

To get a list of vaccination health facilities, you can access the url with the GET method:
https://kipi.covid19.go.id/api/get-faskes-vaksinasi

Result example :

{
    "success": true,
    "message": "Success",
    "count_total": 1691,
    "data": [
      {
        "id": 4570,
        "kode": "10040305",
        "nama": "CIGOMBONG",
        "kota": "KAB. BOGOR",
        "provinsi": "JAWA BARAT",
        "alamat": "Jl. Mayjen H.R. Edi Sukma No.75, Watesjaya, Cigombong, Bogor, Jawa Barat 16740, Indonesia",
        "latitude": "-6.7441501",
        "longitude": "106.803131",
        "telp": "(0251) 8221047",
        "jenis_faskes": "PUSKESMAS",
        "kelas_rs": "",
        "status": "Siap Vaksinasi",
        "detail": [
          {
            "id": 10954,
            "kode": "10040305",
            "batch": "PETUGAS PUBLIK",
            "divaksin": 2787,
            "divaksin_1": 1641,
            "divaksin_2": 1146,
            "batal_vaksin": 0,
            "batal_vaksin_1": 0,
            "batal_vaksin_2": 0,
            "pending_vaksin": 0,
            "pending_vaksin_1": 0,
            "pending_vaksin_2": 0,
            "tanggal": "2021-07-07"
          },
          {
            "id": 11280,
            "kode": "10040305",
            "batch": "LANSIA",
            "divaksin": 387,
            "divaksin_1": 219,
            "divaksin_2": 168,
            "batal_vaksin": 0,
            "batal_vaksin_1": 0,
            "batal_vaksin_2": 0,
            "pending_vaksin": 0,
            "pending_vaksin_1": 0,
            "pending_vaksin_2": 0,
            "tanggal": "2021-07-07"
          },
          {
            "id": 11706,
            "kode": "10040305",
            "batch": "SDM KESEHATAN",
            "divaksin": 212,
            "divaksin_1": 110,
            "divaksin_2": 102,
            "batal_vaksin": 1,
            "batal_vaksin_1": 1,
            "batal_vaksin_2": 0,
            "pending_vaksin": 0,
            "pending_vaksin_1": 0,
            "pending_vaksin_2": 0,
            "tanggal": "2021-07-07"
          },
          {
            "id": 12993,
            "kode": "10040305",
            "batch": "TAHAP 3",
            "divaksin": 2374,
            "divaksin_1": 1637,
            "divaksin_2": 737,
            "batal_vaksin": 0,
            "batal_vaksin_1": 0,
            "batal_vaksin_2": 0,
            "pending_vaksin": 0,
            "pending_vaksin_1": 0,
            "pending_vaksin_2": 0,
            "tanggal": "2021-07-07"
          }
        ],
        "source_data": "Control Tower KPCPEN"
      }
    ]
}
                

QUERY PARAMETERS

Field	Type	Description
skip	Integer	(mandatory) Skip count for pagination, maximum data that can be loaded is 100, so if skip = 0 it will be loading data from 0 - 100, if skip = 1 it will be loading data from 100 - 200 and so on.
province	String	(optional if using parameter city, mandatory if doesn't have parameter city) Key from list Province.
city	String	(optional if using parameter province, mandatory if doesn't have parameter province) Key from list City.