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

# Get Price Point

> Retrieves a specific price point by its base price in USD cents. 

The API returns localized prices for this price point.


<RequestExample>
  ```bash Get Price Point theme={"system"}
    curl -X GET \
    'https://api.appcharge.com/v1/price-points/999' \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -H 'x-publisher-token: <x-publisher-token>' \
  ```
</RequestExample>

<ResponseExample>
  ```json Get Price Point theme={"system"}
  {
    "priceInUsdCents": 999,
    "lastUpdate": "2026-03-01T10:00:00.000Z",
    "priceByCountry": [
      {
        "price": 9.99,
        "currencyCode": "USD",
        "isOverridden": false,
        "taxModel": "Excluded",
        "taxRate": 0,
        "country": "United States",
        "countryCode2": "US",
        "usdExchangeRateOnCalc": 1,
        "exchangeRateDrift": "0%",
        "realTimePrice": 9.99
      },
      {
        "price": 7.99,
        "currencyCode": "GBP",
        "isOverridden": false,
        "taxModel": "Included",
        "taxRate": 20,
        "country": "United Kingdom",
        "countryCode2": "GB",
        "usdExchangeRateOnCalc": 0.79,
        "exchangeRateDrift": "-1.2%",
        "realTimePrice": 8.12
      },
      {
        "price": 29.99,
        "currencyCode": "BRL",
        "isOverridden": true,
        "taxModel": "Excluded",
        "taxRate": 0,
        "country": "Brazil",
        "countryCode2": "BR",
        "usdExchangeRateOnCalc": 5.05,
        "exchangeRateDrift": "2.3%",
        "realTimePrice": 29.99
      },
      {
        "price": 8.99,
        "currencyCode": "EUR",
        "isOverridden": false,
        "taxModel": "Included",
        "taxRate": 19,
        "country": "Germany",
        "countryCode2": "DE",
        "usdExchangeRateOnCalc": 0.92,
        "exchangeRateDrift": "-0.5%",
        "realTimePrice": 9.05
      }
    ]
  }
  ```

  ```json 404 theme={"system"}
  {
    "message": "Price point 999 not found."
  }
  ```
</ResponseExample>


## OpenAPI

````yaml openapi-price-points.json get /v1/price-points/{priceInUsdCents}
openapi: 3.1.0
info:
  title: Price Localization API
  description: API for managing price points and price localization
  version: 1.0.0
servers:
  - url: https://api.example.com
security: []
paths:
  /v1/price-points/{priceInUsdCents}:
    get:
      summary: Get a Price Point
      description: >-
        Retrieves a specific price point by its base price in USD cents. The API
        returns localized prices for this price point.
      operationId: getPricePoint
      parameters:
        - name: priceInUsdCents
          in: path
          required: true
          schema:
            type: number
            example: 999
          description: Base price in USD cents.
      responses:
        '200':
          description: Price point retrieved successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PricePointDetailed'
        '404':
          description: Price point not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                message: Price point 999 not found.
components:
  schemas:
    PricePointDetailed:
      type: object
      properties:
        priceInUsdCents:
          type: number
          description: Base price in USD cents.
          example: 999
        lastUpdate:
          type: string
          format: date-time
          description: >-
            Timestamp indicating when the price point was last updated, in UTC
            ISO 8601 format.
          example: '2026-01-01T14:30:00Z'
        priceByCountry:
          type: array
          items:
            $ref: '#/components/schemas/PriceByCountryDetailed'
          description: List of localized prices by country, including overrides if present.
    ErrorResponse:
      type: object
      required:
        - message
      properties:
        message:
          type: string
          description: Error message describing what went wrong.
          example: Price point 999 not found.
    PriceByCountryDetailed:
      allOf:
        - $ref: '#/components/schemas/PriceByCountry'
    PriceByCountry:
      type: object
      properties:
        price:
          type: number
          description: Localized price for the country.
          example: 7.99
        currencyCode:
          type: string
          description: Currency code.
          example: GBP
        isOverridden:
          type: boolean
          description: Whether the price was overridden.
          example: false
        taxModel:
          type: string
          enum:
            - Included
            - Excluded
          description: Tax model applied to the price.
          example: Included
        taxRate:
          type: number
          description: Tax rate applied to the price.
          example: 20
        country:
          type: string
          description: Country name.
          example: United Kingdom
        countryCode2:
          type: string
          description: >-
            Country code in [ISO 3166-1
            alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
          example: GB
        usdExchangeRateOnCalc:
          type: number
          description: USD exchange rate used at the time of calculation.
          example: 0.79
        exchangeRateDrift:
          type: string
          description: Exchange rate drift since the last calculation.
          example: '-1.2%'

````