Currencycloud · Schema
create_person_request
CompanyFintechPaymentsForeign ExchangeCross-Border PaymentsMoney TransferCurrency ConversionBanking
Properties
| Name | Type | Description |
|---|---|---|
| roles | array | Ther person's role(s). |
| document_ids | arraynull | List of IDs for any uploaded supporting documents. |
| first_name | string | First name |
| middle_name | stringnull | Middle name |
| last_name | string | Surname |
| dob | stringnull | Date of Birth |
| phone_number | stringnull | Phone number |
| stringnull | Email address | |
| ownership_percentage | numbernull | Percentage of company owned. |
| id_number | stringnull | Social security number if home_country=US. |
| home_country | string | Country of permanent address. |
| passport_number | stringnull | Passport number |
| passport_country_of_issue | stringnull | Country code for where the passport was issued. |
| personal_address_attributes | object |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/currencycloud/main/json-schema/currencycloud-create-person-request-schema.json",
"title": "create_person_request",
"x-generated": "2026-10-12",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/currencycloud-people-api-openapi.yml#/components/schemas/create_person_request",
"type": "object",
"properties": {
"roles": {
"type": "array",
"description": "Ther person's role(s).",
"items": {
"type": "string",
"enum": [
"director",
"ultimate_business_owner",
"user"
]
}
},
"document_ids": {
"type": [
"array",
"null"
],
"description": "List of IDs for any uploaded supporting documents.",
"items": {
"type": "string"
}
},
"first_name": {
"description": "First name",
"type": "string"
},
"middle_name": {
"description": "Middle name",
"type": [
"string",
"null"
]
},
"last_name": {
"description": "Surname",
"type": "string"
},
"dob": {
"description": "Date of Birth",
"type": [
"string",
"null"
],
"format": "date"
},
"phone_number": {
"description": "Phone number",
"type": [
"string",
"null"
]
},
"email": {
"description": "Email address",
"type": [
"string",
"null"
]
},
"ownership_percentage": {
"description": "Percentage of company owned.",
"type": [
"number",
"null"
],
"minimum": 0,
"maximum": 100
},
"id_number": {
"description": "Social security number if home_country=US.",
"type": [
"string",
"null"
]
},
"home_country": {
"description": "Country of permanent address.",
"type": "string"
},
"passport_number": {
"type": [
"string",
"null"
],
"description": "Passport number"
},
"passport_country_of_issue": {
"type": [
"string",
"null"
],
"description": "Country code for where the passport was issued."
},
"personal_address_attributes": {
"type": "object",
"properties": {
"city": {
"description": "City",
"type": "string"
},
"street": {
"description": "Street",
"type": "string"
},
"country": {
"description": "Country code",
"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"
]
},
"postal_code": {
"type": "string",
"description": "Post Code"
},
"apartment_number": {
"description": "Apartment number",
"type": [
"string",
"null"
]
},
"building_name": {
"description": "Building name",
"type": [
"string",
"null"
]
},
"building_number": {
"description": "Building number",
"type": [
"string",
"null"
]
},
"state_or_province": {
"description": "State or province",
"type": [
"string",
"null"
]
}
},
"required": [
"city",
"street",
"country",
"postal_code"
]
}
},
"required": [
"roles",
"first_name",
"last_name",
"home_country"
]
}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.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/currencycloud-create-person-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.