# Outbound IP addresses

Refapp calls your system from a small set of fixed IP addresses. If your
firewall only accepts calls from known addresses, allow the addresses of the
Refapp instance your customers use.

## Where to find the addresses

Each Refapp instance publishes its current outbound addresses at
`/ip-ranges.json` on its own host. Use the host your customers sign in to:

- `https://app.refapp.se/ip-ranges.json`
- `https://sec.refapp.se/ip-ranges.json`
- `https://app.refapp.com.au/ip-ranges.json`

Read the list from these URLs rather than copying the addresses once. The list
changes when we move an instance, and the URL always shows the current one.

## Format

```json
{
  "updated": "2026-11-11",
  "egress": [
    { "ip_prefix": "203.0.113.10/32", "region": "eu-central-1" },
    { "ip_prefix": "203.0.113.20/32", "region": "eu-north-1" }
  ]
}
```

- `egress` lists every address the instance may call you from, in CIDR
  notation. Allow all of them.
- `region` says where the address lives. It is informational.
- `updated` is the date the list last changed.

The endpoint needs no authentication and may be cached for up to five minutes.

## When the addresses change

When we move an instance to a new region, the list contains the old and the new
addresses for the whole move, so you can allow the new ones before any traffic
uses them. Remove an address only once it is gone from the list.
