Get Fees

GET 
/fees

Returns all fees with nested fee items (tax rates) for the resolved company in a single response (not paginated). Each good's vat.fee_item_id matches a fee_items[].id under one of these fees — use this list to resolve full fee metadata.

Responses

200

OK

application/json

Schema

Schema

items

object[]

required

Array [

id uuidrequired

Fee identifier (parent of entries in fee_items[]; locate the fee that contains a good's vat.fee_item_id)

name stringrequired

Possible values: >= 2 characters and <= 64 characters

Fee display name

category FeeCategoryPublicDTO (string)required

Possible values: [tax, unknown]

Fee category

application_rule FeeApplicationRulePublicDTO (string)required

Possible values: [inclusive, unknown]

How the fee is applied to the price

fee_items

object[]

required

Available tax rates for this fee. Empty array when no rates are defined for this fee.

Array [

id uuidrequired

Fee item identifier; matches vat.fee_item_id on goods returned by catalog endpoints

name stringrequired

Possible values: >= 2 characters and <= 64 characters

Display name

percentage double

Possible values: <= 100

Tax rate in percent (decimal, e.g. 5 or 5.25). Absent when the fee item represents an exempt (non-percentage) rate.

]

]

Example (from schema)

{
  "items": [
    {
      "id": "55555555-5555-4555-8555-555555555555",
      "name": "VAT",
      "category": "tax",
      "application_rule": "inclusive",
      "fee_items": [
        {
          "id": "66666666-6666-4666-8666-666666666666",
          "name": "5%",
          "percentage": 5
        }
      ]
    }
  ]
}

400

Bad request — malformed syntax, invalid parameters, or failed validation. Typical code values: validation_error, invalid_request. List endpoints that accept a cursor parameter additionally return invalid_cursor when the cursor is invalid or expired.

application/problem+json

Schema

Schema

title stringrequired

Short human-readable summary

type stringrequired

URI reference identifying the problem category

instance stringnullable

URI reference identifying the specific request that caused this error (e.g. the request path).

trace_id stringrequired

Correlation id for support (report when contacting support)

status int32required

HTTP status code

code stringrequired

Machine-readable code for client branching

detail stringnullable

Human-readable explanation (optional)

reason string

Stable extension when code is existing_entity_conflict. For a duplicate external_data.id within the company, the value is duplicate_external_data_id.

errors

object

nullable

Present when code is validation_error. Keys are field names; values are arrays of human-readable error messages for that field.

property name*

string[]

nullable

Array [

string

]

Example (from schema)

{
  "title": "string",
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "instance": "/api/catalog/goods/regular",
  "trace_id": "00-84c1fd4063c38d9f3900d06e56542d48-85d1d4-00",
  "status": 0,
  "code": "validation_error",
  "detail": "string",
  "reason": "duplicate_external_data_id",
  "errors": {
    "uom_id": [
      "'uom_id' must not be empty."
    ],
    "vat": [
      "'vat' must not be empty."
    ],
    "variations": [
      "'variations' must contain between 1 and 150 items."
    ]
  }
}

validation

{
  "title": "One or more errors occurred.",
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "trace_id": "00-00000000000000000000000000000000-00000000-00",
  "status": 400,
  "instance": "/api/catalog/goods/regular",
  "code": "validation_error",
  "errors": {
    "name": [
      "'name' must not be empty."
    ]
  }
}

401

Missing or invalid credentials before the gateway forwards context (when applicable). The response has no body (empty payload).

403

Caller is not allowed to access this resource or company. The response has no body (empty payload).

404

Resource not found or not visible for the resolved company. The response has no body (empty payload).

429

Rate limit exceeded.

Response Headers

• Retry-After

  integer

  Seconds to wait before retrying

application/problem+json

Schema

Schema

title stringrequired

Short human-readable summary

type stringrequired

URI reference identifying the problem category

instance stringnullable

URI reference identifying the specific request that caused this error (e.g. the request path).

trace_id stringrequired

Correlation id for support (report when contacting support)

status int32required

HTTP status code

code stringrequired

Machine-readable code for client branching

detail stringnullable

Human-readable explanation (optional)

reason string

Stable extension when code is existing_entity_conflict. For a duplicate external_data.id within the company, the value is duplicate_external_data_id.

errors

object

nullable

Present when code is validation_error. Keys are field names; values are arrays of human-readable error messages for that field.

property name*

string[]

nullable

Array [

string

]

Example (from schema)

{
  "title": "string",
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "instance": "/api/catalog/goods/regular",
  "trace_id": "00-84c1fd4063c38d9f3900d06e56542d48-85d1d4-00",
  "status": 0,
  "code": "validation_error",
  "detail": "string",
  "reason": "duplicate_external_data_id",
  "errors": {
    "uom_id": [
      "'uom_id' must not be empty."
    ],
    "vat": [
      "'vat' must not be empty."
    ],
    "variations": [
      "'variations' must contain between 1 and 150 items."
    ]
  }
}

rateLimit

{
  "title": "Too Many Requests",
  "type": "https://tools.ietf.org/html/rfc6585#section-4",
  "trace_id": "00-00000000000000000000000000000000-00000000-00",
  "status": 429,
  "code": "unexpected_error"
}

500

Unexpected server error.

application/problem+json

Schema

Schema

title stringrequired

Short human-readable summary

type stringrequired

URI reference identifying the problem category

instance stringnullable

URI reference identifying the specific request that caused this error (e.g. the request path).

trace_id stringrequired

Correlation id for support (report when contacting support)

status int32required

HTTP status code

code stringrequired

Machine-readable code for client branching

detail stringnullable

Human-readable explanation (optional)

reason string

Stable extension when code is existing_entity_conflict. For a duplicate external_data.id within the company, the value is duplicate_external_data_id.

errors

object

nullable

Present when code is validation_error. Keys are field names; values are arrays of human-readable error messages for that field.

property name*

string[]

nullable

Array [

string

]

Example (from schema)

{
  "title": "string",
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "instance": "/api/catalog/goods/regular",
  "trace_id": "00-84c1fd4063c38d9f3900d06e56542d48-85d1d4-00",
  "status": 0,
  "code": "validation_error",
  "detail": "string",
  "reason": "duplicate_external_data_id",
  "errors": {
    "uom_id": [
      "'uom_id' must not be empty."
    ],
    "vat": [
      "'vat' must not be empty."
    ],
    "variations": [
      "'variations' must contain between 1 and 150 items."
    ]
  }
}

unexpected

{
  "type": "https://tools.ietf.org/html/rfc9110#section-15.6.1",
  "trace_id": "00-00000000000000000000000000000000-00000000-00",
  "status": 500,
  "code": "internal_server_error"
}

503

Service temporarily unavailable.

application/problem+json

Schema

Schema

title stringrequired

Short human-readable summary

type stringrequired

URI reference identifying the problem category

instance stringnullable

URI reference identifying the specific request that caused this error (e.g. the request path).

trace_id stringrequired

Correlation id for support (report when contacting support)

status int32required

HTTP status code

code stringrequired

Machine-readable code for client branching

detail stringnullable

Human-readable explanation (optional)

reason string

Stable extension when code is existing_entity_conflict. For a duplicate external_data.id within the company, the value is duplicate_external_data_id.

errors

object

nullable

Present when code is validation_error. Keys are field names; values are arrays of human-readable error messages for that field.

property name*

string[]

nullable

Array [

string

]

Example (from schema)

{
  "title": "string",
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "instance": "/api/catalog/goods/regular",
  "trace_id": "00-84c1fd4063c38d9f3900d06e56542d48-85d1d4-00",
  "status": 0,
  "code": "validation_error",
  "detail": "string",
  "reason": "duplicate_external_data_id",
  "errors": {
    "uom_id": [
      "'uom_id' must not be empty."
    ],
    "vat": [
      "'vat' must not be empty."
    ],
    "variations": [
      "'variations' must contain between 1 and 150 items."
    ]
  }
}

unavailable

{
  "type": "https://tools.ietf.org/html/rfc9110#section-15.6.4",
  "trace_id": "00-00000000000000000000000000000000-00000000-00",
  "status": 503
}

Loading...