# Caliza Beneficiary V1 API

**Canonical:** https://apis.io/apis/caliza/caliza-beneficiary-v1-api/  
**Provider:** Caliza — https://apis.io/providers/caliza/  
**Base URL:** https://api.caliza.com/core-api/v1  
**Documentation:** https://docs.caliza.com

Caliza Beneficiary V1 API is one of 11 APIs that [Caliza](https://apis.io/providers/caliza/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Beneficiary V1. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, and 6 JSON Schemas.

Manage beneficiaries (individuals and businesses) and their related resources. Endpoints cover creating, updating, enabling/disabling, deleting beneficiaries, managing wallets, virtual accounts, files, balances and recording terms acceptance. Use these to onboard and maintain pay-in/payout recipients.

## Operations (14)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/beneficiaries` | List all beneficiaries |
| POST | `/v1/beneficiaries` | Register new beneficiary |
| GET | `/v1/beneficiaries/{beneficiaryId}` | Retrieve beneficiary details |
| PUT | `/v1/beneficiaries/{beneficiaryId}` | Update beneficiary information |
| DELETE | `/v1/beneficiaries/{beneficiaryId}` | Remove beneficiary |
| GET | `/v1/beneficiaries/{beneficiaryId}/balances` | Retrieve beneficiary account balance |
| GET | `/v1/beneficiaries/{beneficiaryId}/balances/details` | Retrieve detailed balance breakdown |
| POST | `/v1/beneficiaries/{beneficiaryId}/disable` | Disable beneficiary account |
| POST | `/v1/beneficiaries/{beneficiaryId}/enable` | Enable beneficiary account |
| GET | `/v1/beneficiaries/{beneficiaryId}/multi-currencies-balances/details` | Retrieve multi-currency balance details |
| POST | `/v1/beneficiaries/{beneficiaryId}/terms-and-conditions` | Record terms and conditions acceptance |
| GET | `/v1/beneficiaries/{beneficiaryId}/virtualAccounts` | List beneficiary virtual accounts |
| POST | `/v1/beneficiaries/{beneficiaryId}/virtualAccounts` | Generate new virtual account |
| GET | `/v1/beneficiaries/{beneficiaryId}/wallets` | Get or create cryptocurrency wallet |

## Machine-readable artifacts (12)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/caliza/refs/heads/main/openapi/caliza-beneficiary-v1-api-openapi.yml
- **Documentation** — https://docs.caliza.com
- **APIReference** — https://docs.caliza.com/reference/overview
- **Authentication** — https://docs.caliza.com/docs/authenticate
- **Webhooks** — https://docs.caliza.com/docs/webhooks
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/caliza/refs/heads/main/json-schema/caliza-recipient-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/caliza/refs/heads/main/json-schema/caliza-person-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/caliza/refs/heads/main/json-schema/caliza-simulation-v2-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/caliza/refs/heads/main/json-schema/caliza-transaction-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/caliza/refs/heads/main/json-schema/caliza-simulation-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/caliza/refs/heads/main/json-schema/caliza-travel-rule-proof-response-schema.json
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/caliza/refs/heads/main/apis.yml

## Other Caliza APIs (10)

- [Caliza Integrator Capabilities V1 API](https://apis.io/apis/caliza/caliza-integrator-capabilities-v1-api/)
- [Caliza Integrator V1 API](https://apis.io/apis/caliza/caliza-integrator-v1-api/)
- [Caliza KYC/KYB V1 API](https://apis.io/apis/caliza/caliza-kyc-kyb-v1-api/)
- [Caliza Payment V1 API](https://apis.io/apis/caliza/caliza-payment-v1-api/)
- [Caliza Recipient V1 API](https://apis.io/apis/caliza/caliza-recipient-v1-api/)
- [Caliza Related Person API](https://apis.io/apis/caliza/caliza-related-person-api/)
- [Caliza Terms and Conditions V1 API](https://apis.io/apis/caliza/caliza-terms-and-conditions-v1-api/)
- [Caliza Transaction V1 API](https://apis.io/apis/caliza/caliza-transaction-v1-api/)
- [Caliza Transaction V1 Sandbox API](https://apis.io/apis/caliza/caliza-transaction-v1-sandbox-api/)
- [Caliza Travel Rule V1 API](https://apis.io/apis/caliza/caliza-travel-rule-v1-api/)

## Tags

Beneficiary V1

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/caliza/caliza-beneficiary-v1-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/caliza/.