Update company accounting settings (admin/approver only)

curl --request POST \ --url https://api.app.lastaccountingcompany.com/portal/company/settings \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "customer_id": "<string>", "fiscal_year_start_month": 123, "vat_period_months": 123, "vat_period_valid_from": "<string>" } '

{ "customer_id": "<string>", "legal_name": "<string>", "business_id": "<string>", "vat_number": "<string>", "country_code": "<string>", "currency": "<string>", "fiscal_year_start_month": 123, "vat_period_months": 123, "company_form": "<string>", "statement_format": "<string>", "editable": true }

Authorizations

Authorization

string

header

required

Firebase ID token from an interactive portal session. Required for admin/approver-only operations (payroll approval, company settings, API-key management).

Body

application/json

customer_id

string

Target company. Optional for single-company sessions.

fiscal_year_start_month

integer

Month the fiscal year starts (1-12).

vat_period_months

integer

VAT reporting period length in months (e.g. 1, 3, 12).

vat_period_valid_from

string

Period-aligned effective date, YYYY-MM-DD.

Response

Updated company profile.

The company's registered details and accounting configuration.

customer_id

string

legal_name

string

business_id

string

Finnish business ID (Y-tunnus).

vat_number

string

country_code

string

currency

string

fiscal_year_start_month

integer

Month the fiscal year starts (1-12).

vat_period_months

integer

VAT reporting period length in months.

vat_period_source

enum<string>

Where the VAT period setting comes from.

Available options:

dated,

column,

default

company_form

string

statement_format

string

editable

boolean

Whether the caller may change settings (false for API keys).