API reference · Communities & institutions

Credit union surplus and distributions

POST Record that a member claimed a held allocation

POST /credit-union/{reference}/allocation/{allocationReference}/claim

Headers

NameNotes
AuthorizationBearer token
X-TenantYour tenant
X-Environmenttest or live

Path parameters

Name
reference
allocationReference

Query parameters

NameDefault
transactionReferenceOptional

Example

Response: GenericResponseDistributionAllocationResponse

curl -X POST "https://api.bridgemoni.com/credit-union/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/allocation/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/claim" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

Responses

StatusWhen
200Allocation claimed successfully

POST Apply the statutory appropriation

POST /credit-union/{reference}/appropriation

Writes a journal per fund out of retained surplus. What is left after every fund has taken its share is what a dividend or a rebate may be declared against.

Headers

NameNotes
AuthorizationBearer token
X-TenantYour tenant
X-Environmenttest or live
Content-Typeapplication/json

Path parameters

Name
reference

Example

Request body: ProposeAppropriationRequest · Response: GenericResponseAppropriationRunResponse

curl -X POST "https://api.bridgemoni.com/credit-union/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/appropriation" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV" \
  -H "Content-Type: application/json" \
  -d '{
  "fiscalYear": 0,
  "ratesBasisPoints": {},
  "resolutionReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e"
}'

Responses

StatusWhen
200Appropriation applied successfully

POST Propose the statutory appropriation

POST /credit-union/{reference}/appropriation/proposal

Runs the sequence without writing it. Each step applies to what the step before it left, and a fund outside its statutory floor or ceiling is named in the refusals rather than clamped.

Headers

NameNotes
AuthorizationBearer token
X-TenantYour tenant
X-Environmenttest or live
Content-Typeapplication/json

Path parameters

Name
reference

Example

Request body: ProposeAppropriationRequest · Response: GenericResponseAppropriationRunResponse

curl -X POST "https://api.bridgemoni.com/credit-union/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/appropriation/proposal" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV" \
  -H "Content-Type: application/json" \
  -d '{
  "fiscalYear": 0,
  "ratesBasisPoints": {},
  "resolutionReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e"
}'

Responses

StatusWhen
200Appropriation proposed successfully

GET Read a year's appropriation

GET /credit-union/{reference}/appropriation/{fiscalYear}

Headers

NameNotes
AuthorizationBearer token
X-TenantYour tenant
X-Environmenttest or live

Path parameters

Name
reference
fiscalYear

Example

Response: GenericResponseAppropriationRunResponse

curl -X GET "https://api.bridgemoni.com/credit-union/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/appropriation/value" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

Responses

StatusWhen
200Appropriation retrieved successfully

POST Declare a distribution

POST /credit-union/{reference}/distribution

One rate for everyone entitled. The surplus is read from the closed year's books, not supplied, and a rate that would overspend it is refused. Allocation is on share-unit days, deposit amount-days or interest actually paid.

Headers

NameNotes
AuthorizationBearer token
X-TenantYour tenant
X-Environmenttest or live
Content-Typeapplication/json

Path parameters

Name
reference

Example

Request body: DeclareDistributionRequest · Response: GenericResponseDistributionResponse

curl -X POST "https://api.bridgemoni.com/credit-union/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/distribution" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "SHARE_DIVIDEND",
  "fiscalYear": 0,
  "rateBasisPoints": 0,
  "agmMinuteReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
  "defaultDestination": "SHARES",
  "withholdingPolicyCode": "string",
  "withholdingBasisPoints": 0
}'

Responses

StatusWhen
200Distribution declared successfully

DELETE Cancel a distribution that has not been paid

DELETE /credit-union/{reference}/distribution/{distributionReference}

Headers

NameNotes
AuthorizationBearer token
X-TenantYour tenant
X-Environmenttest or live

Path parameters

Name
reference
distributionReference

Query parameters

NameDefault
reasonOptional

Example

Response: GenericResponseDistributionResponse

curl -X DELETE "https://api.bridgemoni.com/credit-union/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/distribution/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

Responses

StatusWhen
200Distribution cancelled successfully

GET Read one distribution

GET /credit-union/{reference}/distribution/{distributionReference}

Headers

NameNotes
AuthorizationBearer token
X-TenantYour tenant
X-Environmenttest or live

Path parameters

Name
reference
distributionReference

Example

Response: GenericResponseDistributionResponse

curl -X GET "https://api.bridgemoni.com/credit-union/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/distribution/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

Responses

StatusWhen
200Distribution retrieved successfully

GET Read the per-member allocations of a distribution

GET /credit-union/{reference}/distribution/{distributionReference}/allocations

Headers

NameNotes
AuthorizationBearer token
X-TenantYour tenant
X-Environmenttest or live

Path parameters

Name
reference
distributionReference

Example

Response: GenericResponseListDistributionAllocationResponse

curl -X GET "https://api.bridgemoni.com/credit-union/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/distribution/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/allocations" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

Responses

StatusWhen
200Allocations retrieved successfully

POST Approve a distribution

POST /credit-union/{reference}/distribution/{distributionReference}/approval

The member who declared it may not approve it.

Headers

NameNotes
AuthorizationBearer token
X-TenantYour tenant
X-Environmenttest or live
Content-Typeapplication/json

Path parameters

Name
reference
distributionReference

Example

Request body: ApproveDistributionRequest · Response: GenericResponseDistributionResponse

curl -X POST "https://api.bridgemoni.com/credit-union/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/distribution/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/approval" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV" \
  -H "Content-Type: application/json" \
  -d '{
  "note": "string"
}'

Responses

StatusWhen
200Distribution approved successfully

POST Elect where a member's allocation is paid

POST /credit-union/{reference}/distribution/{distributionReference}/destination

The default is capitalisation back to shares, not cash.

Headers

NameNotes
AuthorizationBearer token
X-TenantYour tenant
X-Environmenttest or live
Content-Typeapplication/json

Path parameters

Name
reference
distributionReference

Example

Request body: ElectDestinationRequest · Response: GenericResponseDistributionAllocationResponse

curl -X POST "https://api.bridgemoni.com/credit-union/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/distribution/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/destination" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV" \
  -H "Content-Type: application/json" \
  -d '{
  "positionReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
  "destination": "SHARES"
}'

Responses

StatusWhen
200Destination elected successfully

POST Pay an approved distribution

POST /credit-union/{reference}/distribution/{distributionReference}/payment

A member who cannot be paid leaves the allocation as a liability of the union rather than losing it, and it is never swept into reserve.

Headers

NameNotes
AuthorizationBearer token
X-TenantYour tenant
X-Environmenttest or live

Path parameters

Name
reference
distributionReference

Example

Response: GenericResponseDistributionResponse

curl -X POST "https://api.bridgemoni.com/credit-union/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/distribution/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/payment" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

Responses

StatusWhen
200Distribution paid successfully

GET List this union's distributions

GET /credit-union/{reference}/distributions

Headers

NameNotes
AuthorizationBearer token
X-TenantYour tenant
X-Environmenttest or live

Path parameters

Name
reference

Example

Response: GenericResponseListDistributionResponse

curl -X GET "https://api.bridgemoni.com/credit-union/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/distributions" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

Responses

StatusWhen
200Distributions retrieved successfully

GET Read the unclaimed distribution register

GET /credit-union/{reference}/report/unclaimed-distributions

Headers

NameNotes
AuthorizationBearer token
X-TenantYour tenant
X-Environmenttest or live

Path parameters

Name
reference

Query parameters

NameDefault
asOfOptional

Example

Response: GenericResponseUnclaimedDistributionResponse

curl -X GET "https://api.bridgemoni.com/credit-union/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/report/unclaimed-distributions" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

Responses

StatusWhen
200Unclaimed distributions retrieved successfully

Generated from the OpenAPI document. Branch on the HTTP status: there is no machine-readable error code on the wire. Errors