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

# Get a Price

> Retorna um preço pelo ID.

Retorna um `price` pelo ID.

## Autenticação

A API key da própria organização atua diretamente. A API key de plataforma exige o
header `Organization: <organization_id>` apontando para uma organização
conectada ativa.

## Parâmetros de caminho

<ParamField path="id" type="string" required>
  ID do preço (`price_*`).
</ParamField>

<RequestExample>
  ```bash cURL theme={}
  curl -X GET "https://api.chargefy.io/v1/prices/price_123" \
    -H "Authorization: Bearer {{API_KEY}}"
  ```
</RequestExample>

## Resposta

`200 OK` com o objeto `price` completo. Mesmo shape de
[`POST /v1/prices`](/api-reference/prices/create#resposta).

<ResponseExample>
  ```json 200 theme={}
  {
    "id": "price_123",
    "object": "price",
    "created_at": "2026-05-16T14:09:27Z",
    "currency": "brl",
    "is_active": true,
    "livemode": true,
    "metadata": {},
    "name": "Mensal",
    "product": "prod_123",
    "recurring": {
      "interval": "month",
      "interval_count": 1,
      "trial_period_days": null,
      "usage_type": "licensed"
    },
    "tax_behavior": "unspecified",
    "type": "recurring",
    "unit_amount": 9990,
    "updated_at": null
  }
  ```
</ResponseExample>

## Erros comuns

| Status | `code`             | Quando ocorre                                        |
| ------ | ------------------ | ---------------------------------------------------- |
| `404`  | `resource_missing` | Preço não existe nesta organização (ou foi removido) |