---
title: "Saldo i ustawienia konta"
method: GET
path: "/v1/account"
tags: ["Konto"]
---

# Saldo i ustawienia konta

`GET /v1/account`

## Request

- Base URL: `https://api.przypominamy.com`
- URL: `https://api.przypominamy.com/v1/account`
- Auth: HTTP bearer

Saldo, cennik (w tym `price_per_hlr_grosze` za sprawdzenie numeru), tryb konta, model rozliczenia (`billing_mode`: `prepaid` domyślnie, `postpaid` włączany na życzenie po weryfikacji firmy), domyślny nadpis, domyślne okno godzin wysyłki (`send_window`), numer odbiorczy do odpowiedzi 2-way (`inbound_number`; `null`, dopóki odbiór nie jest uruchomiony na życzenie dla konta), Twoje słowo kluczowe do odpowiedzi (`inbound_prefix`) i zakresy użytego klucza (`scopes`). Wymaga zakresu `read`.

## Response `200`

Konto

- Account
  - `country_rates` object: Indywidualne stawki zagraniczne: prefiks numeru → ceny kanałów w groszach netto. Bez pasującej stawki SMS kosztuje 2× krajową cenę konta; MMS i głos wymagają osobnej wyceny. Najdłuższy prefiks wygrywa. Polska używa standardowej ceny konta.
  - `id` string
  - `name` string
  - `sender_name` string, nullable
  - `balance_grosze` integer
  - `credit_limit_grosze` integer
  - `price_per_part_grosze` integer
  - `price_per_mms_grosze` integer
  - `price_per_vms_grosze` integer
  - `price_per_hlr_grosze` integer: Cena sprawdzenia numeru (HLR) w groszach
  - `rate_limit_per_minute` integer
  - `webhook_url` string, nullable
  - `status` 'active' | 'suspended' | 'closed'
  - `mode` 'test' | 'live': `test` - tylko zweryfikowane numery, koszt z puli testowej
  - `test_credits` integer: Pozostałe darmowe wiadomości (tylko w trybie `test`)
  - `send_window` string, nullable: Domyślne okno godzin wysyłki konta (czas polski) lub `null`
  - `billing_mode` 'prepaid' | 'postpaid': `prepaid` (domyślnie) - saldo doładowane z góry. `postpaid` - włączany przez nas na życzenie po weryfikacji firmy: saldo może zejść poniżej zera do `credit_limit_grosze`, 1. dnia miesiąca wystawiamy zestawienie za poprzedni miesiąc (14 dni na przelew, tytuł = id zestawienia), po terminie wysyłki są wstrzymane (402 `insufficient_funds`) do zaksięgowania wpłaty.
  - `inbound_number` string, nullable: Numer odbiorczy, na który odbiorcy mogą odpisać (2-way). Odbiór uruchamiamy na życzenie - `null`, dopóki nie jest włączony dla konta
  - `inbound_prefix` string, nullable: Twoje słowo kluczowe: SMS zaczynający się od niego trafia do Twojego konta niezależnie od wcześniejszych wysyłek (`PATCH /v1/account`)
  - `scopes` string[]: Zakresy klucza użytego w tym żądaniu
  - `international_sms` object: Domyślna cena SMS zagranicznego netto za część. Kraje UE aktywne; inne kierunki po potwierdzeniu dostępności.
    - `default_multiplier` integer
    - `price_per_part_grosze` integer
    - `currency` string
    - `tax_included` boolean
    - `availability` string

## Other responses

- `401`: Brak lub nieprawidłowy klucz API
- `403`: Klucz bez wymaganego zakresu (albo konto zawieszone / testowe wysyła na niezweryfikowany numer)

---

[API](https://skmtc.dev/przypominamy/apis/przypominamy-com-sms-api.md) · [All operations](https://skmtc.dev/przypominamy/apis/przypominamy-com-sms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/przypominamy/apis/przypominamy-com-sms-api/revisions/c20f9cfc2a7d?raw)