Regionยถ

Get A Resource By IDยถ

HTTP Request

GET /api/v1/regions/{id}

๐Ÿ“‹ Description: Retrieves detailed information about a specific financial entityโ€™s region within the organizational structure, identified by the provided region ID.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseRegionDto

Update A Resourceยถ

HTTP Request

PUT /api/v1/regions/{id}

๐Ÿ“‹ Description: Updates the details of a specified region within the financial organization structure, allowing for adjustments to the hierarchy and organization of financial entities.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

body

body

RegionDto

true

Request body containing updated details for the specified region, including organizational hierarchy and financial entity attributes.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseRegionDto

Deleteยถ

HTTP Request

DELETE /api/v1/regions/{id}

๐Ÿ“‹ Description: Deletes a specified region from the financial organization structure, ensuring the hierarchy remains accurate and up-to-date for effective management of financial entities.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseVoid

Delete Or Decommissionยถ

HTTP Request

PUT /api/v1/regions/remove/{id}

๐Ÿ“‹ Description: Removes a specified region from the financial organization structure, ensuring the hierarchy remains accurate and up-to-date for effective management of financial entities.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseVoid

Delete Or Decommission Allยถ

HTTP Request

PUT /api/v1/regions/remove/bulk

๐Ÿ“‹ Description: Removes multiple regions from the financial organization structure in a single operation, ensuring efficient management of the entityโ€™s hierarchical configuration.

Parameters

Name

In

Type

Required

Description

body

body

array[integer]

true

Request body containing a list of region identifiers to be removed in bulk from the financial organization structure, ensuring an updated hierarchy within the entity.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseVoid

Decommissionยถ

HTTP Request

PUT /api/v1/regions/decommission/{id}

๐Ÿ“‹ Description: Decommissions a specified region within the financial organization structure, effectively removing it from the active hierarchy and ensuring that it is no longer considered in organizational operations. This operation is essential for maintaining an accurate representation of the financial entityโ€™s structure.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseRegionDto

Decommission By Modification Date Beforeยถ

HTTP Request

PUT /api/v1/regions/decommission/modified-before/{modified_before}

๐Ÿ“‹ Description: Decommissions financial entities in the organization structure that were modified before the specified date, ensuring the hierarchy remains current and aligned with business needs.

Parameters

Name

In

Type

Required

Description

modified_before

path

string(date-time)

true

Specifies the cutoff date for decommissioning regions in the financial organization structure, allowing for the selective removal of entities modified before this date.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseListRegionDto

Decommission Before Nowยถ

HTTP Request

PUT /api/v1/regions/decommission/modified-before-now

๐Ÿ“‹ Description: Decommissions regions within the financial organization structure that have been modified before the current date, ensuring the hierarchy remains up-to-date and aligned with organizational needs.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseListRegionDto

Decommission Allยถ

HTTP Request

PUT /api/v1/regions/decommission/bulk

๐Ÿ“‹ Description: Decommissions multiple regions within the financial organization structure, allowing for efficient management of the hierarchy and alignment of financial entities.

Parameters

Name

In

Type

Required

Description

body

body

array[integer]

true

Request body containing a list of financial entity regions to be decommissioned in bulk, including relevant identifiers and metadata for organizational structure management.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseListRegionDto

Bulk Create-Or-Update Resourcesยถ

HTTP Request

PUT /api/v1/regions/createOrUpdate/bulk

๐Ÿ“‹ Description: Updates or creates multiple regions within the financial organization structure in a single operation, allowing for efficient management of organizational hierarchy and entity configurations.

Parameters

Name

In

Type

Required

Description

body

body

RegionDto

true

Request body containing a bulk array of region data for creating or updating financial entities within the organizational structure and hierarchy.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseListRegionDto

Create Or Update A Resourceยถ

HTTP Request

PUT /api/v1/regions/createOrUpdate

๐Ÿ“‹ Description: Creates or updates a financial entityโ€™s organizational structure within the specified region, ensuring the hierarchy reflects the latest changes in the organization.

Parameters

Name

In

Type

Required

Description

body

body

RegionDto

true

Request body containing the financial entityโ€™s regional data, including hierarchical structure and organizational attributes for creation or update purposes.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseRegionDto

Bulk-Update Resourcesยถ

HTTP Request

PUT /api/v1/regions/bulk

๐Ÿ“‹ Description: Updates multiple regions within the financial organization structure in a single request, allowing for efficient management of hierarchical relationships among financial entities.

Parameters

Name

In

Type

Required

Description

body

body

RegionDto

true

Request body containing a bulk update of regional financial entity data, including organizational hierarchy and structure details.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseListRegionDto

Bulk Createยถ

HTTP Request

POST /api/v1/regions/bulk

๐Ÿ“‹ Description: Submits a bulk creation request for multiple regions within the financial organization structure, enabling efficient management of organizational hierarchy and entity classification.

Parameters

Name

In

Type

Required

Description

body

body

RegionDto

true

Request body containing a list of region data for bulk creation or updates within the financial organization structure, including hierarchical relationships and associated attributes.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseListRegionDto

Bulk Deleteยถ

HTTP Request

DELETE /api/v1/regions/bulk

๐Ÿ“‹ Description: Deletes multiple regions from the financial organization structure, allowing for efficient management of the hierarchy within financial entities.

Parameters

Name

In

Type

Required

Description

body

body

array[integer]

true

Request body containing an array of region identifiers to be deleted from the financial organization structure hierarchy.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseVoid

Search Resourcesยถ

HTTP Request

POST /api/v1/regions/search

๐Ÿ“‹ Description: Submits a search request for financial organization regions, enabling users to identify and retrieve specific hierarchical structures within the financial entity.

Parameters

Name

In

Type

Required

Description

page

query

integer

false

Zero-based page index (0..N)

size

query

integer

false

The size of the page to be returned

sort

query

array[string]

false

Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.

body

body

RegionDtoFilter

false

Request body containing search criteria for identifying financial entities within the organizational structure and hierarchy.

Default Valuesยถ

Parameter

Default

Type

page

0

query

size

100

query

sort

["createdAt,ASC"]

query

Parameter Constraintsยถ

Parameter

Constraints

page

Min: 0

size

Min: 1

Responses

Status

Meaning

Description

Schema

200

OK

OK

PageRegionDto

Detach Countryยถ

HTTP Request

POST /api/v1/regions/detach/country/{relation_id}

๐Ÿ“‹ Description: Detaches a specified country from the financial organization structure hierarchy using the provided relation ID, thereby updating the organizational relationships within the financial entity.

Parameters

Name

In

Type

Required

Description

relation_id

path

integer(int64)

true

Unique identifier for the financial entityโ€™s relationship within the organizational structure, used to detach a country from the specified hierarchy.

body

body

RegionDto

true

Request body containing the details of the financial entityโ€™s relationship to be detached from the specified country, including relevant identifiers and metadata.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseVoid

Attach Countryยถ

HTTP Request

POST /api/v1/regions/attach/country/{relation_id}

๐Ÿ“‹ Description: Attaches a specified country to a financial organizationโ€™s structure using the provided relation ID, facilitating the establishment of hierarchical relationships within the entity.

Parameters

Name

In

Type

Required

Description

relation_id

path

integer(int64)

true

Unique identifier for the country relationship within the financial organization structure, facilitating the attachment of regions to the specified country entity.

body

body

RegionDto

true

Request body containing the country association details, including relationship attributes and hierarchical positioning within the financial organization structure.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseVoid

List All Resourcesยถ

HTTP Request

GET /api/v1/regions

๐Ÿ“‹ Description: Retrieves a list of regions within the financial organization structure, providing insights into the hierarchical organization of financial entities.

Parameters

Name

In

Type

Required

Description

pageable

query

Pageable

true

Indicates whether the results of the financial organization structure query should be returned in a paginated format, facilitating efficient navigation through large datasets of regions.

Responses

Status

Meaning

Description

Schema

200

OK

OK

PageRegionDto

Createยถ

HTTP Request

POST /api/v1/regions

๐Ÿ“‹ Description: Creates a new region within the financial organization structure, enabling the establishment of hierarchical relationships and enhancing the management of financial entities.

Parameters

Name

In

Type

Required

Description

body

body

RegionDto

true

Request body containing the details of a new financial entityโ€™s regional structure, including hierarchy and organizational attributes.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseRegionDto

Get Metadataยถ

HTTP Request

GET /api/v1/regions/meta

๐Ÿ“‹ Description: Retrieves metadata related to the organizational structure and hierarchy of financial entities, providing essential insights for effective management and analysis.

Responses

Status

Meaning

Description

Schema

200

OK

OK

Inline

Response Schema

Find All By System IDยถ

HTTP Request

GET /api/v1/regions/erp-system/{systemId}

๐Ÿ“‹ Description: Retrieves the organizational structure and hierarchy details for a specified financial entity within the ERP system, identified by the unique system ID.

Parameters

Name

In

Type

Required

Description

systemId

path

integer(int64)

true

Unique identifier for the system

pageable

query

Pageable

true

Indicates whether the results should be returned in a paginated format, facilitating efficient navigation through the financial organization structure of the specified ERP system.

Responses

Status

Meaning

Description

Schema

200

OK

OK

PageRegionDto

Get All By Countryยถ

HTTP Request

GET /api/v1/regions/country/{id}

๐Ÿ“‹ Description: Retrieves detailed information about a specific country within the financial organization structure, identified by the provided country ID. This operation supports the understanding of the organizational hierarchy and structure of financial entities.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

pageable

query

Pageable

true

Indicates whether the response should be paginated, facilitating efficient retrieval of hierarchical data related to financial entities within the specified country.

Responses

Status

Meaning

Description

Schema

200

OK

OK

PageRegionDto