Myanmar API Documentation

Candidate Endpoint

Single Candidate
Candidate Lists
Search Candidate By Name

GET single candidate

Get single candidate data by using id.

http://api.maepaysoh.org/candidate/55d474ce5bf73000108b4567?token=user-token-key&_with=party

_with optional	party	Include party data in one request	String
fields optional	id,name	With this parama, you can limit response data with only specify fields separated with comma (,)	String
token required	lmeiOxzUTQFOfIANfS3oFQ631YXqLqBt	User token key of your applicaion	String
font optional	zawgyi	Expected font (zawgyi or unicode)	String

200 500

                                            
{
    "data": {
        "id": "55f54bc411b7f310c6883c8f",
        "name": "ဦးစိုင်းစိန်အုန်း",
        "mpid": "LWMP-01-0001",
        "gender": "M",
        "photo_url": "https://storage.googleapis.com/staticassets/candidate-photos/Scan_B_20150831_165.jpg",
        "legislature": "ပြည်သူ့လွှတ်တော်",
        "birthdate": -531964800,
        "education": "(၁၀) တန်း",
        "occupation": "ခြံတောင်သူ",
        "ethnicity": "ရှမ်း",
        "religion": "ဗုဒ္ဓ",
        "ward_village": "ဧရာဦးရပ်ကွက်၊ ဆင်ဘိုမြို့",
        "constituency": {
            "name": "မြစ်ကြီးနားမဲဆန္ဒနယ်",
            "number": 0,
            "ST_PCODE": "MMR001",
            "DT_PCODE": "MMR001D001",
            "TS_PCODE": "MMR001001",
            "AM_PCODE": "MMR001HLA001",
            "parent": "ကချင်ပြည်နယ်",
        },
        "party_id": 14,
        "mother": {
            "name": "ဒေါ်သန်းကျင်(ကွယ်လွန်)",
            "religion": "ဗုဒ္ဓ"
        },
        "father": {
            "name": "ဦးထွန်းမြင့်(ကွယ်လွန်)",
            "religion": "ဗုဒ္ဓ"
        },
        "party": {
            "id": 14,
            "party_name": "ရှမ်းတိုင်းရင်းသားများဒီမိုကရက်တစ်ပါတီ",
            "party_name_english": "Shan Nationalities Democratic Party",
            "abbreviation": "",
            "member_count": "၁၅ ဦး",
            "leadership": [
                "ဦးစိုင်းအိုက်ပေါင်း",
                "ဦးနယ်(လ်)ဆင်(ခ)ဦးဆောင်ဆီ"
            ],
            "chairman": [
                "ဦးစိုင်းအိုက်ပေါင်း",
                "ဦးစိုင်းလှကျော်(ထွေ/မှူး)"
            ],
            "establishment_date": 1270684800,
            "establishment_approval_date": 1272844800,
            "registration_application_date": 1274140800,
            "registration_approval_date": 1274832000,
            "approved_party_number": "အမှတ်စဉ်( ၁၅ )",
            "party_flag": "https://storage.googleapis.com/staticassets/flags-and-logos/14-flag.png",
            "party_seal": "https://storage.googleapis.com/staticassets/flags-and-logos/14-logo.png",
            "region": "ပြည်ထောင်စုတစ်ဝန်းလုံး",
            "ST_PCODE": "MMR001",
            "DT_PCODE": "MMR001D001",
            "headquarters": "အမှတ်(၃၂၆)၊တောင်ကျောင်းလမ်း၊ မြို့မရပ်၊ တောင်ကြီးမြို့၊ ရှမ်းပြည်နယ်။",
            "contact": [
                "၀၉-၄၁၀၀၈၂၂၅(ဦ:စောယွန်းပိုင်)",
                "၀၉-၅၁၅၉၉၉၈",
                "၀၉-၂၀၂၁၃၅၈ (ဦးစိုင်းမောင်တင်)",
                "၀၈၁-၂၀၂၀၆၄",
                "၀၉-၇၃၀၄၆၂၀၆(ဦးစိုင်းလှကျော်)"
            ],
            "policy": "http://uecmyanmar.org/images/stories/policals_policies/14Shan%20Nationalities%20Democratic%20Party.pdf"
        }
    }
}

                                            
                                                
{
    "error": {
        "message": "Error message text",
    }
}

GET candidate list

Get single candidate data by using id.

http://api.maepaysoh.org/candidate/list?token=user-token-key&_with=party

_with optional	party	Include party data in one request	String
fields optional	id,name	With this parama, you can limit response data with only specify fields separated with comma (,)	String
token required	lmeiOxzUTQFOfIANfS3oFQ631YXqLqBt	User token key of your applicaion	String
font optional	zawgyi	Expected font (zawgyi or unicode)	string
per_page optional	15	Item per request (Max value is 200)	Int
gender optional	M F	Get list of items filtered by gender	String
legislature optional	ပြည်သူ့လွှတ်တော် (or) lower_house အမျိုးသားလွှတ်တော် (or) upper_house တိုင်းဒေသကြီး/ပြည်နယ် လွှတ်တော် (or) state_region	Get list of items filtered by legislature	String
party optional	14	Get list of items filtered by party id	String
constituency_st_pcode optional	MMR008	Get list of items filtered by constituency ST_PCODE (State/Division Pcode)	String
constituency_dt_pcode optional	MMR008D001	Get list of items filtered by constituency DT_PCODE (District Pcode)	String
constituency_ts_pcode optional	MMR001001	Get list of items filtered by constituency TS_PCODE (Township Pcode)	String
constituency_am_pcode optional	MMR001HLA001	Get list of items filtered by constituency AM_PCODE (Amyotha Hluttaw Pcode). This value will be only present in Upper House Candidates.	String
constituency_name optional	ကချင်	Get list of items filtered by constituency name	String
constituency_number optional	1	Get list of items filtered by constituency number. Please use it along with constituency_name or constituency_ts_pcode. Note : constituency_number is 0 for ethnic affairs ministers.	String
constituency_parent optional	ပဲခူးတိုင်းဒေသကြီး	Search by Constituency Parent Region	String

Filter by birthdate You can filter the candidate lists by their birthdate with bd_from and bd_to query parameters.
Query parameter value format are Y-m-d.
Example
http://api.maepaysoh.org/candidate/list?token=TOKEN&bd_from=1934-12-01&bd_to=1935-06-19
Month and Date value must be leading zeros.

Note : If you are not sure what PCODEs are, please check http://themimu.info/place-codes

200 500

                                            
{
    "data" : [
        {
            "id": "55f54bc411b7f310c6883c8f",
            "name": "ဦးစိုင်းစိန်အုန်း",
            "mpid": "LWMP-01-0001",
            "gender": "M",
            "photo_url": "https://storage.googleapis.com/staticassets/candidate-photos/Scan_B_20150831_165.jpg",
            "legislature": "ပြည်သူ့လွှတ်တော်",
            "birthdate": -531964800,
            "education": "(၁၀) တန်း",
            "occupation": "ခြံတောင်သူ",
            "ethnicity": "ရှမ်း",
            "religion": "ဗုဒ္ဓ",
            "ward_village": "ဧရာဦးရပ်ကွက်၊ ဆင်ဘိုမြို့",
            "constituency": {
                "name": "မြစ်ကြီးနားမဲဆန္ဒနယ်",
                "number": 0,
                "ST_PCODE": "MMR001",
                "DT_PCODE": "MMR001D001",
                "TS_PCODE": "MMR001001",
                "AM_PCODE": "MMR001HLA001",
                "parent": "ကချင်ပြည်နယ်",
            },
            "party_id": 14,
            "mother": {
                "name": "ဒေါ်သန်းကျင်(ကွယ်လွန်)",
                "religion": "ဗုဒ္ဓ"
            },
            "father": {
                "name": "ဦးထွန်းမြင့်(ကွယ်လွန်)",
                "religion": "ဗုဒ္ဓ"
            },
            "party": {
                "id": 14,
                "party_name": "ရှမ်းတိုင်းရင်းသားများဒီမိုကရက်တစ်ပါတီ",
                "party_name_english": "Shan Nationalities Democratic Party",
                "abbreviation": "",
                "member_count": "၁၅ ဦး",
                "leadership": [
                  "ဦးစိုင်းအိုက်ပေါင်း",
                  "ဦးနယ်(လ်)ဆင်(ခ)ဦးဆောင်ဆီ"
                ],
                "chairman": [
                  "ဦးစိုင်းအိုက်ပေါင်း",
                  "ဦးစိုင်းလှကျော်(ထွေ/မှူး)"
                ],
                "establishment_date": 1270684800,
                "establishment_approval_date": 1272844800,
                "registration_application_date": 1274140800,
                "registration_approval_date": 1274832000,
                "approved_party_number": "အမှတ်စဉ်( ၁၅ )",
                "party_flag": "https://storage.googleapis.com/staticassets/flags-and-logos/14-flag.png",
                "party_seal": "https://storage.googleapis.com/staticassets/flags-and-logos/14-logo.png",
                "region": "ပြည်ထောင်စုတစ်ဝန်းလုံး",
                "ST_PCODE": "MMR001",
                "DT_PCODE": "MMR001D001",
                "headquarters": "အမှတ်(၃၂၆)၊တောင်ကျောင်းလမ်း၊ မြို့မရပ်၊ တောင်ကြီးမြို့၊ ရှမ်းပြည်နယ်။",
                "contact": [
                  "၀၉-၄၁၀၀၈၂၂၅(ဦ:စောယွန်းပိုင်)",
                  "၀၉-၅၁၅၉၉၉၈",
                  "၀၉-၂၀၂၁၃၅၈ (ဦးစိုင်းမောင်တင်)",
                  "၀၈၁-၂၀၂၀၆၄",
                  "၀၉-၇၃၀၄၆၂၀၆(ဦးစိုင်းလှကျော်)"
                ],
                "policy": "http://uecmyanmar.org/images/stories/policals_policies/14Shan%20Nationalities%20Democratic%20Party.pdf"
            }
        },
        {
            ...
        }
    ],
    "meta": {
        "pagination": {
            "total": 20,
            "count": 15,
            "per_page": 15,
            "current_page": 1,
            "total_pages": 2,
            "links": {
                next: "http://example.com/link/to?page=2"
            }
        }
    }
}

                                            
                                                
{
    "error": {
        "message": "Error message text",
    }
}

GET search candidate by name

Get search candidate by name

http://api.maepaysoh.org/candidate/search?q=ဦးစိုင်းစိန်အုန်း&token=user-token-key&_with=party

q required	စိန်အုန်း	Search Keyword (Candidate name)	String
_with optional	party	Include party data in one request	String
fields optional	id,name	With this parama, you can limit response data with only specify fields separated with comma (,)	String
token required	lmeiOxzUTQFOfIANfS3oFQ631YXqLqBt	User token key of your applicaion	String
font optional	zawgyi	Search by zawgyi or unicode (Response data will be also with specified font format)	String

200 500

                                            
{
    "data" : [
        {
            "id": "55f54bc411b7f310c6883c8f",
            "name": "ဦးစိုင်းစိန်အုန်း",
            "mpid": "LWMP-01-0001",
            "gender": "M",
            "photo_url": "https://storage.googleapis.com/staticassets/candidate-photos/Scan_B_20150831_165.jpg",
            "legislature": "ပြည်သူ့လွှတ်တော်",
            "birthdate": -531964800,
            "education": "(၁၀) တန်း",
            "occupation": "ခြံတောင်သူ",
            "ethnicity": "ရှမ်း",
            "religion": "ဗုဒ္ဓ",
            "ward_village": "ဧရာဦးရပ်ကွက်၊ ဆင်ဘိုမြို့",
            "constituency": {
                "name": "မြစ်ကြီးနားမဲဆန္ဒနယ်",
                "number": 0,
                "ST_PCODE": "MMR001",
                "DT_PCODE": "MMR001D001",
                "TS_PCODE": "MMR001001",
                "AM_PCODE": "MMR001HLA001",
                "parent": "ကချင်ပြည်နယ်",
            },
            "party_id": 14,
            "mother": {
                "name": "ဒေါ်သန်းကျင်(ကွယ်လွန်)",
                "religion": "ဗုဒ္ဓ"
            },
            "father": {
                "name": "ဦးထွန်းမြင့်(ကွယ်လွန်)",
                "religion": "ဗုဒ္ဓ"
            },
            "party": {
                "id": 14,
                "party_name": "ရှမ်းတိုင်းရင်းသားများဒီမိုကရက်တစ်ပါတီ",
                "party_name_english": "Shan Nationalities Democratic Party",
                "abbreviation": "",
                "member_count": "၁၅ ဦး",
                "leadership": [
                  "ဦးစိုင်းအိုက်ပေါင်း",
                  "ဦးနယ်(လ်)ဆင်(ခ)ဦးဆောင်ဆီ"
                ],
                "chairman": [
                  "ဦးစိုင်းအိုက်ပေါင်း",
                  "ဦးစိုင်းလှကျော်(ထွေ/မှူး)"
                ],
                "establishment_date": 1270684800,
                "establishment_approval_date": 1272844800,
                "registration_application_date": 1274140800,
                "registration_approval_date": 1274832000,
                "approved_party_number": "အမှတ်စဉ်( ၁၅ )",
                "party_flag": "https://storage.googleapis.com/staticassets/flags-and-logos/14-flag.png",
                "party_seal": "https://storage.googleapis.com/staticassets/flags-and-logos/14-logo.png",
                "region": "ပြည်ထောင်စုတစ်ဝန်းလုံး",
                "ST_PCODE": "MMR001",
                "DT_PCODE": "MMR001D001",
                "headquarters": "အမှတ်(၃၂၆)၊တောင်ကျောင်းလမ်း၊ မြို့မရပ်၊ တောင်ကြီးမြို့၊ ရှမ်းပြည်နယ်။",
                "contact": [
                  "၀၉-၄၁၀၀၈၂၂၅(ဦ:စောယွန်းပိုင်)",
                  "၀၉-၅၁၅၉၉၉၈",
                  "၀၉-၂၀၂၁၃၅၈ (ဦးစိုင်းမောင်တင်)",
                  "၀၈၁-၂၀၂၀၆၄",
                  "၀၉-၇၃၀၄၆၂၀၆(ဦးစိုင်းလှကျော်)"
                ],
                "policy": "http://uecmyanmar.org/images/stories/policals_policies/14Shan%20Nationalities%20Democratic%20Party.pdf"
            }
        },
        {
            ...
        }
    ],
    "meta": {
        "pagination": {
            "total": 20,
            "count": 3,
            "per_page": 15,
            "current_page": 1,
            "total_pages": 1,
            "links": {
                next: "http://example.com/link/to?page=2"
            }
        },
        "data_version": 1
    }
}

                                            
                                                
{
    "error": {
        "message": "Error message text",
    }
}