Skip to main content
Returns the recommended AWS region for low-latency ingest based on the caller’s location. Endpoint: GET /2/region Auth: User context — OAuth 2.0 (with broadcast.read scope) recommended, or OAuth 1.0a 3-legged. See Authentication.

​
Behavior

Sign and send the request to /2/region; it responds with HTTP 307 Temporary Redirect to a region-recommendation host. Follow the redirect and read region from the final body.
Auth across the redirect: Most HTTP clients drop the Authorization header when a redirect crosses to a different host (standard, secure behavior). That is fine — only the initial /2/region request needs to be signed; the redirect target is public. Clients that follow redirects automatically work without special handling.

​
Response

The final response body:
Use the returned region when creating sources and broadcasts for optimal performance. The API recommends the best region based on the requester’s location.