--- 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` ## Request - The document declares no server URL. - Auth: none required - TypeScript: (a function with typed inputs; its response is checked against the schema) 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.dev/appcharge/apis/grant-award.md) - [All operations](https://skmtc.dev/appcharge/apis/grant-award/llms.txt) - [OpenAPI document](https://skmtc.dev/appcharge/apis/grant-award/revisions/b4f6759240d5?raw)