{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://artifacts.apis.io/blindpay-com/json-schema/blindpay-com-create-customer-in-schema.json", "title": "CreateCustomerIn", "x-generated": "2026-10-30", "x-method": "derived", "x-generator": "derive-json-schema.py", "x-source": "openapi/blindpay-com-openapi.json#/components/schemas/CreateCustomerIn", "type": "object", "properties": { "type": { "type": "string", "enum": [ "individual", "business" ] }, "kyc_type": { "type": "string", "enum": [ "light", "standard", "enhanced" ], "description": "Use standard for individuals and businesses, or enhanced for individuals. light is not available for new customers, and businesses only support standard." }, "email": { "type": "string", "format": "email" }, "tax_id": { "type": [ "string", "null" ] }, "address_line_1": { "type": [ "string", "null" ] }, "address_line_2": { "type": [ "string", "null" ] }, "city": { "type": [ "string", "null" ] }, "state_province_region": { "type": [ "string", "null" ] }, "country": { "type": "string", "enum": [ "AF", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BQ", "BA", "BW", "BV", "BR", "IO", "BN", "BG", "BF", "BI", "CV", "KH", "CM", "CA", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CD", "CG", "CK", "CR", "HR", "CU", "CW", "CY", "CZ", "CI", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "SZ", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "VA", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KP", "KR", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "MK", "RO", "RU", "RW", "RE", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "SS", "ES", "LK", "SD", "SR", "SJ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UG", "UA", "AE", "GB", "UM", "US", "UY", "UZ", "VU", "VE", "VN", "VG", "VI", "WF", "EH", "YE", "ZM", "ZW", "AX" ] }, "postal_code": { "type": [ "string", "null" ] }, "ip_address": { "type": [ "string", "null" ], "format": "ip" }, "latitude": { "type": [ "number", "null" ], "minimum": -90, "maximum": 90, "description": "Optional geolocation latitude collected from the customer. Forwarded to AiPrise and SEON for fraud analysis." }, "longitude": { "type": [ "number", "null" ], "minimum": -180, "maximum": 180, "description": "Optional geolocation longitude collected from the customer. Forwarded to AiPrise and SEON for fraud analysis." }, "image_url": { "type": [ "string", "null" ], "format": "uri" }, "phone_number": { "type": [ "string", "null" ] }, "proof_of_address_doc_type": { "type": [ "string", "null" ], "enum": [ "UTILITY_BILL", "BANK_STATEMENT", "RENTAL_AGREEMENT", "TAX_DOCUMENT", "GOVERNMENT_CORRESPONDENCE" ] }, "proof_of_address_doc_file": { "type": [ "string", "null" ], "format": "uri", "description": "Please upload one document that serve as proof of address, this needs to be the same physical address as the one provided above. Only PDF and image files are accepted (.jpg, .jpeg, .png, .pdf) with a maximum size of 3MB." }, "first_name": { "type": [ "string", "null" ] }, "last_name": { "type": [ "string", "null" ] }, "date_of_birth": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string" }, { "type": "null" } ] }, "id_doc_country": { "type": [ "string", "null" ], "enum": [ "AF", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BQ", "BA", "BW", "BV", "BR", "IO", "BN", "BG", "BF", "BI", "CV", "KH", "CM", "CA", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CD", "CG", "CK", "CR", "HR", "CU", "CW", "CY", "CZ", "CI", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "SZ", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "VA", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KP", "KR", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "MK", "RO", "RU", "RW", "RE", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "SS", "ES", "LK", "SD", "SR", "SJ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UG", "UA", "AE", "GB", "UM", "US", "UY", "UZ", "VU", "VE", "VN", "VG", "VI", "WF", "EH", "YE", "ZM", "ZW", "AX" ] }, "id_doc_type": { "type": [ "string", "null" ], "enum": [ "PASSPORT", "ID_CARD", "DRIVERS" ] }, "id_doc_front_file": { "type": [ "string", "null" ], "format": "uri", "description": "Only image files are accepted (.jpg, .jpeg, .png)" }, "id_doc_back_file": { "type": [ "string", "null" ], "format": "uri", "description": "Only image files are accepted (.jpg, .jpeg, .png)" }, "legal_name": { "type": [ "string", "null" ] }, "alternate_name": { "type": [ "string", "null" ] }, "formation_date": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string" }, { "type": "null" } ], "format": "date-time" }, "website": { "type": [ "string", "null" ], "format": "uri" }, "owners": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "role": { "type": "string", "enum": [ "beneficial_controlling", "beneficial_owner", "controlling_person" ], "description": "A beneficial owner is someone who directly or indirectly owns 25% or more of your business. A controlling person is someone with significant responsibility to control, manage or direct your business (typically a CEO, senior executive officer or equivalent)." }, "first_name": { "type": "string", "minLength": 1 }, "last_name": { "type": "string", "minLength": 1 }, "date_of_birth": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string" } ] }, "tax_id": { "type": "string" }, "address_line_1": { "type": "string" }, "address_line_2": { "type": [ "string", "null" ] }, "city": { "type": "string" }, "state_province_region": { "type": "string" }, "country": { "type": "string", "enum": [ "AF", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BQ", "BA", "BW", "BV", "BR", "IO", "BN", "BG", "BF", "BI", "CV", "KH", "CM", "CA", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CD", "CG", "CK", "CR", "HR", "CU", "CW", "CY", "CZ", "CI", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "SZ", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "VA", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KP", "KR", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "MK", "RO", "RU", "RW", "RE", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "SS", "ES", "LK", "SD", "SR", "SJ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UG", "UA", "AE", "GB", "UM", "US", "UY", "UZ", "VU", "VE", "VN", "VG", "VI", "WF", "EH", "YE", "ZM", "ZW", "AX" ] }, "postal_code": { "type": "string" }, "id_doc_country": { "type": "string", "enum": [ "AF", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BQ", "BA", "BW", "BV", "BR", "IO", "BN", "BG", "BF", "BI", "CV", "KH", "CM", "CA", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CD", "CG", "CK", "CR", "HR", "CU", "CW", "CY", "CZ", "CI", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "SZ", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "VA", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KP", "KR", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "MK", "RO", "RU", "RW", "RE", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "SS", "ES", "LK", "SD", "SR", "SJ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UG", "UA", "AE", "GB", "UM", "US", "UY", "UZ", "VU", "VE", "VN", "VG", "VI", "WF", "EH", "YE", "ZM", "ZW", "AX" ] }, "id_doc_type": { "type": "string", "enum": [ "PASSPORT", "ID_CARD", "DRIVERS" ] }, "id_doc_front_file": { "type": "string", "format": "uri" }, "id_doc_back_file": { "type": [ "string", "null" ], "format": "uri", "description": "Only image files are accepted (.jpg, .jpeg, .png)" }, "proof_of_address_doc_type": { "type": [ "string", "null" ], "enum": [ "UTILITY_BILL", "BANK_STATEMENT", "RENTAL_AGREEMENT", "TAX_DOCUMENT", "GOVERNMENT_CORRESPONDENCE" ] }, "proof_of_address_doc_file": { "type": [ "string", "null" ], "format": "uri", "description": "Please upload one document that serve as proof of address, this needs to be the same address as the one provided above. Only PDF and image files are accepted (.jpg, .jpeg, .png, .pdf) with a maximum size of 3MB." }, "ownership_percentage": { "type": [ "integer", "null" ], "minimum": 0, "maximum": 100, "description": "Ownership percentage of the beneficial owner (0-100)" }, "title": { "type": [ "string", "null" ], "maxLength": 128, "description": "Job title of the owner" }, "tax_type": { "type": [ "string", "null" ], "enum": [ "SSN", "ITIN" ], "description": "Tax identifier type. Mandatory when country is US; must be SSN or ITIN." } }, "required": [ "role", "first_name", "last_name", "date_of_birth", "tax_id", "address_line_1", "city", "state_province_region", "country", "postal_code", "id_doc_country", "id_doc_type", "id_doc_front_file" ] } }, "incorporation_doc_file": { "type": [ "string", "null" ], "format": "uri", "description": "Please upload your articles of incorporation below. The articles of incorporation or a certificate of incorporation usually includes information like the company name, business purpose, number of shares offered, value of shares, etc. Only PDF and image files are accepted (.jpg, .jpeg, .png, .pdf) with a maximum size of 3MB." }, "proof_of_ownership_doc_file": { "type": [ "string", "null" ], "format": "uri", "description": "Please upload your proof of ownership below. This document usually includes information like the shareholders names and percentages. Only PDF and image files are accepted (.jpg, .jpeg, .png, .pdf) with a maximum size of 3MB." }, "source_of_funds_doc_type": { "type": [ "string", "null" ], "enum": [ "business_income", "gambling_proceeds", "gifts", "government_benefits", "inheritance", "investment_loans", "pension_retirement", "salary", "sale_of_assets_real_estate", "savings", "esops", "investment_proceeds", "someone_else_funds" ] }, "source_of_funds_doc_file": { "type": [ "string", "null" ], "format": "uri" }, "selfie_file": { "type": [ "string", "null" ], "format": "uri", "description": "Only image files are accepted (.jpg, .jpeg, .png)" }, "purpose_of_transactions": { "type": [ "string", "null" ], "enum": [ "business_transactions", "charitable_donations", "investment_purposes", "payments_to_friends_or_family_abroad", "personal_or_living_expenses", "protect_wealth", "purchase_good_and_services", "receive_payment_for_freelancing", "receive_salary", "other" ] }, "purpose_of_transactions_explanation": { "type": [ "string", "null" ] }, "account_purpose": { "type": [ "string", "null" ], "enum": [ "charitable_donations", "ecommerce_retail_payments", "investment_purposes", "business_expenses", "payments_to_friends_or_family_abroad", "personal_or_living_expenses", "protect_wealth", "purchase_goods_and_services", "receive_payments_for_goods_and_services", "tax_optimization", "third_party_money_transmission", "payroll", "treasury_management", "other" ] }, "account_purpose_other": { "type": [ "string", "null" ], "maxLength": 512, "description": "Required when account_purpose is \"other\". Max 512 characters." }, "business_type": { "type": [ "string", "null" ], "enum": [ "corporation", "llc", "partnership", "sole_proprietorship", "trust", "non_profit" ] }, "business_description": { "type": [ "string", "null" ], "maxLength": 1000 }, "business_industry": { "type": [ "string", "null" ], "enum": [ "111998", "112120", "113310", "115114", "111120", "111219", "111336", "111421", "112111", "112210", "112310", "112410", "112519", "112990", "113110", "113210", "114119", "114210", "115113", "115210", "115310", "541211", "541213", "541219", "541810", "541430", "541715", "541930", "561422", "561311", "561612", "561740", "561730", "532490", "533110", "541490", "541690", "541720", "561110", "561210", "561611", "561990", "722310", "236115", "236220", "237310", "238210", "236118", "236210", "237130", "237210", "237990", "238191", "238391", "238991", "541310", "811111", "812111", "812112", "532111", "624410", "541922", "811210", "812199", "532289", "532310", "561790", "811198", "811310", "811411", "812210", "812320", "812990", "814110", "611110", "611310", "611410", "611710", "611210", "611420", "611519", "611699", "211120", "212114", "221310", "562111", "562920", "213112", "211130", "212290", "212390", "213113", "221122", "221210", "221320", "324110", "562211", "562998", "522110", "522210", "522320", "523150", "523940", "523999", "524113", "521110", "522130", "522298", "522390", "523210", "524128", "524298", "525190", "525910", "813110", "813211", "813219", "624190", "624230", "624310", "813319", "813410", "813930", "921140", "922190", "923130", "924110", "925120", "926110", "927110", "928110", "551112", "551114", "721110", "722511", "722513", "561510", "713110", "713210", "712110", "711110", "711211", "487110", "487210", "487990", "561599", "711190", "711219", "711310", "712120", "713290", "713990", "721199", "721211", "721310", "722410", "621111", "621210", "622110", "623110", "621511", "623220", "541940", "621399", "621910", "621498", "621610", "621999", "622210", "622310", "623210", "623311", "623990", "541110", "541199", "311421", "337121", "322220", "339920", "334210", "339930", "312130", "334111", "334118", "325412", "339112", "336110", "336390", "315990", "313110", "339910", "311119", "311212", "311314", "311422", "311511", "311612", "311710", "311811", "311999", "312111", "312230", "313240", "313310", "314120", "314999", "315120", "315250", "316110", "316210", "316990", "321113", "321211", "321918", "322120", "322299", "323120", "325180", "325220", "325320", "325510", "325611", "325998", "326111", "326220", "327120", "327212", "327310", "327410", "327999", "331110", "331210", "331313", "331410", "331511", "332111", "332215", "332311", "332410", "332510", "332613", "332710", "332812", "332999", "333111", "333248", "333310", "333413", "333517", "333611", "333618", "334310", "334413", "334511", "334610", "335131", "335220", "335311", "335999", "336211", "336412", "336510", "336611", "336999", "337122", "337214", "337920", "339999", "516120", "513130", "512250", "519130", "519290", "711410", "711510", "512199", "512290", "515210", "531110", "531120", "531130", "531190", "531210", "531311", "531312", "531320", "531390", "454110", "445110", "455110", "457110", "449210", "444110", "459210", "459120", "445320", "458110", "458210", "458310", "455219", "424210", "456110", "446120", "456120", "441110", "441227", "441330", "444180", "444240", "445132", "445298", "449110", "449129", "454390", "458320", "459310", "459410", "459510", "459999", "541511", "541512", "541519", "518210", "511210", "513210", "517111", "517112", "517410", "517810", "481111", "483111", "485210", "488510", "484121", "493110", "423430", "423690", "423110", "423830", "423840", "423510", "424690", "424990", "424410", "424480", "423940", "423120", "423220", "423310", "423490", "423520", "423620", "423710", "423990", "424110", "424310", "424490", "424590", "424720", "424820", "425120", "481211", "482111", "483112", "483212", "484110", "484220", "485119", "485310", "485410", "485510", "485999", "486110", "486210", "486990", "488190", "488210", "488390", "488490", "488999", "492110", "492210", "493190", "541611", "541618", "541330", "541990", "541214", "561499" ] }, "estimated_annual_revenue": { "type": [ "string", "null" ], "enum": [ "0_99999", "100000_999999", "1000000_9999999", "10000000_49999999", "50000000_249999999", "250000000_plus" ] }, "source_of_wealth": { "type": [ "string", "null" ], "enum": [ "business_dividends_or_profits", "investments", "asset_sales", "client_investor_contributions", "gambling", "charitable_contributions", "inheritance", "affiliate_or_royalty_income", "salary_or_wages", "savings" ] }, "publicly_traded": { "type": [ "boolean", "null" ] }, "occupation": { "type": [ "string", "null" ], "maxLength": 255 }, "external_id": { "type": [ "string", "null" ] }, "tos_id": { "type": [ "string", "null" ], "minLength": 15, "maxLength": 15 }, "additional_info": { "type": [ "array", "null" ], "items": { "$ref": "#/$defs/AdditionalInfoItem" }, "description": "Optional extra documents or notes for this customer. `label` is a known category, `value` is either a URL to upload or a free-text description. Any URLs are downloaded and re-hosted on Blindpay storage before being stored." } }, "required": [ "type", "kyc_type", "email", "country" ], "$defs": { "AdditionalInfoItem": { "type": "object", "properties": { "label": { "type": "string", "enum": [ "EIN_LETTER", "KYC_PROVIDER_DOCUMENT", "FLOW_OF_FUNDS", "BANK_STATEMENT", "TAX_RETURN", "AUDITED_FINANCIALS", "OPERATING_AGREEMENT", "BOARD_RESOLUTION", "CERTIFICATE_OF_GOOD_STANDING", "BUSINESS_LICENSE", "MSB_LICENSE", "POWER_OF_ATTORNEY", "TRUST_DEED", "SHAREHOLDER_REGISTRY", "BENEFICIAL_OWNER_DECLARATION", "COMPLIANCE_QUESTIONNAIRE", "PROOF_OF_EMPLOYMENT", "REFERENCE_LETTER", "OTHER" ] }, "value": { "type": "string", "minLength": 1 } }, "required": [ "label", "value" ] } } }