API reference · Identity & onboarding

Crypto wallet addresses

POST/accountholder/{type}/{value}/wallet/addressRecord a wallet address for an account holder
GET/accountholder/{type}/{value}/wallet/addressesList a wallet address for an account holder
GET/wallet/address/{id}Fetch one record
PUT/wallet/address/{id}Update one record
PUT/wallet/address/{id}/controlProve control of a wallet address

POST Record a wallet address for an account holder

POST /accountholder/{type}/{value}/wallet/address

Headers

Name	Notes
`Authorization`	Bearer token
`X-Tenant`	Your tenant
`X-Environment`	test or live
`Content-Type`	application/json

Path parameters

Name
`type`
`value`

Example

Request body: CryptoWalletAddressRequest · Response: GenericResponseCryptoWalletAddressResponse

curl -X POST "https://api.bridgemoni.com/accountholder/value/value/wallet/address" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV" \
  -H "Content-Type: application/json" \
  -d '{
  "chainCode": "string",
  "walletAddress": "string"
}'

{
  "chainCode": "string",
  "walletAddress": "string"
}

{
  "data": {
    "reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "chainCode": "string",
    "walletAddress": "string",
    "proofMethod": "OAUTH",
    "provedDateTime": "2026-09-25T10:00:00Z",
    "controlsAddress": "true",
    "active": "true"
  },
  "description": "A wallet address recorded successfully"
}

Responses

Status	When
`200`	A wallet address recorded successfully

GET List a wallet address for an account holder

GET /accountholder/{type}/{value}/wallet/addresses

Headers

Name	Notes
`Authorization`	Bearer token
`X-Tenant`	Your tenant
`X-Environment`	test or live

Path parameters

Name
`type`
`value`

Example

Response: GenericResponseListCryptoWalletAddressResponse

curl -X GET "https://api.bridgemoni.com/accountholder/value/value/wallet/addresses" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV"

{
  "data": [
    {
      "reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
      "chainCode": "string",
      "walletAddress": "string",
      "proofMethod": "OAUTH",
      "provedDateTime": "2026-09-25T10:00:00Z",
      "controlsAddress": "true",
      "active": "true"
    }
  ],
  "description": "A wallet address fetched successfully"
}

Responses

Status	When
`200`	A wallet address fetched successfully

GET Fetch one record

GET /wallet/address/{id}

Headers

Name	Notes
`Authorization`	Bearer token
`X-Tenant`	Your tenant
`X-Environment`	test or live

Path parameters

Name
`id`

Example

Response: GenericResponseCryptoWalletAddressResponse

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

{
  "data": {
    "reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "chainCode": "string",
    "walletAddress": "string",
    "proofMethod": "OAUTH",
    "provedDateTime": "2026-09-25T10:00:00Z",
    "controlsAddress": "true",
    "active": "true"
  },
  "description": "A wallet address fetched successfully"
}

Responses

Status	When
`200`	A wallet address fetched successfully

PUT Update one record

PUT /wallet/address/{id}

Headers

Name	Notes
`Authorization`	Bearer token
`X-Tenant`	Your tenant
`X-Environment`	test or live
`Content-Type`	application/json

Path parameters

Name
`id`

Example

Request body: UpdateCryptoWalletAddressRequest · Response: GenericResponseCryptoWalletAddressResponse

curl -X PUT "https://api.bridgemoni.com/wallet/address/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV" \
  -H "Content-Type: application/json" \
  -d '{
  "chainCode": "string",
  "walletAddress": "string",
  "active": "true"
}'

{
  "chainCode": "string",
  "walletAddress": "string",
  "active": "true"
}

{
  "data": {
    "reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "chainCode": "string",
    "walletAddress": "string",
    "proofMethod": "OAUTH",
    "provedDateTime": "2026-09-25T10:00:00Z",
    "controlsAddress": "true",
    "active": "true"
  },
  "description": "A wallet address updated successfully"
}

Responses

Status	When
`200`	A wallet address updated successfully

PUT Prove control of a wallet address

PUT /wallet/address/{id}/control

A recorded address is a claim. A proved one is a fact, and the two are distinguishable on the response by controlsAddress rather than by the caller having to know.

Headers

Name	Notes
`Authorization`	Bearer token
`X-Tenant`	Your tenant
`X-Environment`	test or live
`Content-Type`	application/json

Path parameters

Name
`id`

Example

Request body: WalletControlProofRequest · Response: GenericResponseCryptoWalletAddressResponse

curl -X PUT "https://api.bridgemoni.com/wallet/address/b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e/control" \
  -H "Authorization: Bearer $BRIDGEMONI_TOKEN" \
  -H "X-Tenant: $BRIDGEMONI_TENANT" \
  -H "X-Environment: $BRIDGEMONI_ENV" \
  -H "Content-Type: application/json" \
  -d '{
  "proofMethod": "OAUTH",
  "proofReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e"
}'

{
  "proofMethod": "OAUTH",
  "proofReference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e"
}

{
  "data": {
    "reference": "b3f1c2d4-5e6a-4b7c-8d9e-0f1a2b3c4d5e",
    "chainCode": "string",
    "walletAddress": "string",
    "proofMethod": "OAUTH",
    "provedDateTime": "2026-09-25T10:00:00Z",
    "controlsAddress": "true",
    "active": "true"
  },
  "description": "Wallet control proved successfully"
}

Responses

Status	When
`200`	Wallet control proved successfully

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