▚ BIAN PLATFORM
CatalogRunFAQRepo ↗

Operations and Execution

Custody Administration

sd-custody-administration · bian-operations

A BIAN service domain in Operations and Execution. It applies the Administer functional pattern to the Custody Holding, with the Custody Holding Administrative Plan as its control record — one independent Spring Boot microservice on the platform's Cilium eBPF mesh.

View repository ↗The 162-domain platform ↗

Business DomainSecurities
Functional PatternAdminister
Asset TypeCustody Holding
Control RecordCustody Holding Administrative Plan

USEWhat it is used for

Representative use cases for the Custody Administration service domain within a BIAN-aligned core-banking landscape.

APIBIAN semantic API

The control record (Custody Holding Administrative Plan) is exposed through uniform BIAN action terms. Java 21 · Spring Boot 3, OpenAPI at /swagger-ui.html, health at /actuator/health.

MethodPathBIAN action
GET/v1/service-domainService metadata
POST/v1/custody-holding-administrative-plan/initiateInitiate
GET/v1/custody-holding-administrative-plan/{crId}/retrieveRetrieve
PUT/v1/custody-holding-administrative-plan/{crId}/updateUpdate
PUT/v1/custody-holding-administrative-plan/{crId}/controlControl (suspend / resume / terminate)

INTBackend integrations

The systems and standards a real deployment of Custody Administration would transact with.

RUNRun it yourself

Each service domain is its own standalone Spring Boot repository — clone and run in seconds, or deploy onto Kubernetes with the bundled Helm chart behind the Cilium mesh.

# run this service domain standalone
git clone https://github.com/Sreenivas-Sadhu-Prabhakara/sd-custody-administration
mvn -f sd-custody-administration spring-boot:run
curl localhost:8080/v1/service-domain

# or deploy onto Kubernetes (Cilium eBPF mesh)
helm upgrade --install sd-custody-administration ./helm -n bian-operations

FAQQuestions

What is the BIAN “Administer” functional pattern?
An Administer service domain maintains and applies administrative rules, agreements or records over time. Custody Administration applies it to the Custody Holding.
What is a BIAN service domain?
BIAN (the Banking Industry Architecture Network) decomposes a bank into independent service domains, each owning exactly one business capability. Custody Administration is the service domain for Securities; it manages the Custody Holding Administrative Plan and exposes it through standard BIAN action terms.
What business area does Custody Administration belong to?
Custody Administration sits in the Operations and Execution business area — the operational core that executes payments, positions, settlements and transactions. It runs in the bian-operations namespace as one independent Spring Boot microservice.
Is Custody Administration production-ready?
It is an educational reference implementation: a real BIAN REST API over an in-memory store, ready to be filled with domain logic. It is not a live bank and is not affiliated with BIAN.

SEEIn the landscape

Custody Administration is one of 162 BIAN service domains on the platform. Explore the rest:

▚ Platform overview The Master Catalog (162 domains) This repository ↗