Location

Location - Get

HTTP Request

GET /api/v1/locations/{id}

📋 Description: Retrieves detailed information about a specific financial entity’s location within the organizational structure, identified by the provided 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

ResponseLocationDto

Location - Update

HTTP Request

PUT /api/v1/locations/{id}

📋 Description: Updates the details of a specified financial entity location within the organizational structure, allowing for adjustments to hierarchy and operational alignment.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

body

body

LocationDto

true

Request body containing the updated financial entity location details, including hierarchical structure and organizational attributes.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseLocationDto

Location - Delete

HTTP Request

DELETE /api/v1/locations/{id}

📋 Description: Deletes a specified location from the financial organization structure, ensuring the hierarchy remains accurate and up-to-date for effective organizational management.

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

Location - Delete Or Decommission

HTTP Request

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

📋 Description: Removes a specified location 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

Location - Delete Or Decommission All

HTTP Request

PUT /api/v1/locations/remove/bulk

📋 Description: Removes multiple locations from the financial organization structure in a single request, ensuring the hierarchy remains accurate and up-to-date.

Parameters

Name

In

Type

Required

Description

body

body

array[integer]

true

Request body containing an array of location identifiers to be removed in bulk from the financial organization structure, ensuring updates to the hierarchy of financial entities.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseVoid

Location - Decommission

HTTP Request

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

📋 Description: Decommissions a specified financial entity location within the organizational structure, effectively removing it from the hierarchy and ensuring accurate representation of the current operational framework.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseLocationDto

Location - Decommission By Modification Date Before

HTTP Request

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

📋 Description: Decommissions financial organization locations that have been modified before the specified date, ensuring the integrity of the organizational structure and hierarchy within the financial entity. This operation helps maintain an up-to-date and efficient organizational framework.

Parameters

Name

In

Type

Required

Description

modified_before

path

string(date-time)

true

Specifies the date and time before which the financial organization structure locations were modified, facilitating the decommissioning of outdated entries.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseListLocationDto

Location - Decommission Before Now

HTTP Request

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

📋 Description: Decommissions financial entity locations that have been modified before the current date, ensuring the organization’s structure remains up-to-date and aligned with operational needs.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseListLocationDto

Location - Decommission All

HTTP Request

PUT /api/v1/locations/decommission/bulk

📋 Description: Updates the status of multiple locations within the financial organization structure to ‘decommissioned,’ facilitating the management of organizational hierarchy and ensuring accurate representation of active financial entities.

Parameters

Name

In

Type

Required

Description

body

body

array[integer]

true

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

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseListLocationDto

Location - Create Or Update Bulk

HTTP Request

PUT /api/v1/locations/createOrUpdate/bulk

📋 Description: Creates or updates multiple financial entity locations within the organization structure in a single request, ensuring the hierarchy is accurately maintained.

Parameters

Name

In

Type

Required

Description

body

body

LocationDto

true

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

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseListLocationDto

Location - Create Or Update

HTTP Request

PUT /api/v1/locations/createOrUpdate

📋 Description: Creates or updates a financial entity’s location within the organizational structure, ensuring accurate hierarchy representation and alignment with business needs.

Parameters

Name

In

Type

Required

Description

body

body

LocationDto

true

Request body containing the details of the financial entity’s location, including hierarchical structure and organizational attributes for creation or update purposes.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseLocationDto

Location - Bulk Update

HTTP Request

PUT /api/v1/locations/bulk

📋 Description: Updates multiple location records within the financial organization structure, allowing for efficient management of the hierarchy and relationships among financial entities.

Parameters

Name

In

Type

Required

Description

body

body

LocationDto

true

Request body containing a bulk update of financial entity location data, including organizational hierarchy and structural attributes.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseListLocationDto

Location - Bulk Create

HTTP Request

POST /api/v1/locations/bulk

📋 Description: Submits a bulk upload of location data to establish or update the organizational structure of financial entities, ensuring accurate hierarchy representation within the system.

Parameters

Name

In

Type

Required

Description

body

body

LocationDto

true

Request body containing a collection of financial entity location data, structured to facilitate the bulk creation or update of organizational hierarchy within the financial organization.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseListLocationDto

Location - Bulk Delete

HTTP Request

DELETE /api/v1/locations/bulk

📋 Description: Deletes multiple locations within the financial organization structure, allowing for efficient management of the entity’s hierarchical framework.

Parameters

Name

In

Type

Required

Description

body

body

array[integer]

true

Request body containing an array of location identifiers to be deleted from the financial organization structure, reflecting changes in the hierarchy of the financial entity.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseVoid

Location - Find All

HTTP Request

GET /api/v1/locations

📋 Description: Retrieves a list of financial entities within the organizational structure, providing insights into the hierarchy and relationships among various locations.

Parameters

Name

In

Type

Required

Description

pageable

query

Pageable

true

Indicates whether the results for the financial organization structure locations should be returned in a paginated format, facilitating efficient data retrieval and management within the organizational hierarchy.

Responses

Status

Meaning

Description

Schema

200

OK

OK

PageLocationDto

Location - Create

HTTP Request

POST /api/v1/locations

📋 Description: Creates a new location within the financial organization structure, enabling the establishment of hierarchical relationships among financial entities.

Parameters

Name

In

Type

Required

Description

body

body

LocationDto

true

Request body containing the hierarchical structure data for a financial organization, including details on locations and their relationships within the entity.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseLocationDto

Location - Get Metadata

HTTP Request

GET /api/v1/locations/meta

📋 Description: Retrieves metadata related to the financial organization structure, including details about locations within the hierarchy of financial entities. This operation supports effective management and analysis of organizational configurations.

Responses

Status

Meaning

Description

Schema

200

OK

OK

Inline

Response Schema

Location - Find All By System ID

HTTP Request

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

📋 Description: Fetches the details of a specified financial entity’s organizational structure within the ERP system, enabling users to understand the hierarchy and relationships of various components.

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 associated with the specified ERP system.

Responses

Status

Meaning

Description

Schema

200

OK

OK

PageLocationDto

Location - Get All By Asset

HTTP Request

GET /api/v1/locations/asset/{asset_id}

📋 Description: Retrieves detailed information about a specific asset within the financial organization structure, providing insights into its hierarchical positioning and associated organizational elements.

Parameters

Name

In

Type

Required

Description

asset_id

path

integer(int64)

true

Unique identifier for the financial asset within the organization’s structure, used to retrieve detailed information about its location in the hierarchy.

pageable

query

Pageable

true

Indicates whether the results should be returned in a paginated format, facilitating efficient data retrieval within the financial organization structure.

Responses

Status

Meaning

Description

Schema

200

OK

OK

PageLocationDto