Assessment YearΒΆ

Get Assessment YearΒΆ

HTTP Request

GET /api/assessment-years/{assessmentYearId}

πŸ“‹ Description: Retrieves detailed information about a specific assessment year identified by the provided assessmentYearId, enabling users to access relevant data for analysis and reporting.

Parameters

Name

In

Type

Required

Description

assessmentYearId

path

integer(int64)

true

Unique identifier for the assessment year

Responses

Status

Meaning

Description

Schema

200

OK

OK

AssessmentYearDto

Update Assessment YearΒΆ

HTTP Request

PUT /api/assessment-years/{assessmentYearId}

πŸ“‹ Description: Updates the details of a specific assessment year identified by the provided assessmentYearId, allowing for modifications to key attributes as necessary for accurate reporting and compliance.

Parameters

Name

In

Type

Required

Description

assessmentYearId

path

integer(int64)

true

Unique identifier for the assessment year

body

body

AssessmentYearDto

true

Request body containing the updated assessment year details, including relevant attributes and metadata for the specified assessment year.

Responses

Status

Meaning

Description

Schema

200

OK

OK

AssessmentYearDto

Delete Assessment YearΒΆ

HTTP Request

DELETE /api/assessment-years/{assessmentYearId}

πŸ“‹ Description: Deletes the specified assessment year identified by the assessmentYearId, ensuring the removal of associated data and maintaining data integrity within the assessment framework.

Parameters

Name

In

Type

Required

Description

assessmentYearId

path

integer(int64)

true

Unique identifier for the assessment year

Responses

Status

Meaning

Description

Schema

204

No Content

No Content

None

Create Assessment YearΒΆ

HTTP Request

POST /api/assessment-years

πŸ“‹ Description: Creates a new assessment year entry in the system, enabling organizations to manage and evaluate performance metrics effectively.

Parameters

Name

In

Type

Required

Description

body

body

AssessmentYearDto

true

Request body containing the assessment year details, including relevant attributes and metadata necessary for creating a new assessment period.

Responses

Status

Meaning

Description

Schema

201

Created

Created

AssessmentYearDto

Get AssessmentsΒΆ

HTTP Request

GET /api/assessment-years/{assessmentYearId}/assessments

πŸ“‹ Description: Fetches assessments associated with a specified assessment year, enabling users to review and analyze performance metrics for that period.

Parameters

Name

In

Type

Required

Description

assessmentYearId

path

integer(int64)

true

Unique identifier for the assessment year

archived

query

boolean

false

Indicates whether to retrieve assessments that have been archived, allowing users to filter results based on the status of the assessments.

page

query

integer(int32)

false

Page number for pagination

size

query

integer(int32)

false

Number of items per page

sort

query

string

false

Sort order specification

type-id-in

query

string

false

Identifier for the specific type of assessment to filter results in the assessment year query.

no-appeal

query

boolean

false

Indicates whether to exclude assessments that are subject to appeal for the specified assessment year.

no-vacancy

query

boolean

false

Indicates whether to exclude assessments that have no available vacancies for the specified assessment year.

Default ValuesΒΆ

Parameter

Default

Type

archived

false

query

page

0

query

size

5

query

Responses

Status

Meaning

Description

Schema

200

OK

OK

PagedResponseAssessmentDto

Create AssessmentsΒΆ

HTTP Request

POST /api/assessment-years/{assessmentYearId}/assessments

πŸ“‹ Description: Creates a new assessment record for the specified assessment year, enabling organizations to manage and evaluate performance metrics effectively.

Parameters

Name

In

Type

Required

Description

assessmentYearId

path

integer(int64)

true

Unique identifier for the assessment year

body

body

AssessmentDto

true

Request body containing the assessment details, including evaluation criteria and associated metadata, for the specified assessment year.

Responses

Status

Meaning

Description

Schema

201

Created

Created

Inline

Response Schema

Status Code 201

Name

Type

Required

Restrictions

Description

anonymous

[AssessmentDto]

false

none

[Data transfer object representing an assessment, encapsulating key details such as evaluation criteria, results, and associated metadata to facilitate informed decision-making in performance management.]

Β» createdBy

string

false

none

Username of who created this resource

Β» lastModifiedBy

string

false

none

Username of who last modified this resource

Β» createdDate

string(date-time)

false

none

Date of the created

Β» lastModifiedDate

string(date-time)

false

none

Date of the last modified

Β» archived

boolean

false

none

Indicates whether the assessment has been archived, reflecting its status in the system for record-keeping and retrieval purposes.

Β» externalId

string

false

none

Unique identifier for the external

Β» id

integer(int64)

false

none

Unique identifier for the resource

Β» assessmentTypeId

integer(int64)

true

none

Unique identifier for the assessment type

Β» referenceDate

string(date)

false

none

Date of the reference

Β» dateFrom

string(date)

false

none

Specifies the starting date for the assessment period, enabling accurate tracking and reporting of assessment activities.

Β» dateTo

string(date)

false

none

Specifies the end date for the assessment period, enabling accurate tracking and reporting of assessment timelines.

Β» buildingAssessment

number

false

none

Represents the numerical value of the building assessment, which is used to evaluate the condition and compliance of the property within the assessment framework.

Β» landAssessment

number

false

none

Represents the numerical value of the land assessment, which is essential for determining property valuation and tax implications.

Β» equipmentAssessment

number

false

none

Numeric value representing the assessment score of the equipment, used to evaluate its condition and performance within the operational framework.

Β» otherAssessment

number

false

none

Represents the numerical value of an additional assessment, providing insights for comprehensive evaluation within the assessment framework.

Β» totalAssessment

number

false

none

TotalAssessment represents the cumulative score or evaluation metric for the assessment, providing a quantitative measure of performance or achievement.

Β» assessmentType

PickListOptionDto

false

none

Data transfer object representing an option within a pick list, utilized for categorizing and selecting predefined values in business processes, enhancing data consistency and user experience.

»» createdBy

string

false

none

Username of who created this resource

»» lastModifiedBy

string

false

none

Username of who last modified this resource

»» createdDate

string(date-time)

false

none

Date of the created

»» lastModifiedDate

string(date-time)

false

none

Date of the last modified

»» archived

boolean

false

none

Indicates whether the pick list option has been archived, allowing for effective management of active and inactive options within the system.

»» externalId

string

false

none

Unique identifier for the external

»» id

integer(int64)

false

none

Unique identifier for the resource

»» priority

integer(int64)

false

none

Priority of the resource

»» internalId

integer(int64)

false

none

Unique identifier for the internal

»» pickListCode

string

false

none

Code for the pick list

»» pickListLabel

string

false

none

Label for the pick list

»» label

string

false

none

Label for the resource

»» cultureId

integer(int64)

false

none

Unique identifier for the culture

»» labelDtos

[LabelDto]

false

none

An array of pick list options that allows users to select and categorize relevant data points within the application.

»»» createdBy

string

false

none

Username of who created this resource

»»» lastModifiedBy

string

false

none

Username of who last modified this resource

»»» createdDate

string(date-time)

false

none

Date of the created

»»» lastModifiedDate

string(date-time)

false

none

Date of the last modified

»»» archived

boolean

false

none

Indicates whether the label has been archived, reflecting its current status within the system.

»»» externalId

string

false

none

Unique identifier for the external

»»» id

integer(int64)

false

none

Unique identifier for the resource

»»» cultureId

integer(int64)

false

none

Unique identifier for the culture

»»» value

string

true

none

Represents the textual value associated with the label, providing essential context for categorization and identification within the system.

Get Assessment TaxesΒΆ

HTTP Request

GET /api/assessment-years/{assessmentYearId}/assessment-taxes

πŸ“‹ Description: Fetches assessment tax details for a specified assessment year, enabling users to review and analyze tax data associated with that period.

Parameters

Name

In

Type

Required

Description

assessmentYearId

path

integer(int64)

true

Unique identifier for the assessment year

archived

query

boolean

false

Indicates whether to retrieve assessment taxes that have been archived, allowing users to filter results based on their current relevance.

page

query

integer(int32)

false

Page number for pagination

size

query

integer(int32)

false

Number of items per page

sort

query

string

false

Sort order specification

tax-type-id-in

query

string

false

Unique identifier for the type of tax applicable to the specified assessment year, facilitating accurate retrieval of assessment tax details.

tax-bill-version-id-in

query

string

false

Unique identifier for the specific version of the tax bill being queried, enabling precise retrieval of assessment tax data for the specified assessment year.

tax-status-id-in

query

string

false

Identifier for the specific tax status to filter assessment taxes associated with the given assessment year.

Default ValuesΒΆ

Parameter

Default

Type

archived

false

query

page

0

query

size

5

query

Responses

Status

Meaning

Description

Schema

200

OK

OK

PagedResponseAssessmentTaxDto

Create Assessment TaxesΒΆ

HTTP Request

POST /api/assessment-years/{assessmentYearId}/assessment-taxes

πŸ“‹ Description: Creates a new assessment tax record for the specified assessment year, enabling accurate financial tracking and compliance within the assessment framework.

Parameters

Name

In

Type

Required

Description

assessmentYearId

path

integer(int64)

true

Unique identifier for the assessment year

body

body

AssessmentTaxDto

true

Request body containing the assessment tax details, including amounts and applicable rates for the specified assessment year.

Responses

Status

Meaning

Description

Schema

201

Created

Created

Inline

Response Schema

Status Code 201

Name

Type

Required

Restrictions

Description

anonymous

[AssessmentTaxDto]

false

none

[Data transfer object representing the tax assessment details associated with a specific evaluation, including relevant financial metrics and compliance information for effective decision-making.]

Β» createdBy

string

false

none

Username of who created this resource

Β» lastModifiedBy

string

false

none

Username of who last modified this resource

Β» createdDate

string(date-time)

false

none

Date of the created

Β» lastModifiedDate

string(date-time)

false

none

Date of the last modified

Β» archived

boolean

false

none

Indicates whether the assessment has been archived, reflecting its status in the system for record-keeping and retrieval purposes.

Β» externalId

string

false

none

Unique identifier for the external

Β» id

integer(int64)

false

none

Unique identifier for the resource

Β» referenceNumber

string

false

none

Unique identifier for the assessment tax record, facilitating efficient tracking and management within the system.

Β» billingDate

string(date)

true

none

Date of the billing

Β» taxTypeId

integer(int64)

false

none

Unique identifier for the tax type

Β» taxPeriodStartDate

string(date)

false

none

Date of the tax period start

Β» taxPeriodEndDate

string(date)

false

none

Date of the tax period end

Β» taxableAssessment

number

false

none

Represents the total taxable assessment amount used for calculating tax liabilities within the financial reporting framework.

Β» totalTaxes

number

false

none

Total amount of taxes assessed for the transaction, providing a comprehensive view of tax liabilities associated with the assessment.

Β» taxRate

number

false

none

Rate of tax

Β» firstPaymentDate

string(date)

false

none

Date of the first payment

Β» taxBillVersionId

integer(int64)

false

none

Unique identifier for the tax bill version

Β» taxStatusId

integer(int64)

false

none

Unique identifier for the tax status

Β» taxType

PickListOptionDto

false

none

Data transfer object representing an option within a pick list, utilized for categorizing and selecting predefined values in business processes, enhancing data consistency and user experience.

»» createdBy

string

false

none

Username of who created this resource

»» lastModifiedBy

string

false

none

Username of who last modified this resource

»» createdDate

string(date-time)

false

none

Date of the created

»» lastModifiedDate

string(date-time)

false

none

Date of the last modified

»» archived

boolean

false

none

Indicates whether the pick list option has been archived, allowing for effective management of active and inactive options within the system.

»» externalId

string

false

none

Unique identifier for the external

»» id

integer(int64)

false

none

Unique identifier for the resource

»» priority

integer(int64)

false

none

Priority of the resource

»» internalId

integer(int64)

false

none

Unique identifier for the internal

»» pickListCode

string

false

none

Code for the pick list

»» pickListLabel

string

false

none

Label for the pick list

»» label

string

false

none

Label for the resource

»» cultureId

integer(int64)

false

none

Unique identifier for the culture

»» labelDtos

[LabelDto]

false

none

An array of pick list options that allows users to select and categorize relevant data points within the application.

»»» createdBy

string

false

none

Username of who created this resource

»»» lastModifiedBy

string

false

none

Username of who last modified this resource

»»» createdDate

string(date-time)

false

none

Date of the created

»»» lastModifiedDate

string(date-time)

false

none

Date of the last modified

»»» archived

boolean

false

none

Indicates whether the label has been archived, reflecting its current status within the system.

»»» externalId

string

false

none

Unique identifier for the external

»»» id

integer(int64)

false

none

Unique identifier for the resource

»»» cultureId

integer(int64)

false

none

Unique identifier for the culture

»»» value

string

true

none

Represents the textual value associated with the label, providing essential context for categorization and identification within the system.

Β» taxBillVersion

PickListOptionDto

false

none

Data transfer object representing an option within a pick list, utilized for categorizing and selecting predefined values in business processes, enhancing data consistency and user experience.

Β» taxStatus

PickListOptionDto

false

none

Data transfer object representing an option within a pick list, utilized for categorizing and selecting predefined values in business processes, enhancing data consistency and user experience.

Archive Assessment YearΒΆ

HTTP Request

POST /api/assessment-years/{assessmentYearId}/archive

πŸ“‹ Description: Archives the specified assessment year, effectively marking it as inactive and preventing further modifications, thereby ensuring data integrity and compliance with business record-keeping practices.

Parameters

Name

In

Type

Required

Description

assessmentYearId

path

integer(int64)

true

Unique identifier for the assessment year

Responses

Status

Meaning

Description

Schema

200

OK

OK

AssessmentYearDto

Get VacanciesΒΆ

HTTP Request

GET /api/assessment-years/{assessmentYearId}/vacancies

πŸ“‹ Description: Retrieves a list of vacancies associated with a specific assessment year, enabling users to effectively manage and allocate resources for workforce planning.

Parameters

Name

In

Type

Required

Description

assessmentYearId

path

integer(int64)

true

Unique identifier for the assessment year

page

query

integer(int32)

false

Page number for pagination

size

query

integer(int32)

false

Number of items per page

sort

query

string

false

Sort order specification

Default ValuesΒΆ

Parameter

Default

Type

page

0

query

size

5

query

Responses

Status

Meaning

Description

Schema

200

OK

OK

PagedResponseVacancyDto

Get AppealsΒΆ

HTTP Request

GET /api/assessment-years/{assessmentYearId}/appeals

πŸ“‹ Description: Retrieves a list of appeals associated with a specific assessment year, identified by the provided assessmentYearId, to facilitate review and management of appeal cases.

Parameters

Name

In

Type

Required

Description

assessmentYearId

path

integer(int64)

true

Unique identifier for the assessment year

page

query

integer(int32)

false

Page number for pagination

size

query

integer(int32)

false

Number of items per page

sort

query

string

false

Sort order specification

Default ValuesΒΆ

Parameter

Default

Type

page

0

query

size

5

query

Responses

Status

Meaning

Description

Schema

200

OK

OK

PagedResponseAppealDto