0

Get ReadMe's outbound IP addresses

by
Published Oct 17, 2025

Get all of ReadMe's IP addresses used for outbound webhook requests and the "Try It!" button on the API Explorer. Although ReadMe's outbound IP addresses may change, the IPs in this API response will be valid for at least 7 days. If you configure your API or webhooks to limit access based on these IPs, you should refresh the IP list from this endpoint weekly.

Script readme Verified

The script

Submitted by hugo697 Bun
Verified 235 days ago
1
//native
2
/**
3
 * Get ReadMe's outbound IP addresses
4
 * Get all of ReadMe's IP addresses used for outbound webhook requests and the "Try It!" button on the API Explorer.
5

6
Although ReadMe's outbound IP addresses may change, the IPs in this API response will be valid for at least 7 days. If you configure your API or webhooks to limit access based on these IPs, you should refresh the IP list from this endpoint weekly.
7
 */
8
export async function main(auth: RT.Readme) {
9
	const url = new URL(`https://api.readme.com/v2/outbound_ips`)
10

11
	const response = await fetch(url, {
12
		method: 'GET',
13
		headers: {
14
			Authorization: 'Bearer ' + auth.apiKey
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