Currencycloud · Schema

create_business_information_request

CompanyFintechPaymentsForeign ExchangeCross-Border PaymentsMoney TransferCurrency ConversionBanking

Properties

Name Type Description
document_ids arraynull List of IDs for any uploaded supporting documents.
business_country string ISO country code for the country the business is registered in.
company_name string The company name.
trading_name stringnull The company's trading name.
legal_entity_type string Company's legal entity type.
sector string The primary sector the company operates in.
company_registration_number stringnull An official number that identifies the company.
vat_number stringnull The company's VAT number or Tax ID number.
incorporation_date string The date the company was incorporated.
business_website stringnull The company's website URL or other online presence.
business_activity_description stringnull Description of the company's activities.
registered_address_attributes object
trading_address_attributes objectnull
View JSON Schema on GitHub

JSON Schema

currencycloud-create-business-information-request-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/currencycloud/main/json-schema/currencycloud-create-business-information-request-schema.json",
  "title": "create_business_information_request",
  "x-generated": "2026-10-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/currencycloud-business-information-api-openapi.yml#/components/schemas/create_business_information_request",
  "type": "object",
  "properties": {
    "document_ids": {
      "description": "List of IDs for any uploaded supporting documents.",
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "string"
      }
    },
    "business_country": {
      "description": "ISO country code for the country the business is registered in.",
      "type": "string",
      "enum": [
        "AD",
        "AN",
        "AE",
        "AF",
        "AG",
        "AI",
        "AL",
        "AM",
        "AO",
        "AQ",
        "AR",
        "AS",
        "AT",
        "AU",
        "AW",
        "AX",
        "AZ",
        "BA",
        "BB",
        "BD",
        "BE",
        "BF",
        "BG",
        "BH",
        "BI",
        "BJ",
        "BL",
        "BM",
        "BN",
        "BO",
        "BQ",
        "BR",
        "BS",
        "BT",
        "BV",
        "BW",
        "BY",
        "BZ",
        "CA",
        "CC",
        "CD",
        "CF",
        "CG",
        "CH",
        "CI",
        "CK",
        "CL",
        "CM",
        "CN",
        "CO",
        "CR",
        "CV",
        "CW",
        "CX",
        "CY",
        "CZ",
        "DE",
        "DJ",
        "DK",
        "DM",
        "DO",
        "DZ",
        "EC",
        "EE",
        "EG",
        "EH",
        "ER",
        "ES",
        "ET",
        "FI",
        "FJ",
        "FK",
        "FM",
        "FO",
        "FR",
        "GA",
        "GB",
        "GD",
        "GE",
        "GF",
        "GG",
        "GH",
        "GI",
        "GL",
        "GM",
        "GN",
        "GP",
        "GQ",
        "GR",
        "GS",
        "GT",
        "GU",
        "GW",
        "GY",
        "HK",
        "HM",
        "HN",
        "HR",
        "HT",
        "HU",
        "ID",
        "IE",
        "IL",
        "IM",
        "IN",
        "IO",
        "IQ",
        "IS",
        "IT",
        "JE",
        "JM",
        "JO",
        "JP",
        "KE",
        "KG",
        "KH",
        "KI",
        "KM",
        "KN",
        "KR",
        "KW",
        "KY",
        "KZ",
        "LA",
        "LB",
        "LC",
        "LI",
        "LK",
        "LR",
        "LS",
        "LT",
        "LU",
        "LV",
        "MA",
        "MC",
        "MD",
        "ME",
        "MF",
        "MG",
        "MH",
        "MK",
        "ML",
        "MM",
        "MN",
        "MO",
        "MP",
        "MQ",
        "MR",
        "MS",
        "MT",
        "MU",
        "MV",
        "MW",
        "MX",
        "MY",
        "MZ",
        "NA",
        "NC",
        "NE",
        "NF",
        "NG",
        "NI",
        "NL",
        "NO",
        "NP",
        "NR",
        "NU",
        "NZ",
        "OM",
        "PA",
        "PE",
        "PF",
        "PG",
        "PH",
        "PK",
        "PL",
        "PM",
        "PN",
        "PR",
        "PS",
        "PT",
        "PW",
        "PY",
        "QA",
        "RE",
        "RO",
        "RS",
        "RU",
        "RW",
        "SA",
        "SB",
        "SC",
        "SE",
        "SG",
        "SH",
        "SI",
        "SJ",
        "SK",
        "SL",
        "SM",
        "SN",
        "SO",
        "SR",
        "ST",
        "SV",
        "SX",
        "SZ",
        "TC",
        "TD",
        "TF",
        "TG",
        "TH",
        "TJ",
        "TK",
        "TL",
        "TM",
        "TN",
        "TO",
        "TR",
        "TT",
        "TV",
        "TW",
        "TZ",
        "UA",
        "UG",
        "UM",
        "US",
        "UY",
        "UZ",
        "VA",
        "VC",
        "VE",
        "VG",
        "VI",
        "VN",
        "VU",
        "WF",
        "WS",
        "XK",
        "YE",
        "YT",
        "ZA",
        "ZM",
        "ZW",
        "AND",
        "ANT",
        "ARE",
        "AFG",
        "ATG",
        "AIA",
        "ALB",
        "ARM",
        "AGO",
        "ATA",
        "ARG",
        "ASM",
        "AUT",
        "AUS",
        "ABW",
        "ALA",
        "AZE",
        "BIH",
        "BRB",
        "BGD",
        "BEL",
        "BFA",
        "BGR",
        "BHR",
        "BDI",
        "BEN",
        "BLM",
        "BMU",
        "BRN",
        "BOL",
        "BES",
        "BRA",
        "BHS",
        "BTN",
        "BVT",
        "BWA",
        "BLR",
        "BLZ",
        "CAN",
        "CCK",
        "COD",
        "CAF",
        "COG",
        "CHE",
        "CIV",
        "COK",
        "CHL",
        "CMR",
        "CHN",
        "COL",
        "CRI",
        "CPV",
        "CUW",
        "CXR",
        "CYP",
        "CZE",
        "DEU",
        "DJI",
        "DNK",
        "DMA",
        "DOM",
        "DZA",
        "ECU",
        "EST",
        "EGY",
        "ESH",
        "ERI",
        "ESP",
        "ETH",
        "FIN",
        "FJI",
        "FLK",
        "FSM",
        "FRO",
        "FRA",
        "GAB",
        "GBR",
        "GRD",
        "GEO",
        "GUF",
        "GGY",
        "GHA",
        "GIB",
        "GRL",
        "GMB",
        "GIN",
        "GLP",
        "GNQ",
        "GRC",
        "SGS",
        "GTM",
        "GUM",
        "GNB",
        "GUY",
        "HKG",
        "HMD",
        "HND",
        "HRV",
        "HTI",
        "HUN",
        "IDN",
        "IRL",
        "ISR",
        "IMN",
        "IND",
        "IOT",
        "IRQ",
        "ISL",
        "ITA",
        "JEY",
        "JAM",
        "JOR",
        "JPN",
        "KEN",
        "KGZ",
        "KHM",
        "KIR",
        "COM",
        "KNA",
        "KOR",
        "KWT",
        "CYM",
        "KAZ",
        "LAO",
        "LBN",
        "LCA",
        "LIE",
        "LKA",
        "LBR",
        "LSO",
        "LTU",
        "LUX",
        "LVA",
        "MAR",
        "MCO",
        "MDA",
        "MNE",
        "MAF",
        "MDG",
        "MHL",
        "MKD",
        "MLI",
        "MMR",
        "MNG",
        "MAC",
        "MNP",
        "MTQ",
        "MRT",
        "MSR",
        "MLT",
        "MUS",
        "MDV",
        "MWI",
        "MEX",
        "MYS",
        "MOZ",
        "NAM",
        "NCL",
        "NER",
        "NFK",
        "NGA",
        "NIC",
        "NLD",
        "NOR",
        "NPL",
        "NRU",
        "NIU",
        "NZL",
        "OMN",
        "PAN",
        "PER",
        "PYF",
        "PNG",
        "PHL",
        "PAK",
        "POL",
        "SPM",
        "PCN",
        "PRI",
        "PSE",
        "PRT",
        "PLW",
        "PRY",
        "QAT",
        "REU",
        "ROU",
        "SRB",
        "RUS",
        "RWA",
        "SAU",
        "SLB",
        "SYC",
        "SWE",
        "SGP",
        "SHN",
        "SVN",
        "SJM",
        "SVK",
        "SLE",
        "SMR",
        "SEN",
        "SOM",
        "SUR",
        "STP",
        "SLV",
        "SXM",
        "SWZ",
        "TCA",
        "TCD",
        "ATF",
        "TGO",
        "THA",
        "TJK",
        "TKL",
        "TLS",
        "TKM",
        "TUN",
        "TON",
        "TUR",
        "TTO",
        "TUV",
        "TWN",
        "TZA",
        "UKR",
        "UGA",
        "UMI",
        "USA",
        "URY",
        "UZB",
        "VAT",
        "VCT",
        "VEN",
        "VGB",
        "VIR",
        "VNM",
        "VUT",
        "WLF",
        "WSM",
        "UNK",
        "YEM",
        "MYT",
        "ZAF",
        "ZMB",
        "ZWE"
      ]
    },
    "company_name": {
      "description": "The company name.",
      "type": "string"
    },
    "trading_name": {
      "description": "The company's trading name.",
      "type": [
        "string",
        "null"
      ]
    },
    "legal_entity_type": {
      "type": "string",
      "description": "Company's legal entity type.",
      "enum": [
        "limited_liability_company",
        "limited_liability_partnership",
        "company_with_nominee_shareholders_or_shares_in_bearer_form",
        "other",
        "public_limited_company",
        "registered_charity",
        "scottish_limited_partnership",
        "sole_trader",
        "trust",
        "unincorporated_partnership",
        "unregistered_charity"
      ]
    },
    "sector": {
      "type": "string",
      "description": "The primary sector the company operates in.",
      "enum": [
        "registered_charity",
        "unregistered_charity",
        "aerospace",
        "weapons_and_military_equipment",
        "advertising_or_public_relations_or_marketing",
        "multi_level_marketing",
        "telecoms",
        "call_centres",
        "schools_and_universities",
        "hospitals_and_care_facilities",
        "adult_entertainment",
        "books_or_magazines_and_newspapers",
        "casinos_or_gambling",
        "forestry_and_forest_products",
        "Gaming",
        "music_production",
        "radio_or_tv_broadcaster",
        "speculative_trading",
        "sporting_or_professional_club",
        "banking",
        "broker_dealer",
        "building_materials_and_equipment",
        "broker",
        "cryptoassets",
        "fund",
        "insurance_or_insure_tech",
        "loan_company",
        "money_services_business",
        "payroll_company_or_pay_tech",
        "private_equity_or_investment_firm_or_venture_capital",
        "trust_company",
        "asset_or_wealth_management_or_wealth_tech",
        "regulated_online_marketplace_or_platform",
        "accountancy",
        "architecture",
        "interior_design",
        "legal",
        "other_consultancy",
        "political_group_or_lobbying",
        "recruitment",
        "hospitality_or_events_or_conferences",
        "tax_advisers",
        "construction",
        "engineering",
        "estate_or_letting_agency",
        "property_development",
        "real_estate_investment",
        "waste_management_or_recycling",
        "adult_products",
        "agricultural",
        "automobile_or_car_parts",
        "bio_sciences_or_beauty_products",
        "chemical_and_related_manufacturing",
        "clothing_or_textiles",
        "electronic_equipment_or_mobile_phones",
        "fitness_equipment",
        "food_and_beverage",
        "furniture_and_flooring",
        "high_value_goods",
        "machinery_and_tools_or_industrial_equipment",
        "pawn_brokers",
        "pharmaceuticals_or_medical_devices",
        "tobacco_or_alcohol",
        "etailor_or_ecommerce",
        "nutritional_or_dietary_supplements",
        "online_marketing_or_branding",
        "historical_or_cultural_artefacts",
        "bars_or_restaurants",
        "courier_or_express_or_parcel",
        "freight_or_logistics",
        "packaging",
        "transportation",
        "taxi_or_private_transport",
        "security",
        "travel_agent_or_travel_website",
        "hotels",
        "computer_software",
        "it_managed_services",
        "data_storage_or_processing",
        "website_or_app_development",
        "computer_or_cyber_security",
        "utilities",
        "logging_timber_and_paper_mills",
        "oil_and_gas",
        "precious_metals",
        "trust_and_company_formation_providers",
        "hedge_fund_or_family_office",
        "mining_or_extractive_industries"
      ]
    },
    "company_registration_number": {
      "type": [
        "string",
        "null"
      ],
      "description": "An official number that identifies the company."
    },
    "vat_number": {
      "description": "The company's VAT number or Tax ID  number.",
      "type": [
        "string",
        "null"
      ]
    },
    "incorporation_date": {
      "description": "The date the company was incorporated.",
      "type": "string",
      "format": "date"
    },
    "business_website": {
      "description": "The company's website URL or other online presence.",
      "type": [
        "string",
        "null"
      ]
    },
    "business_activity_description": {
      "description": "Description of the company's activities.",
      "type": [
        "string",
        "null"
      ]
    },
    "registered_address_attributes": {
      "type": "object",
      "properties": {
        "city": {
          "type": "string"
        },
        "street": {
          "type": "string"
        },
        "country": {
          "type": "string"
        },
        "postal_code": {
          "type": "string"
        },
        "apartment_number": {
          "type": [
            "string",
            "null"
          ]
        },
        "building_name": {
          "type": [
            "string",
            "null"
          ]
        },
        "building_number": {
          "type": [
            "string",
            "null"
          ]
        },
        "state_or_province": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "city",
        "street",
        "country",
        "postal_code"
      ]
    },
    "trading_address_attributes": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "city": {
          "type": "string"
        },
        "street": {
          "type": "string"
        },
        "country": {
          "type": "string"
        },
        "postal_code": {
          "type": "string"
        },
        "apartment_number": {
          "type": [
            "string",
            "null"
          ]
        },
        "building_name": {
          "type": [
            "string",
            "null"
          ]
        },
        "building_number": {
          "type": [
            "string",
            "null"
          ]
        },
        "state_or_province": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "city",
        "street",
        "country",
        "postal_code"
      ]
    }
  },
  "required": [
    "business_country",
    "company_name",
    "legal_entity_type",
    "sector",
    "incorporation_date",
    "registered_address_attributes"
  ]
}

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-create-business-information-request"
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.

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