0

Get states by country ID

by
Published Oct 17, 2025

Get states/provinces for a specific country. Returns a list of state/province options with ID, label, ISO code, and name.

Script bamboo_hr Verified

The script

Submitted by hugo697 Bun
Verified 235 days ago
1
//native
2
/**
3
 * Get states by country ID
4
 * Get states/provinces for a specific country. Returns a list of state/province options with ID, label, ISO code, and name.
5
 */
6
export async function main(auth: RT.BambooHr, countryId: string) {
7
	const url = new URL(
8
		`https://${auth.companyDomain}.bamboohr.com/api/v1/meta/provinces/${countryId}`
9
	)
10

11
	const response = await fetch(url, {
12
		method: 'GET',
13
		headers: {
14
			Authorization: 'Basic ' + btoa(`${auth.apiKey}:x`)
15
		},
16
		body: undefined
17
	})
18
	if (!response.ok) {
19
		const text = await response.text()
20
		throw new Error(`${response.status} ${text}`)
21
	}
22
	return await response.json()
23
}
24