Pobierz dane użytkownika

Zakres: api:account:read. Stan konta, firmy, planu, księgowości i onboardingu w jednej odpowiedzi.

GET

https://api.sandbox-infakt.pl/v3/account/details.json

Autoryzacja

ApiKey
opcjonalne
API key in header

Token
opcjonalne
API key in header

Odpowiedzi

200

Sukces

JSON

account_data
object
wymagane
- uuid
  string
  wymagane
  format: uuid
- email
  string
  wymagane
- username
  string
  wymagane
- site
  string
  wymagane
- role
  wymagane
  Rola uwierzytelnionej sesji: owner dla kluczy API; dla tokenów OAuth rola z tokenu, np. owner, collaborator, employee, invoicer.
  
  One of the following:
  string
  null
- registered_at
  string
  wymagane
  Czas rejestracji w formacie RRRR-MM-DD GG:MM:SS ±GGMM, nie ISO 8601.
  
  pattern: ^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2} [+-]\d{4}$
- initial_password_set
  boolean
  wymagane
- has_collaborators
  boolean
  wymagane
}
company_data
object
wymagane
- first_name
  string
  wymagane
- last_name
  string
  wymagane
- company_name
  string
  wymagane
- owner_name
  wymagane
  One of the following:
  string
  null
- owner_surname
  wymagane
  One of the following:
  string
  null
- street
  wymagane
  Pełna linia adresu z ulicą.
  
  One of the following:
  string
  null
- street_name
  wymagane
  One of the following:
  string
  null
- street_number
  wymagane
  One of the following:
  string
  null
- flat_number
  wymagane
  One of the following:
  string
  null
- city
  wymagane
  One of the following:
  string
  null
- postal_code
  wymagane
  One of the following:
  string
  null
- tax_id
  wymagane
  One of the following:
  Nip
  null
- pesel
  wymagane
  PESEL z zamaskowanymi ostatnimi pięcioma cyframi.
  
  One of the following:
  string
  null
- regon
  wymagane
  One of the following:
  string
  null
- phone_number
  wymagane
  One of the following:
  string
  null
- mailing_company_name
  wymagane
  One of the following:
  string
  null
- mailing_street
  wymagane
  One of the following:
  string
  null
- mailing_city
  wymagane
  One of the following:
  string
  null
- mailing_postal_code
  wymagane
  One of the following:
  string
  null
- business_activity_code
  wymagane
  Kod formy prawnej (do 6 cyfr), np. 90099 dla jednoosobowej działalności gospodarczej; to nie jest kod PKD.
  
  One of the following:
  string
  null
}
current_subscription
object
wymagane
Bieżący plan; {}, gdy konto nie ma planu. documents_limit i document_used są zwracane dla planów z miesięcznym limitem dokumentów.
- name
  opcjonalne
  One of the following:
  string
  null
- expired_on
  opcjonalne
  One of the following:
  string
  null
- days_until_expiration
  opcjonalne
  One of the following:
  integer
  null
- user_type_symbol
  opcjonalne
  free
  or
  pdk_free
  or
  pdf
  or
  pdk
  or
  obr_self_employed_foundation
  or
  obr_self_employed
  +17 more
  Typ konta wynikający z planu.
- recurring_payment
  opcjonalne
  boolean
- monthly_billing
  opcjonalne
  boolean
- documents_limit
  opcjonalne
  integer
  Limit dokumentów w bieżącym miesiącu; 0 w planie darmowym.
  
  format: int32
- document_used
  opcjonalne
  integer
  Dokumenty wystawione i zarejestrowane w bieżącym miesiącu.
  
  format: int32
}
accounting_settings
object
wymagane
- status
  not_initialized
  or
  in_progress
  or
  finished
  wymagane
- accounting_data_filled
  boolean
  wymagane
- pit_type
  opcjonalne
  object
  value
  string
  wymagane
  label
  string
  wymagane
- pit_history
  opcjonalne
  array of
  object
  value
  string
  wymagane
  label
  string
  wymagane
  start_on
  string
  wymagane
  format: date
  finish_on
  wymagane
  One of the following:
  string
  null
- vat_sales
  opcjonalne
  object
  value
  string
  wymagane
  label
  string
  wymagane
  ratio
  integer
  wymagane
  Udział sprzedaży opodatkowanej w procentach.
  
  format: int32 · maximum: 100 · minimum: 0
- vat_sales_history
  opcjonalne
  array of
  object
  value
  string
  wymagane
  label
  string
  wymagane
  start_on
  string
  wymagane
  format: date
  finish_on
  wymagane
  One of the following:
  string
  null
- vat_method
  opcjonalne
  object
  value
  string
  wymagane
  label
  string
  wymagane
- started_at_in_infakt
  opcjonalne
  One of the following:
  string
  null
- business_activity_code
  opcjonalne
  string
  Kod formy prawnej, np. 90099 dla jednoosobowej działalności gospodarczej.
- insurance_fee_account_number
  opcjonalne
  One of the following:
  string
  null
- individual_tax_account_number
  opcjonalne
  One of the following:
  string
  null
- zus
  opcjonalne
  object
  Jedna z wartości: standard_zus, zus_launch_relief, cutted_zus, zus_plus.
  
  value
  string
  wymagane
  label
  string
  wymagane
}
accounting_office_service
object
wymagane
Usługa biura księgowego inFakt (KAI).
- active
  boolean
  wymagane
- service_global_name
  string
  wymagane
  Nazwa usługi księgowej; domyślnie inFakt.
- last_accounted_month
  opcjonalne
  Pierwszy dzień ostatniego zaksięgowanego miesiąca; tylko przy active.
  
  One of the following:
  string
  null
}
foundation_process
object
wymagane
Proces rejestracji firmy prowadzony przez inFakt.
- in_progress
  boolean
  wymagane
- completed
  boolean
  wymagane
- obr_type
  string
  wymagane
  Typ procesu rejestracji, np. self_employed, copartnership, smart; unknown, gdy procesu nie ma.
- current_step
  wymagane
  One of the following:
  string
  null
- with_bank_account
  boolean
  wymagane
- show_company_status_details
  boolean
  wymagane
- self_service
  boolean
  wymagane
- obr_lead
  boolean
  wymagane
- obr_marketing_agreement
  boolean
  wymagane
- self_service_business_onboarding_completed
  boolean
  wymagane
- company_started_at
  wymagane
  One of the following:
  string
  null
- process_url
  wymagane
  One of the following:
  string
  null
}
aml_process
object
wymagane
Stan weryfikacji tożsamości (AML).
- status
  not_initialized
  or
  verification_unfinished
  or
  pending
  or
  verification_failed
  or
  identt_verification_failed
  or
  failed
  +1 more
  wymagane
- in_progress
  boolean
  wymagane
- completed
  boolean
  wymagane
}
extentions
object
wymagane
Usługi dodatkowe konta.
- ambassador
  object
  wymagane
  name
  string
  wymagane
  active
  boolean
  wymagane
  details
  object
  wymagane
  link
  wymagane
  One of the following:
  string
  null
  pending_withdraw
  integer
  wymagane
  Premie, które nie zostały jeszcze wypłacone.
  
  format: int64
- ksef
  object
  wymagane
  name
  string
  wymagane
  active
  boolean
  wymagane
- ksef_2
  object
  wymagane
  name
  string
  wymagane
  active
  boolean
  wymagane
  details
  object
  wymagane
  integration_status
  wymagane
  Stan integracji z KSeF 2.0; null, gdy nigdy jej nie skonfigurowano.
  
  One of the following:
  string
  null
- merit
  object
  wymagane
  name
  string
  wymagane
  active
  boolean
  wymagane
- autopay
  object
  wymagane
  name
  string
  wymagane
  max_single_transaction_limit_in_cents
  integer
  wymagane
  Maksymalna kwota pojedynczej płatności.
  
  format: int64
  integration_confirmed
  boolean
  wymagane
- finances
  object
  wymagane
  name
  string
  wymagane
  active
  boolean
  wymagane
  details
  object
  wymagane
  available
  boolean
  wymagane
  banking_waitlisted
  boolean
  wymagane
  onboarding_process
  object
  wymagane
  completed
  boolean
  wymagane
  in_progress
  boolean
  wymagane
  current_step
  string
  wymagane
  not_started przed rozpoczęciem onboardingu.
  
  reprofiling_needed?
  opcjonalne
  boolean
  integration
  object
  wymagane
  status
  string
  wymagane
  none, gdy nie ma integracji.
- voice_agent
  object
  wymagane
  waitlisted
  boolean
  wymagane
  available
  boolean
  wymagane
}
transfer_wizard
opcjonalne
object
Obecne, gdy trwa przeniesienie danych z innego programu.
- in_progress
  boolean
  wymagane
- checked
  boolean
  wymagane
- contact_time
  wymagane
  Preferowany termin kontaktu wybrany w kreatorze, np. 05.10.2026, 10:00 - 12:00.
  
  One of the following:
  string
  null
}

401

Brak klucza API, nieprawidłowy klucz albo klucz bez wymaganego zakresu uprawnień.

JSON

error
opcjonalne
Komunikat po polsku (po angielsku dla 429). Niektóre akcje zamiast jednego tekstu zwracają listę komunikatów albo błędy walidacji według pól.
One of the following:
string
array<string>
object
}
errors
opcjonalne
Błędy walidacji według nazw pól API; na niektórych endpointach zwykły komunikat.
One of the following:
object
string
}
limit
opcjonalne
string
Kod limitu planu, np. limit_exceeded, plan_upgrade_needed, cant_add_client.
type
opcjonalne
redirect
or
email_not_confirmed
url
opcjonalne
string
action_url
opcjonalne
string

402

API niedostępne w obecnym planie (limit: plan_upgrade_needed) albo osiągnięty limit dokumentów.

JSON

error
opcjonalne
Komunikat po polsku (po angielsku dla 429). Niektóre akcje zamiast jednego tekstu zwracają listę komunikatów albo błędy walidacji według pól.
One of the following:
string
array<string>
object
}
errors
opcjonalne
Błędy walidacji według nazw pól API; na niektórych endpointach zwykły komunikat.
One of the following:
object
string
}
limit
opcjonalne
string
Kod limitu planu, np. limit_exceeded, plan_upgrade_needed, cant_add_client.
type
opcjonalne
redirect
or
email_not_confirmed
url
opcjonalne
string
action_url
opcjonalne
string

406

Ścieżka nie kończy się na .json.

JSON

error
opcjonalne
Komunikat po polsku (po angielsku dla 429). Niektóre akcje zamiast jednego tekstu zwracają listę komunikatów albo błędy walidacji według pól.
One of the following:
string
array<string>
object
}
errors
opcjonalne
Błędy walidacji według nazw pól API; na niektórych endpointach zwykły komunikat.
One of the following:
object
string
}
limit
opcjonalne
string
Kod limitu planu, np. limit_exceeded, plan_upgrade_needed, cant_add_client.
type
opcjonalne
redirect
or
email_not_confirmed
url
opcjonalne
string
action_url
opcjonalne
string

423

Niepotwierdzony adres e-mail albo wymagana weryfikacja tożsamości.

JSON

error
opcjonalne
Komunikat po polsku (po angielsku dla 429). Niektóre akcje zamiast jednego tekstu zwracają listę komunikatów albo błędy walidacji według pól.
One of the following:
string
array<string>
object
}
errors
opcjonalne
Błędy walidacji według nazw pól API; na niektórych endpointach zwykły komunikat.
One of the following:
object
string
}
limit
opcjonalne
string
Kod limitu planu, np. limit_exceeded, plan_upgrade_needed, cant_add_client.
type
opcjonalne
redirect
or
email_not_confirmed
url
opcjonalne
string
action_url
opcjonalne
string

429

Przekroczony limit zapytań. Komunikat jest po angielsku, np. API rate limit exceeded. Try again in 60 seconds.

JSON

error
opcjonalne
Komunikat po polsku (po angielsku dla 429). Niektóre akcje zamiast jednego tekstu zwracają listę komunikatów albo błędy walidacji według pól.
One of the following:
string
array<string>
object
}
errors
opcjonalne
Błędy walidacji według nazw pól API; na niektórych endpointach zwykły komunikat.
One of the following:
object
string
}
limit
opcjonalne
string
Kod limitu planu, np. limit_exceeded, plan_upgrade_needed, cant_add_client.
type
opcjonalne
redirect
or
email_not_confirmed
url
opcjonalne
string
action_url
opcjonalne
string

{ "account_data": { "uuid": "3f0c1a52-8e4b-4f5e-9d7a-2b6c8e1f4a90", "email": "jan.kowalski@example.com", "username": "jan.kowalski", "site": "infakt", "role": "owner", "registered_at": "2024-03-01 10:00:00 +0100", "initial_password_set": true, "has_collaborators": false }, "company_data": { "first_name": "Jan", "last_name": "Kowalski", "company_name": "Przykładowa Firma Jan Kowalski", "owner_name": "Jan", "owner_surname": "Kowalski", "street": "Lwowska 10/17", "street_name": "Lwowska", "street_number": "10", "flat_number": "17", "city": "Kraków", "postal_code": "31-202", "tax_id": "1234563218", "pesel": "900101*****", "regon": "123456785", "phone_number": "500000000", "mailing_company_name": null, "mailing_street": null, "mailing_city": null, "mailing_postal_code": null, "business_activity_code": "90099" }, "current_subscription": { "name": "Plan Darmowy", "expired_on": null, "documents_limit": 0, "document_used": 0, "days_until_expiration": 0, "user_type_symbol": "free", "monthly_billing": false }, "accounting_settings": { "status": "not_initialized", "accounting_data_filled": false }, "accounting_office_service": { "active": false, "service_global_name": "inFakt" }, "foundation_process": { "in_progress": false, "completed": false, "obr_type": "unknown", "current_step": null, "with_bank_account": false, "show_company_status_details": false, "self_service": false, "obr_lead": false, "obr_marketing_agreement": false, "self_service_business_onboarding_completed": false, "company_started_at": null, "process_url": null }, "aml_process": { "status": "not_initialized", "in_progress": false, "completed": false }, "extentions": { "ambassador": { "name": "Program Ambasador", "active": false, "details": { "link": null, "pending_withdraw": 0 } }, "ksef": { "name": "eFaktury", "active": false }, "ksef_2": { "name": "eFaktury 2.0", "active": false, "details": { "integration_status": null } }, "merit": { "name": "Księgowość 360", "active": false }, "autopay": { "name": "Autopay", "max_single_transaction_limit_in_cents": 430000, "integration_confirmed": false }, "finances": { "name": "Finanse", "active": false, "details": { "available": false, "banking_waitlisted": false, "onboarding_process": { "completed": false, "in_progress": false, "current_step": "not_started", "reprofiling_needed?": false }, "integration": { "status": "none" } } }, "voice_agent": { "waitlisted": false, "available": false } } }