PUBLIC API v1

List of companies

GET /api/v1/companies/

Get a list of the companies the caller can access, most recently activated first. Archived companies are left out unless `include_archived=true` is passed.

Permission: Any valid key for this company · Direct link

Company-scoped. Account permissions, plan limits and document state still apply.

Path and query parameters

Parameter	Location / type	Description
`include_archived`	query · `boolean`	Include archived (wound-down) companies in the listing. Off by default so the company switcher only offers live entities; an archived company stays reachable by id either way.
`page`	query · `integer`	A page number within the paginated result set.
`page_size`	query · `integer`	Number of results to return per page.

Responses

200 Response fields

application/json

Field Type / accepted values Description

countRequired integer Not specified

next string (uri) | null Not specified

previous string (uri) | null Not specified

resultsRequired

object[]

Not specified

Nested fields

Field Type / accepted values Description

publicIdRequiredRead only string (uuid) Not specified

nameRequired string Not specified

statusRequired string Not specified

accountTypeRequired string Not specified

accountTypeCodeRequiredRead only string Not specified

activityStart string (date) Not specified

activityTypeRequired string Not specified

address string | null Not specified

city string Not specified

zipCode string Not specified

country "AT" | "DE" | "BE" | "HR" | "CY" | "CZ" | "DK" | "EE" | "FI" | "FR" | "HU" | "IE" | "IT" | "LV" | "LT" | "LU" | "MT" | "NL" | "PL" | "PT" | "SK" | "SI" | "ES" | "SE" | "IL" | "LI" | "MC" | "MON" | "NO" | "SM" | "RS" | "CH" | "GB" | "CA" | "US" | "AF" | "AX" | "AL" | "DZ" | "AS" | "AD" | "AO" | "AI" | "AQ" | "AG" | "AR" | "AM" | "AW" | "AU" | "AZ" | "BS" | "BH" | "BD" | "BB" | "BY" | "BZ" | "BJ" | "BM" | "BT" | "BO" | "BA" | "BW" | "BV" | "BR" | "IO" | "BN" | "BG" | "BF" | "BI" | "KH" | "CM" | "CV" | "KY" | "CF" | "TD" | "CL" | "CN" | "CX" | "CC" | "CO" | "KM" | "CG" | "CD" | "CK" | "CR" | "CI" | "CU" | "DJ" | "DM" | "DO" | "EC" | "EG" | "SV" | "GQ" | "ER" | "ET" | "FK" | "FO" | "FJ" | "GF" | "PF" | "TF" | "GA" | "GM" | "GE" | "GH" | "GI" | "GR" | "GL" | "GD" | "GP" | "GU" | "GT" | "GG" | "GN" | "GW" | "GY" | "HT" | "HM" | "HN" | "HK" | "IS" | "IN" | "ID" | "IR" | "IQ" | "IM" | "JM" | "JP" | "JE" | "JO" | "KZ" | "KE" | "KI" | "KP" | "KR" | "KW" | "KG" | "LA" | "LB" | "LS" | "LR" | "LY" | "MO" | "MK" | "MG" | "MW" | "MY" | "MV" | "ML" | "MH" | "MQ" | "MR" | "MU" | "YT" | "MX" | "FM" | "MD" | "MN" | "MS" | "MA" | "MZ" | "MM" | "NA" | "NR" | "NP" | "AN" | "NC" | "NZ" | "NI" | "NE" | "NG" | "NU" | "NF" | "MP" | "OM" | "PK" | "PW" | "PS" | "PA" | "PG" | "PY" | "PE" | "PH" | "PN" | "PR" | "QA" | "RE" | "RO" | "RU" | "RW" | "SH" | "KN" | "LC" | "PM" | "VC" | "WS" | "ST" | "SA" | "SN" | "SC" | "SL" | "SG" | "SB" | "SO" | "ZA" | "GS" | "LK" | "SD" | "SR" | "SJ" | "SZ" | "SY" | "TW" | "TJ" | "TZ" | "TH" | "TL" | "TG" | "TK" | "TO" | "TT" | "TN" | "TR" | "TM" | "TC" | "TV" | "UG" | "UA" | "AE" | "UM" | "UY" | "UZ" | "VU" | "VA" | "VE" | "VN" | "VG" | "VI" | "WF" | "EH" | "YE" | "ZM" | "ZW" * `AT` - Austria * `DE` - Germany * `BE` - Belgium * `HR` - Croatia * `CY` - Cyprus * `CZ` - Czech Republic * `DK` - Denmark * `EE` - Estonia * `FI` - Finland * `FR` - France * `HU` - Hungary * `IE` - Ireland * `IT` - Italy * `LV` - Latvia * `LT` - Lithuania * `LU` - Luxembourg * `MT` - Malta * `NL` - Netherlands * `PL` - Poland * `PT` - Portugal * `SK` - Slovakia * `SI` - Slovenia * `ES` - Spain * `SE` - Sweden * `IL` - Israel * `LI` - Liechtenstein * `MC` - Monaco * `MON` - Montenegro * `NO` - Norway * `SM` - San Marino * `RS` - Serbia * `CH` - Switzerland * `GB` - United Kingdom * `CA` - Canada * `US` - United States * `AF` - Afghanistan * `AX` - Åland Islands * `AL` - Albania * `DZ` - Algeria * `AS` - American Samoa * `AD` - AndorrA * `AO` - Angola * `AI` - Anguilla * `AQ` - Antarctica * `AG` - Antigua and Barbuda * `AR` - Argentina * `AM` - Armenia * `AW` - Aruba * `AU` - Australia * `AZ` - Azerbaijan * `BS` - Bahamas * `BH` - Bahrain * `BD` - Bangladesh * `BB` - Barbados * `BY` - Belarus * `BZ` - Belize * `BJ` - Benin * `BM` - Bermuda * `BT` - Bhutan * `BO` - Bolivia * `BA` - Bosnia and Herzegovina * `BW` - Botswana * `BV` - Bouvet Island * `BR` - Brazil * `IO` - British Indian Ocean Territory * `BN` - Brunei Darussalam * `BG` - Bulgaria * `BF` - Burkina Faso * `BI` - Burundi * `KH` - Cambodia * `CM` - Cameroon * `CV` - Cape Verde * `KY` - Cayman Islands * `CF` - Central African Republic * `TD` - Chad * `CL` - Chile * `CN` - China * `CX` - Christmas Island * `CC` - Cocos (Keeling) Islands * `CO` - Colombia * `KM` - Comoros * `CG` - Congo * `CD` - Congo, The Democratic Republic of the * `CK` - Cook Islands * `CR` - Costa Rica * `CI` - Cote D'Ivoire * `CU` - Cuba * `DJ` - Djibouti * `DM` - Dominica * `DO` - Dominican Republic * `EC` - Ecuador * `EG` - Egypt * `SV` - El Salvador * `GQ` - Equatorial Guinea * `ER` - Eritrea * `ET` - Ethiopia * `FK` - Falkland Islands * `FO` - Faroe Islands * `FJ` - Fiji * `GF` - French Guiana * `PF` - French Polynesia * `TF` - French Southern Territories * `GA` - Gabon * `GM` - Gambia * `GE` - Georgia * `GH` - Ghana * `GI` - Gibraltar * `GR` - Greece * `GL` - Greenland * `GD` - Grenada * `GP` - Guadeloupe * `GU` - Guam * `GT` - Guatemala * `GG` - Guernsey * `GN` - Guinea * `GW` - Guinea-Bissau * `GY` - Guyana * `HT` - Haiti * `HM` - Heard Island and Mcdonald Islands * `HN` - Honduras * `HK` - Hong Kong * `IS` - Iceland * `IN` - India * `ID` - Indonesia * `IR` - Iran * `IQ` - Iraq * `IM` - Isle of Man * `JM` - Jamaica * `JP` - Japan * `JE` - Jersey * `JO` - Jordan * `KZ` - Kazakhstan * `KE` - Kenya * `KI` - Kiribati * `KP` - North Korea * `KR` - South Korea * `KW` - Kuwait * `KG` - Kyrgyzstan * `LA` - Lao People'S * `LB` - Lebanon * `LS` - Lesotho * `LR` - Liberia * `LY` - Libya * `MO` - Macao * `MK` - Macedonia * `MG` - Madagascar * `MW` - Malawi * `MY` - Malaysia * `MV` - Maldives * `ML` - Mali * `MH` - Marshall Islands * `MQ` - Martinique * `MR` - Mauritania * `MU` - Mauritius * `YT` - Mayotte * `MX` - Mexico * `FM` - Micronesia * `MD` - Moldova * `MN` - Mongolia * `MS` - Montserrat * `MA` - Morocco * `MZ` - Mozambique * `MM` - Myanmar * `NA` - Namibia * `NR` - Nauru * `NP` - Nepal * `AN` - Netherlands Antilles * `NC` - New Caledonia * `NZ` - New Zealand * `NI` - Nicaragua * `NE` - Niger * `NG` - Nigeria * `NU` - Niue * `NF` - Norfolk Island * `MP` - Northern Mariana Islands * `OM` - Oman * `PK` - Pakistan * `PW` - Palau * `PS` - Palestina * `PA` - Panama * `PG` - Papua New Guinea * `PY` - Paraguay * `PE` - Peru * `PH` - Philippines * `PN` - Pitcairn * `PR` - Puerto Rico * `QA` - Qatar * `RE` - Reunion * `RO` - Romania * `RU` - Russian Federation * `RW` - RWANDA * `SH` - Saint Helena * `KN` - Saint Kitts and Nevis * `LC` - Saint Lucia * `PM` - Saint Pierre and Miquelon * `VC` - Saint Vincent and the Grenadines * `WS` - Samoa * `ST` - Sao Tome and Principe * `SA` - Saudi Arabia * `SN` - Senegal * `SC` - Seychelles * `SL` - Sierra Leone * `SG` - Singapore * `SB` - Solomon Islands * `SO` - Somalia * `ZA` - South Africa * `GS` - South Georgia and the South Sandwich Islands * `LK` - Sri Lanka * `SD` - Sudan * `SR` - Suriname * `SJ` - Svalbard and Jan Mayen * `SZ` - Swaziland * `SY` - Syrian Arab Republic * `TW` - Taiwan, Province of China * `TJ` - Tajikistan * `TZ` - Tanzania, United Republic of * `TH` - Thailand * `TL` - Timor-Leste * `TG` - Togo * `TK` - Tokelau * `TO` - Tonga * `TT` - Trinidad and Tobago * `TN` - Tunisia * `TR` - Turkey * `TM` - Turkmenistan * `TC` - Turks and Caicos Islands * `TV` - Tuvalu * `UG` - Uganda * `UA` - Ukraine * `AE` - United Arab Emirates * `UM` - United States Minor Outlying Islands * `UY` - Uruguay * `UZ` - Uzbekistan * `VU` - Vanuatu * `VA` - Vatican * `VE` - Venezuela * `VN` - Viet Nam * `VG` - Virgin Islands, British * `VI` - Virgin Islands, U.S. * `WF` - Wallis and Futuna * `EH` - Western Sahara * `YE` - Yemen * `ZM` - Zambia * `ZW` - Zimbabwe

countryNameRequired string Not specified

countryConfigRequiredRead only

object

Not specified

Nested fields

Field	Type / accepted values	Description
`code`RequiredRead only	`string`	Not specified
`name`RequiredRead only	`string`	Not specified
`defaultCurrency`RequiredRead only	`string`	Not specified
`defaultLanguage`RequiredRead only	`string`	Not specified
`vatRates`RequiredRead only	`object`	e.g. {"standard": 19, "reduced": [7], "zero": 0}
`smallBusinessVatExemptLabel`RequiredRead only	`string`	e.g. Kleinunternehmer (DE), Zwolnienie podmiotowe z VAT (PL)
`taxIdTypes`RequiredRead only	`object`	e.g. {"vat": "USt-IdNr.", "tax": "Steuernummer", "personal": "Steuer-IdNr."}
`supportedBusinessTypes`RequiredRead only	`object`	e.g. [{"key": "freiberufler", "label": "Freiberufler"}, {"key": "gmbh", "label": "GmbH"}]
`supportedTaxRegimes`RequiredRead only	`object`	e.g. [{"key": "progressive", "label": "Progressive (12%/32%)"}, {"key": "flat", "label": "Flat 19%"}]
`bookkeepingTypes`RequiredRead only	`object`	e.g. [{"key": "euer", "label": "EÜR"}, {"key": "bilanz", "label": "Bilanz"}]
`invoiceRequirements`RequiredRead only	`object`	Country-specific mandatory invoice fields and rules
`taxFilingProvider`RequiredRead only	`string`	e.g. elster, ksef, sdi
`hasRegionalTaxes`RequiredRead only	`boolean`	True for DE (Gewerbesteuer per Bundesland), False for PL
`isEuMember`RequiredRead only	`boolean`	Not specified
`isActive`RequiredRead only	`boolean`	Not specified
`supportsTaxPayment`RequiredRead only	`boolean`	True if SEPA payments to tax offices are supported (e.g. DE via finAPI)

taxRegimeRequiredRead only string Not specified

regionRequiredRead only string Not specified

iban string | null Not specified

bic string | null Not specified

bankName string | null Not specified

taxStateRequired string Not specified

taxReportingsRequired

object[]

Not specified

Nested fields

Field	Type / accepted values	Description
`publicId`RequiredRead only	`string (uuid)`	Not specified
`taxType`	`"sales" \| "trade" \| "income" \| "profit_loss" \| "corporate"`	* `sales` - Sales * `trade` - Trade * `income` - Income * `profit_loss` - Profit & Loss * `corporate` - Corporate
`taxYear`	`integer`	Not specified

vatNumber string | null Not specified

taxNumber string | null Not specified

membersRequiredRead only string (uuid)[] Not specified

profession string Not specified

currency string Not specified

incomeType 0 | 1 * `0` - Less then 60k * `1` - Greater or equal to 60k

phoneNumberRequiredRead only string The phone number to publish FOR THIS ENTITY. `contact_phone` is the entity's own number; the owner's personal one is only the fallback, kept so an account with a single company behaves exactly as before.

contactEmail string (email) | null Not specified

contactPhone string | null Not specified

bankAccountsRequired string (uuid)[] Not specified

referralLinkRequiredRead only string Not specified

isToNotifyTaxDeadlines boolean Not specified

createdRequiredRead only string (date-time) Not specified

isSmallBusinessRequiredRead only boolean Not specified

logo string (uri) | null Not specified

invoiceSettings object | null Not specified

isCurrentReportDeadlineRequiredRead only integer Not specified

chartOfAccountsRequiredRead only

object

Not specified

Nested fields

Field	Type / accepted values	Description
`publicId`RequiredRead only	`string (uuid)`	Not specified
`name`RequiredRead only	`string`	Not specified
`code`RequiredRead only	`string`	Not specified

datevAdvisorNumber string | null Not specified

datevClientNumber string | null Not specified

fiscalYearStart string (date) | null Not specified

isSmeRequiredRead only boolean Not specified

isFreelancerRequiredRead only boolean True for sole proprietors, including Freiberufler and Gewerbetreibender.

isArchivedRequiredRead only boolean ``status`` is rendered as its human label, so give the clients a flag they can branch on to mark a wound-down entity (POST /companies/{id}/archive/).

receiptsInboxEmailRequiredRead only string Not specified

billsInboxEmailRequiredRead only string Not specified

hasSepaTaxMandate boolean Not specified

hasKsefTokenRequiredRead only boolean Not specified

ksefAutoSync boolean Automatically sync invoices from KSeF every 6 hours.

pesel string Polish personal identification number. Required for JDG owners for PIT and ZUS filings.

zusRelief "none" | "start_relief" | "small_zus_plus" | "" Polish ZUS contribution relief for self-employed (JDG). * `none` - No relief * `start_relief` - Start relief (Ulga na start) * `small_zus_plus` - Small ZUS Plus (Mały ZUS Plus)

onboardingState object | null Not specified

400 Response fields

application/json

Field	Type / accepted values	Description
`detail`Required	`string`	Not specified
`code`	`integer`	Not specified
`type_`	`string`	Not specified
`field`Required	`string`	Not specified

401 Response fields

application/json

Field	Type / accepted values	Description
`detail`RequiredRead only	`string`	Not specified

403 Missing scope, company mismatch, unsupported operation, or a plan/account restriction.

429 Rate limit exceeded. Wait for the Retry-After header before retrying.

Use the base URL https://api.norman.finance/api/v1. Sign up or log in to Norman to create an API key, then send it as a Bearer token. For an OpenAPI JSON file, contact support.