All requests the go through our cloud hosting a proxied by
We append headers based on the GeoIP to these requests.
Currently we can only ensure the accuracy of country data and not city, postcode or region. We recommend only using country.
We have api packages available to get GeoIP Data in the middleware.
If you're an enterprise customer and you've modified your Falcon Server instance you'll need to check the following:
1. Adding our packages as server dependencies
server directory run
2. Adding the data source
server/config/default.json add the following as a data source:
3. Adding the extension
server/config/default.json add the following as an extension:
Geographic data is available to the entire client app via a context provider.
The data provided contains:
name | object key
- Country code |
- Region |
- City |
- Post Code |
@deity/falcon-front-kit contains a handy component to access this information.
GeoIP data is added via our cloud platform so is NOT available for local development.
If you want to access it locally you have 2 options:
Connect to a cloud instance of Falcon Server (this is already the case for all non-enterprise customers)
Fake the headers. This can easily be done using a borwser extension such as bewisse. The headers are below and aren't case sensitive:
If you want to access the GeoIP headers in your custom data source you can get it from