> ## Documentation Index
> Fetch the complete documentation index at: https://lava.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ip-api

> IP geolocation API returning country, city, coordinates, timezone, and ISP for any IP address.

IP geolocation API returning country, city, coordinates, timezone, and ISP for any IP address. Best for location-based personalization, fraud detection, or analytics workflows that need geographic context from an IP. Free tier limited to 45 requests/minute over HTTP — HTTPS requires a paid Pro plan.

1 example endpoint available through Lava's AI Gateway. See the [ip-api API docs](https://ip-api.com/docs/) for full documentation.

<Info>This provider is **managed** — no additional setup required.</Info>

<Info>This is a **catch-all provider** — any valid URL under `http://ip-api.com` is supported. IP geolocation API. Construct URL as [http://ip-api.com/\&#123;format\&#125;/\&#123;ip\&#125](http://ip-api.com/\&#123;format\&#125;/\&#123;ip\&#125);. Common: /json/\{ip} for JSON response. The endpoints below are curated examples.</Info>

## Endpoints

### Geolocate an IP address

**GET** `http://ip-api.com/json/24.48.0.1` — Free

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('http://ip-api.com/json/24.48.0.1', { method: 'GET' });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.lava.so/v1/forward?u=http%3A%2F%2Fip-api.com%2Fjson%2F24.48.0.1" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY"
    ```
  </Tab>
</Tabs>

## Next Steps

<CardGroup cols={2}>
  <Card title="All Providers" icon="grid" href="/gateway/supported-providers">
    Browse all supported AI providers
  </Card>

  <Card title="Forward Proxy" icon="route" href="/gateway/forward-proxy">
    Learn how to construct proxy URLs and authenticate requests
  </Card>
</CardGroup>