---
title: "Get Price Points for a Country"
method: POST
path: "/v1/price-points/localized/lookup"
---

# Get Price Points for a Country

`POST /v1/price-points/localized/lookup`

Retrieves price points localized for a specific country.

Pass price points in USD cents and a country code. The API returns each requested price point with its localized price in the currency for that country.

## Request body

- LocalizedPricePointLookupRequest
  - `pricesInUsdCents` number[], required — List of base prices in USD.
  - `countryCode2` string, required — Two-letter country code in [ISO-3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format. Required if `playerIp` is not provided. Example: `US`.
  - `playerIp` string — Player IP address in [IPv4](https://en.wikipedia.org/wiki/IPv4) format. Required if `countryCode2` is not provided. Example: `192.0.2.1`.

## Response `200`

Localized price points retrieved successfully.

- LocalizedPricePointLookupResponse
  - `currencyCode` string — ISO 4217 currency code of the resolved local currency. Pass this value as `priceDetails.currency` when creating a checkout session. Empty string when no local price is configured for any of the requested price points.
  - `pricePoints` object — Map of requested USD price points, as JSON string keys, to localized price objects. The value is `null` when no local price is configured for that price point.

## Other responses

- `400` — Bad request. All errors return a `message` property.
- `401` — Unauthorized.
- `429` — Too many requests. The rate limit is 5,000 requests per minute.

---

[API](https://skmtc.net/appcharge/apis/grant-award.md) · [All operations](https://skmtc.net/appcharge/apis/grant-award/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/appcharge/grant-award/revisions/b4f6759240d5/schema)