SoFi Tech Solutions Risk API 2.0

{"openapi":"3.1.0","info":{"title":"Risk API 2.0","version":"2.0"},"paths":{"/ivs/2.0/verifyCustomer":{"post":{"parameters":[{"name":"authorization","in":"header","schema":{"examples":["Basic eW91cl9hcGlsb2dpbjp5b3VyX2FwaXRyYW5za2V5"],"pattern":"^Basic [A-Za-z0-9+/]+=*$","title":"Authorization","type":"string"},"description":"Basic authentication token (base64-encoded {apilogin}:{apitranskey} credentials provided by SoFi Tech Solutions)"},{"name":"X-Request-Id","in":"header","schema":{"examples":["1234567890"],"pattern":"","title":"X-Request-Id","type":"string"},"description":"Unique identifier for the request"}],"responses":{"200":{"content":{"application/json":{"schema":{"description":"Successful Response","properties":{"ivsProfileId":{"description":"The third-party provider supplies this identifier to reference the account status across other endpoints.","title":"Ivsprofileid","type":"integer"},"customerId":{"description":"ID generated by you or SoFi Tech Solutions for the customer undergoing verification. Use this to correlate this event with the specific entity record in your system.","title":"Customerid","type":"string"},"customerType":{"description":"Specifies the category of customer undergoing verification: `Person` or `Business`.","title":"Customertype","type":"string"},"riskServiceId":{"description":"System-generated identifier that specifies the IVS configuration strategy assigned during IVS setup.","title":"Riskserviceid","type":"string"},"customerStatus":{"description":"Overall status of the customer identity-verification process.","title":"Customerstatus","type":"string"},"customerDecision":{"description":"Final decision for identity verification. The system returns this field only when the verification is complete.","title":"Customerdecision","type":"string"},"customerVerificationResult":{"description":"Derived identity verification result based on the `customer_status` and `customer_decision`.","enum":["Pass","Fail","Refer","In Progress"],"title":"CustomerVerificationResult","type":"string"},"applications":{"description":"List of identity verification applications for each entity.","items":{"properties":{"entityId":{"description":"ID generated by you or SoFi Tech Solutions for the entity undergoing verification. Use this to correlate this event with the specific entity record in your system.","title":"Entityid","type":"string"},"verificationType":{"description":"Specifies the type of identity verification being performed.","title":"Verificationtype","type":"string"},"startDateTime":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Date-time when the system created this identity verification in <a href=\"ref:system-time\" target=\"_blank\">our system time</a> (GMT -0700).","title":"Startdatetime"},"endDateTime":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Date-time when the system ended this identity verification in <a href=\"ref:system-time\" target=\"_blank\">our system time</a> (GMT -0700).","title":"Enddatetime"},"entityStatus":{"description":"Current status of the entity identity verification:\n* `COMPLETE`\n* `REFERRED`\n* `AWAITING_RESPONSE`\n* `IN_PROGRESS`","title":"Entitystatus","type":"string"},"entityDecision":{"description":"Final decision for entity verification. The system returns this field only when the identity verification is complete.","title":"Entitydecision","type":"string"},"rulesetOutcomes":{"description":"A list of outcome objects for every ruleset executed during the identity verification journey.","items":{"properties":{"reference":{"description":"Unique identifier for the specific collection of rules.","title":"Reference","type":"string"},"score":{"description":"The sum of all individual `rule_score` values within this specific set.","title":"Score","type":"integer"},"ruleOutcomes":{"description":"A list of individual rule outcomes.","items":{"properties":{"ruleName":{"description":"Display name of the rule.","title":"Rulename","type":"string"},"outcome":{"description":"Returns `true` if the rule's specific rule condition passed.","title":"Outcome","type":"boolean"},"description":{"description":"Explanation of what this specific rule was checking for and the result.","title":"Description","type":"string"},"score":{"description":"Incremental score applied by this rule to the cumulative ruleset result.","title":"Score","type":"integer"}},"title":"RuleOutcome","type":"object"},"title":"Ruleoutcomes","type":"array"}},"title":"RulesetOutcomes","type":"object"},"title":"Rulesetoutcomes","type":"array"},"documentVerificationId":{"description":"The unique identifier for document verification. The system returns this field when awaiting a response.","title":"Documentverificationid","type":"string"},"links":{"description":"A collection of links associated with the journey for follow-up actions. The system returns this field when awaiting a response.","items":{"type":"string"},"title":"Links","type":"array"}},"title":"Application","type":"object"},"title":"Applications","type":"array"}},"required":["customerId","customerType","riskServiceId"],"title":"VerifyCustomerResponse","type":"object"},"examples":{"response":{"value":"{\n  \"status\": \"Success\",\n  \"statusCode\": 0,\n  \"processingTime\": \"0.125\",\n  \"responseData\": {\n    \"ivsProfileId\": 40038495,\n    \"customerId\": \"155555\",\n    \"customerType\": \"Person\",\n    \"riskServiceId\": \"GCORE:6475:0437:6475\",\n    \"customerStatus\": \"COMPLETE\",\n    \"customerDecision\": \"ACCEPT\",\n    \"customerVerificationResult\": \"Pass\",\n    \"applications\": [\n      {\n        \"entityId\": \"155555\",\n        \"verificationType\": \"IDV\",\n        \"startDateTime\": \"2026-04-27 12:33:02\",\n        \"endDateTime\": \"2026-04-27 12:33:03\",\n        \"entityStatus\": \"Complete\",\n        \"entityDecision\": \"ACCEPT\",\n        \"rulesetOutcomes\": [\n          {\n            \"reference\": \"RS77865\",\n            \"score\": 3000,\n            \"ruleOutcomes\": [\n              {\n                \"ruleName\": \"GFTPass\",\n                \"outcome\": true,\n                \"description\": \"GFtPAss\",\n                \"score\": 3000\n              },\n              {\n                \"ruleName\": \"GFT IP\",\n                \"outcome\": false,\n                \"description\": \"GFT In Progress\",\n                \"score\": 0\n              },\n              {\n                \"ruleName\": \"GFT Refer\",\n                \"outcome\": false,\n                \"description\": \"Refer application\",\n                \"score\": 0\n              },\n              {\n                \"ruleName\": \"GFT Fail\",\n                \"outcome\": false,\n                \"description\": \"Will always fail the application\",\n                \"score\": 0\n              }\n            ]\n          }\n        ],\n        \"documentVerificationId\": null,\n        \"links\": null\n      }\n    ]\n  },\n  \"echo\": {\n    \"transactionId\": \"IVS-VRFY-CUST-33106\",\n    \"rtoken\": \"1q2w3e-4r5t-6y7u-8i9o-0p1a2s3d4f5g\"\n  },\n  \"systemTimestamp\": \"2026-04-27 12:33:03\",\n  \"errors\": []\n}"}}}},"description":"Successful Response","headers":{"X-GFT-Rtoken":{"schema":{"description":"Response token for tracking requests","title":"X-Gft-Rtoken","type":"string"}}}},"400":{"content":{"application/json":{"schema":{"description":"Bad Request","examples":[{"error":{"code":"BAD_REQUEST","message":"The request was not acceptable, typically due to missing or invalid parameters."}}],"properties":{"error":{"description":"Provides additional information about the error.","properties":{"code":{"description":"Identifier for the error","examples":["SERVICE_UNAVAILABLE","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","INTERNAL_SERVER_ERROR"],"title":"Code","type":"string"},"message":{"description":"Short description of the error.","title":"Message","type":"string"},"details":{"anyOf":[{"type":"object"},{"type":"null"}],"description":"Contains details about the error when available. For example, which fields have validation problems or which action fails.","title":"Details"}},"required":["code","message"],"title":"GSAPIErrorDetail","type":"object"}},"required":["error"],"title":"ResponseModel","type":"object"}}},"description":"Bad Request","headers":{"X-GFT-Rtoken":{"schema":{"description":"Response token for tracking requests","title":"X-Gft-Rtoken","type":"string"}}}},"401":{"content":{"application/json":{"schema":{"description":"Unauthorized","examples":[{"error":{"code":"UNAUTHORIZED","message":"No valid API credentials provided."}}],"properties":{"error":{"description":"Provides additional information about the error.","properties":{"code":{"description":"Identifier for the error","examples":["SERVICE_UNAVAILABLE","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","INTERNAL_SERVER_ERROR"],"title":"Code","type":"string"},"message":{"description":"Short description of the error.","title":"Message","type":"string"},"details":{"anyOf":[{"type":"object"},{"type":"null"}],"description":"Contains details about the error when available. For example, which fields have validation problems or which action fails.","title":"Details"}},"required":["code","message"],"title":"GSAPIErrorDetail","type":"object"}},"required":["error"],"title":"ResponseModel","type":"object"}}},"description":"Unauthorized","headers":{"X-GFT-Rtoken":{"schema":{"description":"Response token for tracking requests","title":"X-Gft-Rtoken","type":"string"}}}},"403":{"content":{"application/json":{"schema":{"description":"Forbidden","examples":[{"error":{"code":"FORBIDDEN","message":"The provided API credential does not allow this operation."}}],"properties":{"error":{"description":"Provides additional information about the error.","properties":{"code":{"description":"Identifier for the error","examples":["SERVICE_UNAVAILABLE","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","INTERNAL_SERVER_ERROR"],"title":"Code","type":"string"},"message":{"description":"Short description of the error.","title":"Message","type":"string"},"details":{"anyOf":[{"type":"object"},{"type":"null"}],"description":"Contains details about the error when available. For example, which fields have validation problems or which action fails.","title":"Details"}},"required":["code","message"],"title":"GSAPIErrorDetail","type":"object"}},"required":["error"],"title":"ResponseModel","type":"object"}}},"description":"Forbidden","headers":{"X-GFT-Rtoken":{"schema":{"description":"Response token for tracking requests","title":"X-Gft-Rtoken","type":"string"}}}},"404":{"content":{"application/json":{"schema":{"description":"Not Found","examples":[{"error":{"code":"NOT_FOUND","message":"The requested entity does not exist."}}],"properties":{"error":{"description":"Provides additional information about the error.","properties":{"code":{"description":"Identifier for the error","examples":["SERVICE_UNAVAILABLE","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","INTERNAL_SERVER_ERROR"],"title":"Code","type":"string"},"message":{"description":"Short description of the error.","title":"Message","type":"string"},"details":{"anyOf":[{"type":"object"},{"type":"null"}],"description":"Contains details about the error when available. For example, which fields have validation problems or which action fails.","title":"Details"}},"required":["code","message"],"title":"GSAPIErrorDetail","type":"object"}},"required":["error"],"title":"ResponseModel","type":"object"}}},"description":"Not Found","headers":{"X-GFT-Rtoken":{"schema":{"description":"Response token for tracking requests","title":"X-Gft-Rtoken","type":"string"}}}},"409":{"content":{"application/json":{"schema":{"description":"Conflict","examples":[{"error":{"code":"CONCURRENT_IDEMPOTENT_REQUEST","message":"The operation was called concurrently with duplicate `X-GFT-Idempotency-Key` headers, but does not support concurrent requests."}}],"properties":{"error":{"description":"Provides additional information about the error.","properties":{"code":{"description":"Identifier for the error","examples":["SERVICE_UNAVAILABLE","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","INTERNAL_SERVER_ERROR"],"title":"Code","type":"string"},"message":{"description":"Short description of the error.","title":"Message","type":"string"},"details":{"anyOf":[{"type":"object"},{"type":"null"}],"description":"Contains details about the error when available. For example, which fields have validation problems or which action fails.","title":"Details"}},"required":["code","message"],"title":"GSAPIErrorDetail","type":"object"}},"required":["error"],"title":"ResponseModel","type":"object"}}},"description":"Conflict","headers":{"X-GFT-Rtoken":{"schema":{"description":"Response token for tracking requests","title":"X-Gft-Rtoken","type":"string"}}}},"429":{"content":{"application/json":{"schema":{"description":"Too Many Requests","examples":[{"error":{"code":"TOO_MANY_REQUESTS","message":"Rate limit exceeded by too many requests."}}],"properties":{"error":{"description":"Provides additional information about the error.","properties":{"code":{"description":"Identifier for the error","examples":["SERVICE_UNAVAILABLE","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","INTERNAL_SERVER_ERROR"],"title":"Code","type":"string"},"message":{"description":"Short description of the error.","title":"Message","type":"string"},"details":{"anyOf":[{"type":"object"},{"type":"null"}],"description":"Contains details about the error when available. For example, which fields have validation problems or which action fails.","title":"Details"}},"required":["code","message"],"title":"GSAPIErrorDetail","type":"object"}},"required":["error"],"title":"ResponseModel","type":"object"}}},"description":"Too Many Requests","headers":{"X-GFT-Rtoken":{"schema":{"description":"Response token for tracking requests","title":"X-Gft-Rtoken","type":"string"}}}},"500":{"content":{"application/json":{"schema":{"description":"Internal Service Error","examples":[{"error":{"code":"INTERNAL_SERVICE_ERROR","message":"Indicates an issue with the origin web server."}}],"properties":{"error":{"description":"Provides additional information about the error.","properties":{"code":{"description":"Identifier for the error","examples":["SERVICE_UNAVAILABLE","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","INTERNAL_SERVER_ERROR"],"title":"Code","type":"string"},"message":{"description":"Short description of the error.","title":"Message","type":"string"},"details":{"anyOf":[{"type":"object"},{"type":"null"}],"description":"Contains details about the error when available. For example, which fields have validation problems or which action fails.","title":"Details"}},"required":["code","message"],"title":"GSAPIErrorDetail","type":"object"}},"required":["error"],"title":"ResponseModel","type":"object"}}},"description":"Internal Service Error","headers":{"X-GFT-Rtoken":{"schema":{"description":"Response token for tracking requests","title":"X-Gft-Rtoken","type":"string"}}}},"503":{"content":{"application/json":{"schema":{"description":"Service Unavailable","examples":[{"error":{"code":"SERVICE_UNAVAILABLE","message":"A SoFi Tech Solutions internal service error occurred, and the system was not able to process the request. This is equivalent to a Program API -1 System Failure error."}}],"properties":{"error":{"description":"Provides additional information about the error.","properties":{"code":{"description":"Identifier for the error","examples":["SERVICE_UNAVAILABLE","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","INTERNAL_SERVER_ERROR"],"title":"Code","type":"string"},"message":{"description":"Short description of the error.","title":"Message","type":"string"},"details":{"anyOf":[{"type":"object"},{"type":"null"}],"description":"Contains details about the error when available. For example, which fields have validation problems or which action fails.","title":"Details"}},"required":["code","message"],"title":"GSAPIErrorDetail","type":"object"}},"required":["error"],"title":"ResponseModel","type":"object"}}},"description":"Service Unavailable","headers":{"X-GFT-Rtoken":{"schema":{"description":"Response token for tracking requests","title":"X-Gft-Rtoken","type":"string"}}}}},"description":"Use the Verify Customer endpoint to perform identity verification for individual or business customers and their associated entities. This endpoint validates customer information, including personal details, addresses, and identification documents. For businesses, a single customer profile can support the verification of multiple associated entities (e.g., directors or beneficial owners).","summary":"Verify Customer","tags":["IVS"],"requestBody":{"content":{"application/json":{"schema":{"properties":{"providerId":{"description":"The system-generated identifier for the IVS provider.\nPattern: Up to 10 digits\nExample: `\"9999\"`","examples":["\"9999\""],"title":"Providerid","type":"string"},"customerType":{"description":"Specifies the category of customer undergoing verification.\nPattern: Person or Business\nExample: `Person`","examples":["Person"],"enum":["Person","Business"],"title":"VerifyCustomerType","type":"string"},"customerId":{"description":"ID generated by you or SoFi Tech Solutions for the top-level customer (person or business) undergoing verification. Use this to correlate this event with the specific customer record in your system.\nPattern: Alphanumeric identifier\nExample: `789XYZ2025`","examples":["789XYZ2025"],"title":"Customerid","type":"string"},"eventTs":{"description":"Timestamp for when the verification event occurred.\nPattern: ISO 8601 date-time (YYYY-MM-DDTHH:MM:SS)\nExample: `2025-01-01T00:00:00`","examples":["2025-01-01T00:00:00"],"format":"date-time","title":"Eventts","type":"string"},"riskServiceId":{"description":"System-generated identifier that specifies the IVS configuration strategy assigned during IVS setup.\nPattern: EPRP or GCORE prefix followed by colon-separated identifiers, up to 50 characters\nExample: ``EPRP-test-1231231:1``","examples":["`EPRP-test-1231231:1`"],"title":"Riskserviceid","type":"string"},"prodId":{"description":"The product ID of the account.\nPattern: One or more digits\nExample: `9999`","examples":["9999"],"title":"Prodid","type":"string"},"persons":{"description":"A list of objects containing identity details for every person or entity associated with the verification. This object is **required** when `customerType: Person` and optional when `customerType: Business`.\nPattern: List of objects","examples":[],"items":{"properties":{"isPrimary":{"description":"Whether this person is the primary entity.\nPattern: `true` or `false`\nExample: `true`","examples":["true"],"title":"Isprimary","type":"boolean"},"entityId":{"description":"ID generated by you or SoFi Tech Solutions for a specific entity within a customer. For a `Person` customer type, this maps 1-to-1 with the `customerId`. For a `Business` customer type, a single customer may have multiple entities. Use this to correlate this event with the specific entity record in your system.\nPattern: Alphanumeric identifier\nExample: `789XYZ2025`","examples":["789XYZ2025"],"title":"Entityid","type":"string"},"ubo":{"description":"Whether the person is an Ultimate Beneficial Owner (UBO).\nPattern: `true` or `false`\nExample: `true`","examples":["true"],"title":"Ubo","type":"boolean"},"soleProprietor":{"description":"Whether the person is a sole proprietor.\nPattern: `true` or `false`\nExample: `false`","examples":["false"],"title":"Soleproprietor","type":"boolean"},"percentShareholding":{"description":"Percentage of shares held by the person.\nPattern: 0–100 with decimal places\nExample: `25.5`","examples":["25.5"],"title":"Percentshareholding","type":"number"},"role":{"description":"Role of the person.\nPattern: `APPLICANT`, `DIRECTOR`, or `BENEFICIARY`\nExample: `APPLICANT`","examples":["APPLICANT"],"enum":["APPLICANT","DIRECTOR","BENEFICIARY"],"title":"PersonEntityRoles","type":"string"},"firstName":{"description":"Person's first name.\nPattern: 1–40 characters: letters, spaces, hyphens, and single quotes\nExample: `John`","examples":["John"],"title":"Firstname","type":"string","writeOnly":true},"middleName":{"description":"Person's middle name.\nPattern: 1–40 characters: letters, spaces, hyphens, and single quotes\nExample: `M`","examples":["M"],"title":"Middlename","type":"string","writeOnly":true},"lastName":{"description":"Person's last name.\nPattern: 1–40 characters: letters, spaces, hyphens, and single quotes\nExample: `Doe`","examples":["Doe"],"title":"Lastname","type":"string","writeOnly":true},"dateOfBirth":{"description":"Person's birth date.\nPattern: YYYY-MM-DD\nExample: `1990-01-01`","examples":["1990-01-01"],"title":"Dateofbirth","type":"string","writeOnly":true},"residentialAddress":{"description":"Person's residential address.\nPattern: Nested object","examples":[],"properties":{"address1":{"description":"Person's first address line. Cannot be a P.O. box.\nPattern: 4–40 alphanumeric characters\nExample: `123 Main Street`","examples":["123 Main Street"],"title":"Address1","type":"string","writeOnly":true},"address2":{"description":"Person's second address line.\nPattern: Up to 40 characters\nExample: `Apt 4B`","examples":["Apt 4B"],"title":"Address2","type":"string","writeOnly":true},"city":{"description":"Person's residential city.\nPattern: Up to 30 characters: letters, spaces, hyphen, and period\nExample: `New York`","examples":["New York"],"title":"City","type":"string","writeOnly":true},"state":{"description":"Person's state or province.\nPattern: 2 character state abbreviation\nExample: `NY`","examples":["NY"],"title":"State","type":"string","writeOnly":true},"zipCode":{"description":"Person's postal code (US ZIP code or local postal code).\nPattern: 5–20 characters\nExample: `10001`","examples":["10001"],"title":"Zipcode","type":"string","writeOnly":true},"countryCode":{"description":"Person's three-letter country code.\nPattern: 3 character country code\nExample: `USA`","examples":["USA"],"title":"Countrycode","type":"string","writeOnly":true}},"required":["address1","city","state","zipCode","countryCode"],"title":"ResidentialAddress","type":"object"},"ssn":{"description":"Person's social security number.\nPattern: 9 digits\nExample: `123456789`","examples":["123456789"],"title":"Ssn","type":"string","writeOnly":true},"nationalIdentificationType":{"description":"The type of national identification.\nPattern: Non-empty text\nExample: `passport`","examples":["passport"],"title":"Nationalidentificationtype","type":"string"},"nationalIdentificationNumber":{"description":"The person's national identification number.\nPattern: 5–20 alphanumeric characters\nExample: `A12345678`","examples":["A12345678"],"title":"Nationalidentificationnumber","type":"string","writeOnly":true},"countryOfIssuance":{"description":"The country that issued the identification.\nPattern: Up to 3 characters\nExample: `USA`","examples":["USA"],"title":"Countryofissuance","type":"string","writeOnly":true},"phone":{"description":"Person's phone number.\nPattern: E.164 format\nExample: `+12125551234`","examples":["+12125551234"],"title":"Phone","type":"string","writeOnly":true},"email":{"description":"Person's email address.\nPattern: 3–63 characters\nExample: `john.doe@example.com`","examples":["john.doe@example.com"],"title":"Email","type":"string","writeOnly":true},"eddq1":{"description":"<<glossary:EDD>> question 1.\nPattern: Integer\nExample: `1`","examples":["1"],"title":"Eddq1","type":"integer"},"edda1":{"description":"EDD answer 1.\nPattern: Non-empty text\nExample: `Answer text`","examples":["Answer text"],"title":"Edda1","type":"string"},"eddq2":{"description":"EDD question 2.\nPattern: Integer\nExample: `2`","examples":["2"],"title":"Eddq2","type":"integer"},"edda2":{"description":"EDD answer 2.\nPattern: Non-empty text\nExample: `Answer text`","examples":["Answer text"],"title":"Edda2","type":"string"},"eddq3":{"description":"EDD question 3.\nPattern: Integer\nExample: `3`","examples":["3"],"title":"Eddq3","type":"integer"},"edda3":{"description":"<<glossary:EDD>> answer 3.\nPattern: Non-empty text\nExample: `Answer text`","examples":["Answer text"],"title":"Edda3","type":"string"},"eddq4":{"description":"EDD question 4.\nPattern: Integer\nExample: `4`","examples":["4"],"title":"Eddq4","type":"integer"},"edda4":{"description":"EDD answer 4.\nPattern: Non-empty text\nExample: `Answer text`","examples":["Answer text"],"title":"Edda4","type":"string"},"eddq5":{"description":"EDD question 5.\nPattern: Integer\nExample: `5`","examples":["5"],"title":"Eddq5","type":"integer"},"edda5":{"description":"EDD answer 5.\nPattern: Non-empty text\nExample: `Answer text`","examples":["Answer text"],"title":"Edda5","type":"string"}},"required":["isPrimary","entityId","role","firstName","lastName","dateOfBirth","residentialAddress","ssn"],"title":"PersonEntity","type":"object"},"title":"Persons","type":"array"},"business":{"description":"An object containing the legal and registration details for the business entity. This object is **required** when `customerType: Business`.\nPattern: Nested object","examples":[],"properties":{"isPrimary":{"description":"Whether this business is the primary entity.\nPattern: `true` or `false`\nExample: `true`","examples":["true"],"title":"Isprimary","type":"boolean"},"entityId":{"description":"ID generated by you or SoFi Tech Solutions for a specific entity within a customer. For a `Person` customer type, this maps 1-to-1 with the `customerId`. For a `Business` customer type, a single customer may have multiple entities. Use this to correlate this event with the specific entity record in your system.\nPattern: Alphanumeric identifier\nExample: `789XYZ2025`","examples":["789XYZ2025"],"title":"Entityid","type":"string"},"businessLegalName":{"description":"Legal name of the business.\nPattern: 2–150 characters\nExample: `Acme Corporation`","examples":["Acme Corporation"],"title":"Businesslegalname","type":"string"},"businessDBA":{"description":"The Doing Business As (DBA) name.\nPattern: 2–150 characters\nExample: `Acme Co`","examples":["Acme Co"],"title":"Businessdba","type":"string"},"businessLegalStructure":{"description":"Legal structure of the business.\nPattern: Standard corporate abbreviation\nExample: `LLC`","examples":["LLC"],"title":"Businesslegalstructure","type":"string"},"businessRegAddress":{"description":"The registration address for the business.\nPattern: Nested object","examples":[],"properties":{"businessRegAddress":{"description":"First line of the business registration address. Cannot be a P.O. box.\nPattern: 4–40 alphanumeric characters\nExample: `456 Business Blvd`","examples":["456 Business Blvd"],"title":"Businessregaddress","type":"string","writeOnly":true},"businessRegAddress2":{"description":"Second line of the business registration address.\nPattern: Up to 40 characters\nExample: `Suite 200`","examples":["Suite 200"],"title":"Businessregaddress2","type":"string","writeOnly":true},"businessRegCity":{"description":"City of the business registration address.\nPattern: Up to 30 characters: letters, spaces, hyphen, and period\nExample: `San Francisco`","examples":["San Francisco"],"title":"Businessregcity","type":"string","writeOnly":true},"businessRegState":{"description":"State of the business registration address.\nPattern: 2 character state abbreviation\nExample: `CA`","examples":["CA"],"title":"Businessregstate","type":"string","writeOnly":true},"businessRegZip":{"description":"ZIP code of the business registration address.\nPattern: Up to 5 digits\nExample: `94105`","examples":["94105"],"title":"Businessregzip","type":"string","writeOnly":true},"businessRegCountryCode":{"description":"Country code of the business registration address.\nPattern: 3 character country code\nExample: `USA`","examples":["USA"],"title":"Businessregcountrycode","type":"string","writeOnly":true}},"required":["businessRegAddress","businessRegCity","businessRegState","businessRegZip","businessRegCountryCode"],"title":"BusinessRegAddress","type":"object"},"companyMailingAddress":{"description":"Business mailing address\nPattern: Nested object","examples":[],"properties":{"businessMailingAddress":{"description":"First line of the business mailing address. Cannot be a P.O. box.\nPattern: 4–40 alphanumeric characters\nExample: `456 Business Blvd`","examples":["456 Business Blvd"],"title":"Businessmailingaddress","type":"string","writeOnly":true},"businessMailingAddress2":{"description":"Second line of the business mailing address.\nPattern: Up to 40 characters\nExample: `Suite 200`","examples":["Suite 200"],"title":"Businessmailingaddress2","type":"string","writeOnly":true},"businessMailingCity":{"description":"City of the business mailing address.\nPattern: Up to 30 characters: letters, spaces, hyphen, and period\nExample: `San Francisco`","examples":["San Francisco"],"title":"Businessmailingcity","type":"string","writeOnly":true},"businessMailingState":{"description":"State of the business mailing address.\nPattern: 2 character state abbreviation\nExample: `CA`","examples":["CA"],"title":"Businessmailingstate","type":"string","writeOnly":true},"businessMailingZip":{"description":"ZIP code of the business mailing address.\nPattern: Up to 5 digits\nExample: `94105`","examples":["94105"],"title":"Businessmailingzip","type":"string","writeOnly":true},"businessMailingCountryCode":{"description":"Country code of the business mailing address.\nPattern: 3 character country code\nExample: `USA`","examples":["USA"],"title":"Businessmailingcountrycode","type":"string","writeOnly":true}},"required":["businessMailingAddress","businessMailingCity","businessMailingState","businessMailingZip","businessMailingCountryCode"],"title":"BusinessMailingAddress","type":"object"},"businessDateOfIncorporation":{"description":"Date the business was incorporated.\nPattern: YYYY-MM-DD\nExample: `2010-01-01`","examples":["2010-01-01"],"title":"Businessdateofincorporation","type":"string","writeOnly":true},"businessTaxId":{"description":"Business tax ID (EIN).\nPattern: 9 digits\nExample: `123456789`","examples":["123456789"],"title":"Businesstaxid","type":"string","writeOnly":true},"businessSPDateOfBirth":{"description":"Date of birth for the sole proprietor.\nPattern: YYYY-MM-DD\nExample: `1980-01-01`","examples":["1980-01-01"],"title":"Businessspdateofbirth","type":"string","writeOnly":true},"thirdPartyOwnershipStructure":{"description":"Third-party ownership structure.\nPattern: Non-empty text\nExample: `Private`","examples":["Private"],"title":"Thirdpartyownershipstructure","type":"string"},"thirdPartyBusinessActivities":{"description":"Third-party business activities.\nPattern: Non-empty text\nExample: `Software development`","examples":["Software development"],"title":"Thirdpartybusinessactivities","type":"string"},"thirdPartyBusinessTenure":{"description":"Third-party business tenure.\nPattern: Non-empty text\nExample: `5 years`","examples":["5 years"],"title":"Thirdpartybusinesstenure","type":"string"},"businessWebsite":{"description":"Website URL for the business.\nPattern: URL\nExample: `https://www.acmecorp.com`","examples":["https://www.acmecorp.com"],"title":"Businesswebsite","type":"string"},"businessParentLegalName":{"description":"Legal name of the parent business.\nPattern: 2–150 characters\nExample: `Acme Holdings Inc`","examples":["Acme Holdings Inc"],"title":"Businessparentlegalname","type":"string"},"businessParentRegState":{"description":"State where the parent business is registered.\nPattern: 2 character state abbreviation\nExample: `DE`","examples":["DE"],"title":"Businessparentregstate","type":"string"},"businessParentRegCountry":{"description":"Country where the parent business is registered.\nPattern: 3 character country code\nExample: `USA`","examples":["USA"],"title":"Businessparentregcountry","type":"string"},"phone":{"description":"Business phone number.\nPattern: E.164 format\nExample: `+14155551234`","examples":["+14155551234"],"title":"Phone","type":"string","writeOnly":true},"email":{"description":"Business email address.\nPattern: 3–63 characters\nExample: `contact@acmecorp.com`","examples":["contact@acmecorp.com"],"title":"Email","type":"string","writeOnly":true},"eddq1":{"description":"<<glossary:EDD>> question 1\nPattern: Integer\nExample: `1`","examples":["1"],"title":"Eddq1","type":"integer"},"edda1":{"description":"EDD answer 1\nPattern: Non-empty text\nExample: `Answer text`","examples":["Answer text"],"title":"Edda1","type":"string"},"eddq2":{"description":"EDD question 2\nPattern: Integer\nExample: `2`","examples":["2"],"title":"Eddq2","type":"integer"},"edda2":{"description":"EDD answer 

# --- truncated at 32 KB (134 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/sofi-technologies/refs/heads/main/openapi/sofi-technologies-risk-api-2-0-openapi.json