Malaysian States

State codes for Malaysian addresses in InvoisX.

State Codes

Code	Name
01	Johor
02	Kedah
03	Kelantan
04	Melaka
05	Negeri Sembilan
06	Pahang
07	Pulau Pinang
08	Perak
09	Perlis
10	Selangor
11	Terengganu
12	Sabah
13	Sarawak
14	Kuala Lumpur
15	Labuan
16	Putrajaya
17	Not Applicable (Foreign)

Usage

Use state codes in buyer and seller addresses:

Node.js

const buyer = await api('POST', '/buyers', {
  name: 'Company Name',
  // ...
  address: {
    line1: '123 Jalan Business',
    city: 'Kuala Lumpur',
    state: '14',           // Kuala Lumpur
    countryCode: 'MYS'
  }
});

Python

buyer = api('POST', '/buyers', {
    'name': 'Company Name',
    # ...
    'address': {
        'line1': '123 Jalan Business',
        'city': 'Kuala Lumpur',
        'state': '14',           # Kuala Lumpur
        'countryCode': 'MYS'
    }
})

Laravel

$buyer = $api->post('/buyers', [
    'name' => 'Company Name',
    // ...
    'address' => [
        'line1' => '123 Jalan Business',
        'city' => 'Kuala Lumpur',
        'state' => '14',           // Kuala Lumpur
        'countryCode' => 'MYS'
    ]
]);

Foreign Addresses

For addresses outside Malaysia, use state code 17:

{
  "address": {
    "line1": "123 Orchard Road",
    "city": "Singapore",
    "state": "17",           // Not Applicable (Foreign)
    "countryCode": "SGP"    // Singapore
  }
}

Fetching States

Get the complete list via API:

Node.js

const states = await api('GET', '/states');

// Response:
// {
//   "data": [
//     { "code": "01", "name": "Johor" },
//     { "code": "02", "name": "Kedah" },
//     ...
//   ]
// }

Python

states = api('GET', '/states')

# Response:
# {
#   "data": [
#     { "code": "01", "name": "Johor" },
#     { "code": "02", "name": "Kedah" },
#     ...
#   ]
# }

Laravel

$states = $api->get('/states');

// Response:
// {
//   "data": [
//     { "code": "01", "name": "Johor" },
//     { "code": "02", "name": "Kedah" },
//     ...
//   ]
// }

State by Region

Peninsular Malaysia (West)

Code	Name
01	Johor
02	Kedah
03	Kelantan
04	Melaka
05	Negeri Sembilan
06	Pahang
07	Pulau Pinang
08	Perak
09	Perlis
10	Selangor
11	Terengganu

East Malaysia

Code	Name
12	Sabah
13	Sarawak

Federal Territories

Code	Name
14	Kuala Lumpur
15	Labuan
16	Putrajaya

Special

Code	Name	Use Case
17	Not Applicable	Foreign addresses