Currencycloud · Schema

Beneficiary

Beneficiary

CompanyFintechPaymentsForeign ExchangeCross-Border PaymentsMoney TransferCurrency ConversionBanking

Properties

Name Type Description
id string Beneficiary UUID
bank_account_holder_name string Bank account holder's name.
name string Beneficiary's name
email string Beneficiary's email address
payment_types array
beneficiary_address array
beneficiary_country string Two-letter ISO country code.
beneficiary_entity_type string Beneficiary legal entity type - company or individual.
beneficiary_company_name string For companies
beneficiary_first_name string For individuals
beneficiary_last_name string For individuals
beneficiary_city string City
beneficiary_postcode string Postal code
beneficiary_state_or_province string State or province.
beneficiary_date_of_birth string For companies, this is the foundation date of the company. For individuals, it is their date of birth.
beneficiary_identification_type string A legal document that verifies the identity of the beneficiary.
beneficiary_identification_value string A unique reference code for the identification document, such as a passport number.
bank_country string Two-letter ISO code for the country in which the beneficiary's bank account is held.
bank_name string Bank name
bank_account_type string Bank account type.
currency string Currency in which money is held in the beneficiary's bank account. Three-digit currency code.
account_number string Bank account number.
routing_code_type_1 string Local payment routing system.
routing_code_value_1 string Value for "routing_code_type_1".
routing_code_type_2 string Local payment routing system.
routing_code_value_2 string Value for "routing_code_type_2".
bic_swift string BIC/Swift code
iban string IBAN code
default_beneficiary string Payments are made automatically to default beneficiaries when a beneficiary is not specified.
creator_contact_id string Contact UUID of beneficiary creator.
bank_address array
created_at string Date the beneficiary record was created.
updated_at string Date the beneficiary record was last updated.
beneficiary_external_reference string Beneficiary external reference.
business_nature string Beneficiary nature of business.
company_website string Beneficiary company website.
View JSON Schema on GitHub

JSON Schema

currencycloud-beneficiary-schema.json Raw ↑ 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/currencycloud/main/json-schema/currencycloud-beneficiary-schema.json",
  "title": "Beneficiary",
  "description": "Beneficiary",
  "x-generated": "2026-10-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/currencycloud-beneficiaries-api-openapi.yml#/components/schemas/Beneficiary",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Beneficiary UUID"
    },
    "bank_account_holder_name": {
      "type": "string",
      "description": "Bank account holder's name."
    },
    "name": {
      "type": "string",
      "description": "Beneficiary's name"
    },
    "email": {
      "type": "string",
      "description": "Beneficiary's email address"
    },
    "payment_types": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "The payment type - regular (local) or priority (Swift).",
        "enum": [
          "priority",
          "regular"
        ]
      }
    },
    "beneficiary_address": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Line of address."
      }
    },
    "beneficiary_country": {
      "type": "string",
      "description": "Two-letter ISO country code."
    },
    "beneficiary_entity_type": {
      "type": "string",
      "description": "Beneficiary legal entity type - company or individual.",
      "enum": [
        "company",
        "individual"
      ]
    },
    "beneficiary_company_name": {
      "type": "string",
      "description": "For companies"
    },
    "beneficiary_first_name": {
      "type": "string",
      "description": "For individuals"
    },
    "beneficiary_last_name": {
      "type": "string",
      "description": "For individuals"
    },
    "beneficiary_city": {
      "type": "string",
      "description": "City"
    },
    "beneficiary_postcode": {
      "type": "string",
      "description": "Postal code"
    },
    "beneficiary_state_or_province": {
      "type": "string",
      "description": "State or province."
    },
    "beneficiary_date_of_birth": {
      "type": "string",
      "description": "For companies, this is the foundation date of the company. For individuals, it is their date of birth."
    },
    "beneficiary_identification_type": {
      "type": "string",
      "description": "A legal document that verifies the identity of the beneficiary."
    },
    "beneficiary_identification_value": {
      "type": "string",
      "description": "A unique reference code for the identification document, such as a passport number."
    },
    "bank_country": {
      "type": "string",
      "description": "Two-letter ISO code for the country in which the beneficiary's bank account is held."
    },
    "bank_name": {
      "type": "string",
      "description": "Bank name"
    },
    "bank_account_type": {
      "type": "string",
      "description": "Bank account type.",
      "enum": [
        "checking",
        "savings"
      ]
    },
    "currency": {
      "type": "string",
      "description": "Currency in which money is held in the beneficiary's bank account. Three-digit currency code."
    },
    "account_number": {
      "type": "string",
      "description": "Bank account number."
    },
    "routing_code_type_1": {
      "type": "string",
      "description": "Local payment routing system."
    },
    "routing_code_value_1": {
      "type": "string",
      "description": "Value for \"routing_code_type_1\"."
    },
    "routing_code_type_2": {
      "type": "string",
      "description": "Local payment routing system."
    },
    "routing_code_value_2": {
      "type": "string",
      "description": "Value for \"routing_code_type_2\"."
    },
    "bic_swift": {
      "type": "string",
      "description": "BIC/Swift code"
    },
    "iban": {
      "type": "string",
      "description": "IBAN code"
    },
    "default_beneficiary": {
      "type": "string",
      "description": "Payments are made automatically to default beneficiaries when a beneficiary is not specified.",
      "enum": [
        "true",
        "false"
      ]
    },
    "creator_contact_id": {
      "type": "string",
      "description": "Contact UUID of beneficiary creator."
    },
    "bank_address": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Line of address."
      }
    },
    "created_at": {
      "type": "string",
      "description": "Date the beneficiary record was created.",
      "format": "date-time"
    },
    "updated_at": {
      "type": "string",
      "description": "Date the beneficiary record was last updated.",
      "format": "date-time"
    },
    "beneficiary_external_reference": {
      "type": "string",
      "description": "Beneficiary external reference."
    },
    "business_nature": {
      "type": "string",
      "description": "Beneficiary nature of business."
    },
    "company_website": {
      "type": "string",
      "description": "Beneficiary company website."
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema 
curl "https://apis.io/api/v1/json-schemas/currencycloud-beneficiary"
All schemas 
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.