PUBLIC API v1

List of tax settings of the company

GET /api/v1/taxes/tax-settings/

The endpoint returns a list of tax settings of the company

Permission: read_tax · Direct link

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

Parameter	Location / type	Description
`ordering`	query · `"-tax_year" \| "tax_year"[]`	Ordering * `tax_year` - Tax year * `-tax_year` - Tax year (descending)
`page`	query · `integer`	A page number within the paginated result set.
`page_size`	query · `integer`	Number of results to return per page.
`tax_type`	query · `"corporate" \| "income" \| "profit_loss" \| "sales" \| "trade"`	* `sales` - Sales * `trade` - Trade * `income` - Income * `profit_loss` - Profit & Loss * `corporate` - Corporate
`tax_year`	query · `integer`	Not specified

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
`pk`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
`taxTypeName`Required	`string`	Not specified
`vatType`	`"vat_subject" \| "kleinunternehmer" \| "small_business_exempt" \| "vat_exempt"`	* `vat_subject` - Subject to VAT * `kleinunternehmer` - Kleinunternehmer * `small_business_exempt` - Small business VAT exempt * `vat_exempt` - Exempt of VAT
`vatTypeName`Required	`string`	Not specified
`vatPercent`	`0 \| 5 \| 7 \| 8 \| 19 \| 23`	* `0` - 0 * `5` - 5 * `7` - 7 * `8` - 8 * `19` - 19 * `23` - 23
`startTaxReportDate`	`string (date)`	Not specified
`advancedPaymentSize`	`integer`	Not specified
`reportingFrequency`	`"monthly" \| "quarterly" \| "yearly"`	* `monthly` - Monthly * `quarterly` - Quarterly * `yearly` - Yearly
`reportingFrequencyName`Required	`string`	Not specified
`taxYear`	`integer`	Not specified
`company`Required	`string (uuid)`	Not specified

400 Response fields

application/json

401 Response fields

application/json

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

403 Response fields

application/json

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

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.