--- updatedAt: 2026-08-27T13:26:06.000Z agentTools: projectIndex: https://docs.fiatrepublic.com/llms.txt --- # Create Business End User # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "fiat-republic", "version": "1.0" }, "servers": [ { "url": "https://sandbox.fiatrepublic.com/api/v1" } ], "components": { "securitySchemes": { "sec0": { "type": "oauth2", "flows": {} } } }, "security": [ { "sec0": [] } ], "paths": { "/end-users/businesses": { "post": { "summary": "Create Business End User", "description": "", "operationId": "create-business-end-user", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "businessPersons", "ipAddress", "sector" ], "properties": { "business": { "type": "object", "required": [ "companyName", "tradingName", "type", "registrationNumber", "registrationDate" ], "properties": { "companyName": { "type": "string", "description": "Cannot contain any of these special chars: **\\#@=\"~ {}\\\\**" }, "tradingName": { "type": "string" }, "type": { "type": "string", "enum": [ "LIMITED" ] }, "registrationNumber": { "type": "string" }, "registrationDate": { "type": "string", "format": "date" }, "registeredAddress": { "type": "object", "required": [ "line 1", "city", "postal code", "country" ], "properties": { "line 1": { "type": "string", "description": "First line of the company registration address" }, "line 2": { "type": "string", "description": "Second line of the company registration address" }, "city": { "type": "string", "description": "City of the registration address" }, "state": { "type": "string", "description": "Required for entity with address in CA and US" }, "postal code": { "type": "string", "description": "Postal code of the registration address" }, "country": { "type": "string", "description": "Country code of the registration address" } } }, "tradingAddress": { "type": "object", "required": [ "line1", "city", "postalCode", "country" ], "properties": { "line1": { "type": "string", "description": "First line of the company trading address" }, "line2": { "type": "string", "description": "Second line of the company trading address" }, "city": { "type": "string", "description": "City of the trading address" }, "state": { "type": "string", "description": "State or region of the trading address" }, "postalCode": { "type": "string", "description": "Postal code of the trading address" }, "country": { "type": "string", "description": "Two-letter ISO 3166-1 alpha-2 country code e.g. GB for United Kingdom" } } }, "website": { "type": "string" }, "phone": { "type": "string", "description": "Phone number of the Individual including country prefix. e.g. +447788661100" } } }, "businessPersons": { "type": "array", "items": { "properties": { "person": { "type": "object", "required": [ "dob", "email", "firstName", "lastName" ], "properties": { "address": { "type": "object", "description": "Home Address of the Individual. Is required", "required": [ "line1", "city", "postalCode", "country" ], "properties": { "line1": { "type": "string" }, "line2": { "type": "string" }, "city": { "type": "string" }, "state": { "type": "string", "description": "Required for entity with address in CA and US" }, "postalCode": { "type": "string" }, "country": { "type": "string", "description": "Two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code e.g. `GB` for United Kingdom" } } }, "birthCountry": { "type": "string", "description": "Two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code e.g. `GB` for United Kingdom" }, "dob": { "type": "string", "description": "Date of Birth of the Individual in `YYYY-MM-DD` format. e.g. `1975-04-05`", "format": "date" }, "email": { "type": "string", "description": "Email of the Individual." }, "firstName": { "type": "string", "description": "First Name of the Individual." }, "middleName": { "type": "string", "description": "Middle Name(s) of the Individual." }, "lastName": { "type": "string", "description": "Last Name of the Individual." }, "nationality": { "type": "array", "description": "Two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code e.g. `GB` for United Kingdom. One of more nationalities can be provided. Required for USD.", "items": { "type": "string" } }, "phone": { "type": "string", "description": "Phone number of the Individual including country prefix. e.g. `+447788661100` Required for USD" }, "identificationDocument": { "type": "object", "description": "Required for USD", "properties": { "number": { "type": "string" }, "type": { "type": "string", "description": "Type of identity document", "enum": [ "WORK_PERMIT", "PASSPORT", "NATIONAL_ID", "DRIVERS_LICENCE" ] } } } } }, "types": { "type": "array", "description": "Type of the Business Person. Can be CONTACT, DIRECTOR or UBO. Multiple choice field", "default": [], "items": { "type": "string" } }, "ownership": { "type": "string", "description": "Amount of shares hold by the Business Person (in %)" } }, "type": "object" } }, "ipAddress": { "type": "string", "description": "The IP address from where the individual signed up on your platform." }, "linkedCryptoWallets": { "type": "string", "description": "Details of any known crypto wallets linked with the individual being created." }, "tags": { "type": "string", "description": "Tags allowing you to provide additional risk-related information for the business." }, "sector": { "type": "string", "description": "Sector in which business operates", "enum": [ "OTHER_PRODUCTS_SERVICES", "BLOCKCHAIN", "LICENSED_ALCOHOL_SERVICES", "LEGAL_SERVICES", "LICENSED_PHARMACEUTICALS", "LICENSED_TELECOM_SERVICES", "MEDICAL_SERVICES", "PRECIOUS_METALS_DEALERS", "TRAVEL_SERVICES", "TRUST", "SCRAPYARD_DEALERS", "REGULATED_FINANCIAL_SERVICES", "MONEY_TRANSMISSION_SERVICES", "DOWNSTREAM_SERVICES_TO_OTHER_PSP", "DONATIONS_CHARITABLE_ORGANISATIONS", "ADULT_CONTENT", "BAIL_BONDSMAN_BAILIFF_SERVICES", "BINARY_OPTIONS", "CASH_LIKE_PRODUCTS", "CBD_MARIJUANA", "COPYRIGHT_MEDIA_AND_SOFTWARE", "COUNTERFEIT_GOODS", "UNREGULATED_CRYPTO_BUSINESS", "DRUG_RELATED_ACCESSORIES", "ESCORT_PROSTITUTES_AGENCY", "TAROT_HOROSCOPE_READERS", "GAMBLING_CASINOS", "PONZI_SCHEME_UNREGULATED_INVESTMENT", "GOVERNMENTID_DOCUMENT_UNIFORMS", "HUMAN_BODY_PARTS", "ILLEGAL_TELECOMMUNICATION_DEVICES", "ILLEGAL_UNSAFE_PRODUCTS", "NUTRACEUTICALS", "OFFENSIVE_GOODS_RELATED_TO_CRIME", "PAY_DAY_LENDERS", "PYROTECHNIC_HAZARDOUS_MATERIALS", "UNREGULATED_FINANCIAL_SERVICES", "FIREARMS_WEAPONS_MILITARY_SOFTWARE_TECHNOLOGY", "SKINS_LOOT_BOX_TRADING", "TIMESHARE", "ELECTRONIC_DATA_SOLUTION", "HUMAN_CLONING_REPRODUCTION", "OUTBOUND_TELEMARKETING", "CHEMICALS", "WHOLESALE_TO_CASH_BASED_REMITTANCE", "ART_MARKET_PARTICIPANT", "CRYPTO", "TICKET_BROKER", "NON_LICENSED_COUNSELLING", "TOBACCO_ECIGARETTES", "UNLICENSED_LAWYERS_LEGAL_SERVICES", "UNLICENSED_LIQUOR_SALES", "UNLICENSED_PHARMACEUTICALS", "GOVERNMENTAL_LICENSED_WITHOUT_THE_LICENCE", "PYRAMID_SCHEME_MLM" ] }, "riskRating": { "type": "string", "description": "Rating of the risk level assigned to the business", "enum": [ "LOW", "MEDIUM", "HIGH" ] }, "signupAt": { "type": "integer", "description": "A date of registration of End User profile within Member platform", "format": "int32" }, "metadata": { "type": "array", "items": { "type": "string" } }, "annualTurnoverRange": { "type": "string", "description": "Value of annual turnover range of the Business End User (in EUR)", "enum": [ "RANGE_0_TO_50000", "RANGE_50000_TO_250000", "RANGE_250000_TO_1000000", "RANGE_1000000_TO_5000000", "ABOVE_5000000" ] } } } } } }, "responses": { "201": { "description": "201", "content": { "application/json": { "examples": { "Result": { "value": { "id": "eus_eaxp4n74jm827lzzz", "business": { "id": "biz_v8jkx67nd5bg1zzz", "companyName": "Conn LLC", "tradingName": null, "type": "LIMITED", "registrationNumber": "OWvVE1", "registrationDate": "2010-11-21", "registeredAddress": { "line1": "24913 Frami Motorway", "line2": null, "city": "Lake Wilford", "state": "Test", "postalCode": "75454", "country": "US" }, "tradingAddress": { "line1": "588 Stiedemann Branch", "line2": null, "city": "West Sienna", "state": null, "postalCode": "75454", "country": "US" }, "phone": "+48444542323", "website": "https://randomwebsit.com/home" }, "businessPersons": [ { "id": "bps_82rl497g394k1g5ykv", "person": { "firstName": "Marisol", "middleName": null, "lastName": "Heidenreich", "address": { "line1": "78242 Lesch Crossing", "line2": null, "city": "Baileyside", "state": null, "postalCode": "W1A0AX", "country": "GB" }, "email": "Elyssa_Schaefer45@yahoo.com", "phone": "+48444542323", "birthCountry": null, "nationality": [ "GB", "US" ], "dob": "1990-10-19", "identificationDocument": null }, "businessEndUserId": "eus_eaxp4n74jm827l58vm", "types": [ "DIRECTOR", "UBO" ], "ownership": "50.00", "createdAt": 1761832672368, "updatedAt": 1761832672368 }, { "id": "bps_4pmer37xx94k782gkv", "person": { "firstName": "Demetrius", "middleName": null, "lastName": "Gaylord", "address": { "line1": "93672 Stacey Garden", "line2": null, "city": "New Bonitamouth", "state": null, "postalCode": "W1A0AX", "country": "GB" }, "email": "Malachi.Romaguera@gmail.com", "phone": null, "birthCountry": null, "nationality": [ "GB", "US" ], "dob": "1990-10-19", "identificationDocument": null }, "businessEndUserId": "eus_eaxp4n74jm827l58vm", "types": [ "UBO" ], "ownership": "50.00", "createdAt": 1761832672397, "updatedAt": 1761832672397 }, { "id": "bps_legpmn06oxlg0ry2bv", "person": { "firstName": "Vanessa", "middleName": null, "lastName": "Lesch", "address": { "line1": "49888 William Rue", "line2": null, "city": "Ahmedstad", "state": null, "postalCode": "W1A0AX", "country": "GB" }, "email": "Roxanne56@yahoo.com", "phone": null, "birthCountry": "GB", "nationality": [ "GB", "US" ], "dob": "1990-10-19", "identificationDocument": null }, "businessEndUserId": "eus_eaxp4n74jm827l58vm", "types": [ "CONTACT" ], "ownership": null, "createdAt": 1761832672403, "updatedAt": 1761832672403 } ], "ipAddress": "2001:0db8:85a3:0000:0000:8a2e:0370:7334", "linkedCryptoWallets": [ { "coin": "XLM", "walletAddress": "1Ge55S4LurGch9HtHQAyzmkXdK4", "relationship": [ "OWN", "SENDER" ] } ], "tags": [ "PEP" ], "status": "CREATED", "riskRating": "LOW", "annualTurnoverRange": null, "signupAt": null, "sector": "CRYPTO", "createdAt": 1761832672343, "updatedAt": 1761832672343, "metadata": { "productType": "LENDING" } } } }, "schema": { "type": "object", "properties": {} } } } }, "400": { "description": "400", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"errorCode\": \"INVALID_REQUEST_DATA\",\n \"message\": \"Invalid BusinessEndUserRequest.\",\n \"warnings\": [\n {\n \"position\": \"business.companyName\",\n \"issue\": \"Field is required\"\n }\n ]\n}" } }, "schema": { "type": "object", "properties": { "errorCode": { "type": "string", "example": "INVALID_REQUEST_DATA" }, "message": { "type": "string", "example": "Invalid BusinessEndUserRequest." }, "warnings": { "type": "array", "items": { "type": "object", "properties": { "position": { "type": "string", "example": "business.companyName" }, "issue": { "type": "string", "example": "Field is required" } } } } } } } } }, "409": { "description": "409", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"errorCode\": \"INVALID_REQUEST_DATA\",\n \"message\": \"Creating Business End User has failed. End User with the same identity already exists.\"\n}" } }, "schema": { "type": "object", "properties": { "errorCode": { "type": "string", "example": "INVALID_REQUEST_DATA" }, "message": { "type": "string", "example": "Creating Business End User has failed. End User with the same identity already exists." } } } } } } } } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true } ```