Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Code Block
languagejson
{
    "returnCode": "200",
    "outlet": [
        {
            "dhisCode": "KE-CODE-123",
            "dhisId": "xkcEJARvo2O",
            "servicesStandard": "CCS,CNT,ANC,STI,HVS,HVT",
            "outletType": "Public",
            "ouShowContactInfo": "TLF",
            "path": "",
            "outletName": "Facility Clinic",
            "phoneNumber": "+254541483334",
            "postgresId": "1511345870",
            "locatorType": "OUT",
            "location": {
                "area": "Nairobi",
                "areaSub": "Starehe",
                "address": "street1, city, subarea, area",
                "latitude": "-1.28575",
                "longitude": "39.81234"
            },
            "dhisName": "Facility Clinic (KE-CODE-123)",
            "openingHours": "Mon-Fri,8:00,17:00;Sat,9:00,14:00;Public Holiday,9:00,14:00;Sun,Closed",
            "openingDate": "2023-02-11",
            "ouTags": "MSI",
            "providers": [],
            "ouContraceptives": "IMP,OCP,IUD,INJ,STL,EMC"
        }
    ]
}

Areas in the country

Provides list of areas in the country.

url : api/v1/area

method: POST

authorization: will be provided by admin

payload:

Code Block
languagejson
{
    "country": "KE",
    "pageNo": 1,
    "pageSize": 5,
    "facilityType": "Public",
    "tags": "KEUNV"
}

response:

Code Block
languagejson
{
    "response": {
        "returnCode": "200",
        "totaNosofPages": 10,
        "areas": [
            {
                "area": "Baringo",
                "country": "Kenya"
            },
            {
                "area": "Bomet",
                "country": "Kenya"
            },
            {
                "area": "Bungoma",
                "country": "Kenya"
            },
            {
                "area": "Busia",
                "country": "Kenya"
            },
            {
                "area": "Elgeyo Marakwet",
                "country": "Kenya"
            }
        ],
        "links": [
            {
                "rel": "self",
                "href": "/locator-dev/api/area?1=1&country=KE&pageNo=1&pageSize=5"
            },
            {
                "rel": "next",
                "href": "/locator-dev/api/area?1=1&country=KE&pageNo=2&pageSize=5"
            }
        ],
        "totalNosOfRecords": 48,
        "currentPageNo": "1",
        "status": "Showing 5 Areas"
    }
}

SubAreas in the country

Provides list of areas in the country.

url : api/v1/subArea

method: POST

authorization: will be provided by admin

payload:

Code Block
{
    "country": "GT",
    "area": "Guatemala",
    "pageNo": 1,
    "pageSize": 5,
    "facilityType": "Public",
    "tags": "KEUNV"
}

response:

Code Block
{
    "response": {
        "returnCode": "200",
        "totaNosofPages": 10,
        "subAreas": [
            {
                "subArea": "Amatitlán",
                "area": "Guatemala",
                "country": "GT"
            },
            {
                "subArea": "Antigua Guatemala",
                "area": "Guatemala",
                "country": "GT"
            },
            {
                "subArea": "Fraijanes",
                "area": "Guatemala",
                "country": "GT"
            },
            {
                "subArea": "Guatemala Zona 1",
                "area": "Guatemala",
                "country": "GT"
            },
            {
                "subArea": "Guatemala Zona 10",
                "area": "Guatemala",
                "country": "GT"
            }
        ],
        "links": [
            {
                "rel": "self",
                "href": "/locator-dev/api/subArea?1=1&country=GT&area=Guatemala&pageNo=1&pageSize=5"
            },
            {
                "rel": "next",
                "href": "/locator-dev/api/subArea?1=1&country=GT&area=Guatemala&pageNo=2&pageSize=5"
            }
        ],
        "totalNosOfRecords": 48,
        "currentPageNo": "1",
        "status": "Showing 5 Areas"
    }
}

You can also find the POSTMAN examples here.