---
title: "Get weather by IP"
method: GET
path: "/ip2location/weather"
tags: ["Data AI — IP Geolocation"]
---

# Get weather by IP

`GET /ip2location/weather`

## Request

- Base URL: `https://api.paperoffice.ai/latest`
- URL: `https://api.paperoffice.ai/latest/ip2location/weather`
- Auth: HTTP bearer

Weather for an IP address (geolocation + weather).

## Query parameters

- `ip` string
- `lang` string
- `locale` string

## Response `200`

Success

- object: Weather by IP address
  - `_billing` object
    - `credits` object
      - `total_monthly` integer
      - `remaining_monthly` integer
      - `credit_source` string
      - `api_handler` string
      - `tier_info` object
        - `tier` string
        - `name` string
        - `initial_credits` integer
        - `price_monthly` integer
        - `price_overage_per_credit` integer
      - `notice` string
      - `renewal_days` integer
      - `subscription_status` string
    - `job` object
      - `api_job_name` string
      - `app` string
      - `action` string
      - `credits_billed` integer
      - `pricing` object
        - `credits_per_unit` integer
        - `unit` string
        - `unit_count` integer
        - `addons` string
    - `requests` object
      - `limits` object
        - `second` integer
        - `minute` integer
        - `hour` integer
        - `day` integer
      - `current` object
        - `second` integer
        - `minute` integer
        - `hour` integer
        - `day` integer
      - `remaining` object
        - `second` integer
        - `minute` integer
        - `hour` integer
        - `day` integer
      - `next_possible_request_seconds` integer
    - `plan` object
      - `tier` string
      - `name` string
    - `credits_billed` integer
  - `ip` object
    - `ip` string
    - `location` object
      - `timezone` object
        - `name` string
        - `offsethours` integer
      - `geo_lat` string
      - `geo_lon` string
      - `city` object
        - `name` string
        - `zip` string
        - `district` string
      - `region` object
        - `code` string
        - `name` string
      - `continent` object
        - `name` string
        - `code` string
      - `country` object
        - `name` string
        - `code` string
        - `currency` string
        - `spoken_languages` string
        - `capital` string
        - `callingcode` string
        - `primary_language` string
    - `provider` object
      - `as` string
      - `asname` string
      - `isp` string
      - `org` string
    - `status` string
    - `language` object
      - `by_country` string
    - `locale` object
      - `by_browser` boolean
    - `country_details` object
      - `warnings` unknown[]
        - unknown
  - `processing_time` string
  - `status` string

## Other responses

- `4XX`: Error
- `5XX`: Error

---

[API](https://skmtc.dev/paperoffice/apis/paperoffice-ai-api.md) · [All operations](https://skmtc.dev/paperoffice/apis/paperoffice-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/paperoffice/apis/paperoffice-ai-api/revisions/c6a6228a4509?raw)