{"openapi":"3.0.0","paths":{"/clients/api/v1/accounts/{id}":{"get":{"summary":"Get account by id","tags":["accounts"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6","accountId":"account_00041061050r3gg28a1c60t3gf"}},{"name":"include","in":"query","schema":{"type":"string","example":"accountManager,accountIntegrations,accountSettings,apiKeys,assets,dataRooms,individuals,investorAccounts,invites,issuers,legalEntities,offerings,pages,sites,trades,users"}}],"operationId":"getAccount","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"name":{"type":"string","example":"Dalmore"},"status":{"type":"string","enum":["ONBOARDING","LIVE","OVERDUE","SUSPENDED","INACTIVE"],"example":"LIVE"},"managedBy":{"type":"string","enum":["DALMORE","ISSUER"],"nullable":true,"example":"DALMORE"},"platform":{"type":"string","enum":["DALMORE","IMPORT"],"example":"IMPORT"},"onboardingReviewerId":{"type":"string","nullable":true,"example":"user_01j1xgme5mfrasd02hmfwsy13a"},"onboardingReviewAt":{"type":"string","format":"date-time","nullable":true},"allowPendingComplianceReview":{"type":"boolean","example":false}},"required":["id","createdAt","updatedAt","deletedAt","name","status","managedBy","platform","onboardingReviewerId","onboardingReviewAt","allowPendingComplianceReview"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/accounts":{"get":{"summary":"Get accounts","tags":["accounts"],"parameters":[{"name":"page","in":"query","schema":{"default":1,"type":"number","nullable":true}},{"name":"limit","in":"query","schema":{"default":10,"type":"number","nullable":true}},{"name":"search","in":"query","schema":{"type":"string","maxLength":50}},{"name":"status","in":"query","schema":{"type":"string","enum":["ONBOARDING","LIVE","OVERDUE","SUSPENDED","INACTIVE"]}},{"name":"platform","in":"query","schema":{"type":"string","enum":["DALMORE","IMPORT"],"example":"IMPORT"}},{"name":"managedBy","in":"query","schema":{"type":"string","enum":["DALMORE","ISSUER"],"example":"DALMORE"}},{"name":"from","in":"query","schema":{"type":"string","nullable":true,"example":"MM/DD/YYYY"}},{"name":"to","in":"query","schema":{"type":"string","nullable":true,"example":"MM/DD/YYYY"}},{"name":"include","in":"query","schema":{"type":"string","example":"accountManager,accountIntegrations,accountSettings,apiKeys,assets,dataRooms,individuals,investorAccounts,invites,issuers,legalEntities,offerings,pages,sites,trades,users"}}],"operationId":"getAccounts","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"name":{"type":"string","example":"Dalmore"},"status":{"type":"string","enum":["ONBOARDING","LIVE","OVERDUE","SUSPENDED","INACTIVE"],"example":"LIVE"},"managedBy":{"type":"string","enum":["DALMORE","ISSUER"],"nullable":true,"example":"DALMORE"},"platform":{"type":"string","enum":["DALMORE","IMPORT"],"example":"IMPORT"},"onboardingReviewerId":{"type":"string","nullable":true,"example":"user_01j1xgme5mfrasd02hmfwsy13a"},"onboardingReviewAt":{"type":"string","format":"date-time","nullable":true},"allowPendingComplianceReview":{"type":"boolean","example":false}},"required":["id","createdAt","updatedAt","deletedAt","name","status","managedBy","platform","onboardingReviewerId","onboardingReviewAt","allowPendingComplianceReview"]}},"meta":{"type":"object","properties":{"itemCount":{"type":"number","example":1},"totalItems":{"type":"number","example":10},"itemsPerPage":{"type":"number","example":1},"totalPages":{"type":"number","example":10},"currentPage":{"type":"number","example":1}},"required":["itemCount","itemsPerPage","currentPage"]}},"required":["items","meta"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/individual/{individualId}/aic":{"get":{"summary":"Get AIC","tags":["aic"],"parameters":[{"name":"individualId","in":"path","required":true,"schema":{"type":"string"}},{"name":"include","in":"query","schema":{"type":"string","example":"individual"}}],"operationId":"getAic","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"individualId":{},"individual":{"nullable":true},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"]},"reviewedById":{"nullable":true},"reviewedBy":{"nullable":true},"reviewedAt":{"type":"string","format":"date-time","nullable":true},"systemReview":{"type":"string","enum":["PENDING","NEEDS_INFO","READY_TO_APPROVE","NEEDS_REVIEW","APPROVED","REJECTED"]},"systemLog":{"type":"array","items":{"type":"object","properties":{"check":{"type":"string","minLength":1},"entered":{"type":"number"},"extracted":{"type":"number"},"result":{"type":"string","enum":["PASS","FAIL"]},"reason":{"type":"string"}},"required":["check","result"]},"nullable":true},"firstName":{"type":"string"},"lastName":{"type":"string"},"method":{"type":"string","enum":["PENDING","INCOME","NET_WORTH","PROFESSIONAL_CERTIFICATION","KNOWLEDGEABLE_EMPLOYEE"]},"incomeData":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer","minimum":2020,"maximum":2025},"filingStatus":{"type":"string","enum":["SINGLE","JOINT"]},"income":{"type":"number","minimum":0,"multipleOf":0.01},"fileId":{}},"required":["year","filingStatus","income","fileId"]},"nullable":true},"netWorthData":{"type":"array","items":{"type":"object","properties":{"institution":{"type":"string","minLength":1,"maxLength":100},"accountType":{"type":"string","enum":["CHECKING","SAVINGS","BROKERAGE","REAL_ESTATE","OTHER"]},"balance":{"type":"number","minimum":0,"multipleOf":0.01},"fileId":{}},"required":["institution","accountType","balance","fileId"]},"nullable":true},"professionalData":{"type":"array","items":{"type":"object","properties":{"professionalType":{"type":"string","enum":["SECURITIES_LICENSES","DIRECTORS","FAMILY_OFFICE"]},"licenseNumber":{"type":"string","minLength":1,"maxLength":50,"nullable":true},"fileId":{"nullable":true}},"required":["professionalType"]},"nullable":true},"employeeData":{"type":"array","items":{"type":"object","properties":{"position":{"type":"string","minLength":1,"maxLength":100},"fileId":{}},"required":["position","fileId"]},"nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","individualId","complianceReview","reviewedById","reviewedAt","systemReview","systemLog","firstName","lastName","method","incomeData","netWorthData","professionalData","employeeData"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/individual/{individualId}/aic/file":{"put":{"summary":"Attach AIC File","tags":["aic"],"parameters":[{"name":"individualId","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"attachAicFile","requestBody":{"description":"Body","content":{"application/json":{"schema":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["INCOME"]},"metadata":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer","minimum":2020,"maximum":2025},"filingStatus":{"type":"string","enum":["SINGLE","JOINT"]},"income":{"type":"number","minimum":0,"multipleOf":0.01},"fileId":{}},"required":["year","filingStatus","income","fileId"]}}},"required":["type","metadata"]},{"type":"object","properties":{"type":{"type":"string","enum":["NET_WORTH"]},"metadata":{"type":"array","items":{"type":"object","properties":{"institution":{"type":"string","minLength":1,"maxLength":100},"accountType":{"type":"string","enum":["CHECKING","SAVINGS","BROKERAGE","REAL_ESTATE","OTHER"]},"balance":{"type":"number","minimum":0,"multipleOf":0.01},"fileId":{}},"required":["institution","accountType","balance","fileId"]}}},"required":["type","metadata"]},{"type":"object","properties":{"type":{"type":"string","enum":["PROFESSIONAL_CERTIFICATION"]},"metadata":{"type":"array","items":{"type":"object","properties":{"professionalType":{"type":"string","enum":["SECURITIES_LICENSES","DIRECTORS","FAMILY_OFFICE"]},"licenseNumber":{"type":"string","minLength":1,"maxLength":50,"nullable":true},"fileId":{"nullable":true}},"required":["professionalType"]}}},"required":["type","metadata"]},{"type":"object","properties":{"type":{"type":"string","enum":["KNOWLEDGEABLE_EMPLOYEE"]},"metadata":{"type":"array","items":{"type":"object","properties":{"position":{"type":"string","minLength":1,"maxLength":100},"fileId":{}},"required":["position","fileId"]}}},"required":["type","metadata"]}]}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"individualId":{},"individual":{"nullable":true},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"]},"reviewedById":{"nullable":true},"reviewedBy":{"nullable":true},"reviewedAt":{"type":"string","format":"date-time","nullable":true},"systemReview":{"type":"string","enum":["PENDING","NEEDS_INFO","READY_TO_APPROVE","NEEDS_REVIEW","APPROVED","REJECTED"]},"systemLog":{"type":"array","items":{"type":"object","properties":{"check":{"type":"string","minLength":1},"entered":{"type":"number"},"extracted":{"type":"number"},"result":{"type":"string","enum":["PASS","FAIL"]},"reason":{"type":"string"}},"required":["check","result"]},"nullable":true},"firstName":{"type":"string"},"lastName":{"type":"string"},"method":{"type":"string","enum":["PENDING","INCOME","NET_WORTH","PROFESSIONAL_CERTIFICATION","KNOWLEDGEABLE_EMPLOYEE"]},"incomeData":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer","minimum":2020,"maximum":2025},"filingStatus":{"type":"string","enum":["SINGLE","JOINT"]},"income":{"type":"number","minimum":0,"multipleOf":0.01},"fileId":{}},"required":["year","filingStatus","income","fileId"]},"nullable":true},"netWorthData":{"type":"array","items":{"type":"object","properties":{"institution":{"type":"string","minLength":1,"maxLength":100},"accountType":{"type":"string","enum":["CHECKING","SAVINGS","BROKERAGE","REAL_ESTATE","OTHER"]},"balance":{"type":"number","minimum":0,"multipleOf":0.01},"fileId":{}},"required":["institution","accountType","balance","fileId"]},"nullable":true},"professionalData":{"type":"array","items":{"type":"object","properties":{"professionalType":{"type":"string","enum":["SECURITIES_LICENSES","DIRECTORS","FAMILY_OFFICE"]},"licenseNumber":{"type":"string","minLength":1,"maxLength":50,"nullable":true},"fileId":{"nullable":true}},"required":["professionalType"]},"nullable":true},"employeeData":{"type":"array","items":{"type":"object","properties":{"position":{"type":"string","minLength":1,"maxLength":100},"fileId":{}},"required":["position","fileId"]},"nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","individualId","complianceReview","reviewedById","reviewedAt","systemReview","systemLog","firstName","lastName","method","incomeData","netWorthData","professionalData","employeeData"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/api-key-logs":{"get":{"summary":"Get API key logs","tags":["apiKeyLogs"],"parameters":[{"name":"page","in":"query","schema":{"default":1,"type":"number","nullable":true}},{"name":"limit","in":"query","schema":{"default":10,"type":"number","nullable":true}},{"name":"endpoint","in":"query","schema":{"type":"string"}},{"name":"apiKeyId","in":"query","schema":{"type":"string"}},{"name":"method","in":"query","schema":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE","HEAD","OPTIONS"]}},{"name":"status","in":"query","schema":{"type":"string","enum":["CONTINUE","SWITCHING_PROTOCOLS","PROCESSING","EARLYHINTS","OK","CREATED","ACCEPTED","NON_AUTHORITATIVE_INFORMATION","NO_CONTENT","RESET_CONTENT","PARTIAL_CONTENT","MULTI_STATUS","ALREADY_REPORTED","CONTENT_DIFFERENT","AMBIGUOUS","MOVED_PERMANENTLY","FOUND","SEE_OTHER","NOT_MODIFIED","TEMPORARY_REDIRECT","PERMANENT_REDIRECT","BAD_REQUEST","UNAUTHORIZED","PAYMENT_REQUIRED","FORBIDDEN","NOT_FOUND","METHOD_NOT_ALLOWED","NOT_ACCEPTABLE","PROXY_AUTHENTICATION_REQUIRED","REQUEST_TIMEOUT","CONFLICT","GONE","LENGTH_REQUIRED","PRECONDITION_FAILED","PAYLOAD_TOO_LARGE","URI_TOO_LONG","UNSUPPORTED_MEDIA_TYPE","REQUESTED_RANGE_NOT_SATISFIABLE","EXPECTATION_FAILED","I_AM_A_TEAPOT","MISDIRECTED","UNPROCESSABLE_ENTITY","LOCKED","FAILED_DEPENDENCY","PRECONDITION_REQUIRED","TOO_MANY_REQUESTS","UNRECOVERABLE_ERROR","INTERNAL_SERVER_ERROR","NOT_IMPLEMENTED","BAD_GATEWAY","SERVICE_UNAVAILABLE","GATEWAY_TIMEOUT","HTTP_VERSION_NOT_SUPPORTED","INSUFFICIENT_STORAGE","LOOP_DETECTED",100,101,102,103,200,201,202,203,204,205,206,207,208,210,300,301,302,303,304,307,308,400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,415,416,417,418,421,422,423,424,428,429,456,500,501,502,503,504,505,507,508]}},{"name":"from","in":"query","schema":{"type":"string","nullable":true,"example":"MM/DD/YYYY"}},{"name":"to","in":"query","schema":{"type":"string","nullable":true,"example":"MM/DD/YYYY"}}],"operationId":"getApiKeyLogs","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"apiKeyId":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE","HEAD","OPTIONS"]},"path":{"type":"string"},"status":{"type":"string","enum":["CONTINUE","SWITCHING_PROTOCOLS","PROCESSING","EARLYHINTS","OK","CREATED","ACCEPTED","NON_AUTHORITATIVE_INFORMATION","NO_CONTENT","RESET_CONTENT","PARTIAL_CONTENT","MULTI_STATUS","ALREADY_REPORTED","CONTENT_DIFFERENT","AMBIGUOUS","MOVED_PERMANENTLY","FOUND","SEE_OTHER","NOT_MODIFIED","TEMPORARY_REDIRECT","PERMANENT_REDIRECT","BAD_REQUEST","UNAUTHORIZED","PAYMENT_REQUIRED","FORBIDDEN","NOT_FOUND","METHOD_NOT_ALLOWED","NOT_ACCEPTABLE","PROXY_AUTHENTICATION_REQUIRED","REQUEST_TIMEOUT","CONFLICT","GONE","LENGTH_REQUIRED","PRECONDITION_FAILED","PAYLOAD_TOO_LARGE","URI_TOO_LONG","UNSUPPORTED_MEDIA_TYPE","REQUESTED_RANGE_NOT_SATISFIABLE","EXPECTATION_FAILED","I_AM_A_TEAPOT","MISDIRECTED","UNPROCESSABLE_ENTITY","LOCKED","FAILED_DEPENDENCY","PRECONDITION_REQUIRED","TOO_MANY_REQUESTS","UNRECOVERABLE_ERROR","INTERNAL_SERVER_ERROR","NOT_IMPLEMENTED","BAD_GATEWAY","SERVICE_UNAVAILABLE","GATEWAY_TIMEOUT","HTTP_VERSION_NOT_SUPPORTED","INSUFFICIENT_STORAGE","LOOP_DETECTED",100,101,102,103,200,201,202,203,204,205,206,207,208,210,300,301,302,303,304,307,308,400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,415,416,417,418,421,422,423,424,428,429,456,500,501,502,503,504,505,507,508]},"durationMs":{"type":"number"},"requestBody":{"type":"object","additionalProperties":{"nullable":true},"nullable":true},"responseBody":{"type":"object","additionalProperties":{"nullable":true},"nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","apiKeyId","method","path","status","durationMs","requestBody","responseBody"]}},"meta":{"type":"object","properties":{"itemCount":{"type":"number","example":1},"totalItems":{"type":"number","example":10},"itemsPerPage":{"type":"number","example":1},"totalPages":{"type":"number","example":10},"currentPage":{"type":"number","example":1}},"required":["itemCount","itemsPerPage","currentPage"]}},"required":["items","meta"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/api-key-logs/totals":{"get":{"summary":"Get totals of API key logs","tags":["apiKeyLogs"],"parameters":[{"name":"apiKeyId","in":"query","schema":{"type":"string"}},{"name":"from","in":"query","schema":{"type":"string","nullable":true,"example":"MM/DD/YYYY"}},{"name":"to","in":"query","schema":{"type":"string","nullable":true,"example":"MM/DD/YYYY"}}],"operationId":"getApiKeyLogsTotals","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"number"},"failed":{"type":"number"},"total":{"type":"number"}},"required":["success","failed"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/api-keys":{"get":{"summary":"Get API Keys","tags":["apiKeys"],"parameters":[{"name":"page","in":"query","schema":{"default":1,"type":"number","nullable":true}},{"name":"limit","in":"query","schema":{"default":10,"type":"number","nullable":true}}],"operationId":"getApiKeys","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"name":{"type":"string"},"description":{"type":"string","nullable":true},"key":{"type":"string"},"keyHash":{"type":"string"},"active":{"type":"boolean"},"lastUsedAt":{"type":"string","format":"date-time","nullable":true},"accountId":{"type":"string"},"roleId":{"type":"string","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","name","description","key","keyHash","active","lastUsedAt","accountId","roleId"]}},"meta":{"type":"object","properties":{"itemCount":{"type":"number","example":1},"totalItems":{"type":"number","example":10},"itemsPerPage":{"type":"number","example":1},"totalPages":{"type":"number","example":10},"currentPage":{"type":"number","example":1}},"required":["itemCount","itemsPerPage","currentPage"]}},"required":["items","meta"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/api-keys/{id}":{"get":{"summary":"Get API Key","tags":["apiKeys"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"getApiKey","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"name":{"type":"string"},"description":{"type":"string","nullable":true},"key":{"type":"string"},"keyHash":{"type":"string"},"active":{"type":"boolean"},"lastUsedAt":{"type":"string","format":"date-time","nullable":true},"accountId":{"type":"string"},"roleId":{"type":"string","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","name","description","key","keyHash","active","lastUsedAt","accountId","roleId"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/api-keys/{id}/deactivate":{"patch":{"summary":"Deactivate API Key by id","tags":["apiKeys"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"deactivateApiKey","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"202":{"description":"202","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"name":{"type":"string"},"description":{"type":"string","nullable":true},"key":{"type":"string"},"keyHash":{"type":"string"},"active":{"type":"boolean"},"lastUsedAt":{"type":"string","format":"date-time","nullable":true},"accountId":{"type":"string"},"roleId":{"type":"string","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","name","description","key","keyHash","active","lastUsedAt","accountId","roleId"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/assets":{"get":{"summary":"Get assets","tags":["assets"],"parameters":[{"name":"page","in":"query","schema":{"default":1,"type":"number","nullable":true}},{"name":"limit","in":"query","schema":{"default":10,"type":"number","nullable":true}},{"name":"include","in":"query","schema":{"type":"string","example":"account, offering, bonusTiers"}},{"name":"name","in":"query","schema":{"type":"string"}},{"name":"accountId","in":"query","schema":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6","accountId":"account_00041061050r3gg28a1c60t3gf"}},{"name":"offeringId","in":"query","schema":{"example":"offering_01jayn2qkpeebav9gjpqx7xm8j"}},{"name":"issuerId","in":"query","schema":{}},{"name":"type","in":"query","schema":{"type":"string","enum":["BOND","STOCK","PROMISSORY_NOTE"]}}],"operationId":"getAssets","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"asset_00041061050r3gg28a1c60t3gf"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"name":{"type":"string"},"type":{"type":"string","enum":["BOND","STOCK","PROMISSORY_NOTE"],"nullable":true},"pricePerUnit":{"type":"number","nullable":true},"totalUnits":{"type":"number","nullable":true},"totalAmount":{"type":"number","nullable":true},"yield":{"type":"number","nullable":true},"duration":{"type":"number","nullable":true},"durationType":{"type":"string","enum":["DAYS","WEEKS","MONTHS","YEARS"],"nullable":true},"accountId":{"type":"string"},"account":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"name":{"type":"string","example":"Dalmore"},"status":{"type":"string","enum":["ONBOARDING","LIVE","OVERDUE","SUSPENDED","INACTIVE"],"example":"LIVE"},"managedBy":{"type":"string","enum":["DALMORE","ISSUER"],"nullable":true,"example":"DALMORE"},"platform":{"type":"string","enum":["DALMORE","IMPORT"],"example":"IMPORT"},"onboardingReviewerId":{"type":"string","nullable":true,"example":"user_01j1xgme5mfrasd02hmfwsy13a"},"onboardingReviewAt":{"type":"string","format":"date-time","nullable":true},"allowPendingComplianceReview":{"type":"boolean","example":false}},"required":["id","createdAt","updatedAt","deletedAt","name","status","managedBy","platform","onboardingReviewerId","onboardingReviewAt","allowPendingComplianceReview"],"nullable":true},"offeringId":{"type":"string"},"offering":{"nullable":true},"template":{"type":"string","enum":["STANDARD","TIERED"]},"tiers":{"type":"array","items":{"type":"number","minimum":0,"exclusiveMinimum":0},"nullable":true},"enableBonus":{"type":"boolean"},"interestRate":{"type":"number","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","name","type","pricePerUnit","totalUnits","totalAmount","yield","duration","durationType","accountId","offeringId","template","tiers","enableBonus","interestRate"]}},"meta":{"type":"object","properties":{"itemCount":{"type":"number","example":1},"totalItems":{"type":"number","example":10},"itemsPerPage":{"type":"number","example":1},"totalPages":{"type":"number","example":10},"currentPage":{"type":"number","example":1}},"required":["itemCount","itemsPerPage","currentPage"]}},"required":["items","meta"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]},"post":{"summary":"Create an asset","tags":["assets"],"parameters":[],"operationId":"postAssets","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"offeringId":{"example":"offering_01jayn2qkpeebav9gjpqx7xm8j"},"name":{"type":"string","minLength":2,"maxLength":50,"example":"Asset name"},"type":{"type":"string","enum":["BOND","STOCK","PROMISSORY_NOTE"],"example":"STOCK"},"pricePerUnit":{"type":"number","minimum":0.01,"maximum":10000000000,"nullable":true,"example":2000},"totalUnits":{"type":"number","minimum":1,"maximum":10000000000,"nullable":true,"example":5200},"yield":{"type":"number","minimum":0.01,"maximum":10000000000,"nullable":true,"example":1200},"duration":{"type":"number","minimum":1,"maximum":1000,"nullable":true,"example":1},"durationType":{"type":"string","enum":["DAYS","WEEKS","MONTHS","YEARS"],"nullable":true,"example":"DAYS"},"template":{"default":"STANDARD","type":"string","enum":["STANDARD","TIERED"],"example":"STANDARD"},"tiers":{"type":"array","items":{"type":"number","minimum":0,"exclusiveMinimum":0},"nullable":true},"enableBonus":{"default":false,"type":"boolean","example":false},"interestRate":{"type":"number","minimum":0.01,"maximum":100,"nullable":true,"example":10}},"required":["offeringId","name","type","pricePerUnit","totalUnits"]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"asset_00041061050r3gg28a1c60t3gf"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"name":{"type":"string"},"type":{"type":"string","enum":["BOND","STOCK","PROMISSORY_NOTE"],"nullable":true},"pricePerUnit":{"type":"number","nullable":true},"totalUnits":{"type":"number","nullable":true},"totalAmount":{"type":"number","nullable":true},"yield":{"type":"number","nullable":true},"duration":{"type":"number","nullable":true},"durationType":{"type":"string","enum":["DAYS","WEEKS","MONTHS","YEARS"],"nullable":true},"accountId":{"type":"string"},"account":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"name":{"type":"string","example":"Dalmore"},"status":{"type":"string","enum":["ONBOARDING","LIVE","OVERDUE","SUSPENDED","INACTIVE"],"example":"LIVE"},"managedBy":{"type":"string","enum":["DALMORE","ISSUER"],"nullable":true,"example":"DALMORE"},"platform":{"type":"string","enum":["DALMORE","IMPORT"],"example":"IMPORT"},"onboardingReviewerId":{"type":"string","nullable":true,"example":"user_01j1xgme5mfrasd02hmfwsy13a"},"onboardingReviewAt":{"type":"string","format":"date-time","nullable":true},"allowPendingComplianceReview":{"type":"boolean","example":false}},"required":["id","createdAt","updatedAt","deletedAt","name","status","managedBy","platform","onboardingReviewerId","onboardingReviewAt","allowPendingComplianceReview"],"nullable":true},"offeringId":{"type":"string"},"offering":{"nullable":true},"template":{"type":"string","enum":["STANDARD","TIERED"]},"tiers":{"type":"array","items":{"type":"number","minimum":0,"exclusiveMinimum":0},"nullable":true},"enableBonus":{"type":"boolean"},"interestRate":{"type":"number","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","name","type","pricePerUnit","totalUnits","totalAmount","yield","duration","durationType","accountId","offeringId","template","tiers","enableBonus","interestRate"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"409":{"description":"409","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"409"},"message":{"type":"string","example":"CONFLICT"},"errors":{"type":"array","items":{"type":"string"},"example":["resource conflicted"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/assets/{id}":{"get":{"summary":"Get asset by id","tags":["assets"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","example":"asset_00041061050r3gg28a1c60t3gf"}},{"name":"include","in":"query","schema":{"type":"string","example":"account, offering, bonusTiers"}}],"operationId":"getAsset","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"asset_00041061050r3gg28a1c60t3gf"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"name":{"type":"string"},"type":{"type":"string","enum":["BOND","STOCK","PROMISSORY_NOTE"],"nullable":true},"pricePerUnit":{"type":"number","nullable":true},"totalUnits":{"type":"number","nullable":true},"totalAmount":{"type":"number","nullable":true},"yield":{"type":"number","nullable":true},"duration":{"type":"number","nullable":true},"durationType":{"type":"string","enum":["DAYS","WEEKS","MONTHS","YEARS"],"nullable":true},"accountId":{"type":"string"},"account":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"name":{"type":"string","example":"Dalmore"},"status":{"type":"string","enum":["ONBOARDING","LIVE","OVERDUE","SUSPENDED","INACTIVE"],"example":"LIVE"},"managedBy":{"type":"string","enum":["DALMORE","ISSUER"],"nullable":true,"example":"DALMORE"},"platform":{"type":"string","enum":["DALMORE","IMPORT"],"example":"IMPORT"},"onboardingReviewerId":{"type":"string","nullable":true,"example":"user_01j1xgme5mfrasd02hmfwsy13a"},"onboardingReviewAt":{"type":"string","format":"date-time","nullable":true},"allowPendingComplianceReview":{"type":"boolean","example":false}},"required":["id","createdAt","updatedAt","deletedAt","name","status","managedBy","platform","onboardingReviewerId","onboardingReviewAt","allowPendingComplianceReview"],"nullable":true},"offeringId":{"type":"string"},"offering":{"nullable":true},"template":{"type":"string","enum":["STANDARD","TIERED"]},"tiers":{"type":"array","items":{"type":"number","minimum":0,"exclusiveMinimum":0},"nullable":true},"enableBonus":{"type":"boolean"},"interestRate":{"type":"number","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","name","type","pricePerUnit","totalUnits","totalAmount","yield","duration","durationType","accountId","offeringId","template","tiers","enableBonus","interestRate"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]},"put":{"summary":"Update asset","tags":["assets"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","example":"asset_00041061050r3gg28a1c60t3gf"}}],"operationId":"updateAsset","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":50,"example":"Z"},"type":{"type":"string","enum":["BOND","STOCK","PROMISSORY_NOTE"],"example":"STOCK"},"pricePerUnit":{"type":"number","minimum":0.01,"maximum":10000000000,"nullable":true,"example":2000},"totalUnits":{"type":"number","minimum":1,"maximum":10000000000,"nullable":true,"example":5200},"yield":{"type":"number","minimum":0.01,"maximum":10000000000,"nullable":true,"example":1200},"duration":{"type":"number","minimum":1,"maximum":1000,"nullable":true,"example":1},"durationType":{"type":"string","enum":["DAYS","WEEKS","MONTHS","YEARS"],"nullable":true,"example":"DAYS"},"template":{"default":"STANDARD","type":"string","enum":["STANDARD","TIERED"],"example":"STANDARD","nullable":true},"tiers":{"type":"array","items":{"type":"number","minimum":0,"exclusiveMinimum":0},"nullable":true},"enableBonus":{"type":"boolean","example":false},"interestRate":{"type":"number","minimum":0.01,"maximum":100,"nullable":true,"example":10}}}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"asset_00041061050r3gg28a1c60t3gf"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"name":{"type":"string"},"type":{"type":"string","enum":["BOND","STOCK","PROMISSORY_NOTE"],"nullable":true},"pricePerUnit":{"type":"number","nullable":true},"totalUnits":{"type":"number","nullable":true},"totalAmount":{"type":"number","nullable":true},"yield":{"type":"number","nullable":true},"duration":{"type":"number","nullable":true},"durationType":{"type":"string","enum":["DAYS","WEEKS","MONTHS","YEARS"],"nullable":true},"accountId":{"type":"string"},"account":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"name":{"type":"string","example":"Dalmore"},"status":{"type":"string","enum":["ONBOARDING","LIVE","OVERDUE","SUSPENDED","INACTIVE"],"example":"LIVE"},"managedBy":{"type":"string","enum":["DALMORE","ISSUER"],"nullable":true,"example":"DALMORE"},"platform":{"type":"string","enum":["DALMORE","IMPORT"],"example":"IMPORT"},"onboardingReviewerId":{"type":"string","nullable":true,"example":"user_01j1xgme5mfrasd02hmfwsy13a"},"onboardingReviewAt":{"type":"string","format":"date-time","nullable":true},"allowPendingComplianceReview":{"type":"boolean","example":false}},"required":["id","createdAt","updatedAt","deletedAt","name","status","managedBy","platform","onboardingReviewerId","onboardingReviewAt","allowPendingComplianceReview"],"nullable":true},"offeringId":{"type":"string"},"offering":{"nullable":true},"template":{"type":"string","enum":["STANDARD","TIERED"]},"tiers":{"type":"array","items":{"type":"number","minimum":0,"exclusiveMinimum":0},"nullable":true},"enableBonus":{"type":"boolean"},"interestRate":{"type":"number","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","name","type","pricePerUnit","totalUnits","totalAmount","yield","duration","durationType","accountId","offeringId","template","tiers","enableBonus","interestRate"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/auth/register/investor":{"post":{"summary":"Register investor with email (API Key Auth)","tags":["auth"],"parameters":[],"operationId":"registerInvestor","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"firstName":{"type":"string","minLength":2,"maxLength":20,"example":"Neil"},"lastName":{"type":"string","minLength":2,"maxLength":20,"example":"Armstrong"},"email":{"type":"string","format":"email","example":"john.doe@example.com"},"password":{"type":"string","minLength":8,"maxLength":100,"pattern":"^(?=.*[A-Z])(?=.*[a-z])(?=.*\\d)(?=.*[\\W_]).*$","example":"Secretpassword6#"},"confirmPassword":{"type":"string","minLength":8,"maxLength":100,"pattern":"^(?=.*[A-Z])(?=.*[a-z])(?=.*\\d)(?=.*[\\W_]).*$","example":"Secretpassword6#"},"phoneNumber":{"type":"string","nullable":true,"example":"+12124567890"},"site":{"type":"string","minLength":2,"maxLength":253,"example":"func.co"}},"required":["firstName","lastName","email","password","confirmPassword","site"]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string","example":"user_01je6ht4b8fbmttkzh2hs82xqp"}},"required":["userId"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/auth/register/issuer":{"post":{"summary":"Register issuer with email (API Key Auth)","tags":["auth"],"parameters":[],"operationId":"registerIssuer","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"firstName":{"type":"string","minLength":2,"maxLength":20,"example":"Neil"},"lastName":{"type":"string","minLength":2,"maxLength":20,"example":"Armstrong"},"email":{"type":"string","format":"email","example":"john.doe@example.com"},"password":{"type":"string","minLength":8,"maxLength":100,"pattern":"^(?=.*[A-Z])(?=.*[a-z])(?=.*\\d)(?=.*[\\W_]).*$","example":"Secretpassword6#"},"confirmPassword":{"type":"string","minLength":8,"maxLength":100,"pattern":"^(?=.*[A-Z])(?=.*[a-z])(?=.*\\d)(?=.*[\\W_]).*$","example":"Secretpassword6#"},"accountName":{"type":"string","minLength":1,"maxLength":150,"example":"Example Account","nullable":true},"accountType":{"default":"DALMORE","type":"string","enum":["DALMORE","ISSUER"],"example":"DALMORE"}},"required":["firstName","lastName","email","password","confirmPassword"]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"accessToken":{"type":"string","example":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9"},"requiresTwoFactor":{"type":"boolean","example":true},"temporaryToken":{"type":"string","example":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9"},"requiresTwoFactorSetup":{"type":"boolean","example":true},"twoFactorMethod":{"type":"string","enum":["NONE","AUTHENTICATOR","SMS"],"example":"SMS"}}}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/carts":{"get":{"summary":"Get carts (Trade.status = CART)","tags":["cart"],"parameters":[{"name":"userId","in":"query","required":true,"schema":{"type":"string"}}],"operationId":"getTradeCart","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"investorAccountId":{"nullable":true},"investorAccount":{"nullable":true},"offering":{"nullable":true},"accountId":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6","accountId":"account_00041061050r3gg28a1c60t3gf","nullable":true},"account":{"nullable":true},"offeringId":{"nullable":true},"paymentMethodId":{"nullable":true},"paymentMethod":{"nullable":true},"userId":{"nullable":true},"tradeNumber":{"type":"string"},"ip":{"type":"string","nullable":true},"tid":{"type":"string","nullable":true},"investmentType":{"type":"string","enum":["INDIVIDUAL","JOINT","ENTITY"]},"purchasedShares":{"type":"integer"},"bonusShares":{"type":"integer","nullable":true},"totalNumberOfShares":{"type":"integer"},"pricePerShare":{"type":"number","multipleOf":0.01},"lineItems":{"type":"array","items":{}},"adjustments":{"type":"array","items":{}},"transactions":{"type":"array","items":{}},"totalAmount":{"type":"number","multipleOf":0.01,"nullable":true},"tradeStatus":{"type":"string","enum":["CART","PLACED","IN_REVIEW","NEEDS_INFO","NEEDS_PAYMENT_INFO","FUNDING","CANCELLED","SETTLED","IMPORT_ERROR","ERROR","UPDATE_PAYMENT_METHOD"]},"tradeStatusUnmapped":{"type":"string","nullable":true},"tradeDate":{"type":"string","format":"date-time","nullable":true},"saStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW"]},"saStatusUnmapped":{"type":"string","nullable":true},"saUrl":{"type":"string","nullable":true},"saSignedAt":{"type":"string","format":"date-time","nullable":true},"saExtractedNumberOfShares":{"type":"string","nullable":true},"saExtractedTotalAmount":{"type":"string","nullable":true},"saExtractedPricePerShare":{"type":"string","nullable":true},"saExtractedInvestorType":{"type":"string","nullable":true},"saExtractedSigner":{"type":"string","nullable":true},"saExtractedSignatureDate":{"type":"string","format":"date-time","nullable":true},"saExtractedSigner2":{"type":"string","nullable":true},"saExtractedSignatureDate2":{"type":"string","format":"date-time","nullable":true},"saCheck":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"]},"saCheckedAt":{"type":"string","format":"date-time","nullable":true},"saLog":{"type":"object","properties":{"finalStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW"]},"matchResults":{"type":"array","items":{"type":"object","properties":{"tradeLineItemId":{"type":"string","example":"trade_line_item_01kctsycw3fq7sj6hedvy62cja"},"signerName":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"totalAmount":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"investorName":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"numberOfShares":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]}},"required":["tradeLineItemId"]}}},"required":["finalStatus","matchResults"],"nullable":true},"txnTid":{"type":"string","nullable":true},"txnResponse":{"type":"string","nullable":true},"txnPaymentMethod":{"type":"string","enum":["CREDIT_CARD","WIRE","ACH","BANK_ACCOUNT","CHECK","RETIREMENT"],"nullable":true},"txnCurrencyCode":{"type":"string","minLength":3,"maxLength":3,"nullable":true},"txnChargedAmount":{"type":"number","multipleOf":0.01,"nullable":true},"txnDate":{"type":"string","format":"date-time","nullable":true},"txnSettledDate":{"type":"string","format":"date-time","nullable":true},"fundingStatus":{"type":"string","enum":["PENDING","CANCELLED","SETTLED","REFUNDED","DECLINED","FUNDING","AUTHORIZING","FAILED"],"nullable":true},"fundingStatusUnmapped":{"type":"string","nullable":true},"txnCheck":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"],"nullable":true},"txnCheckedAt":{"type":"string","format":"date-time","nullable":true},"txnLog":{"type":"string","nullable":true},"systemReviewCheck":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","WARNING","INCOMPLETE"],"nullable":true},"systemReviewCheckedAt":{"type":"string","format":"date-time","nullable":true},"systemReviewLog":{"type":"string","nullable":true},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"],"nullable":true},"complianceReviewNotes":{"type":"string","nullable":true},"complianceReviewerId":{"type":"string","nullable":true},"issuerId":{"nullable":true},"complianceReviewName":{"type":"string","nullable":true},"complianceReviewAt":{"type":"string","format":"date-time","nullable":true},"tradeType":{"type":"string","enum":["PURCHASE","CONVERSION","TRANSFER"],"nullable":true},"placedAt":{"type":"string","format":"date-time","nullable":true},"platform":{"type":"string"},"cancelledAt":{"type":"string","format":"date-time","nullable":true},"cancelledById":{"type":"string","nullable":true},"cancelledReason":{"type":"string","nullable":true},"cancellationPeriod":{"type":"number","nullable":true},"disbursed":{"type":"boolean"},"tradeAdjustments":{"type":"number","nullable":true},"chargedAmount":{"type":"number","nullable":true},"balance":{"type":"number","nullable":true},"isUncleared24h":{"type":"boolean"},"term":{"type":"number","nullable":true},"exercisePrice":{"type":"number","nullable":true},"warrantPercentage":{"type":"number","nullable":true},"calculationMethod":{"type":"string","enum":["NONE","PRORATA","INCREMENT"],"nullable":true},"incrementThreshold":{"type":"number","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","investorAccountId","accountId","account","offeringId","paymentMethodId","userId","tradeNumber","ip","tid","investmentType","purchasedShares","bonusShares","totalNumberOfShares","pricePerShare","lineItems","adjustments","transactions","totalAmount","tradeStatus","tradeStatusUnmapped","tradeDate","saStatus","saStatusUnmapped","saUrl","saSignedAt","saExtractedNumberOfShares","saExtractedTotalAmount","saExtractedPricePerShare","saExtractedInvestorType","saExtractedSigner","saExtractedSignatureDate","saExtractedSigner2","saExtractedSignatureDate2","saCheck","saCheckedAt","saLog","txnTid","txnResponse","txnPaymentMethod","txnCurrencyCode","txnChargedAmount","txnDate","txnSettledDate","fundingStatus","fundingStatusUnmapped","txnCheck","txnCheckedAt","txnLog","systemReviewCheck","systemReviewCheckedAt","systemReviewLog","complianceReview","complianceReviewNotes","complianceReviewerId","issuerId","complianceReviewName","complianceReviewAt","tradeType","placedAt","platform","cancelledAt","cancelledById","cancelledReason","cancellationPeriod","isUncleared24h","term","exercisePrice","warrantPercentage","calculationMethod","incrementThreshold"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/carts/checkout":{"post":{"summary":"Place a trade (checkout button)","tags":["cart"],"parameters":[],"operationId":"postCheckout","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"}},"required":["userId"]}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"tradeStatus":{"type":"string","enum":["CART","PLACED","IN_REVIEW","NEEDS_INFO","NEEDS_PAYMENT_INFO","FUNDING","CANCELLED","SETTLED","IMPORT_ERROR","ERROR","UPDATE_PAYMENT_METHOD"]},"tradeId":{"type":"string"}}}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/carts/{id}":{"patch":{"summary":"Patch a cart","tags":["cart"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"patchCart","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"investorAccountId":{"type":"string"},"paymentMethodId":{"type":"string"}}}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"investorAccountId":{"nullable":true},"investorAccount":{"nullable":true},"offering":{"nullable":true},"accountId":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6","accountId":"account_00041061050r3gg28a1c60t3gf","nullable":true},"account":{"nullable":true},"offeringId":{"nullable":true},"paymentMethodId":{"nullable":true},"paymentMethod":{"nullable":true},"userId":{"nullable":true},"tradeNumber":{"type":"string"},"ip":{"type":"string","nullable":true},"tid":{"type":"string","nullable":true},"investmentType":{"type":"string","enum":["INDIVIDUAL","JOINT","ENTITY"]},"purchasedShares":{"type":"integer"},"bonusShares":{"type":"integer","nullable":true},"totalNumberOfShares":{"type":"integer"},"pricePerShare":{"type":"number","multipleOf":0.01},"lineItems":{"type":"array","items":{}},"adjustments":{"type":"array","items":{}},"transactions":{"type":"array","items":{}},"totalAmount":{"type":"number","multipleOf":0.01,"nullable":true},"tradeStatus":{"type":"string","enum":["CART","PLACED","IN_REVIEW","NEEDS_INFO","NEEDS_PAYMENT_INFO","FUNDING","CANCELLED","SETTLED","IMPORT_ERROR","ERROR","UPDATE_PAYMENT_METHOD"]},"tradeStatusUnmapped":{"type":"string","nullable":true},"tradeDate":{"type":"string","format":"date-time","nullable":true},"saStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW"]},"saStatusUnmapped":{"type":"string","nullable":true},"saUrl":{"type":"string","nullable":true},"saSignedAt":{"type":"string","format":"date-time","nullable":true},"saExtractedNumberOfShares":{"type":"string","nullable":true},"saExtractedTotalAmount":{"type":"string","nullable":true},"saExtractedPricePerShare":{"type":"string","nullable":true},"saExtractedInvestorType":{"type":"string","nullable":true},"saExtractedSigner":{"type":"string","nullable":true},"saExtractedSignatureDate":{"type":"string","format":"date-time","nullable":true},"saExtractedSigner2":{"type":"string","nullable":true},"saExtractedSignatureDate2":{"type":"string","format":"date-time","nullable":true},"saCheck":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"]},"saCheckedAt":{"type":"string","format":"date-time","nullable":true},"saLog":{"type":"object","properties":{"finalStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW"]},"matchResults":{"type":"array","items":{"type":"object","properties":{"tradeLineItemId":{"type":"string","example":"trade_line_item_01kctsycw3fq7sj6hedvy62cja"},"signerName":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"totalAmount":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"investorName":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"numberOfShares":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]}},"required":["tradeLineItemId"]}}},"required":["finalStatus","matchResults"],"nullable":true},"txnTid":{"type":"string","nullable":true},"txnResponse":{"type":"string","nullable":true},"txnPaymentMethod":{"type":"string","enum":["CREDIT_CARD","WIRE","ACH","BANK_ACCOUNT","CHECK","RETIREMENT"],"nullable":true},"txnCurrencyCode":{"type":"string","minLength":3,"maxLength":3,"nullable":true},"txnChargedAmount":{"type":"number","multipleOf":0.01,"nullable":true},"txnDate":{"type":"string","format":"date-time","nullable":true},"txnSettledDate":{"type":"string","format":"date-time","nullable":true},"fundingStatus":{"type":"string","enum":["PENDING","CANCELLED","SETTLED","REFUNDED","DECLINED","FUNDING","AUTHORIZING","FAILED"],"nullable":true},"fundingStatusUnmapped":{"type":"string","nullable":true},"txnCheck":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"],"nullable":true},"txnCheckedAt":{"type":"string","format":"date-time","nullable":true},"txnLog":{"type":"string","nullable":true},"systemReviewCheck":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","WARNING","INCOMPLETE"],"nullable":true},"systemReviewCheckedAt":{"type":"string","format":"date-time","nullable":true},"systemReviewLog":{"type":"string","nullable":true},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"],"nullable":true},"complianceReviewNotes":{"type":"string","nullable":true},"complianceReviewerId":{"type":"string","nullable":true},"issuerId":{"nullable":true},"complianceReviewName":{"type":"string","nullable":true},"complianceReviewAt":{"type":"string","format":"date-time","nullable":true},"tradeType":{"type":"string","enum":["PURCHASE","CONVERSION","TRANSFER"],"nullable":true},"placedAt":{"type":"string","format":"date-time","nullable":true},"platform":{"type":"string"},"cancelledAt":{"type":"string","format":"date-time","nullable":true},"cancelledById":{"type":"string","nullable":true},"cancelledReason":{"type":"string","nullable":true},"cancellationPeriod":{"type":"number","nullable":true},"disbursed":{"type":"boolean"},"tradeAdjustments":{"type":"number","nullable":true},"chargedAmount":{"type":"number","nullable":true},"balance":{"type":"number","nullable":true},"isUncleared24h":{"type":"boolean"},"term":{"type":"number","nullable":true},"exercisePrice":{"type":"number","nullable":true},"warrantPercentage":{"type":"number","nullable":true},"calculationMethod":{"type":"string","enum":["NONE","PRORATA","INCREMENT"],"nullable":true},"incrementThreshold":{"type":"number","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","investorAccountId","accountId","account","offeringId","paymentMethodId","userId","tradeNumber","ip","tid","investmentType","purchasedShares","bonusShares","totalNumberOfShares","pricePerShare","lineItems","adjustments","transactions","totalAmount","tradeStatus","tradeStatusUnmapped","tradeDate","saStatus","saStatusUnmapped","saUrl","saSignedAt","saExtractedNumberOfShares","saExtractedTotalAmount","saExtractedPricePerShare","saExtractedInvestorType","saExtractedSigner","saExtractedSignatureDate","saExtractedSigner2","saExtractedSignatureDate2","saCheck","saCheckedAt","saLog","txnTid","txnResponse","txnPaymentMethod","txnCurrencyCode","txnChargedAmount","txnDate","txnSettledDate","fundingStatus","fundingStatusUnmapped","txnCheck","txnCheckedAt","txnLog","systemReviewCheck","systemReviewCheckedAt","systemReviewLog","complianceReview","complianceReviewNotes","complianceReviewerId","issuerId","complianceReviewName","complianceReviewAt","tradeType","placedAt","platform","cancelledAt","cancelledById","cancelledReason","cancellationPeriod","isUncleared24h","term","exercisePrice","warrantPercentage","calculationMethod","incrementThreshold"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/csv/investors":{"post":{"summary":"Upload and process CSV file for investor account creation","tags":["csv"],"parameters":[],"operationId":"uploadInvestorCsv","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"totalRows":{"type":"number"},"successfulRows":{"type":"number"},"createdAccounts":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"row":{"type":"number"},"userId":{"type":"string"},"investorAccountId":{"type":"string"}},"required":["row","userId","investorAccountId"]},{"type":"object","properties":{"row":{"type":"number"},"userId":{"type":"string"},"accountId":{"type":"string"}},"required":["row","userId","accountId"]}]}}},"required":["totalRows","successfulRows","createdAccounts"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"422":{"description":"422","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"422"},"message":{"type":"string","example":"UNPROCESSABLE_ENTITY"},"errors":{"type":"array","items":{"type":"string"},"example":["file is required"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/csv/aic":{"post":{"summary":"Upload and process CSV file for AIC questionnaire data","tags":["csv"],"parameters":[{"name":"accredited","in":"query","schema":{"type":"boolean","nullable":true}},{"name":"aicAccreditationType","in":"query","required":true,"schema":{"type":"string","enum":["PENDING","INCOME","NET_WORTH","PROFESSIONAL_CERTIFICATION","KNOWLEDGEABLE_EMPLOYEE"]}},{"name":"investorAccountId","in":"query","required":true,"schema":{"type":"string"}}],"operationId":"uploadAicCsv","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"accountId":{"type":"string"},"account":{},"investorAccountId":{"type":"string"},"investorAccount":{},"role":{"type":"string","enum":["PRIMARY","JOINT"]},"firstName":{"type":"string"},"lastName":{"type":"string","nullable":true},"dob":{"type":"string","format":"date-time","nullable":true},"isUsCitizenOrGreenCardHolder":{"type":"boolean"},"ssn":{"type":"string","nullable":true},"lastFour":{"type":"string","nullable":true},"address":{"type":"string","nullable":true},"address2":{"type":"string","nullable":true},"email":{"type":"string","format":"email","nullable":true},"phone":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"citizenship":{"type":"string","nullable":true},"state":{"type":"string","nullable":true},"zip":{"type":"string","nullable":true},"currencyCode":{"type":"string","minLength":3,"maxLength":3,"nullable":true},"financialAdvisor":{"type":"boolean"},"occupation":{"type":"string","nullable":true},"employmentStatus":{"type":"string","enum":["EMPLOYED","UNEMPLOYED","SELF_EMPLOYED","RETIRED","STUDENT","OTHER"]},"employerName":{"type":"string","nullable":true},"employerAddressLine1":{"type":"string","nullable":true},"employerAddressLine2":{"type":"string","nullable":true},"employerCity":{"type":"string","nullable":true},"employerState":{"type":"string","nullable":true},"employerZip":{"type":"string","nullable":true},"employerCountry":{"type":"string","nullable":true},"kycDocumentType":{"type":"string","enum":["PASSPORT","DRIVER_LICENSE","STATE_ID"],"nullable":true},"kycDocumentIssuer":{"type":"string","nullable":true},"kycExpirationDate":{"type":"string","nullable":true},"kycIssuerDate":{"type":"string","nullable":true},"kycDocumentNumber":{"type":"string","nullable":true},"kycFirstName":{"type":"string","nullable":true},"kycLastName":{"type":"string","nullable":true},"ownership":{"type":"number","nullable":true},"householdNetWorth":{"type":"number","nullable":true},"liquidNetWorth":{"type":"number","multipleOf":0.01,"nullable":true},"currentHouseholdIncome":{"type":"number","nullable":true},"currentAnnualIncome":{"type":"number","nullable":true},"investedInCrowdfunding":{"type":"number","nullable":true},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]},"setupStep":{"type":"string","enum":["NEW","PERSONAL_INFO","ADDRESS","KYC","INCOME","AIC_QUESTIONS","AIC_FILES"]},"sourceOfIncome":{"type":"string","enum":["EMPLOYED","SELF_EMPLOYED","UNEMPLOYED","RETIREMENT","STUDENT"],"nullable":true},"aicQuestionnaire":{"type":"string","nullable":true},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"]},"kycProvider":{"type":"string","nullable":true},"kycTid":{"type":"string","nullable":true},"aicAccreditationType":{"type":"string","enum":["PENDING","INCOME","NET_WORTH","PROFESSIONAL_CERTIFICATION","KNOWLEDGEABLE_EMPLOYEE"]},"accredited":{"type":"boolean"},"retirementAccountType":{"type":"string","enum":["SELF_DIRECTED","CUSTODIAN_MANAGED"],"nullable":true},"custodianName":{"type":"string","nullable":true},"custodianAccountNumber":{"type":"string","nullable":true},"custodianRepresentativeName":{"type":"string","nullable":true},"custodianEmail":{"type":"string","format":"email","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","tid","accountId","investorAccountId","role","firstName","lastName","dob","isUsCitizenOrGreenCardHolder","ssn","lastFour","address","address2","email","phone","city","country","citizenship","state","zip","currencyCode","financialAdvisor","occupation","employmentStatus","employerName","employerAddressLine1","employerAddressLine2","employerCity","employerState","employerZip","employerCountry","kycDocumentType","kycDocumentIssuer","kycExpirationDate","kycIssuerDate","kycDocumentNumber","kycFirstName","kycLastName","ownership","householdNetWorth","liquidNetWorth","currentHouseholdIncome","currentAnnualIncome","investedInCrowdfunding","setupStatus","setupStep","sourceOfIncome","aicQuestionnaire","kycStatus","kycProvider","kycTid","aicAccreditationType","accredited","retirementAccountType","custodianName","custodianAccountNumber","custodianRepresentativeName","custodianEmail"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/csv/kyc":{"post":{"summary":"Upload and process CSV file for KYC data","tags":["csv"],"parameters":[{"name":"individualId","in":"query","required":true,"schema":{"type":"string"}},{"name":"frontFileId","in":"query","required":true,"schema":{"type":"string"}},{"name":"backFileId","in":"query","schema":{"type":"string"}},{"name":"selfieFileId","in":"query","schema":{"type":"string"}}],"operationId":"uploadKycCsv","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"platform":{"type":"string","example":"KYC Platform"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Passport"},"documentImage":{"type":"string","example":"https://example.com/passport.jpg"},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Document unclear"},"response":{"type":"string","nullable":true,"example":"Submitted clearer document"}},"required":["id","createdAt","updatedAt","deletedAt","tid","platform","individualId","documentType","documentImage","kycStatus","reason","response"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/csv/issuers":{"post":{"summary":"Upload and process CSV file for issuer account creation","tags":["csv"],"parameters":[],"operationId":"uploadIssuerCsv","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"totalRows":{"type":"number"},"successfulRows":{"type":"number"},"createdAccounts":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"row":{"type":"number"},"userId":{"type":"string"},"investorAccountId":{"type":"string"}},"required":["row","userId","investorAccountId"]},{"type":"object","properties":{"row":{"type":"number"},"userId":{"type":"string"},"accountId":{"type":"string"}},"required":["row","userId","accountId"]}]}}},"required":["totalRows","successfulRows","createdAccounts"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"422":{"description":"422","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"422"},"message":{"type":"string","example":"UNPROCESSABLE_ENTITY"},"errors":{"type":"array","items":{"type":"string"},"example":["file is required"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/csv/offering":{"post":{"summary":"Upload and process CSV file for offering creation","tags":["csv"],"parameters":[{"name":"issuerId","in":"query","required":true,"schema":{"type":"string","example":"issuer_01jdq2crwke8xskjd840cj79pw"}}],"operationId":"uploadOfferingCsv","responses":{"200":{"description":"200","content":{"application/json":{"schema":{}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/files":{"post":{"description":"Upload a file to the system. CLIENT portal only supports uploads to INDIVIDUALS.\n\n### Example curl request\n\n```bash\ncurl -X POST 'https://dalmore-client-portal-api-prod.onrender.com/api/v1/files?name=test&category=application&targetId=individual_01j5tkg6k2fygr0x06fegt27aj' \\\n  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9' \\\n  --form 'file=@\"/Users/local/Desktop/test.csv\"'\n```","summary":"Upload a file","tags":["files"],"parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":100,"example":"file_name"}},{"name":"category","in":"query","required":true,"schema":{"type":"string","maxLength":50,"example":"application"}},{"name":"label","in":"query","required":true,"schema":{"type":"string","enum":["PROOF_OF_INCOME","PROOF_OF_NET_WORTH","EMPLOYEE","TAX_RETURNS","ACCOUNT_STATEMENT","ACCREDITATION_LETTER","LICENSE","IDENTITY_FRONT","IDENTITY_BACK","BAD_ACTOR_REPORT_FILE","OTHER","COMPLIANCE_REQUEST","SUB_DOC","CONTENT_FILE","CSV_EXPORT_FILE","CUSTODIAN_INSTRUCTION_DOCUMENT","LOGO","FAVICON","BACKGROUND_IMAGE","MEMORANDUM","SUBSCRIPTION_AGREEMENT","COVER_ART","ESCROW_AGREEMENT","SS4_LETTER","FORMATION_DOCUMENT","PASSPORT","TRADE_DOCUMENT"],"example":"OTHER"}},{"name":"targetId","in":"query","required":true,"schema":{"oneOf":[{"type":"string"},{"type":"string"}],"example":"individual_01kcrsny60fb9rjc8bbqc3b80c"}},{"name":"metadata","in":"query","schema":{"type":"string","minLength":2,"maxLength":600000,"nullable":true}}],"operationId":"postFile","responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"url":{"type":"string","format":"uri","example":"https://file-location.com"},"fileType":{"type":"string","example":"pdf"},"fileName":{"type":"string","example":"test.pdf"},"name":{"type":"string","example":"test"},"category":{"type":"string","example":"application"},"label":{"type":"string","example":"other"},"private":{"type":"boolean"},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"]},"targetTable":{"type":"string","enum":["KYCS","AMLS","AICS","KYBS","INDIVIDUALS","LEGAL_ENTITIES","INVESTOR_ACCOUNTS","TRADES","OFFERINGS","ISSUERS","COVERED_PERSONS","PAYMENT_METHODS","NOTES","USERS","ACCOUNTS","PAGES","TASKS","FILES","DATA_RECORD_FILES","ASSETS","SITES","PAGE_REVISIONS","TRADE_LINE_ITEMS","TRANSACTIONS","DISBURSEMENTS","DISBURSEMENT_REVIEWS","ISSUER_PAYMENT_METHODS","SIGNER_BRANDS","THEMES","THEME_SETTINGS","CAP_TABLES","CAP_TABLE_SHARE_CLASSES","CAP_TABLE_ENTRIES","EMAIL_THEMES","EMAIL_THEME_SETTINGS"],"nullable":true},"targetId":{"type":"string","nullable":true},"linkedFrom":{"type":"string","nullable":true},"accountId":{"type":"string","example":"account_01j6aqmtfyfwy9spjdcnh7yqk7"},"userId":{"type":"string","example":"user_01j6aqmtfyfwy9spjdcnh7yqk7"},"kycs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"platform":{"type":"string","example":"KYC Platform"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Passport"},"documentImage":{"type":"string","example":"https://example.com/passport.jpg"},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Document unclear"},"response":{"type":"string","nullable":true,"example":"Submitted clearer document"}},"required":["id","createdAt","updatedAt","deletedAt","tid","platform","individualId","documentType","documentImage","kycStatus","reason","response"]},"nullable":true},"kybs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_kyb_123"},"platform":{"type":"string","example":"KYB Platform"},"legalEntityId":{"type":"string","example":"legal_entity_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Certificate of Incorporation"},"documentImage":{"type":"string","example":"https://example.com/document.pdf"},"kybStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Additional information required"},"response":{"type":"string","nullable":true,"example":"Submitted additional documents"}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","platform","legalEntityId","documentType","documentImage","kybStatus","reason","response"]},"nullable":true},"individuals":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"accountId":{"type":"string"},"account":{},"investorAccountId":{"type":"string"},"investorAccount":{},"role":{"type":"string","enum":["PRIMARY","JOINT"]},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"]},"kycFirstName":{"type":"string","nullable":true},"kycLastName":{"type":"string","nullable":true},"kycDocumentType":{"type":"string","enum":["PASSPORT","DRIVER_LICENSE","STATE_ID"],"nullable":true},"kycDocumentIssuer":{"type":"string","nullable":true},"kycDocumentNumber":{"type":"string","nullable":true},"kycIssuerDate":{"type":"string","nullable":true},"kycExpirationDate":{"type":"string","nullable":true},"kycCheck":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"]},"kycCheckedAt":{"type":"string","format":"date-time","nullable":true},"kycLog":{"type":"string","nullable":true},"kycReviewedById":{"type":"string","nullable":true},"kycReviewedAt":{"type":"string","format":"date-time","nullable":true},"kycDocumentFrontFileId":{"type":"string","nullable":true},"kycDocumentFrontFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"kycDocumentBackFileId":{"type":"string","nullable":true},"kycDocumentBackFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"kycSelfieFileId":{"type":"string","nullable":true},"kycSelfieFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"sanctionsStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"]},"amlStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","ERROR"]},"amlProvider":{"type":"string","enum":["ComplyAdvantage"],"nullable":true},"amlTid":{"type":"string","nullable":true},"amlUrl":{"type":"string","nullable":true},"amlCheckedAt":{"type":"string","format":"date-time","nullable":true},"amlLog":{"type":"string","nullable":true},"amlLogData":{"type":"string","nullable":true},"amlReviewedById":{"type":"string","nullable":true},"amlReviewedAt":{"type":"string","format":"date-time","nullable":true},"liquidNetWorth":{"type":"number","multipleOf":0.01,"nullable":true},"liquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"illiquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"privateSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"aicAccreditationType":{"type":"string","enum":["PENDING","INCOME","NET_WORTH","PROFESSIONAL_CERTIFICATION","KNOWLEDGEABLE_EMPLOYEE"]},"aicExpirationDate":{"type":"string","format":"date-time","nullable":true},"aicQuestionnaire":{"type":"string","nullable":true},"aicStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","PROCESSED"]},"aicCheckedAt":{"type":"string","format":"date-time","nullable":true},"aicLog":{"type":"string","nullable":true},"aicReviewedById":{"type":"string","nullable":true},"aicReviewedAt":{"type":"string","format":"date-time","nullable":true},"iraQuestionnaire":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"hasIraAccounts":{"type":"boolean"},"inSelfDirectedIra":{"type":"boolean"},"custodian":{"type":"string"},"hasOtherQualifiedFunds":{"type":"boolean"}},"required":["id","hasIraAccounts","inSelfDirectedIra","custodian","hasOtherQualifiedFunds"]},"nullable":true},"iraCheck":{"type":"string","enum":["PENDING","APPROVED","NEEDS_REVIEW","REJECTED"]},"iraCheckedAt":{"type":"string","format":"date-time","nullable":true},"iraLog":{"type":"string","nullable":true},"iraReviewedById":{"type":"string","nullable":true},"iraReviewedAt":{"type":"string","format":"date-time","nullable":true},"firstName":{"type":"string"},"lastName":{"type":"string","nullable":true},"dob":{"type":"string","format":"date-time","nullable":true},"isUsCitizenOrGreenCardHolder":{"type":"boolean"},"citizenship":{"type":"string","enum":["AD","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","CU","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","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","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","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","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","YE","YT","ZA","ZM","ZW"],"nullable":true},"ssn":{"type":"string","nullable":true},"lastFour":{"type":"string","nullable":true},"address":{"type":"string","nullable":true},"address2":{"type":"string","nullable":true},"email":{"type":"string","format":"email","nullable":true},"phone":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"state":{"type":"string","nullable":true},"zip":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"kycTid":{"type":"string","nullable":true},"currencyCode":{"type":"string","minLength":3,"maxLength":3,"nullable":true},"investedInCrowdfunding":{"type":"number","nullable":true},"currentAnnualIncome":{"type":"number","nullable":true},"averageAnnualIncome":{"type":"number","nullable":true},"averageHouseholdIncome":{"type":"number","nullable":true},"currentHouseholdIncome":{"type":"number","nullable":true},"householdNetWorth":{"type":"number","nullable":true},"isSolicited":{"type":"boolean"},"isRealEstate":{"type":"boolean"},"iliquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"timeHorizon":{"type":"string","nullable":true},"riskTolerance":{"type":"string","nullable":true},"investmentObjective":{"type":"string","nullable":true},"investmentExperience":{"type":"string","nullable":true},"experienceInPrivate":{"type":"string","nullable":true},"levelOfEducation":{"type":"string","nullable":true},"financialAdvisor":{"type":"boolean"},"occupation":{"type":"string","nullable":true},"employmentStatus":{"type":"string","enum":["EMPLOYED","UNEMPLOYED","SELF_EMPLOYED","RETIRED","STUDENT","OTHER"]},"employerName":{"type":"string","nullable":true},"employerAddressLine1":{"type":"string","nullable":true},"employerAddressLine2":{"type":"string","nullable":true},"employerCity":{"type":"string","nullable":true},"employerState":{"type":"string","nullable":true},"employerZip":{"type":"string","nullable":true},"employerCountry":{"type":"string","nullable":true},"notes":{"type":"string","nullable":true},"kycs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"platform":{"type":"string","example":"KYC Platform"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Passport"},"documentImage":{"type":"string","example":"https://example.com/passport.jpg"},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Document unclear"},"response":{"type":"string","nullable":true,"example":"Submitted clearer document"}},"required":["id","createdAt","updatedAt","deletedAt","tid","platform","individualId","documentType","documentImage","kycStatus","reason","response"]},"nullable":true},"amls":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"provider":{"type":"string","nullable":true,"example":"AML Provider"},"url":{"type":"string","nullable":true,"example":"https://example.com/aml"},"status":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","ERROR"],"example":"PENDING"},"checkedAt":{"type":"string","format":"date-time","nullable":true,"example":"2022-01-01T00:00:00Z"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"}},"required":["id","createdAt","updatedAt","deletedAt","tid","provider","url","status","checkedAt","individualId"]},"nullable":true},"aics":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"individualId":{},"individual":{"nullable":true},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"]},"reviewedById":{"nullable":true},"reviewedBy":{"nullable":true},"reviewedAt":{"type":"string","format":"date-time","nullable":true},"systemReview":{"type":"string","enum":["PENDING","NEEDS_INFO","READY_TO_APPROVE","NEEDS_REVIEW","APPROVED","REJECTED"]},"systemLog":{"type":"array","items":{"type":"object","properties":{"check":{"type":"string","minLength":1},"entered":{"type":"number"},"extracted":{"type":"number"},"result":{"type":"string","enum":["PASS","FAIL"]},"reason":{"type":"string"}},"required":["check","result"]},"nullable":true},"firstName":{"type":"string"},"lastName":{"type":"string"},"method":{"type":"string","enum":["PENDING","INCOME","NET_WORTH","PROFESSIONAL_CERTIFICATION","KNOWLEDGEABLE_EMPLOYEE"]},"incomeData":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer","minimum":2020,"maximum":2025},"filingStatus":{"type":"string","enum":["SINGLE","JOINT"]},"income":{"type":"number","minimum":0,"multipleOf":0.01},"fileId":{}},"required":["year","filingStatus","income","fileId"]},"nullable":true},"netWorthData":{"type":"array","items":{"type":"object","properties":{"institution":{"type":"string","minLength":1,"maxLength":100},"accountType":{"type":"string","enum":["CHECKING","SAVINGS","BROKERAGE","REAL_ESTATE","OTHER"]},"balance":{"type":"number","minimum":0,"multipleOf":0.01},"fileId":{}},"required":["institution","accountType","balance","fileId"]},"nullable":true},"professionalData":{"type":"array","items":{"type":"object","properties":{"professionalType":{"type":"string","enum":["SECURITIES_LICENSES","DIRECTORS","FAMILY_OFFICE"]},"licenseNumber":{"type":"string","minLength":1,"maxLength":50,"nullable":true},"fileId":{"nullable":true}},"required":["professionalType"]},"nullable":true},"employeeData":{"type":"array","items":{"type":"object","properties":{"position":{"type":"string","minLength":1,"maxLength":100},"fileId":{}},"required":["position","fileId"]},"nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","individualId","complianceReview","reviewedById","reviewedAt","systemReview","systemLog","firstName","lastName","method","incomeData","netWorthData","professionalData","employeeData"]},"nullable":true},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]},"setupStep":{"type":"string","enum":["NEW","PERSONAL_INFO","ADDRESS","KYC","INCOME","AIC_QUESTIONS","AIC_FILES"]},"sourceOfIncome":{"type":"string","enum":["EMPLOYED","SELF_EMPLOYED","UNEMPLOYED","RETIREMENT","STUDENT"],"nullable":true},"ownership":{"type":"number","nullable":true},"kycProvider":{"type":"string","nullable":true},"retirementAccountType":{"type":"string","enum":["SELF_DIRECTED","CUSTODIAN_MANAGED"],"nullable":true},"custodianName":{"type":"string","nullable":true},"custodianAccountNumber":{"type":"string","nullable":true},"custodianRepresentativeName":{"type":"string","nullable":true},"custodianEmail":{"type":"string","format":"email","nullable":true},"accredited":{"type":"boolean"}},"required":["id","createdAt","updatedAt","deletedAt","tid","accountId","investorAccountId","role","kycStatus","kycFirstName","kycLastName","kycDocumentType","kycDocumentIssuer","kycDocumentNumber","kycIssuerDate","kycExpirationDate","kycCheck","kycCheckedAt","kycLog","kycReviewedById","kycReviewedAt","kycDocumentFrontFileId","kycDocumentBackFileId","kycSelfieFileId","sanctionsStatus","amlStatus","amlProvider","amlTid","amlUrl","amlCheckedAt","amlLog","amlLogData","amlReviewedById","amlReviewedAt","liquidNetWorth","liquidSecurities","illiquidSecurities","privateSecurities","aicAccreditationType","aicExpirationDate","aicQuestionnaire","aicStatus","aicCheckedAt","aicLog","aicReviewedById","aicReviewedAt","iraQuestionnaire","iraCheck","iraCheckedAt","iraLog","iraReviewedById","iraReviewedAt","firstName","lastName","dob","isUsCitizenOrGreenCardHolder","ssn","lastFour","address","address2","email","phone","city","state","zip","country","kycTid","currencyCode","investedInCrowdfunding","currentAnnualIncome","averageAnnualIncome","averageHouseholdIncome","currentHouseholdIncome","householdNetWorth","isSolicited","isRealEstate","timeHorizon","riskTolerance","investmentObjective","investmentExperience","experienceInPrivate","levelOfEducation","financialAdvisor","occupation","employmentStatus","employerName","employerAddressLine1","employerAddressLine2","employerCity","employerState","employerZip","employerCountry","notes","setupStatus","setupStep","sourceOfIncome","ownership","kycProvider","accredited"]},"nullable":true},"legalEntities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_legal_entity_123","nullable":true},"accountId":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6"},"investorAccountId":{"type":"string","example":"investor_account_01j1xgme5qeqq97gpdztd7e4a7"},"kybStatus":{"example":"PENDING"},"sanctionsStatus":{"example":"PENDING"},"kybs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_kyb_123"},"platform":{"type":"string","example":"KYB Platform"},"legalEntityId":{"type":"string","example":"legal_entity_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Certificate of Incorporation"},"documentImage":{"type":"string","example":"https://example.com/document.pdf"},"kybStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Additional information required"},"response":{"type":"string","nullable":true,"example":"Submitted additional documents"}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","platform","legalEntityId","documentType","documentImage","kybStatus","reason","response"]}},"name":{"type":"string","example":"Acme Corporation"},"ein":{"type":"string","example":"12-3456789","nullable":true},"companyType":{"type":"string","example":"LLC","nullable":true},"streetAddress":{"type":"string","example":"123 Main St","nullable":true},"city":{"type":"string","example":"Anytown","nullable":true},"state":{"type":"string","example":"CA","nullable":true},"zip":{"type":"string","example":"12345","nullable":true},"country":{"type":"string","example":"USA","nullable":true},"phone":{"type":"string","example":"+12124567890","nullable":true},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","accountId","investorAccountId","kybStatus","sanctionsStatus","name","state","setupStatus"]},"nullable":true},"investorAccounts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"investorAccountType":{"type":"string","enum":["INDIVIDUAL","JOINT","RETIREMENT","LEGAL_ENTITY"]},"user":{"nullable":true},"userId":{"type":"string","nullable":true},"email":{"type":"string","format":"email","nullable":true},"name":{"type":"string","nullable":true},"regAQualified":{"type":"boolean"},"regCfQualified":{"type":"boolean"},"regDQualified":{"type":"boolean"},"accountId":{"type":"string"},"account":{},"trades":{"type":"array","items":{}},"individuals":{"type":"array","items":{}},"legalEntities":{"type":"array","items":{}},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]},"systemReviewLog":{"type":"string","nullable":true},"totalAmount":{"type":"number"},"statusCheck":{},"trustedContacts":{"type":"array","items":{}}},"required":["id","createdAt","updatedAt","deletedAt","tid","investorAccountType","regAQualified","regCfQualified","regDQualified","accountId","setupStatus","systemReviewLog"]},"nullable":true},"trades":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"investorAccountId":{"nullable":true},"investorAccount":{"nullable":true},"offering":{"nullable":true},"accountId":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6","accountId":"account_00041061050r3gg28a1c60t3gf","nullable":true},"account":{"nullable":true},"offeringId":{"nullable":true},"paymentMethodId":{"nullable":true},"paymentMethod":{"nullable":true},"userId":{"nullable":true},"tradeNumber":{"type":"string"},"ip":{"type":"string","nullable":true},"tid":{"type":"string","nullable":true},"investmentType":{"type":"string","enum":["INDIVIDUAL","JOINT","ENTITY"]},"purchasedShares":{"type":"integer"},"bonusShares":{"type":"integer","nullable":true},"totalNumberOfShares":{"type":"integer"},"pricePerShare":{"type":"number","multipleOf":0.01},"lineItems":{"type":"array","items":{}},"adjustments":{"type":"array","items":{}},"transactions":{"type":"array","items":{}},"totalAmount":{"type":"number","multipleOf":0.01,"nullable":true},"tradeStatus":{"type":"string","enum":["CART","PLACED","IN_REVIEW","NEEDS_INFO","NEEDS_PAYMENT_INFO","FUNDING","CANCELLED","SETTLED","IMPORT_ERROR","ERROR","UPDATE_PAYMENT_METHOD"]},"tradeStatusUnmapped":{"type":"string","nullable":true},"tradeDate":{"type":"string","format":"date-time","nullable":true},"saStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW"]},"saStatusUnmapped":{"type":"string","nullable":true},"saUrl":{"type":"string","nullable":true},"saSignedAt":{"type":"string","format":"date-time","nullable":true},"saExtractedNumberOfShares":{"type":"string","nullable":true},"saExtractedTotalAmount":{"type":"string","nullable":true},"saExtractedPricePerShare":{"type":"string","nullable":true},"saExtractedInvestorType":{"type":"string","nullable":true},"saExtractedSigner":{"type":"string","nullable":true},"saExtractedSignatureDate":{"type":"string","format":"date-time","nullable":true},"saExtractedSigner2":{"type":"string","nullable":true},"saExtractedSignatureDate2":{"type":"string","format":"date-time","nullable":true},"saCheck":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"]},"saCheckedAt":{"type":"string","format":"date-time","nullable":true},"saLog":{"type":"object","properties":{"finalStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW"]},"matchResults":{"type":"array","items":{"type":"object","properties":{"tradeLineItemId":{"type":"string","example":"trade_line_item_01kctsycw3fq7sj6hedvy62cja"},"signerName":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"totalAmount":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"investorName":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"numberOfShares":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]}},"required":["tradeLineItemId"]}}},"required":["finalStatus","matchResults"],"nullable":true},"txnTid":{"type":"string","nullable":true},"txnResponse":{"type":"string","nullable":true},"txnPaymentMethod":{"type":"string","enum":["CREDIT_CARD","WIRE","ACH","BANK_ACCOUNT","CHECK","RETIREMENT"],"nullable":true},"txnCurrencyCode":{"type":"string","minLength":3,"maxLength":3,"nullable":true},"txnChargedAmount":{"type":"number","multipleOf":0.01,"nullable":true},"txnDate":{"type":"string","format":"date-time","nullable":true},"txnSettledDate":{"type":"string","format":"date-time","nullable":true},"fundingStatus":{"type":"string","enum":["PENDING","CANCELLED","SETTLED","REFUNDED","DECLINED","FUNDING","AUTHORIZING","FAILED"],"nullable":true},"fundingStatusUnmapped":{"type":"string","nullable":true},"txnCheck":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"],"nullable":true},"txnCheckedAt":{"type":"string","format":"date-time","nullable":true},"txnLog":{"type":"string","nullable":true},"systemReviewCheck":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","WARNING","INCOMPLETE"],"nullable":true},"systemReviewCheckedAt":{"type":"string","format":"date-time","nullable":true},"systemReviewLog":{"type":"string","nullable":true},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"],"nullable":true},"complianceReviewNotes":{"type":"string","nullable":true},"complianceReviewerId":{"type":"string","nullable":true},"issuerId":{"nullable":true},"complianceReviewName":{"type":"string","nullable":true},"complianceReviewAt":{"type":"string","format":"date-time","nullable":true},"tradeType":{"type":"string","enum":["PURCHASE","CONVERSION","TRANSFER"],"nullable":true},"placedAt":{"type":"string","format":"date-time","nullable":true},"platform":{"type":"string"},"cancelledAt":{"type":"string","format":"date-time","nullable":true},"cancelledById":{"type":"string","nullable":true},"cancelledReason":{"type":"string","nullable":true},"cancellationPeriod":{"type":"number","nullable":true},"disbursed":{"type":"boolean"},"tradeAdjustments":{"type":"number","nullable":true},"chargedAmount":{"type":"number","nullable":true},"balance":{"type":"number","nullable":true},"isUncleared24h":{"type":"boolean"},"term":{"type":"number","nullable":true},"exercisePrice":{"type":"number","nullable":true},"warrantPercentage":{"type":"number","nullable":true},"calculationMethod":{"type":"string","enum":["NONE","PRORATA","INCREMENT"],"nullable":true},"incrementThreshold":{"type":"number","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","investorAccountId","accountId","account","offeringId","paymentMethodId","userId","tradeNumber","ip","tid","investmentType","purchasedShares","bonusShares","totalNumberOfShares","pricePerShare","lineItems","adjustments","transactions","totalAmount","tradeStatus","tradeStatusUnmapped","tradeDate","saStatus","saStatusUnmapped","saUrl","saSignedAt","saExtractedNumberOfShares","saExtractedTotalAmount","saExtractedPricePerShare","saExtractedInvestorType","saExtractedSigner","saExtractedSignatureDate","saExtractedSigner2","saExtractedSignatureDate2","saCheck","saCheckedAt","saLog","txnTid","txnResponse","txnPaymentMethod","txnCurrencyCode","txnChargedAmount","txnDate","txnSettledDate","fundingStatus","fundingStatusUnmapped","txnCheck","txnCheckedAt","txnLog","systemReviewCheck","systemReviewCheckedAt","systemReviewLog","complianceReview","complianceReviewNotes","complianceReviewerId","issuerId","complianceReviewName","complianceReviewAt","tradeType","placedAt","platform","cancelledAt","cancelledById","cancelledReason","cancellationPeriod","isUncleared24h","term","exercisePrice","warrantPercentage","calculationMethod","incrementThreshold"]},"nullable":true},"metadata":{"type":"string","nullable":true},"status":{"type":"string","enum":["PENDING","ERROR","VALID","INVALID","NOT_PROCESSED","PROCESSING","PROCESSING_ERROR","REVIEW_ERROR","PROCESSED"]},"reviewLog":{"type":"string","nullable":true},"pipeline":{"type":"string","enum":["NONE","SUBDOCS_PHOENIX","SUBDOCS_GENERAL","AIC_TAX_RETURNS","AIC_ACCOUNT_STATEMENTS","PAY_STUBS"]},"errorMessage":{"type":"string","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","tid","url","fileType","fileName","name","category","label","private","complianceReview","targetTable","targetId","linkedFrom","accountId","userId","metadata","status","reviewLog","pipeline","errorMessage"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"422":{"description":"422","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"422"},"message":{"type":"string","example":"UNPROCESSABLE_ENTITY"},"errors":{"type":"array","items":{"type":"string"},"example":["file is required"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}},"502":{"description":"502","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"502"},"message":{"type":"string","example":"BAD_GATEWAY"},"errors":{"type":"array","items":{"type":"string"},"example":["bad gateway"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]},"get":{"summary":"Get files","tags":["files"],"parameters":[{"name":"page","in":"query","schema":{"default":1,"type":"number","nullable":true}},{"name":"limit","in":"query","schema":{"default":10,"type":"number","nullable":true}},{"name":"include","in":"query","schema":{"type":"string","example":"user,account"}},{"name":"targetTable","in":"query","schema":{"type":"string","enum":["KYCS","AMLS","AICS","KYBS","INDIVIDUALS","LEGAL_ENTITIES","INVESTOR_ACCOUNTS","TRADES","OFFERINGS","ISSUERS","COVERED_PERSONS","PAYMENT_METHODS","NOTES","USERS","ACCOUNTS","PAGES","TASKS","FILES","DATA_RECORD_FILES","ASSETS","SITES","PAGE_REVISIONS","TRADE_LINE_ITEMS","TRANSACTIONS","DISBURSEMENTS","DISBURSEMENT_REVIEWS","ISSUER_PAYMENT_METHODS","SIGNER_BRANDS","THEMES","THEME_SETTINGS","CAP_TABLES","CAP_TABLE_SHARE_CLASSES","CAP_TABLE_ENTRIES","EMAIL_THEMES","EMAIL_THEME_SETTINGS"]}},{"name":"targetId","in":"query","schema":{"type":"string"}}],"operationId":"getFiles","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"url":{"type":"string","format":"uri","example":"https://file-location.com"},"fileType":{"type":"string","example":"pdf"},"fileName":{"type":"string","example":"test.pdf"},"name":{"type":"string","example":"test"},"category":{"type":"string","example":"application"},"label":{"type":"string","example":"other"},"private":{"type":"boolean"},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"]},"targetTable":{"type":"string","enum":["KYCS","AMLS","AICS","KYBS","INDIVIDUALS","LEGAL_ENTITIES","INVESTOR_ACCOUNTS","TRADES","OFFERINGS","ISSUERS","COVERED_PERSONS","PAYMENT_METHODS","NOTES","USERS","ACCOUNTS","PAGES","TASKS","FILES","DATA_RECORD_FILES","ASSETS","SITES","PAGE_REVISIONS","TRADE_LINE_ITEMS","TRANSACTIONS","DISBURSEMENTS","DISBURSEMENT_REVIEWS","ISSUER_PAYMENT_METHODS","SIGNER_BRANDS","THEMES","THEME_SETTINGS","CAP_TABLES","CAP_TABLE_SHARE_CLASSES","CAP_TABLE_ENTRIES","EMAIL_THEMES","EMAIL_THEME_SETTINGS"],"nullable":true},"targetId":{"type":"string","nullable":true},"linkedFrom":{"type":"string","nullable":true},"accountId":{"type":"string","example":"account_01j6aqmtfyfwy9spjdcnh7yqk7"},"userId":{"type":"string","example":"user_01j6aqmtfyfwy9spjdcnh7yqk7"},"kycs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"platform":{"type":"string","example":"KYC Platform"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Passport"},"documentImage":{"type":"string","example":"https://example.com/passport.jpg"},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Document unclear"},"response":{"type":"string","nullable":true,"example":"Submitted clearer document"}},"required":["id","createdAt","updatedAt","deletedAt","tid","platform","individualId","documentType","documentImage","kycStatus","reason","response"]},"nullable":true},"kybs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_kyb_123"},"platform":{"type":"string","example":"KYB Platform"},"legalEntityId":{"type":"string","example":"legal_entity_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Certificate of Incorporation"},"documentImage":{"type":"string","example":"https://example.com/document.pdf"},"kybStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Additional information required"},"response":{"type":"string","nullable":true,"example":"Submitted additional documents"}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","platform","legalEntityId","documentType","documentImage","kybStatus","reason","response"]},"nullable":true},"individuals":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"accountId":{"type":"string"},"account":{},"investorAccountId":{"type":"string"},"investorAccount":{},"role":{"type":"string","enum":["PRIMARY","JOINT"]},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"]},"kycFirstName":{"type":"string","nullable":true},"kycLastName":{"type":"string","nullable":true},"kycDocumentType":{"type":"string","enum":["PASSPORT","DRIVER_LICENSE","STATE_ID"],"nullable":true},"kycDocumentIssuer":{"type":"string","nullable":true},"kycDocumentNumber":{"type":"string","nullable":true},"kycIssuerDate":{"type":"string","nullable":true},"kycExpirationDate":{"type":"string","nullable":true},"kycCheck":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"]},"kycCheckedAt":{"type":"string","format":"date-time","nullable":true},"kycLog":{"type":"string","nullable":true},"kycReviewedById":{"type":"string","nullable":true},"kycReviewedAt":{"type":"string","format":"date-time","nullable":true},"kycDocumentFrontFileId":{"type":"string","nullable":true},"kycDocumentFrontFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"kycDocumentBackFileId":{"type":"string","nullable":true},"kycDocumentBackFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"kycSelfieFileId":{"type":"string","nullable":true},"kycSelfieFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"sanctionsStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"]},"amlStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","ERROR"]},"amlProvider":{"type":"string","enum":["ComplyAdvantage"],"nullable":true},"amlTid":{"type":"string","nullable":true},"amlUrl":{"type":"string","nullable":true},"amlCheckedAt":{"type":"string","format":"date-time","nullable":true},"amlLog":{"type":"string","nullable":true},"amlLogData":{"type":"string","nullable":true},"amlReviewedById":{"type":"string","nullable":true},"amlReviewedAt":{"type":"string","format":"date-time","nullable":true},"liquidNetWorth":{"type":"number","multipleOf":0.01,"nullable":true},"liquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"illiquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"privateSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"aicAccreditationType":{"type":"string","enum":["PENDING","INCOME","NET_WORTH","PROFESSIONAL_CERTIFICATION","KNOWLEDGEABLE_EMPLOYEE"]},"aicExpirationDate":{"type":"string","format":"date-time","nullable":true},"aicQuestionnaire":{"type":"string","nullable":true},"aicStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","PROCESSED"]},"aicCheckedAt":{"type":"string","format":"date-time","nullable":true},"aicLog":{"type":"string","nullable":true},"aicReviewedById":{"type":"string","nullable":true},"aicReviewedAt":{"type":"string","format":"date-time","nullable":true},"iraQuestionnaire":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"hasIraAccounts":{"type":"boolean"},"inSelfDirectedIra":{"type":"boolean"},"custodian":{"type":"string"},"hasOtherQualifiedFunds":{"type":"boolean"}},"required":["id","hasIraAccounts","inSelfDirectedIra","custodian","hasOtherQualifiedFunds"]},"nullable":true},"iraCheck":{"type":"string","enum":["PENDING","APPROVED","NEEDS_REVIEW","REJECTED"]},"iraCheckedAt":{"type":"string","format":"date-time","nullable":true},"iraLog":{"type":"string","nullable":true},"iraReviewedById":{"type":"string","nullable":true},"iraReviewedAt":{"type":"string","format":"date-time","nullable":true},"firstName":{"type":"string"},"lastName":{"type":"string","nullable":true},"dob":{"type":"string","format":"date-time","nullable":true},"isUsCitizenOrGreenCardHolder":{"type":"boolean"},"citizenship":{"type":"string","enum":["AD","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","CU","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","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","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","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","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","YE","YT","ZA","ZM","ZW"],"nullable":true},"ssn":{"type":"string","nullable":true},"lastFour":{"type":"string","nullable":true},"address":{"type":"string","nullable":true},"address2":{"type":"string","nullable":true},"email":{"type":"string","format":"email","nullable":true},"phone":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"state":{"type":"string","nullable":true},"zip":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"kycTid":{"type":"string","nullable":true},"currencyCode":{"type":"string","minLength":3,"maxLength":3,"nullable":true},"investedInCrowdfunding":{"type":"number","nullable":true},"currentAnnualIncome":{"type":"number","nullable":true},"averageAnnualIncome":{"type":"number","nullable":true},"averageHouseholdIncome":{"type":"number","nullable":true},"currentHouseholdIncome":{"type":"number","nullable":true},"householdNetWorth":{"type":"number","nullable":true},"isSolicited":{"type":"boolean"},"isRealEstate":{"type":"boolean"},"iliquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"timeHorizon":{"type":"string","nullable":true},"riskTolerance":{"type":"string","nullable":true},"investmentObjective":{"type":"string","nullable":true},"investmentExperience":{"type":"string","nullable":true},"experienceInPrivate":{"type":"string","nullable":true},"levelOfEducation":{"type":"string","nullable":true},"financialAdvisor":{"type":"boolean"},"occupation":{"type":"string","nullable":true},"employmentStatus":{"type":"string","enum":["EMPLOYED","UNEMPLOYED","SELF_EMPLOYED","RETIRED","STUDENT","OTHER"]},"employerName":{"type":"string","nullable":true},"employerAddressLine1":{"type":"string","nullable":true},"employerAddressLine2":{"type":"string","nullable":true},"employerCity":{"type":"string","nullable":true},"employerState":{"type":"string","nullable":true},"employerZip":{"type":"string","nullable":true},"employerCountry":{"type":"string","nullable":true},"notes":{"type":"string","nullable":true},"kycs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"platform":{"type":"string","example":"KYC Platform"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Passport"},"documentImage":{"type":"string","example":"https://example.com/passport.jpg"},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Document unclear"},"response":{"type":"string","nullable":true,"example":"Submitted clearer document"}},"required":["id","createdAt","updatedAt","deletedAt","tid","platform","individualId","documentType","documentImage","kycStatus","reason","response"]},"nullable":true},"amls":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"provider":{"type":"string","nullable":true,"example":"AML Provider"},"url":{"type":"string","nullable":true,"example":"https://example.com/aml"},"status":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","ERROR"],"example":"PENDING"},"checkedAt":{"type":"string","format":"date-time","nullable":true,"example":"2022-01-01T00:00:00Z"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"}},"required":["id","createdAt","updatedAt","deletedAt","tid","provider","url","status","checkedAt","individualId"]},"nullable":true},"aics":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"individualId":{},"individual":{"nullable":true},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"]},"reviewedById":{"nullable":true},"reviewedBy":{"nullable":true},"reviewedAt":{"type":"string","format":"date-time","nullable":true},"systemReview":{"type":"string","enum":["PENDING","NEEDS_INFO","READY_TO_APPROVE","NEEDS_REVIEW","APPROVED","REJECTED"]},"systemLog":{"type":"array","items":{"type":"object","properties":{"check":{"type":"string","minLength":1},"entered":{"type":"number"},"extracted":{"type":"number"},"result":{"type":"string","enum":["PASS","FAIL"]},"reason":{"type":"string"}},"required":["check","result"]},"nullable":true},"firstName":{"type":"string"},"lastName":{"type":"string"},"method":{"type":"string","enum":["PENDING","INCOME","NET_WORTH","PROFESSIONAL_CERTIFICATION","KNOWLEDGEABLE_EMPLOYEE"]},"incomeData":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer","minimum":2020,"maximum":2025},"filingStatus":{"type":"string","enum":["SINGLE","JOINT"]},"income":{"type":"number","minimum":0,"multipleOf":0.01},"fileId":{}},"required":["year","filingStatus","income","fileId"]},"nullable":true},"netWorthData":{"type":"array","items":{"type":"object","properties":{"institution":{"type":"string","minLength":1,"maxLength":100},"accountType":{"type":"string","enum":["CHECKING","SAVINGS","BROKERAGE","REAL_ESTATE","OTHER"]},"balance":{"type":"number","minimum":0,"multipleOf":0.01},"fileId":{}},"required":["institution","accountType","balance","fileId"]},"nullable":true},"professionalData":{"type":"array","items":{"type":"object","properties":{"professionalType":{"type":"string","enum":["SECURITIES_LICENSES","DIRECTORS","FAMILY_OFFICE"]},"licenseNumber":{"type":"string","minLength":1,"maxLength":50,"nullable":true},"fileId":{"nullable":true}},"required":["professionalType"]},"nullable":true},"employeeData":{"type":"array","items":{"type":"object","properties":{"position":{"type":"string","minLength":1,"maxLength":100},"fileId":{}},"required":["position","fileId"]},"nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","individualId","complianceReview","reviewedById","reviewedAt","systemReview","systemLog","firstName","lastName","method","incomeData","netWorthData","professionalData","employeeData"]},"nullable":true},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]},"setupStep":{"type":"string","enum":["NEW","PERSONAL_INFO","ADDRESS","KYC","INCOME","AIC_QUESTIONS","AIC_FILES"]},"sourceOfIncome":{"type":"string","enum":["EMPLOYED","SELF_EMPLOYED","UNEMPLOYED","RETIREMENT","STUDENT"],"nullable":true},"ownership":{"type":"number","nullable":true},"kycProvider":{"type":"string","nullable":true},"retirementAccountType":{"type":"string","enum":["SELF_DIRECTED","CUSTODIAN_MANAGED"],"nullable":true},"custodianName":{"type":"string","nullable":true},"custodianAccountNumber":{"type":"string","nullable":true},"custodianRepresentativeName":{"type":"string","nullable":true},"custodianEmail":{"type":"string","format":"email","nullable":true},"accredited":{"type":"boolean"}},"required":["id","createdAt","updatedAt","deletedAt","tid","accountId","investorAccountId","role","kycStatus","kycFirstName","kycLastName","kycDocumentType","kycDocumentIssuer","kycDocumentNumber","kycIssuerDate","kycExpirationDate","kycCheck","kycCheckedAt","kycLog","kycReviewedById","kycReviewedAt","kycDocumentFrontFileId","kycDocumentBackFileId","kycSelfieFileId","sanctionsStatus","amlStatus","amlProvider","amlTid","amlUrl","amlCheckedAt","amlLog","amlLogData","amlReviewedById","amlReviewedAt","liquidNetWorth","liquidSecurities","illiquidSecurities","privateSecurities","aicAccreditationType","aicExpirationDate","aicQuestionnaire","aicStatus","aicCheckedAt","aicLog","aicReviewedById","aicReviewedAt","iraQuestionnaire","iraCheck","iraCheckedAt","iraLog","iraReviewedById","iraReviewedAt","firstName","lastName","dob","isUsCitizenOrGreenCardHolder","ssn","lastFour","address","address2","email","phone","city","state","zip","country","kycTid","currencyCode","investedInCrowdfunding","currentAnnualIncome","averageAnnualIncome","averageHouseholdIncome","currentHouseholdIncome","householdNetWorth","isSolicited","isRealEstate","timeHorizon","riskTolerance","investmentObjective","investmentExperience","experienceInPrivate","levelOfEducation","financialAdvisor","occupation","employmentStatus","employerName","employerAddressLine1","employerAddressLine2","employerCity","employerState","employerZip","employerCountry","notes","setupStatus","setupStep","sourceOfIncome","ownership","kycProvider","accredited"]},"nullable":true},"legalEntities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_legal_entity_123","nullable":true},"accountId":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6"},"investorAccountId":{"type":"string","example":"investor_account_01j1xgme5qeqq97gpdztd7e4a7"},"kybStatus":{"example":"PENDING"},"sanctionsStatus":{"example":"PENDING"},"kybs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_kyb_123"},"platform":{"type":"string","example":"KYB Platform"},"legalEntityId":{"type":"string","example":"legal_entity_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Certificate of Incorporation"},"documentImage":{"type":"string","example":"https://example.com/document.pdf"},"kybStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Additional information required"},"response":{"type":"string","nullable":true,"example":"Submitted additional documents"}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","platform","legalEntityId","documentType","documentImage","kybStatus","reason","response"]}},"name":{"type":"string","example":"Acme Corporation"},"ein":{"type":"string","example":"12-3456789","nullable":true},"companyType":{"type":"string","example":"LLC","nullable":true},"streetAddress":{"type":"string","example":"123 Main St","nullable":true},"city":{"type":"string","example":"Anytown","nullable":true},"state":{"type":"string","example":"CA","nullable":true},"zip":{"type":"string","example":"12345","nullable":true},"country":{"type":"string","example":"USA","nullable":true},"phone":{"type":"string","example":"+12124567890","nullable":true},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","accountId","investorAccountId","kybStatus","sanctionsStatus","name","state","setupStatus"]},"nullable":true},"investorAccounts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"investorAccountType":{"type":"string","enum":["INDIVIDUAL","JOINT","RETIREMENT","LEGAL_ENTITY"]},"user":{"nullable":true},"userId":{"type":"string","nullable":true},"email":{"type":"string","format":"email","nullable":true},"name":{"type":"string","nullable":true},"regAQualified":{"type":"boolean"},"regCfQualified":{"type":"boolean"},"regDQualified":{"type":"boolean"},"accountId":{"type":"string"},"account":{},"trades":{"type":"array","items":{}},"individuals":{"type":"array","items":{}},"legalEntities":{"type":"array","items":{}},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]},"systemReviewLog":{"type":"string","nullable":true},"totalAmount":{"type":"number"},"statusCheck":{},"trustedContacts":{"type":"array","items":{}}},"required":["id","createdAt","updatedAt","deletedAt","tid","investorAccountType","regAQualified","regCfQualified","regDQualified","accountId","setupStatus","systemReviewLog"]},"nullable":true},"trades":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"investorAccountId":{"nullable":true},"investorAccount":{"nullable":true},"offering":{"nullable":true},"accountId":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6","accountId":"account_00041061050r3gg28a1c60t3gf","nullable":true},"account":{"nullable":true},"offeringId":{"nullable":true},"paymentMethodId":{"nullable":true},"paymentMethod":{"nullable":true},"userId":{"nullable":true},"tradeNumber":{"type":"string"},"ip":{"type":"string","nullable":true},"tid":{"type":"string","nullable":true},"investmentType":{"type":"string","enum":["INDIVIDUAL","JOINT","ENTITY"]},"purchasedShares":{"type":"integer"},"bonusShares":{"type":"integer","nullable":true},"totalNumberOfShares":{"type":"integer"},"pricePerShare":{"type":"number","multipleOf":0.01},"lineItems":{"type":"array","items":{}},"adjustments":{"type":"array","items":{}},"transactions":{"type":"array","items":{}},"totalAmount":{"type":"number","multipleOf":0.01,"nullable":true},"tradeStatus":{"type":"string","enum":["CART","PLACED","IN_REVIEW","NEEDS_INFO","NEEDS_PAYMENT_INFO","FUNDING","CANCELLED","SETTLED","IMPORT_ERROR","ERROR","UPDATE_PAYMENT_METHOD"]},"tradeStatusUnmapped":{"type":"string","nullable":true},"tradeDate":{"type":"string","format":"date-time","nullable":true},"saStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW"]},"saStatusUnmapped":{"type":"string","nullable":true},"saUrl":{"type":"string","nullable":true},"saSignedAt":{"type":"string","format":"date-time","nullable":true},"saExtractedNumberOfShares":{"type":"string","nullable":true},"saExtractedTotalAmount":{"type":"string","nullable":true},"saExtractedPricePerShare":{"type":"string","nullable":true},"saExtractedInvestorType":{"type":"string","nullable":true},"saExtractedSigner":{"type":"string","nullable":true},"saExtractedSignatureDate":{"type":"string","format":"date-time","nullable":true},"saExtractedSigner2":{"type":"string","nullable":true},"saExtractedSignatureDate2":{"type":"string","format":"date-time","nullable":true},"saCheck":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"]},"saCheckedAt":{"type":"string","format":"date-time","nullable":true},"saLog":{"type":"object","properties":{"finalStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW"]},"matchResults":{"type":"array","items":{"type":"object","properties":{"tradeLineItemId":{"type":"string","example":"trade_line_item_01kctsycw3fq7sj6hedvy62cja"},"signerName":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"totalAmount":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"investorName":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"numberOfShares":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]}},"required":["tradeLineItemId"]}}},"required":["finalStatus","matchResults"],"nullable":true},"txnTid":{"type":"string","nullable":true},"txnResponse":{"type":"string","nullable":true},"txnPaymentMethod":{"type":"string","enum":["CREDIT_CARD","WIRE","ACH","BANK_ACCOUNT","CHECK","RETIREMENT"],"nullable":true},"txnCurrencyCode":{"type":"string","minLength":3,"maxLength":3,"nullable":true},"txnChargedAmount":{"type":"number","multipleOf":0.01,"nullable":true},"txnDate":{"type":"string","format":"date-time","nullable":true},"txnSettledDate":{"type":"string","format":"date-time","nullable":true},"fundingStatus":{"type":"string","enum":["PENDING","CANCELLED","SETTLED","REFUNDED","DECLINED","FUNDING","AUTHORIZING","FAILED"],"nullable":true},"fundingStatusUnmapped":{"type":"string","nullable":true},"txnCheck":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"],"nullable":true},"txnCheckedAt":{"type":"string","format":"date-time","nullable":true},"txnLog":{"type":"string","nullable":true},"systemReviewCheck":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","WARNING","INCOMPLETE"],"nullable":true},"systemReviewCheckedAt":{"type":"string","format":"date-time","nullable":true},"systemReviewLog":{"type":"string","nullable":true},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"],"nullable":true},"complianceReviewNotes":{"type":"string","nullable":true},"complianceReviewerId":{"type":"string","nullable":true},"issuerId":{"nullable":true},"complianceReviewName":{"type":"string","nullable":true},"complianceReviewAt":{"type":"string","format":"date-time","nullable":true},"tradeType":{"type":"string","enum":["PURCHASE","CONVERSION","TRANSFER"],"nullable":true},"placedAt":{"type":"string","format":"date-time","nullable":true},"platform":{"type":"string"},"cancelledAt":{"type":"string","format":"date-time","nullable":true},"cancelledById":{"type":"string","nullable":true},"cancelledReason":{"type":"string","nullable":true},"cancellationPeriod":{"type":"number","nullable":true},"disbursed":{"type":"boolean"},"tradeAdjustments":{"type":"number","nullable":true},"chargedAmount":{"type":"number","nullable":true},"balance":{"type":"number","nullable":true},"isUncleared24h":{"type":"boolean"},"term":{"type":"number","nullable":true},"exercisePrice":{"type":"number","nullable":true},"warrantPercentage":{"type":"number","nullable":true},"calculationMethod":{"type":"string","enum":["NONE","PRORATA","INCREMENT"],"nullable":true},"incrementThreshold":{"type":"number","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","investorAccountId","accountId","account","offeringId","paymentMethodId","userId","tradeNumber","ip","tid","investmentType","purchasedShares","bonusShares","totalNumberOfShares","pricePerShare","lineItems","adjustments","transactions","totalAmount","tradeStatus","tradeStatusUnmapped","tradeDate","saStatus","saStatusUnmapped","saUrl","saSignedAt","saExtractedNumberOfShares","saExtractedTotalAmount","saExtractedPricePerShare","saExtractedInvestorType","saExtractedSigner","saExtractedSignatureDate","saExtractedSigner2","saExtractedSignatureDate2","saCheck","saCheckedAt","saLog","txnTid","txnResponse","txnPaymentMethod","txnCurrencyCode","txnChargedAmount","txnDate","txnSettledDate","fundingStatus","fundingStatusUnmapped","txnCheck","txnCheckedAt","txnLog","systemReviewCheck","systemReviewCheckedAt","systemReviewLog","complianceReview","complianceReviewNotes","complianceReviewerId","issuerId","complianceReviewName","complianceReviewAt","tradeType","placedAt","platform","cancelledAt","cancelledById","cancelledReason","cancellationPeriod","isUncleared24h","term","exercisePrice","warrantPercentage","calculationMethod","incrementThreshold"]},"nullable":true},"metadata":{"type":"string","nullable":true},"status":{"type":"string","enum":["PENDING","ERROR","VALID","INVALID","NOT_PROCESSED","PROCESSING","PROCESSING_ERROR","REVIEW_ERROR","PROCESSED"]},"reviewLog":{"type":"string","nullable":true},"pipeline":{"type":"string","enum":["NONE","SUBDOCS_PHOENIX","SUBDOCS_GENERAL","AIC_TAX_RETURNS","AIC_ACCOUNT_STATEMENTS","PAY_STUBS"]},"errorMessage":{"type":"string","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","tid","url","fileType","fileName","name","category","label","private","complianceReview","targetTable","targetId","linkedFrom","accountId","userId","metadata","status","reviewLog","pipeline","errorMessage"]}},"meta":{"type":"object","properties":{"itemCount":{"type":"number","example":1},"totalItems":{"type":"number","example":10},"itemsPerPage":{"type":"number","example":1},"totalPages":{"type":"number","example":10},"currentPage":{"type":"number","example":1}},"required":["itemCount","itemsPerPage","currentPage"]}},"required":["items","meta"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/files/{id}/link":{"post":{"summary":"Links a file to a new resource","tags":["files"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"linkFile","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"targetId":{"type":"string","example":"trades_01j6aqmtfyfwy9spjdcnh7yqk7"},"label":{"type":"string","enum":["PROOF_OF_INCOME","PROOF_OF_NET_WORTH","EMPLOYEE","TAX_RETURNS","ACCOUNT_STATEMENT","ACCREDITATION_LETTER","LICENSE","IDENTITY_FRONT","IDENTITY_BACK","BAD_ACTOR_REPORT_FILE","OTHER","COMPLIANCE_REQUEST","SUB_DOC","CONTENT_FILE","CSV_EXPORT_FILE","CUSTODIAN_INSTRUCTION_DOCUMENT","LOGO","FAVICON","BACKGROUND_IMAGE","MEMORANDUM","SUBSCRIPTION_AGREEMENT","COVER_ART","ESCROW_AGREEMENT","SS4_LETTER","FORMATION_DOCUMENT","PASSPORT","TRADE_DOCUMENT"],"example":"OTHER"},"category":{"type":"string","minLength":1,"maxLength":50}},"required":["targetId"]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"url":{"type":"string","format":"uri","example":"https://file-location.com"},"fileType":{"type":"string","example":"pdf"},"fileName":{"type":"string","example":"test.pdf"},"name":{"type":"string","example":"test"},"category":{"type":"string","example":"application"},"label":{"type":"string","example":"other"},"private":{"type":"boolean"},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"]},"targetTable":{"type":"string","enum":["KYCS","AMLS","AICS","KYBS","INDIVIDUALS","LEGAL_ENTITIES","INVESTOR_ACCOUNTS","TRADES","OFFERINGS","ISSUERS","COVERED_PERSONS","PAYMENT_METHODS","NOTES","USERS","ACCOUNTS","PAGES","TASKS","FILES","DATA_RECORD_FILES","ASSETS","SITES","PAGE_REVISIONS","TRADE_LINE_ITEMS","TRANSACTIONS","DISBURSEMENTS","DISBURSEMENT_REVIEWS","ISSUER_PAYMENT_METHODS","SIGNER_BRANDS","THEMES","THEME_SETTINGS","CAP_TABLES","CAP_TABLE_SHARE_CLASSES","CAP_TABLE_ENTRIES","EMAIL_THEMES","EMAIL_THEME_SETTINGS"],"nullable":true},"targetId":{"type":"string","nullable":true},"linkedFrom":{"type":"string","nullable":true},"accountId":{"type":"string","example":"account_01j6aqmtfyfwy9spjdcnh7yqk7"},"userId":{"type":"string","example":"user_01j6aqmtfyfwy9spjdcnh7yqk7"},"kycs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"platform":{"type":"string","example":"KYC Platform"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Passport"},"documentImage":{"type":"string","example":"https://example.com/passport.jpg"},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Document unclear"},"response":{"type":"string","nullable":true,"example":"Submitted clearer document"}},"required":["id","createdAt","updatedAt","deletedAt","tid","platform","individualId","documentType","documentImage","kycStatus","reason","response"]},"nullable":true},"kybs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_kyb_123"},"platform":{"type":"string","example":"KYB Platform"},"legalEntityId":{"type":"string","example":"legal_entity_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Certificate of Incorporation"},"documentImage":{"type":"string","example":"https://example.com/document.pdf"},"kybStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Additional information required"},"response":{"type":"string","nullable":true,"example":"Submitted additional documents"}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","platform","legalEntityId","documentType","documentImage","kybStatus","reason","response"]},"nullable":true},"individuals":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"accountId":{"type":"string"},"account":{},"investorAccountId":{"type":"string"},"investorAccount":{},"role":{"type":"string","enum":["PRIMARY","JOINT"]},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"]},"kycFirstName":{"type":"string","nullable":true},"kycLastName":{"type":"string","nullable":true},"kycDocumentType":{"type":"string","enum":["PASSPORT","DRIVER_LICENSE","STATE_ID"],"nullable":true},"kycDocumentIssuer":{"type":"string","nullable":true},"kycDocumentNumber":{"type":"string","nullable":true},"kycIssuerDate":{"type":"string","nullable":true},"kycExpirationDate":{"type":"string","nullable":true},"kycCheck":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"]},"kycCheckedAt":{"type":"string","format":"date-time","nullable":true},"kycLog":{"type":"string","nullable":true},"kycReviewedById":{"type":"string","nullable":true},"kycReviewedAt":{"type":"string","format":"date-time","nullable":true},"kycDocumentFrontFileId":{"type":"string","nullable":true},"kycDocumentFrontFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"kycDocumentBackFileId":{"type":"string","nullable":true},"kycDocumentBackFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"kycSelfieFileId":{"type":"string","nullable":true},"kycSelfieFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"sanctionsStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"]},"amlStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","ERROR"]},"amlProvider":{"type":"string","enum":["ComplyAdvantage"],"nullable":true},"amlTid":{"type":"string","nullable":true},"amlUrl":{"type":"string","nullable":true},"amlCheckedAt":{"type":"string","format":"date-time","nullable":true},"amlLog":{"type":"string","nullable":true},"amlLogData":{"type":"string","nullable":true},"amlReviewedById":{"type":"string","nullable":true},"amlReviewedAt":{"type":"string","format":"date-time","nullable":true},"liquidNetWorth":{"type":"number","multipleOf":0.01,"nullable":true},"liquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"illiquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"privateSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"aicAccreditationType":{"type":"string","enum":["PENDING","INCOME","NET_WORTH","PROFESSIONAL_CERTIFICATION","KNOWLEDGEABLE_EMPLOYEE"]},"aicExpirationDate":{"type":"string","format":"date-time","nullable":true},"aicQuestionnaire":{"type":"string","nullable":true},"aicStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","PROCESSED"]},"aicCheckedAt":{"type":"string","format":"date-time","nullable":true},"aicLog":{"type":"string","nullable":true},"aicReviewedById":{"type":"string","nullable":true},"aicReviewedAt":{"type":"string","format":"date-time","nullable":true},"iraQuestionnaire":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"hasIraAccounts":{"type":"boolean"},"inSelfDirectedIra":{"type":"boolean"},"custodian":{"type":"string"},"hasOtherQualifiedFunds":{"type":"boolean"}},"required":["id","hasIraAccounts","inSelfDirectedIra","custodian","hasOtherQualifiedFunds"]},"nullable":true},"iraCheck":{"type":"string","enum":["PENDING","APPROVED","NEEDS_REVIEW","REJECTED"]},"iraCheckedAt":{"type":"string","format":"date-time","nullable":true},"iraLog":{"type":"string","nullable":true},"iraReviewedById":{"type":"string","nullable":true},"iraReviewedAt":{"type":"string","format":"date-time","nullable":true},"firstName":{"type":"string"},"lastName":{"type":"string","nullable":true},"dob":{"type":"string","format":"date-time","nullable":true},"isUsCitizenOrGreenCardHolder":{"type":"boolean"},"citizenship":{"type":"string","enum":["AD","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","CU","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","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","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","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","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","YE","YT","ZA","ZM","ZW"],"nullable":true},"ssn":{"type":"string","nullable":true},"lastFour":{"type":"string","nullable":true},"address":{"type":"string","nullable":true},"address2":{"type":"string","nullable":true},"email":{"type":"string","format":"email","nullable":true},"phone":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"state":{"type":"string","nullable":true},"zip":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"kycTid":{"type":"string","nullable":true},"currencyCode":{"type":"string","minLength":3,"maxLength":3,"nullable":true},"investedInCrowdfunding":{"type":"number","nullable":true},"currentAnnualIncome":{"type":"number","nullable":true},"averageAnnualIncome":{"type":"number","nullable":true},"averageHouseholdIncome":{"type":"number","nullable":true},"currentHouseholdIncome":{"type":"number","nullable":true},"householdNetWorth":{"type":"number","nullable":true},"isSolicited":{"type":"boolean"},"isRealEstate":{"type":"boolean"},"iliquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"timeHorizon":{"type":"string","nullable":true},"riskTolerance":{"type":"string","nullable":true},"investmentObjective":{"type":"string","nullable":true},"investmentExperience":{"type":"string","nullable":true},"experienceInPrivate":{"type":"string","nullable":true},"levelOfEducation":{"type":"string","nullable":true},"financialAdvisor":{"type":"boolean"},"occupation":{"type":"string","nullable":true},"employmentStatus":{"type":"string","enum":["EMPLOYED","UNEMPLOYED","SELF_EMPLOYED","RETIRED","STUDENT","OTHER"]},"employerName":{"type":"string","nullable":true},"employerAddressLine1":{"type":"string","nullable":true},"employerAddressLine2":{"type":"string","nullable":true},"employerCity":{"type":"string","nullable":true},"employerState":{"type":"string","nullable":true},"employerZip":{"type":"string","nullable":true},"employerCountry":{"type":"string","nullable":true},"notes":{"type":"string","nullable":true},"kycs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"platform":{"type":"string","example":"KYC Platform"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Passport"},"documentImage":{"type":"string","example":"https://example.com/passport.jpg"},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Document unclear"},"response":{"type":"string","nullable":true,"example":"Submitted clearer document"}},"required":["id","createdAt","updatedAt","deletedAt","tid","platform","individualId","documentType","documentImage","kycStatus","reason","response"]},"nullable":true},"amls":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"provider":{"type":"string","nullable":true,"example":"AML Provider"},"url":{"type":"string","nullable":true,"example":"https://example.com/aml"},"status":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","ERROR"],"example":"PENDING"},"checkedAt":{"type":"string","format":"date-time","nullable":true,"example":"2022-01-01T00:00:00Z"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"}},"required":["id","createdAt","updatedAt","deletedAt","tid","provider","url","status","checkedAt","individualId"]},"nullable":true},"aics":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"individualId":{},"individual":{"nullable":true},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"]},"reviewedById":{"nullable":true},"reviewedBy":{"nullable":true},"reviewedAt":{"type":"string","format":"date-time","nullable":true},"systemReview":{"type":"string","enum":["PENDING","NEEDS_INFO","READY_TO_APPROVE","NEEDS_REVIEW","APPROVED","REJECTED"]},"systemLog":{"type":"array","items":{"type":"object","properties":{"check":{"type":"string","minLength":1},"entered":{"type":"number"},"extracted":{"type":"number"},"result":{"type":"string","enum":["PASS","FAIL"]},"reason":{"type":"string"}},"required":["check","result"]},"nullable":true},"firstName":{"type":"string"},"lastName":{"type":"string"},"method":{"type":"string","enum":["PENDING","INCOME","NET_WORTH","PROFESSIONAL_CERTIFICATION","KNOWLEDGEABLE_EMPLOYEE"]},"incomeData":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer","minimum":2020,"maximum":2025},"filingStatus":{"type":"string","enum":["SINGLE","JOINT"]},"income":{"type":"number","minimum":0,"multipleOf":0.01},"fileId":{}},"required":["year","filingStatus","income","fileId"]},"nullable":true},"netWorthData":{"type":"array","items":{"type":"object","properties":{"institution":{"type":"string","minLength":1,"maxLength":100},"accountType":{"type":"string","enum":["CHECKING","SAVINGS","BROKERAGE","REAL_ESTATE","OTHER"]},"balance":{"type":"number","minimum":0,"multipleOf":0.01},"fileId":{}},"required":["institution","accountType","balance","fileId"]},"nullable":true},"professionalData":{"type":"array","items":{"type":"object","properties":{"professionalType":{"type":"string","enum":["SECURITIES_LICENSES","DIRECTORS","FAMILY_OFFICE"]},"licenseNumber":{"type":"string","minLength":1,"maxLength":50,"nullable":true},"fileId":{"nullable":true}},"required":["professionalType"]},"nullable":true},"employeeData":{"type":"array","items":{"type":"object","properties":{"position":{"type":"string","minLength":1,"maxLength":100},"fileId":{}},"required":["position","fileId"]},"nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","individualId","complianceReview","reviewedById","reviewedAt","systemReview","systemLog","firstName","lastName","method","incomeData","netWorthData","professionalData","employeeData"]},"nullable":true},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]},"setupStep":{"type":"string","enum":["NEW","PERSONAL_INFO","ADDRESS","KYC","INCOME","AIC_QUESTIONS","AIC_FILES"]},"sourceOfIncome":{"type":"string","enum":["EMPLOYED","SELF_EMPLOYED","UNEMPLOYED","RETIREMENT","STUDENT"],"nullable":true},"ownership":{"type":"number","nullable":true},"kycProvider":{"type":"string","nullable":true},"retirementAccountType":{"type":"string","enum":["SELF_DIRECTED","CUSTODIAN_MANAGED"],"nullable":true},"custodianName":{"type":"string","nullable":true},"custodianAccountNumber":{"type":"string","nullable":true},"custodianRepresentativeName":{"type":"string","nullable":true},"custodianEmail":{"type":"string","format":"email","nullable":true},"accredited":{"type":"boolean"}},"required":["id","createdAt","updatedAt","deletedAt","tid","accountId","investorAccountId","role","kycStatus","kycFirstName","kycLastName","kycDocumentType","kycDocumentIssuer","kycDocumentNumber","kycIssuerDate","kycExpirationDate","kycCheck","kycCheckedAt","kycLog","kycReviewedById","kycReviewedAt","kycDocumentFrontFileId","kycDocumentBackFileId","kycSelfieFileId","sanctionsStatus","amlStatus","amlProvider","amlTid","amlUrl","amlCheckedAt","amlLog","amlLogData","amlReviewedById","amlReviewedAt","liquidNetWorth","liquidSecurities","illiquidSecurities","privateSecurities","aicAccreditationType","aicExpirationDate","aicQuestionnaire","aicStatus","aicCheckedAt","aicLog","aicReviewedById","aicReviewedAt","iraQuestionnaire","iraCheck","iraCheckedAt","iraLog","iraReviewedById","iraReviewedAt","firstName","lastName","dob","isUsCitizenOrGreenCardHolder","ssn","lastFour","address","address2","email","phone","city","state","zip","country","kycTid","currencyCode","investedInCrowdfunding","currentAnnualIncome","averageAnnualIncome","averageHouseholdIncome","currentHouseholdIncome","householdNetWorth","isSolicited","isRealEstate","timeHorizon","riskTolerance","investmentObjective","investmentExperience","experienceInPrivate","levelOfEducation","financialAdvisor","occupation","employmentStatus","employerName","employerAddressLine1","employerAddressLine2","employerCity","employerState","employerZip","employerCountry","notes","setupStatus","setupStep","sourceOfIncome","ownership","kycProvider","accredited"]},"nullable":true},"legalEntities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_legal_entity_123","nullable":true},"accountId":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6"},"investorAccountId":{"type":"string","example":"investor_account_01j1xgme5qeqq97gpdztd7e4a7"},"kybStatus":{"example":"PENDING"},"sanctionsStatus":{"example":"PENDING"},"kybs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_kyb_123"},"platform":{"type":"string","example":"KYB Platform"},"legalEntityId":{"type":"string","example":"legal_entity_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Certificate of Incorporation"},"documentImage":{"type":"string","example":"https://example.com/document.pdf"},"kybStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Additional information required"},"response":{"type":"string","nullable":true,"example":"Submitted additional documents"}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","platform","legalEntityId","documentType","documentImage","kybStatus","reason","response"]}},"name":{"type":"string","example":"Acme Corporation"},"ein":{"type":"string","example":"12-3456789","nullable":true},"companyType":{"type":"string","example":"LLC","nullable":true},"streetAddress":{"type":"string","example":"123 Main St","nullable":true},"city":{"type":"string","example":"Anytown","nullable":true},"state":{"type":"string","example":"CA","nullable":true},"zip":{"type":"string","example":"12345","nullable":true},"country":{"type":"string","example":"USA","nullable":true},"phone":{"type":"string","example":"+12124567890","nullable":true},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","accountId","investorAccountId","kybStatus","sanctionsStatus","name","state","setupStatus"]},"nullable":true},"investorAccounts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"investorAccountType":{"type":"string","enum":["INDIVIDUAL","JOINT","RETIREMENT","LEGAL_ENTITY"]},"user":{"nullable":true},"userId":{"type":"string","nullable":true},"email":{"type":"string","format":"email","nullable":true},"name":{"type":"string","nullable":true},"regAQualified":{"type":"boolean"},"regCfQualified":{"type":"boolean"},"regDQualified":{"type":"boolean"},"accountId":{"type":"string"},"account":{},"trades":{"type":"array","items":{}},"individuals":{"type":"array","items":{}},"legalEntities":{"type":"array","items":{}},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]},"systemReviewLog":{"type":"string","nullable":true},"totalAmount":{"type":"number"},"statusCheck":{},"trustedContacts":{"type":"array","items":{}}},"required":["id","createdAt","updatedAt","deletedAt","tid","investorAccountType","regAQualified","regCfQualified","regDQualified","accountId","setupStatus","systemReviewLog"]},"nullable":true},"trades":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"investorAccountId":{"nullable":true},"investorAccount":{"nullable":true},"offering":{"nullable":true},"accountId":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6","accountId":"account_00041061050r3gg28a1c60t3gf","nullable":true},"account":{"nullable":true},"offeringId":{"nullable":true},"paymentMethodId":{"nullable":true},"paymentMethod":{"nullable":true},"userId":{"nullable":true},"tradeNumber":{"type":"string"},"ip":{"type":"string","nullable":true},"tid":{"type":"string","nullable":true},"investmentType":{"type":"string","enum":["INDIVIDUAL","JOINT","ENTITY"]},"purchasedShares":{"type":"integer"},"bonusShares":{"type":"integer","nullable":true},"totalNumberOfShares":{"type":"integer"},"pricePerShare":{"type":"number","multipleOf":0.01},"lineItems":{"type":"array","items":{}},"adjustments":{"type":"array","items":{}},"transactions":{"type":"array","items":{}},"totalAmount":{"type":"number","multipleOf":0.01,"nullable":true},"tradeStatus":{"type":"string","enum":["CART","PLACED","IN_REVIEW","NEEDS_INFO","NEEDS_PAYMENT_INFO","FUNDING","CANCELLED","SETTLED","IMPORT_ERROR","ERROR","UPDATE_PAYMENT_METHOD"]},"tradeStatusUnmapped":{"type":"string","nullable":true},"tradeDate":{"type":"string","format":"date-time","nullable":true},"saStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW"]},"saStatusUnmapped":{"type":"string","nullable":true},"saUrl":{"type":"string","nullable":true},"saSignedAt":{"type":"string","format":"date-time","nullable":true},"saExtractedNumberOfShares":{"type":"string","nullable":true},"saExtractedTotalAmount":{"type":"string","nullable":true},"saExtractedPricePerShare":{"type":"string","nullable":true},"saExtractedInvestorType":{"type":"string","nullable":true},"saExtractedSigner":{"type":"string","nullable":true},"saExtractedSignatureDate":{"type":"string","format":"date-time","nullable":true},"saExtractedSigner2":{"type":"string","nullable":true},"saExtractedSignatureDate2":{"type":"string","format":"date-time","nullable":true},"saCheck":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"]},"saCheckedAt":{"type":"string","format":"date-time","nullable":true},"saLog":{"type":"object","properties":{"finalStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW"]},"matchResults":{"type":"array","items":{"type":"object","properties":{"tradeLineItemId":{"type":"string","example":"trade_line_item_01kctsycw3fq7sj6hedvy62cja"},"signerName":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"totalAmount":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"investorName":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"numberOfShares":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]}},"required":["tradeLineItemId"]}}},"required":["finalStatus","matchResults"],"nullable":true},"txnTid":{"type":"string","nullable":true},"txnResponse":{"type":"string","nullable":true},"txnPaymentMethod":{"type":"string","enum":["CREDIT_CARD","WIRE","ACH","BANK_ACCOUNT","CHECK","RETIREMENT"],"nullable":true},"txnCurrencyCode":{"type":"string","minLength":3,"maxLength":3,"nullable":true},"txnChargedAmount":{"type":"number","multipleOf":0.01,"nullable":true},"txnDate":{"type":"string","format":"date-time","nullable":true},"txnSettledDate":{"type":"string","format":"date-time","nullable":true},"fundingStatus":{"type":"string","enum":["PENDING","CANCELLED","SETTLED","REFUNDED","DECLINED","FUNDING","AUTHORIZING","FAILED"],"nullable":true},"fundingStatusUnmapped":{"type":"string","nullable":true},"txnCheck":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"],"nullable":true},"txnCheckedAt":{"type":"string","format":"date-time","nullable":true},"txnLog":{"type":"string","nullable":true},"systemReviewCheck":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","WARNING","INCOMPLETE"],"nullable":true},"systemReviewCheckedAt":{"type":"string","format":"date-time","nullable":true},"systemReviewLog":{"type":"string","nullable":true},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"],"nullable":true},"complianceReviewNotes":{"type":"string","nullable":true},"complianceReviewerId":{"type":"string","nullable":true},"issuerId":{"nullable":true},"complianceReviewName":{"type":"string","nullable":true},"complianceReviewAt":{"type":"string","format":"date-time","nullable":true},"tradeType":{"type":"string","enum":["PURCHASE","CONVERSION","TRANSFER"],"nullable":true},"placedAt":{"type":"string","format":"date-time","nullable":true},"platform":{"type":"string"},"cancelledAt":{"type":"string","format":"date-time","nullable":true},"cancelledById":{"type":"string","nullable":true},"cancelledReason":{"type":"string","nullable":true},"cancellationPeriod":{"type":"number","nullable":true},"disbursed":{"type":"boolean"},"tradeAdjustments":{"type":"number","nullable":true},"chargedAmount":{"type":"number","nullable":true},"balance":{"type":"number","nullable":true},"isUncleared24h":{"type":"boolean"},"term":{"type":"number","nullable":true},"exercisePrice":{"type":"number","nullable":true},"warrantPercentage":{"type":"number","nullable":true},"calculationMethod":{"type":"string","enum":["NONE","PRORATA","INCREMENT"],"nullable":true},"incrementThreshold":{"type":"number","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","investorAccountId","accountId","account","offeringId","paymentMethodId","userId","tradeNumber","ip","tid","investmentType","purchasedShares","bonusShares","totalNumberOfShares","pricePerShare","lineItems","adjustments","transactions","totalAmount","tradeStatus","tradeStatusUnmapped","tradeDate","saStatus","saStatusUnmapped","saUrl","saSignedAt","saExtractedNumberOfShares","saExtractedTotalAmount","saExtractedPricePerShare","saExtractedInvestorType","saExtractedSigner","saExtractedSignatureDate","saExtractedSigner2","saExtractedSignatureDate2","saCheck","saCheckedAt","saLog","txnTid","txnResponse","txnPaymentMethod","txnCurrencyCode","txnChargedAmount","txnDate","txnSettledDate","fundingStatus","fundingStatusUnmapped","txnCheck","txnCheckedAt","txnLog","systemReviewCheck","systemReviewCheckedAt","systemReviewLog","complianceReview","complianceReviewNotes","complianceReviewerId","issuerId","complianceReviewName","complianceReviewAt","tradeType","placedAt","platform","cancelledAt","cancelledById","cancelledReason","cancellationPeriod","isUncleared24h","term","exercisePrice","warrantPercentage","calculationMethod","incrementThreshold"]},"nullable":true},"metadata":{"type":"string","nullable":true},"status":{"type":"string","enum":["PENDING","ERROR","VALID","INVALID","NOT_PROCESSED","PROCESSING","PROCESSING_ERROR","REVIEW_ERROR","PROCESSED"]},"reviewLog":{"type":"string","nullable":true},"pipeline":{"type":"string","enum":["NONE","SUBDOCS_PHOENIX","SUBDOCS_GENERAL","AIC_TAX_RETURNS","AIC_ACCOUNT_STATEMENTS","PAY_STUBS"]},"errorMessage":{"type":"string","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","tid","url","fileType","fileName","name","category","label","private","complianceReview","targetTable","targetId","linkedFrom","accountId","userId","metadata","status","reviewLog","pipeline","errorMessage"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"422":{"description":"422","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"422"},"message":{"type":"string","example":"UNPROCESSABLE_ENTITY"},"errors":{"type":"array","items":{"type":"string"},"example":["file is required"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}},"502":{"description":"502","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"502"},"message":{"type":"string","example":"BAD_GATEWAY"},"errors":{"type":"array","items":{"type":"string"},"example":["bad gateway"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/files/{id}/unlink":{"post":{"summary":"Unlinks a file to the parent resource","tags":["files"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"unlinkFile","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"202":{"description":"202","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"url":{"type":"string","format":"uri","example":"https://file-location.com"},"fileType":{"type":"string","example":"pdf"},"fileName":{"type":"string","example":"test.pdf"},"name":{"type":"string","example":"test"},"category":{"type":"string","example":"application"},"label":{"type":"string","example":"other"},"private":{"type":"boolean"},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"]},"targetTable":{"type":"string","enum":["KYCS","AMLS","AICS","KYBS","INDIVIDUALS","LEGAL_ENTITIES","INVESTOR_ACCOUNTS","TRADES","OFFERINGS","ISSUERS","COVERED_PERSONS","PAYMENT_METHODS","NOTES","USERS","ACCOUNTS","PAGES","TASKS","FILES","DATA_RECORD_FILES","ASSETS","SITES","PAGE_REVISIONS","TRADE_LINE_ITEMS","TRANSACTIONS","DISBURSEMENTS","DISBURSEMENT_REVIEWS","ISSUER_PAYMENT_METHODS","SIGNER_BRANDS","THEMES","THEME_SETTINGS","CAP_TABLES","CAP_TABLE_SHARE_CLASSES","CAP_TABLE_ENTRIES","EMAIL_THEMES","EMAIL_THEME_SETTINGS"],"nullable":true},"targetId":{"type":"string","nullable":true},"linkedFrom":{"type":"string","nullable":true},"accountId":{"type":"string","example":"account_01j6aqmtfyfwy9spjdcnh7yqk7"},"userId":{"type":"string","example":"user_01j6aqmtfyfwy9spjdcnh7yqk7"},"kycs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"platform":{"type":"string","example":"KYC Platform"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Passport"},"documentImage":{"type":"string","example":"https://example.com/passport.jpg"},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Document unclear"},"response":{"type":"string","nullable":true,"example":"Submitted clearer document"}},"required":["id","createdAt","updatedAt","deletedAt","tid","platform","individualId","documentType","documentImage","kycStatus","reason","response"]},"nullable":true},"kybs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_kyb_123"},"platform":{"type":"string","example":"KYB Platform"},"legalEntityId":{"type":"string","example":"legal_entity_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Certificate of Incorporation"},"documentImage":{"type":"string","example":"https://example.com/document.pdf"},"kybStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Additional information required"},"response":{"type":"string","nullable":true,"example":"Submitted additional documents"}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","platform","legalEntityId","documentType","documentImage","kybStatus","reason","response"]},"nullable":true},"individuals":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"accountId":{"type":"string"},"account":{},"investorAccountId":{"type":"string"},"investorAccount":{},"role":{"type":"string","enum":["PRIMARY","JOINT"]},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"]},"kycFirstName":{"type":"string","nullable":true},"kycLastName":{"type":"string","nullable":true},"kycDocumentType":{"type":"string","enum":["PASSPORT","DRIVER_LICENSE","STATE_ID"],"nullable":true},"kycDocumentIssuer":{"type":"string","nullable":true},"kycDocumentNumber":{"type":"string","nullable":true},"kycIssuerDate":{"type":"string","nullable":true},"kycExpirationDate":{"type":"string","nullable":true},"kycCheck":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"]},"kycCheckedAt":{"type":"string","format":"date-time","nullable":true},"kycLog":{"type":"string","nullable":true},"kycReviewedById":{"type":"string","nullable":true},"kycReviewedAt":{"type":"string","format":"date-time","nullable":true},"kycDocumentFrontFileId":{"type":"string","nullable":true},"kycDocumentFrontFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"kycDocumentBackFileId":{"type":"string","nullable":true},"kycDocumentBackFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"kycSelfieFileId":{"type":"string","nullable":true},"kycSelfieFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"sanctionsStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"]},"amlStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","ERROR"]},"amlProvider":{"type":"string","enum":["ComplyAdvantage"],"nullable":true},"amlTid":{"type":"string","nullable":true},"amlUrl":{"type":"string","nullable":true},"amlCheckedAt":{"type":"string","format":"date-time","nullable":true},"amlLog":{"type":"string","nullable":true},"amlLogData":{"type":"string","nullable":true},"amlReviewedById":{"type":"string","nullable":true},"amlReviewedAt":{"type":"string","format":"date-time","nullable":true},"liquidNetWorth":{"type":"number","multipleOf":0.01,"nullable":true},"liquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"illiquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"privateSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"aicAccreditationType":{"type":"string","enum":["PENDING","INCOME","NET_WORTH","PROFESSIONAL_CERTIFICATION","KNOWLEDGEABLE_EMPLOYEE"]},"aicExpirationDate":{"type":"string","format":"date-time","nullable":true},"aicQuestionnaire":{"type":"string","nullable":true},"aicStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","PROCESSED"]},"aicCheckedAt":{"type":"string","format":"date-time","nullable":true},"aicLog":{"type":"string","nullable":true},"aicReviewedById":{"type":"string","nullable":true},"aicReviewedAt":{"type":"string","format":"date-time","nullable":true},"iraQuestionnaire":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"hasIraAccounts":{"type":"boolean"},"inSelfDirectedIra":{"type":"boolean"},"custodian":{"type":"string"},"hasOtherQualifiedFunds":{"type":"boolean"}},"required":["id","hasIraAccounts","inSelfDirectedIra","custodian","hasOtherQualifiedFunds"]},"nullable":true},"iraCheck":{"type":"string","enum":["PENDING","APPROVED","NEEDS_REVIEW","REJECTED"]},"iraCheckedAt":{"type":"string","format":"date-time","nullable":true},"iraLog":{"type":"string","nullable":true},"iraReviewedById":{"type":"string","nullable":true},"iraReviewedAt":{"type":"string","format":"date-time","nullable":true},"firstName":{"type":"string"},"lastName":{"type":"string","nullable":true},"dob":{"type":"string","format":"date-time","nullable":true},"isUsCitizenOrGreenCardHolder":{"type":"boolean"},"citizenship":{"type":"string","enum":["AD","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","CU","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","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","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","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","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","YE","YT","ZA","ZM","ZW"],"nullable":true},"ssn":{"type":"string","nullable":true},"lastFour":{"type":"string","nullable":true},"address":{"type":"string","nullable":true},"address2":{"type":"string","nullable":true},"email":{"type":"string","format":"email","nullable":true},"phone":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"state":{"type":"string","nullable":true},"zip":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"kycTid":{"type":"string","nullable":true},"currencyCode":{"type":"string","minLength":3,"maxLength":3,"nullable":true},"investedInCrowdfunding":{"type":"number","nullable":true},"currentAnnualIncome":{"type":"number","nullable":true},"averageAnnualIncome":{"type":"number","nullable":true},"averageHouseholdIncome":{"type":"number","nullable":true},"currentHouseholdIncome":{"type":"number","nullable":true},"householdNetWorth":{"type":"number","nullable":true},"isSolicited":{"type":"boolean"},"isRealEstate":{"type":"boolean"},"iliquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"timeHorizon":{"type":"string","nullable":true},"riskTolerance":{"type":"string","nullable":true},"investmentObjective":{"type":"string","nullable":true},"investmentExperience":{"type":"string","nullable":true},"experienceInPrivate":{"type":"string","nullable":true},"levelOfEducation":{"type":"string","nullable":true},"financialAdvisor":{"type":"boolean"},"occupation":{"type":"string","nullable":true},"employmentStatus":{"type":"string","enum":["EMPLOYED","UNEMPLOYED","SELF_EMPLOYED","RETIRED","STUDENT","OTHER"]},"employerName":{"type":"string","nullable":true},"employerAddressLine1":{"type":"string","nullable":true},"employerAddressLine2":{"type":"string","nullable":true},"employerCity":{"type":"string","nullable":true},"employerState":{"type":"string","nullable":true},"employerZip":{"type":"string","nullable":true},"employerCountry":{"type":"string","nullable":true},"notes":{"type":"string","nullable":true},"kycs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"platform":{"type":"string","example":"KYC Platform"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Passport"},"documentImage":{"type":"string","example":"https://example.com/passport.jpg"},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Document unclear"},"response":{"type":"string","nullable":true,"example":"Submitted clearer document"}},"required":["id","createdAt","updatedAt","deletedAt","tid","platform","individualId","documentType","documentImage","kycStatus","reason","response"]},"nullable":true},"amls":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"provider":{"type":"string","nullable":true,"example":"AML Provider"},"url":{"type":"string","nullable":true,"example":"https://example.com/aml"},"status":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","ERROR"],"example":"PENDING"},"checkedAt":{"type":"string","format":"date-time","nullable":true,"example":"2022-01-01T00:00:00Z"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"}},"required":["id","createdAt","updatedAt","deletedAt","tid","provider","url","status","checkedAt","individualId"]},"nullable":true},"aics":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"individualId":{},"individual":{"nullable":true},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"]},"reviewedById":{"nullable":true},"reviewedBy":{"nullable":true},"reviewedAt":{"type":"string","format":"date-time","nullable":true},"systemReview":{"type":"string","enum":["PENDING","NEEDS_INFO","READY_TO_APPROVE","NEEDS_REVIEW","APPROVED","REJECTED"]},"systemLog":{"type":"array","items":{"type":"object","properties":{"check":{"type":"string","minLength":1},"entered":{"type":"number"},"extracted":{"type":"number"},"result":{"type":"string","enum":["PASS","FAIL"]},"reason":{"type":"string"}},"required":["check","result"]},"nullable":true},"firstName":{"type":"string"},"lastName":{"type":"string"},"method":{"type":"string","enum":["PENDING","INCOME","NET_WORTH","PROFESSIONAL_CERTIFICATION","KNOWLEDGEABLE_EMPLOYEE"]},"incomeData":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer","minimum":2020,"maximum":2025},"filingStatus":{"type":"string","enum":["SINGLE","JOINT"]},"income":{"type":"number","minimum":0,"multipleOf":0.01},"fileId":{}},"required":["year","filingStatus","income","fileId"]},"nullable":true},"netWorthData":{"type":"array","items":{"type":"object","properties":{"institution":{"type":"string","minLength":1,"maxLength":100},"accountType":{"type":"string","enum":["CHECKING","SAVINGS","BROKERAGE","REAL_ESTATE","OTHER"]},"balance":{"type":"number","minimum":0,"multipleOf":0.01},"fileId":{}},"required":["institution","accountType","balance","fileId"]},"nullable":true},"professionalData":{"type":"array","items":{"type":"object","properties":{"professionalType":{"type":"string","enum":["SECURITIES_LICENSES","DIRECTORS","FAMILY_OFFICE"]},"licenseNumber":{"type":"string","minLength":1,"maxLength":50,"nullable":true},"fileId":{"nullable":true}},"required":["professionalType"]},"nullable":true},"employeeData":{"type":"array","items":{"type":"object","properties":{"position":{"type":"string","minLength":1,"maxLength":100},"fileId":{}},"required":["position","fileId"]},"nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","individualId","complianceReview","reviewedById","reviewedAt","systemReview","systemLog","firstName","lastName","method","incomeData","netWorthData","professionalData","employeeData"]},"nullable":true},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]},"setupStep":{"type":"string","enum":["NEW","PERSONAL_INFO","ADDRESS","KYC","INCOME","AIC_QUESTIONS","AIC_FILES"]},"sourceOfIncome":{"type":"string","enum":["EMPLOYED","SELF_EMPLOYED","UNEMPLOYED","RETIREMENT","STUDENT"],"nullable":true},"ownership":{"type":"number","nullable":true},"kycProvider":{"type":"string","nullable":true},"retirementAccountType":{"type":"string","enum":["SELF_DIRECTED","CUSTODIAN_MANAGED"],"nullable":true},"custodianName":{"type":"string","nullable":true},"custodianAccountNumber":{"type":"string","nullable":true},"custodianRepresentativeName":{"type":"string","nullable":true},"custodianEmail":{"type":"string","format":"email","nullable":true},"accredited":{"type":"boolean"}},"required":["id","createdAt","updatedAt","deletedAt","tid","accountId","investorAccountId","role","kycStatus","kycFirstName","kycLastName","kycDocumentType","kycDocumentIssuer","kycDocumentNumber","kycIssuerDate","kycExpirationDate","kycCheck","kycCheckedAt","kycLog","kycReviewedById","kycReviewedAt","kycDocumentFrontFileId","kycDocumentBackFileId","kycSelfieFileId","sanctionsStatus","amlStatus","amlProvider","amlTid","amlUrl","amlCheckedAt","amlLog","amlLogData","amlReviewedById","amlReviewedAt","liquidNetWorth","liquidSecurities","illiquidSecurities","privateSecurities","aicAccreditationType","aicExpirationDate","aicQuestionnaire","aicStatus","aicCheckedAt","aicLog","aicReviewedById","aicReviewedAt","iraQuestionnaire","iraCheck","iraCheckedAt","iraLog","iraReviewedById","iraReviewedAt","firstName","lastName","dob","isUsCitizenOrGreenCardHolder","ssn","lastFour","address","address2","email","phone","city","state","zip","country","kycTid","currencyCode","investedInCrowdfunding","currentAnnualIncome","averageAnnualIncome","averageHouseholdIncome","currentHouseholdIncome","householdNetWorth","isSolicited","isRealEstate","timeHorizon","riskTolerance","investmentObjective","investmentExperience","experienceInPrivate","levelOfEducation","financialAdvisor","occupation","employmentStatus","employerName","employerAddressLine1","employerAddressLine2","employerCity","employerState","employerZip","employerCountry","notes","setupStatus","setupStep","sourceOfIncome","ownership","kycProvider","accredited"]},"nullable":true},"legalEntities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_legal_entity_123","nullable":true},"accountId":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6"},"investorAccountId":{"type":"string","example":"investor_account_01j1xgme5qeqq97gpdztd7e4a7"},"kybStatus":{"example":"PENDING"},"sanctionsStatus":{"example":"PENDING"},"kybs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_kyb_123"},"platform":{"type":"string","example":"KYB Platform"},"legalEntityId":{"type":"string","example":"legal_entity_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Certificate of Incorporation"},"documentImage":{"type":"string","example":"https://example.com/document.pdf"},"kybStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Additional information required"},"response":{"type":"string","nullable":true,"example":"Submitted additional documents"}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","platform","legalEntityId","documentType","documentImage","kybStatus","reason","response"]}},"name":{"type":"string","example":"Acme Corporation"},"ein":{"type":"string","example":"12-3456789","nullable":true},"companyType":{"type":"string","example":"LLC","nullable":true},"streetAddress":{"type":"string","example":"123 Main St","nullable":true},"city":{"type":"string","example":"Anytown","nullable":true},"state":{"type":"string","example":"CA","nullable":true},"zip":{"type":"string","example":"12345","nullable":true},"country":{"type":"string","example":"USA","nullable":true},"phone":{"type":"string","example":"+12124567890","nullable":true},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","accountId","investorAccountId","kybStatus","sanctionsStatus","name","state","setupStatus"]},"nullable":true},"investorAccounts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"investorAccountType":{"type":"string","enum":["INDIVIDUAL","JOINT","RETIREMENT","LEGAL_ENTITY"]},"user":{"nullable":true},"userId":{"type":"string","nullable":true},"email":{"type":"string","format":"email","nullable":true},"name":{"type":"string","nullable":true},"regAQualified":{"type":"boolean"},"regCfQualified":{"type":"boolean"},"regDQualified":{"type":"boolean"},"accountId":{"type":"string"},"account":{},"trades":{"type":"array","items":{}},"individuals":{"type":"array","items":{}},"legalEntities":{"type":"array","items":{}},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]},"systemReviewLog":{"type":"string","nullable":true},"totalAmount":{"type":"number"},"statusCheck":{},"trustedContacts":{"type":"array","items":{}}},"required":["id","createdAt","updatedAt","deletedAt","tid","investorAccountType","regAQualified","regCfQualified","regDQualified","accountId","setupStatus","systemReviewLog"]},"nullable":true},"trades":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"investorAccountId":{"nullable":true},"investorAccount":{"nullable":true},"offering":{"nullable":true},"accountId":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6","accountId":"account_00041061050r3gg28a1c60t3gf","nullable":true},"account":{"nullable":true},"offeringId":{"nullable":true},"paymentMethodId":{"nullable":true},"paymentMethod":{"nullable":true},"userId":{"nullable":true},"tradeNumber":{"type":"string"},"ip":{"type":"string","nullable":true},"tid":{"type":"string","nullable":true},"investmentType":{"type":"string","enum":["INDIVIDUAL","JOINT","ENTITY"]},"purchasedShares":{"type":"integer"},"bonusShares":{"type":"integer","nullable":true},"totalNumberOfShares":{"type":"integer"},"pricePerShare":{"type":"number","multipleOf":0.01},"lineItems":{"type":"array","items":{}},"adjustments":{"type":"array","items":{}},"transactions":{"type":"array","items":{}},"totalAmount":{"type":"number","multipleOf":0.01,"nullable":true},"tradeStatus":{"type":"string","enum":["CART","PLACED","IN_REVIEW","NEEDS_INFO","NEEDS_PAYMENT_INFO","FUNDING","CANCELLED","SETTLED","IMPORT_ERROR","ERROR","UPDATE_PAYMENT_METHOD"]},"tradeStatusUnmapped":{"type":"string","nullable":true},"tradeDate":{"type":"string","format":"date-time","nullable":true},"saStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW"]},"saStatusUnmapped":{"type":"string","nullable":true},"saUrl":{"type":"string","nullable":true},"saSignedAt":{"type":"string","format":"date-time","nullable":true},"saExtractedNumberOfShares":{"type":"string","nullable":true},"saExtractedTotalAmount":{"type":"string","nullable":true},"saExtractedPricePerShare":{"type":"string","nullable":true},"saExtractedInvestorType":{"type":"string","nullable":true},"saExtractedSigner":{"type":"string","nullable":true},"saExtractedSignatureDate":{"type":"string","format":"date-time","nullable":true},"saExtractedSigner2":{"type":"string","nullable":true},"saExtractedSignatureDate2":{"type":"string","format":"date-time","nullable":true},"saCheck":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"]},"saCheckedAt":{"type":"string","format":"date-time","nullable":true},"saLog":{"type":"object","properties":{"finalStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW"]},"matchResults":{"type":"array","items":{"type":"object","properties":{"tradeLineItemId":{"type":"string","example":"trade_line_item_01kctsycw3fq7sj6hedvy62cja"},"signerName":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"totalAmount":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"investorName":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"numberOfShares":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]}},"required":["tradeLineItemId"]}}},"required":["finalStatus","matchResults"],"nullable":true},"txnTid":{"type":"string","nullable":true},"txnResponse":{"type":"string","nullable":true},"txnPaymentMethod":{"type":"string","enum":["CREDIT_CARD","WIRE","ACH","BANK_ACCOUNT","CHECK","RETIREMENT"],"nullable":true},"txnCurrencyCode":{"type":"string","minLength":3,"maxLength":3,"nullable":true},"txnChargedAmount":{"type":"number","multipleOf":0.01,"nullable":true},"txnDate":{"type":"string","format":"date-time","nullable":true},"txnSettledDate":{"type":"string","format":"date-time","nullable":true},"fundingStatus":{"type":"string","enum":["PENDING","CANCELLED","SETTLED","REFUNDED","DECLINED","FUNDING","AUTHORIZING","FAILED"],"nullable":true},"fundingStatusUnmapped":{"type":"string","nullable":true},"txnCheck":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"],"nullable":true},"txnCheckedAt":{"type":"string","format":"date-time","nullable":true},"txnLog":{"type":"string","nullable":true},"systemReviewCheck":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","WARNING","INCOMPLETE"],"nullable":true},"systemReviewCheckedAt":{"type":"string","format":"date-time","nullable":true},"systemReviewLog":{"type":"string","nullable":true},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"],"nullable":true},"complianceReviewNotes":{"type":"string","nullable":true},"complianceReviewerId":{"type":"string","nullable":true},"issuerId":{"nullable":true},"complianceReviewName":{"type":"string","nullable":true},"complianceReviewAt":{"type":"string","format":"date-time","nullable":true},"tradeType":{"type":"string","enum":["PURCHASE","CONVERSION","TRANSFER"],"nullable":true},"placedAt":{"type":"string","format":"date-time","nullable":true},"platform":{"type":"string"},"cancelledAt":{"type":"string","format":"date-time","nullable":true},"cancelledById":{"type":"string","nullable":true},"cancelledReason":{"type":"string","nullable":true},"cancellationPeriod":{"type":"number","nullable":true},"disbursed":{"type":"boolean"},"tradeAdjustments":{"type":"number","nullable":true},"chargedAmount":{"type":"number","nullable":true},"balance":{"type":"number","nullable":true},"isUncleared24h":{"type":"boolean"},"term":{"type":"number","nullable":true},"exercisePrice":{"type":"number","nullable":true},"warrantPercentage":{"type":"number","nullable":true},"calculationMethod":{"type":"string","enum":["NONE","PRORATA","INCREMENT"],"nullable":true},"incrementThreshold":{"type":"number","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","investorAccountId","accountId","account","offeringId","paymentMethodId","userId","tradeNumber","ip","tid","investmentType","purchasedShares","bonusShares","totalNumberOfShares","pricePerShare","lineItems","adjustments","transactions","totalAmount","tradeStatus","tradeStatusUnmapped","tradeDate","saStatus","saStatusUnmapped","saUrl","saSignedAt","saExtractedNumberOfShares","saExtractedTotalAmount","saExtractedPricePerShare","saExtractedInvestorType","saExtractedSigner","saExtractedSignatureDate","saExtractedSigner2","saExtractedSignatureDate2","saCheck","saCheckedAt","saLog","txnTid","txnResponse","txnPaymentMethod","txnCurrencyCode","txnChargedAmount","txnDate","txnSettledDate","fundingStatus","fundingStatusUnmapped","txnCheck","txnCheckedAt","txnLog","systemReviewCheck","systemReviewCheckedAt","systemReviewLog","complianceReview","complianceReviewNotes","complianceReviewerId","issuerId","complianceReviewName","complianceReviewAt","tradeType","placedAt","platform","cancelledAt","cancelledById","cancelledReason","cancellationPeriod","isUncleared24h","term","exercisePrice","warrantPercentage","calculationMethod","incrementThreshold"]},"nullable":true},"metadata":{"type":"string","nullable":true},"status":{"type":"string","enum":["PENDING","ERROR","VALID","INVALID","NOT_PROCESSED","PROCESSING","PROCESSING_ERROR","REVIEW_ERROR","PROCESSED"]},"reviewLog":{"type":"string","nullable":true},"pipeline":{"type":"string","enum":["NONE","SUBDOCS_PHOENIX","SUBDOCS_GENERAL","AIC_TAX_RETURNS","AIC_ACCOUNT_STATEMENTS","PAY_STUBS"]},"errorMessage":{"type":"string","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","tid","url","fileType","fileName","name","category","label","private","complianceReview","targetTable","targetId","linkedFrom","accountId","userId","metadata","status","reviewLog","pipeline","errorMessage"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"422":{"description":"422","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"422"},"message":{"type":"string","example":"UNPROCESSABLE_ENTITY"},"errors":{"type":"array","items":{"type":"string"},"example":["file is required"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}},"502":{"description":"502","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"502"},"message":{"type":"string","example":"BAD_GATEWAY"},"errors":{"type":"array","items":{"type":"string"},"example":["bad gateway"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/files/{id}":{"get":{"summary":"Get file by id","tags":["files"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"getFile","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"url":{"type":"string","format":"uri","example":"https://file-location.com"},"fileType":{"type":"string","example":"pdf"},"fileName":{"type":"string","example":"test.pdf"},"name":{"type":"string","example":"test"},"category":{"type":"string","example":"application"},"label":{"type":"string","example":"other"},"private":{"type":"boolean"},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"]},"targetTable":{"type":"string","enum":["KYCS","AMLS","AICS","KYBS","INDIVIDUALS","LEGAL_ENTITIES","INVESTOR_ACCOUNTS","TRADES","OFFERINGS","ISSUERS","COVERED_PERSONS","PAYMENT_METHODS","NOTES","USERS","ACCOUNTS","PAGES","TASKS","FILES","DATA_RECORD_FILES","ASSETS","SITES","PAGE_REVISIONS","TRADE_LINE_ITEMS","TRANSACTIONS","DISBURSEMENTS","DISBURSEMENT_REVIEWS","ISSUER_PAYMENT_METHODS","SIGNER_BRANDS","THEMES","THEME_SETTINGS","CAP_TABLES","CAP_TABLE_SHARE_CLASSES","CAP_TABLE_ENTRIES","EMAIL_THEMES","EMAIL_THEME_SETTINGS"],"nullable":true},"targetId":{"type":"string","nullable":true},"linkedFrom":{"type":"string","nullable":true},"accountId":{"type":"string","example":"account_01j6aqmtfyfwy9spjdcnh7yqk7"},"userId":{"type":"string","example":"user_01j6aqmtfyfwy9spjdcnh7yqk7"},"kycs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"platform":{"type":"string","example":"KYC Platform"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Passport"},"documentImage":{"type":"string","example":"https://example.com/passport.jpg"},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Document unclear"},"response":{"type":"string","nullable":true,"example":"Submitted clearer document"}},"required":["id","createdAt","updatedAt","deletedAt","tid","platform","individualId","documentType","documentImage","kycStatus","reason","response"]},"nullable":true},"kybs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_kyb_123"},"platform":{"type":"string","example":"KYB Platform"},"legalEntityId":{"type":"string","example":"legal_entity_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Certificate of Incorporation"},"documentImage":{"type":"string","example":"https://example.com/document.pdf"},"kybStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Additional information required"},"response":{"type":"string","nullable":true,"example":"Submitted additional documents"}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","platform","legalEntityId","documentType","documentImage","kybStatus","reason","response"]},"nullable":true},"individuals":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"accountId":{"type":"string"},"account":{},"investorAccountId":{"type":"string"},"investorAccount":{},"role":{"type":"string","enum":["PRIMARY","JOINT"]},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"]},"kycFirstName":{"type":"string","nullable":true},"kycLastName":{"type":"string","nullable":true},"kycDocumentType":{"type":"string","enum":["PASSPORT","DRIVER_LICENSE","STATE_ID"],"nullable":true},"kycDocumentIssuer":{"type":"string","nullable":true},"kycDocumentNumber":{"type":"string","nullable":true},"kycIssuerDate":{"type":"string","nullable":true},"kycExpirationDate":{"type":"string","nullable":true},"kycCheck":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"]},"kycCheckedAt":{"type":"string","format":"date-time","nullable":true},"kycLog":{"type":"string","nullable":true},"kycReviewedById":{"type":"string","nullable":true},"kycReviewedAt":{"type":"string","format":"date-time","nullable":true},"kycDocumentFrontFileId":{"type":"string","nullable":true},"kycDocumentFrontFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"kycDocumentBackFileId":{"type":"string","nullable":true},"kycDocumentBackFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"kycSelfieFileId":{"type":"string","nullable":true},"kycSelfieFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"sanctionsStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"]},"amlStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","ERROR"]},"amlProvider":{"type":"string","enum":["ComplyAdvantage"],"nullable":true},"amlTid":{"type":"string","nullable":true},"amlUrl":{"type":"string","nullable":true},"amlCheckedAt":{"type":"string","format":"date-time","nullable":true},"amlLog":{"type":"string","nullable":true},"amlLogData":{"type":"string","nullable":true},"amlReviewedById":{"type":"string","nullable":true},"amlReviewedAt":{"type":"string","format":"date-time","nullable":true},"liquidNetWorth":{"type":"number","multipleOf":0.01,"nullable":true},"liquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"illiquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"privateSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"aicAccreditationType":{"type":"string","enum":["PENDING","INCOME","NET_WORTH","PROFESSIONAL_CERTIFICATION","KNOWLEDGEABLE_EMPLOYEE"]},"aicExpirationDate":{"type":"string","format":"date-time","nullable":true},"aicQuestionnaire":{"type":"string","nullable":true},"aicStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","PROCESSED"]},"aicCheckedAt":{"type":"string","format":"date-time","nullable":true},"aicLog":{"type":"string","nullable":true},"aicReviewedById":{"type":"string","nullable":true},"aicReviewedAt":{"type":"string","format":"date-time","nullable":true},"iraQuestionnaire":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"hasIraAccounts":{"type":"boolean"},"inSelfDirectedIra":{"type":"boolean"},"custodian":{"type":"string"},"hasOtherQualifiedFunds":{"type":"boolean"}},"required":["id","hasIraAccounts","inSelfDirectedIra","custodian","hasOtherQualifiedFunds"]},"nullable":true},"iraCheck":{"type":"string","enum":["PENDING","APPROVED","NEEDS_REVIEW","REJECTED"]},"iraCheckedAt":{"type":"string","format":"date-time","nullable":true},"iraLog":{"type":"string","nullable":true},"iraReviewedById":{"type":"string","nullable":true},"iraReviewedAt":{"type":"string","format":"date-time","nullable":true},"firstName":{"type":"string"},"lastName":{"type":"string","nullable":true},"dob":{"type":"string","format":"date-time","nullable":true},"isUsCitizenOrGreenCardHolder":{"type":"boolean"},"citizenship":{"type":"string","enum":["AD","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","CU","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","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","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","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","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","YE","YT","ZA","ZM","ZW"],"nullable":true},"ssn":{"type":"string","nullable":true},"lastFour":{"type":"string","nullable":true},"address":{"type":"string","nullable":true},"address2":{"type":"string","nullable":true},"email":{"type":"string","format":"email","nullable":true},"phone":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"state":{"type":"string","nullable":true},"zip":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"kycTid":{"type":"string","nullable":true},"currencyCode":{"type":"string","minLength":3,"maxLength":3,"nullable":true},"investedInCrowdfunding":{"type":"number","nullable":true},"currentAnnualIncome":{"type":"number","nullable":true},"averageAnnualIncome":{"type":"number","nullable":true},"averageHouseholdIncome":{"type":"number","nullable":true},"currentHouseholdIncome":{"type":"number","nullable":true},"householdNetWorth":{"type":"number","nullable":true},"isSolicited":{"type":"boolean"},"isRealEstate":{"type":"boolean"},"iliquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"timeHorizon":{"type":"string","nullable":true},"riskTolerance":{"type":"string","nullable":true},"investmentObjective":{"type":"string","nullable":true},"investmentExperience":{"type":"string","nullable":true},"experienceInPrivate":{"type":"string","nullable":true},"levelOfEducation":{"type":"string","nullable":true},"financialAdvisor":{"type":"boolean"},"occupation":{"type":"string","nullable":true},"employmentStatus":{"type":"string","enum":["EMPLOYED","UNEMPLOYED","SELF_EMPLOYED","RETIRED","STUDENT","OTHER"]},"employerName":{"type":"string","nullable":true},"employerAddressLine1":{"type":"string","nullable":true},"employerAddressLine2":{"type":"string","nullable":true},"employerCity":{"type":"string","nullable":true},"employerState":{"type":"string","nullable":true},"employerZip":{"type":"string","nullable":true},"employerCountry":{"type":"string","nullable":true},"notes":{"type":"string","nullable":true},"kycs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"platform":{"type":"string","example":"KYC Platform"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Passport"},"documentImage":{"type":"string","example":"https://example.com/passport.jpg"},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Document unclear"},"response":{"type":"string","nullable":true,"example":"Submitted clearer document"}},"required":["id","createdAt","updatedAt","deletedAt","tid","platform","individualId","documentType","documentImage","kycStatus","reason","response"]},"nullable":true},"amls":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"provider":{"type":"string","nullable":true,"example":"AML Provider"},"url":{"type":"string","nullable":true,"example":"https://example.com/aml"},"status":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","ERROR"],"example":"PENDING"},"checkedAt":{"type":"string","format":"date-time","nullable":true,"example":"2022-01-01T00:00:00Z"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"}},"required":["id","createdAt","updatedAt","deletedAt","tid","provider","url","status","checkedAt","individualId"]},"nullable":true},"aics":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"individualId":{},"individual":{"nullable":true},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"]},"reviewedById":{"nullable":true},"reviewedBy":{"nullable":true},"reviewedAt":{"type":"string","format":"date-time","nullable":true},"systemReview":{"type":"string","enum":["PENDING","NEEDS_INFO","READY_TO_APPROVE","NEEDS_REVIEW","APPROVED","REJECTED"]},"systemLog":{"type":"array","items":{"type":"object","properties":{"check":{"type":"string","minLength":1},"entered":{"type":"number"},"extracted":{"type":"number"},"result":{"type":"string","enum":["PASS","FAIL"]},"reason":{"type":"string"}},"required":["check","result"]},"nullable":true},"firstName":{"type":"string"},"lastName":{"type":"string"},"method":{"type":"string","enum":["PENDING","INCOME","NET_WORTH","PROFESSIONAL_CERTIFICATION","KNOWLEDGEABLE_EMPLOYEE"]},"incomeData":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer","minimum":2020,"maximum":2025},"filingStatus":{"type":"string","enum":["SINGLE","JOINT"]},"income":{"type":"number","minimum":0,"multipleOf":0.01},"fileId":{}},"required":["year","filingStatus","income","fileId"]},"nullable":true},"netWorthData":{"type":"array","items":{"type":"object","properties":{"institution":{"type":"string","minLength":1,"maxLength":100},"accountType":{"type":"string","enum":["CHECKING","SAVINGS","BROKERAGE","REAL_ESTATE","OTHER"]},"balance":{"type":"number","minimum":0,"multipleOf":0.01},"fileId":{}},"required":["institution","accountType","balance","fileId"]},"nullable":true},"professionalData":{"type":"array","items":{"type":"object","properties":{"professionalType":{"type":"string","enum":["SECURITIES_LICENSES","DIRECTORS","FAMILY_OFFICE"]},"licenseNumber":{"type":"string","minLength":1,"maxLength":50,"nullable":true},"fileId":{"nullable":true}},"required":["professionalType"]},"nullable":true},"employeeData":{"type":"array","items":{"type":"object","properties":{"position":{"type":"string","minLength":1,"maxLength":100},"fileId":{}},"required":["position","fileId"]},"nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","individualId","complianceReview","reviewedById","reviewedAt","systemReview","systemLog","firstName","lastName","method","incomeData","netWorthData","professionalData","employeeData"]},"nullable":true},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]},"setupStep":{"type":"string","enum":["NEW","PERSONAL_INFO","ADDRESS","KYC","INCOME","AIC_QUESTIONS","AIC_FILES"]},"sourceOfIncome":{"type":"string","enum":["EMPLOYED","SELF_EMPLOYED","UNEMPLOYED","RETIREMENT","STUDENT"],"nullable":true},"ownership":{"type":"number","nullable":true},"kycProvider":{"type":"string","nullable":true},"retirementAccountType":{"type":"string","enum":["SELF_DIRECTED","CUSTODIAN_MANAGED"],"nullable":true},"custodianName":{"type":"string","nullable":true},"custodianAccountNumber":{"type":"string","nullable":true},"custodianRepresentativeName":{"type":"string","nullable":true},"custodianEmail":{"type":"string","format":"email","nullable":true},"accredited":{"type":"boolean"}},"required":["id","createdAt","updatedAt","deletedAt","tid","accountId","investorAccountId","role","kycStatus","kycFirstName","kycLastName","kycDocumentType","kycDocumentIssuer","kycDocumentNumber","kycIssuerDate","kycExpirationDate","kycCheck","kycCheckedAt","kycLog","kycReviewedById","kycReviewedAt","kycDocumentFrontFileId","kycDocumentBackFileId","kycSelfieFileId","sanctionsStatus","amlStatus","amlProvider","amlTid","amlUrl","amlCheckedAt","amlLog","amlLogData","amlReviewedById","amlReviewedAt","liquidNetWorth","liquidSecurities","illiquidSecurities","privateSecurities","aicAccreditationType","aicExpirationDate","aicQuestionnaire","aicStatus","aicCheckedAt","aicLog","aicReviewedById","aicReviewedAt","iraQuestionnaire","iraCheck","iraCheckedAt","iraLog","iraReviewedById","iraReviewedAt","firstName","lastName","dob","isUsCitizenOrGreenCardHolder","ssn","lastFour","address","address2","email","phone","city","state","zip","country","kycTid","currencyCode","investedInCrowdfunding","currentAnnualIncome","averageAnnualIncome","averageHouseholdIncome","currentHouseholdIncome","householdNetWorth","isSolicited","isRealEstate","timeHorizon","riskTolerance","investmentObjective","investmentExperience","experienceInPrivate","levelOfEducation","financialAdvisor","occupation","employmentStatus","employerName","employerAddressLine1","employerAddressLine2","employerCity","employerState","employerZip","employerCountry","notes","setupStatus","setupStep","sourceOfIncome","ownership","kycProvider","accredited"]},"nullable":true},"legalEntities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_legal_entity_123","nullable":true},"accountId":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6"},"investorAccountId":{"type":"string","example":"investor_account_01j1xgme5qeqq97gpdztd7e4a7"},"kybStatus":{"example":"PENDING"},"sanctionsStatus":{"example":"PENDING"},"kybs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_kyb_123"},"platform":{"type":"string","example":"KYB Platform"},"legalEntityId":{"type":"string","example":"legal_entity_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Certificate of Incorporation"},"documentImage":{"type":"string","example":"https://example.com/document.pdf"},"kybStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Additional information required"},"response":{"type":"string","nullable":true,"example":"Submitted additional documents"}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","platform","legalEntityId","documentType","documentImage","kybStatus","reason","response"]}},"name":{"type":"string","example":"Acme Corporation"},"ein":{"type":"string","example":"12-3456789","nullable":true},"companyType":{"type":"string","example":"LLC","nullable":true},"streetAddress":{"type":"string","example":"123 Main St","nullable":true},"city":{"type":"string","example":"Anytown","nullable":true},"state":{"type":"string","example":"CA","nullable":true},"zip":{"type":"string","example":"12345","nullable":true},"country":{"type":"string","example":"USA","nullable":true},"phone":{"type":"string","example":"+12124567890","nullable":true},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","accountId","investorAccountId","kybStatus","sanctionsStatus","name","state","setupStatus"]},"nullable":true},"investorAccounts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"investorAccountType":{"type":"string","enum":["INDIVIDUAL","JOINT","RETIREMENT","LEGAL_ENTITY"]},"user":{"nullable":true},"userId":{"type":"string","nullable":true},"email":{"type":"string","format":"email","nullable":true},"name":{"type":"string","nullable":true},"regAQualified":{"type":"boolean"},"regCfQualified":{"type":"boolean"},"regDQualified":{"type":"boolean"},"accountId":{"type":"string"},"account":{},"trades":{"type":"array","items":{}},"individuals":{"type":"array","items":{}},"legalEntities":{"type":"array","items":{}},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]},"systemReviewLog":{"type":"string","nullable":true},"totalAmount":{"type":"number"},"statusCheck":{},"trustedContacts":{"type":"array","items":{}}},"required":["id","createdAt","updatedAt","deletedAt","tid","investorAccountType","regAQualified","regCfQualified","regDQualified","accountId","setupStatus","systemReviewLog"]},"nullable":true},"trades":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"investorAccountId":{"nullable":true},"investorAccount":{"nullable":true},"offering":{"nullable":true},"accountId":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6","accountId":"account_00041061050r3gg28a1c60t3gf","nullable":true},"account":{"nullable":true},"offeringId":{"nullable":true},"paymentMethodId":{"nullable":true},"paymentMethod":{"nullable":true},"userId":{"nullable":true},"tradeNumber":{"type":"string"},"ip":{"type":"string","nullable":true},"tid":{"type":"string","nullable":true},"investmentType":{"type":"string","enum":["INDIVIDUAL","JOINT","ENTITY"]},"purchasedShares":{"type":"integer"},"bonusShares":{"type":"integer","nullable":true},"totalNumberOfShares":{"type":"integer"},"pricePerShare":{"type":"number","multipleOf":0.01},"lineItems":{"type":"array","items":{}},"adjustments":{"type":"array","items":{}},"transactions":{"type":"array","items":{}},"totalAmount":{"type":"number","multipleOf":0.01,"nullable":true},"tradeStatus":{"type":"string","enum":["CART","PLACED","IN_REVIEW","NEEDS_INFO","NEEDS_PAYMENT_INFO","FUNDING","CANCELLED","SETTLED","IMPORT_ERROR","ERROR","UPDATE_PAYMENT_METHOD"]},"tradeStatusUnmapped":{"type":"string","nullable":true},"tradeDate":{"type":"string","format":"date-time","nullable":true},"saStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW"]},"saStatusUnmapped":{"type":"string","nullable":true},"saUrl":{"type":"string","nullable":true},"saSignedAt":{"type":"string","format":"date-time","nullable":true},"saExtractedNumberOfShares":{"type":"string","nullable":true},"saExtractedTotalAmount":{"type":"string","nullable":true},"saExtractedPricePerShare":{"type":"string","nullable":true},"saExtractedInvestorType":{"type":"string","nullable":true},"saExtractedSigner":{"type":"string","nullable":true},"saExtractedSignatureDate":{"type":"string","format":"date-time","nullable":true},"saExtractedSigner2":{"type":"string","nullable":true},"saExtractedSignatureDate2":{"type":"string","format":"date-time","nullable":true},"saCheck":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"]},"saCheckedAt":{"type":"string","format":"date-time","nullable":true},"saLog":{"type":"object","properties":{"finalStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW"]},"matchResults":{"type":"array","items":{"type":"object","properties":{"tradeLineItemId":{"type":"string","example":"trade_line_item_01kctsycw3fq7sj6hedvy62cja"},"signerName":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"totalAmount":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"investorName":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"numberOfShares":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]}},"required":["tradeLineItemId"]}}},"required":["finalStatus","matchResults"],"nullable":true},"txnTid":{"type":"string","nullable":true},"txnResponse":{"type":"string","nullable":true},"txnPaymentMethod":{"type":"string","enum":["CREDIT_CARD","WIRE","ACH","BANK_ACCOUNT","CHECK","RETIREMENT"],"nullable":true},"txnCurrencyCode":{"type":"string","minLength":3,"maxLength":3,"nullable":true},"txnChargedAmount":{"type":"number","multipleOf":0.01,"nullable":true},"txnDate":{"type":"string","format":"date-time","nullable":true},"txnSettledDate":{"type":"string","format":"date-time","nullable":true},"fundingStatus":{"type":"string","enum":["PENDING","CANCELLED","SETTLED","REFUNDED","DECLINED","FUNDING","AUTHORIZING","FAILED"],"nullable":true},"fundingStatusUnmapped":{"type":"string","nullable":true},"txnCheck":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"],"nullable":true},"txnCheckedAt":{"type":"string","format":"date-time","nullable":true},"txnLog":{"type":"string","nullable":true},"systemReviewCheck":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","WARNING","INCOMPLETE"],"nullable":true},"systemReviewCheckedAt":{"type":"string","format":"date-time","nullable":true},"systemReviewLog":{"type":"string","nullable":true},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"],"nullable":true},"complianceReviewNotes":{"type":"string","nullable":true},"complianceReviewerId":{"type":"string","nullable":true},"issuerId":{"nullable":true},"complianceReviewName":{"type":"string","nullable":true},"complianceReviewAt":{"type":"string","format":"date-time","nullable":true},"tradeType":{"type":"string","enum":["PURCHASE","CONVERSION","TRANSFER"],"nullable":true},"placedAt":{"type":"string","format":"date-time","nullable":true},"platform":{"type":"string"},"cancelledAt":{"type":"string","format":"date-time","nullable":true},"cancelledById":{"type":"string","nullable":true},"cancelledReason":{"type":"string","nullable":true},"cancellationPeriod":{"type":"number","nullable":true},"disbursed":{"type":"boolean"},"tradeAdjustments":{"type":"number","nullable":true},"chargedAmount":{"type":"number","nullable":true},"balance":{"type":"number","nullable":true},"isUncleared24h":{"type":"boolean"},"term":{"type":"number","nullable":true},"exercisePrice":{"type":"number","nullable":true},"warrantPercentage":{"type":"number","nullable":true},"calculationMethod":{"type":"string","enum":["NONE","PRORATA","INCREMENT"],"nullable":true},"incrementThreshold":{"type":"number","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","investorAccountId","accountId","account","offeringId","paymentMethodId","userId","tradeNumber","ip","tid","investmentType","purchasedShares","bonusShares","totalNumberOfShares","pricePerShare","lineItems","adjustments","transactions","totalAmount","tradeStatus","tradeStatusUnmapped","tradeDate","saStatus","saStatusUnmapped","saUrl","saSignedAt","saExtractedNumberOfShares","saExtractedTotalAmount","saExtractedPricePerShare","saExtractedInvestorType","saExtractedSigner","saExtractedSignatureDate","saExtractedSigner2","saExtractedSignatureDate2","saCheck","saCheckedAt","saLog","txnTid","txnResponse","txnPaymentMethod","txnCurrencyCode","txnChargedAmount","txnDate","txnSettledDate","fundingStatus","fundingStatusUnmapped","txnCheck","txnCheckedAt","txnLog","systemReviewCheck","systemReviewCheckedAt","systemReviewLog","complianceReview","complianceReviewNotes","complianceReviewerId","issuerId","complianceReviewName","complianceReviewAt","tradeType","placedAt","platform","cancelledAt","cancelledById","cancelledReason","cancellationPeriod","isUncleared24h","term","exercisePrice","warrantPercentage","calculationMethod","incrementThreshold"]},"nullable":true},"metadata":{"type":"string","nullable":true},"status":{"type":"string","enum":["PENDING","ERROR","VALID","INVALID","NOT_PROCESSED","PROCESSING","PROCESSING_ERROR","REVIEW_ERROR","PROCESSED"]},"reviewLog":{"type":"string","nullable":true},"pipeline":{"type":"string","enum":["NONE","SUBDOCS_PHOENIX","SUBDOCS_GENERAL","AIC_TAX_RETURNS","AIC_ACCOUNT_STATEMENTS","PAY_STUBS"]},"errorMessage":{"type":"string","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","tid","url","fileType","fileName","name","category","label","private","complianceReview","targetTable","targetId","linkedFrom","accountId","userId","metadata","status","reviewLog","pipeline","errorMessage"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]},"patch":{"summary":"Update file by id","tags":["files"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"patchFile","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":50},"category":{"type":"string","maxLength":50},"label":{"type":"string","enum":["PROOF_OF_INCOME","PROOF_OF_NET_WORTH","EMPLOYEE","TAX_RETURNS","ACCOUNT_STATEMENT","ACCREDITATION_LETTER","LICENSE","IDENTITY_FRONT","IDENTITY_BACK","BAD_ACTOR_REPORT_FILE","OTHER","COMPLIANCE_REQUEST","SUB_DOC","CONTENT_FILE","CSV_EXPORT_FILE","CUSTODIAN_INSTRUCTION_DOCUMENT","LOGO","FAVICON","BACKGROUND_IMAGE","MEMORANDUM","SUBSCRIPTION_AGREEMENT","COVER_ART","ESCROW_AGREEMENT","SS4_LETTER","FORMATION_DOCUMENT","PASSPORT","TRADE_DOCUMENT"],"example":"OTHER"},"metadata":{"type":"string","minLength":2,"maxLength":600000,"nullable":true}},"required":["name","category","label"]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"url":{"type":"string","format":"uri","example":"https://file-location.com"},"fileType":{"type":"string","example":"pdf"},"fileName":{"type":"string","example":"test.pdf"},"name":{"type":"string","example":"test"},"category":{"type":"string","example":"application"},"label":{"type":"string","example":"other"},"private":{"type":"boolean"},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"]},"targetTable":{"type":"string","enum":["KYCS","AMLS","AICS","KYBS","INDIVIDUALS","LEGAL_ENTITIES","INVESTOR_ACCOUNTS","TRADES","OFFERINGS","ISSUERS","COVERED_PERSONS","PAYMENT_METHODS","NOTES","USERS","ACCOUNTS","PAGES","TASKS","FILES","DATA_RECORD_FILES","ASSETS","SITES","PAGE_REVISIONS","TRADE_LINE_ITEMS","TRANSACTIONS","DISBURSEMENTS","DISBURSEMENT_REVIEWS","ISSUER_PAYMENT_METHODS","SIGNER_BRANDS","THEMES","THEME_SETTINGS","CAP_TABLES","CAP_TABLE_SHARE_CLASSES","CAP_TABLE_ENTRIES","EMAIL_THEMES","EMAIL_THEME_SETTINGS"],"nullable":true},"targetId":{"type":"string","nullable":true},"linkedFrom":{"type":"string","nullable":true},"accountId":{"type":"string","example":"account_01j6aqmtfyfwy9spjdcnh7yqk7"},"userId":{"type":"string","example":"user_01j6aqmtfyfwy9spjdcnh7yqk7"},"kycs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"platform":{"type":"string","example":"KYC Platform"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Passport"},"documentImage":{"type":"string","example":"https://example.com/passport.jpg"},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Document unclear"},"response":{"type":"string","nullable":true,"example":"Submitted clearer document"}},"required":["id","createdAt","updatedAt","deletedAt","tid","platform","individualId","documentType","documentImage","kycStatus","reason","response"]},"nullable":true},"kybs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_kyb_123"},"platform":{"type":"string","example":"KYB Platform"},"legalEntityId":{"type":"string","example":"legal_entity_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Certificate of Incorporation"},"documentImage":{"type":"string","example":"https://example.com/document.pdf"},"kybStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Additional information required"},"response":{"type":"string","nullable":true,"example":"Submitted additional documents"}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","platform","legalEntityId","documentType","documentImage","kybStatus","reason","response"]},"nullable":true},"individuals":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"accountId":{"type":"string"},"account":{},"investorAccountId":{"type":"string"},"investorAccount":{},"role":{"type":"string","enum":["PRIMARY","JOINT"]},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"]},"kycFirstName":{"type":"string","nullable":true},"kycLastName":{"type":"string","nullable":true},"kycDocumentType":{"type":"string","enum":["PASSPORT","DRIVER_LICENSE","STATE_ID"],"nullable":true},"kycDocumentIssuer":{"type":"string","nullable":true},"kycDocumentNumber":{"type":"string","nullable":true},"kycIssuerDate":{"type":"string","nullable":true},"kycExpirationDate":{"type":"string","nullable":true},"kycCheck":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"]},"kycCheckedAt":{"type":"string","format":"date-time","nullable":true},"kycLog":{"type":"string","nullable":true},"kycReviewedById":{"type":"string","nullable":true},"kycReviewedAt":{"type":"string","format":"date-time","nullable":true},"kycDocumentFrontFileId":{"type":"string","nullable":true},"kycDocumentFrontFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"kycDocumentBackFileId":{"type":"string","nullable":true},"kycDocumentBackFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"kycSelfieFileId":{"type":"string","nullable":true},"kycSelfieFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"sanctionsStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"]},"amlStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","ERROR"]},"amlProvider":{"type":"string","enum":["ComplyAdvantage"],"nullable":true},"amlTid":{"type":"string","nullable":true},"amlUrl":{"type":"string","nullable":true},"amlCheckedAt":{"type":"string","format":"date-time","nullable":true},"amlLog":{"type":"string","nullable":true},"amlLogData":{"type":"string","nullable":true},"amlReviewedById":{"type":"string","nullable":true},"amlReviewedAt":{"type":"string","format":"date-time","nullable":true},"liquidNetWorth":{"type":"number","multipleOf":0.01,"nullable":true},"liquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"illiquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"privateSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"aicAccreditationType":{"type":"string","enum":["PENDING","INCOME","NET_WORTH","PROFESSIONAL_CERTIFICATION","KNOWLEDGEABLE_EMPLOYEE"]},"aicExpirationDate":{"type":"string","format":"date-time","nullable":true},"aicQuestionnaire":{"type":"string","nullable":true},"aicStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","PROCESSED"]},"aicCheckedAt":{"type":"string","format":"date-time","nullable":true},"aicLog":{"type":"string","nullable":true},"aicReviewedById":{"type":"string","nullable":true},"aicReviewedAt":{"type":"string","format":"date-time","nullable":true},"iraQuestionnaire":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"hasIraAccounts":{"type":"boolean"},"inSelfDirectedIra":{"type":"boolean"},"custodian":{"type":"string"},"hasOtherQualifiedFunds":{"type":"boolean"}},"required":["id","hasIraAccounts","inSelfDirectedIra","custodian","hasOtherQualifiedFunds"]},"nullable":true},"iraCheck":{"type":"string","enum":["PENDING","APPROVED","NEEDS_REVIEW","REJECTED"]},"iraCheckedAt":{"type":"string","format":"date-time","nullable":true},"iraLog":{"type":"string","nullable":true},"iraReviewedById":{"type":"string","nullable":true},"iraReviewedAt":{"type":"string","format":"date-time","nullable":true},"firstName":{"type":"string"},"lastName":{"type":"string","nullable":true},"dob":{"type":"string","format":"date-time","nullable":true},"isUsCitizenOrGreenCardHolder":{"type":"boolean"},"citizenship":{"type":"string","enum":["AD","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","CU","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","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","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","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","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","YE","YT","ZA","ZM","ZW"],"nullable":true},"ssn":{"type":"string","nullable":true},"lastFour":{"type":"string","nullable":true},"address":{"type":"string","nullable":true},"address2":{"type":"string","nullable":true},"email":{"type":"string","format":"email","nullable":true},"phone":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"state":{"type":"string","nullable":true},"zip":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"kycTid":{"type":"string","nullable":true},"currencyCode":{"type":"string","minLength":3,"maxLength":3,"nullable":true},"investedInCrowdfunding":{"type":"number","nullable":true},"currentAnnualIncome":{"type":"number","nullable":true},"averageAnnualIncome":{"type":"number","nullable":true},"averageHouseholdIncome":{"type":"number","nullable":true},"currentHouseholdIncome":{"type":"number","nullable":true},"householdNetWorth":{"type":"number","nullable":true},"isSolicited":{"type":"boolean"},"isRealEstate":{"type":"boolean"},"iliquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"timeHorizon":{"type":"string","nullable":true},"riskTolerance":{"type":"string","nullable":true},"investmentObjective":{"type":"string","nullable":true},"investmentExperience":{"type":"string","nullable":true},"experienceInPrivate":{"type":"string","nullable":true},"levelOfEducation":{"type":"string","nullable":true},"financialAdvisor":{"type":"boolean"},"occupation":{"type":"string","nullable":true},"employmentStatus":{"type":"string","enum":["EMPLOYED","UNEMPLOYED","SELF_EMPLOYED","RETIRED","STUDENT","OTHER"]},"employerName":{"type":"string","nullable":true},"employerAddressLine1":{"type":"string","nullable":true},"employerAddressLine2":{"type":"string","nullable":true},"employerCity":{"type":"string","nullable":true},"employerState":{"type":"string","nullable":true},"employerZip":{"type":"string","nullable":true},"employerCountry":{"type":"string","nullable":true},"notes":{"type":"string","nullable":true},"kycs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"platform":{"type":"string","example":"KYC Platform"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Passport"},"documentImage":{"type":"string","example":"https://example.com/passport.jpg"},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Document unclear"},"response":{"type":"string","nullable":true,"example":"Submitted clearer document"}},"required":["id","createdAt","updatedAt","deletedAt","tid","platform","individualId","documentType","documentImage","kycStatus","reason","response"]},"nullable":true},"amls":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"provider":{"type":"string","nullable":true,"example":"AML Provider"},"url":{"type":"string","nullable":true,"example":"https://example.com/aml"},"status":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","ERROR"],"example":"PENDING"},"checkedAt":{"type":"string","format":"date-time","nullable":true,"example":"2022-01-01T00:00:00Z"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"}},"required":["id","createdAt","updatedAt","deletedAt","tid","provider","url","status","checkedAt","individualId"]},"nullable":true},"aics":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"individualId":{},"individual":{"nullable":true},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"]},"reviewedById":{"nullable":true},"reviewedBy":{"nullable":true},"reviewedAt":{"type":"string","format":"date-time","nullable":true},"systemReview":{"type":"string","enum":["PENDING","NEEDS_INFO","READY_TO_APPROVE","NEEDS_REVIEW","APPROVED","REJECTED"]},"systemLog":{"type":"array","items":{"type":"object","properties":{"check":{"type":"string","minLength":1},"entered":{"type":"number"},"extracted":{"type":"number"},"result":{"type":"string","enum":["PASS","FAIL"]},"reason":{"type":"string"}},"required":["check","result"]},"nullable":true},"firstName":{"type":"string"},"lastName":{"type":"string"},"method":{"type":"string","enum":["PENDING","INCOME","NET_WORTH","PROFESSIONAL_CERTIFICATION","KNOWLEDGEABLE_EMPLOYEE"]},"incomeData":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer","minimum":2020,"maximum":2025},"filingStatus":{"type":"string","enum":["SINGLE","JOINT"]},"income":{"type":"number","minimum":0,"multipleOf":0.01},"fileId":{}},"required":["year","filingStatus","income","fileId"]},"nullable":true},"netWorthData":{"type":"array","items":{"type":"object","properties":{"institution":{"type":"string","minLength":1,"maxLength":100},"accountType":{"type":"string","enum":["CHECKING","SAVINGS","BROKERAGE","REAL_ESTATE","OTHER"]},"balance":{"type":"number","minimum":0,"multipleOf":0.01},"fileId":{}},"required":["institution","accountType","balance","fileId"]},"nullable":true},"professionalData":{"type":"array","items":{"type":"object","properties":{"professionalType":{"type":"string","enum":["SECURITIES_LICENSES","DIRECTORS","FAMILY_OFFICE"]},"licenseNumber":{"type":"string","minLength":1,"maxLength":50,"nullable":true},"fileId":{"nullable":true}},"required":["professionalType"]},"nullable":true},"employeeData":{"type":"array","items":{"type":"object","properties":{"position":{"type":"string","minLength":1,"maxLength":100},"fileId":{}},"required":["position","fileId"]},"nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","individualId","complianceReview","reviewedById","reviewedAt","systemReview","systemLog","firstName","lastName","method","incomeData","netWorthData","professionalData","employeeData"]},"nullable":true},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]},"setupStep":{"type":"string","enum":["NEW","PERSONAL_INFO","ADDRESS","KYC","INCOME","AIC_QUESTIONS","AIC_FILES"]},"sourceOfIncome":{"type":"string","enum":["EMPLOYED","SELF_EMPLOYED","UNEMPLOYED","RETIREMENT","STUDENT"],"nullable":true},"ownership":{"type":"number","nullable":true},"kycProvider":{"type":"string","nullable":true},"retirementAccountType":{"type":"string","enum":["SELF_DIRECTED","CUSTODIAN_MANAGED"],"nullable":true},"custodianName":{"type":"string","nullable":true},"custodianAccountNumber":{"type":"string","nullable":true},"custodianRepresentativeName":{"type":"string","nullable":true},"custodianEmail":{"type":"string","format":"email","nullable":true},"accredited":{"type":"boolean"}},"required":["id","createdAt","updatedAt","deletedAt","tid","accountId","investorAccountId","role","kycStatus","kycFirstName","kycLastName","kycDocumentType","kycDocumentIssuer","kycDocumentNumber","kycIssuerDate","kycExpirationDate","kycCheck","kycCheckedAt","kycLog","kycReviewedById","kycReviewedAt","kycDocumentFrontFileId","kycDocumentBackFileId","kycSelfieFileId","sanctionsStatus","amlStatus","amlProvider","amlTid","amlUrl","amlCheckedAt","amlLog","amlLogData","amlReviewedById","amlReviewedAt","liquidNetWorth","liquidSecurities","illiquidSecurities","privateSecurities","aicAccreditationType","aicExpirationDate","aicQuestionnaire","aicStatus","aicCheckedAt","aicLog","aicReviewedById","aicReviewedAt","iraQuestionnaire","iraCheck","iraCheckedAt","iraLog","iraReviewedById","iraReviewedAt","firstName","lastName","dob","isUsCitizenOrGreenCardHolder","ssn","lastFour","address","address2","email","phone","city","state","zip","country","kycTid","currencyCode","investedInCrowdfunding","currentAnnualIncome","averageAnnualIncome","averageHouseholdIncome","currentHouseholdIncome","householdNetWorth","isSolicited","isRealEstate","timeHorizon","riskTolerance","investmentObjective","investmentExperience","experienceInPrivate","levelOfEducation","financialAdvisor","occupation","employmentStatus","employerName","employerAddressLine1","employerAddressLine2","employerCity","employerState","employerZip","employerCountry","notes","setupStatus","setupStep","sourceOfIncome","ownership","kycProvider","accredited"]},"nullable":true},"legalEntities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_legal_entity_123","nullable":true},"accountId":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6"},"investorAccountId":{"type":"string","example":"investor_account_01j1xgme5qeqq97gpdztd7e4a7"},"kybStatus":{"example":"PENDING"},"sanctionsStatus":{"example":"PENDING"},"kybs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_kyb_123"},"platform":{"type":"string","example":"KYB Platform"},"legalEntityId":{"type":"string","example":"legal_entity_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Certificate of Incorporation"},"documentImage":{"type":"string","example":"https://example.com/document.pdf"},"kybStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Additional information required"},"response":{"type":"string","nullable":true,"example":"Submitted additional documents"}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","platform","legalEntityId","documentType","documentImage","kybStatus","reason","response"]}},"name":{"type":"string","example":"Acme Corporation"},"ein":{"type":"string","example":"12-3456789","nullable":true},"companyType":{"type":"string","example":"LLC","nullable":true},"streetAddress":{"type":"string","example":"123 Main St","nullable":true},"city":{"type":"string","example":"Anytown","nullable":true},"state":{"type":"string","example":"CA","nullable":true},"zip":{"type":"string","example":"12345","nullable":true},"country":{"type":"string","example":"USA","nullable":true},"phone":{"type":"string","example":"+12124567890","nullable":true},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","accountId","investorAccountId","kybStatus","sanctionsStatus","name","state","setupStatus"]},"nullable":true},"investorAccounts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"investorAccountType":{"type":"string","enum":["INDIVIDUAL","JOINT","RETIREMENT","LEGAL_ENTITY"]},"user":{"nullable":true},"userId":{"type":"string","nullable":true},"email":{"type":"string","format":"email","nullable":true},"name":{"type":"string","nullable":true},"regAQualified":{"type":"boolean"},"regCfQualified":{"type":"boolean"},"regDQualified":{"type":"boolean"},"accountId":{"type":"string"},"account":{},"trades":{"type":"array","items":{}},"individuals":{"type":"array","items":{}},"legalEntities":{"type":"array","items":{}},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]},"systemReviewLog":{"type":"string","nullable":true},"totalAmount":{"type":"number"},"statusCheck":{},"trustedContacts":{"type":"array","items":{}}},"required":["id","createdAt","updatedAt","deletedAt","tid","investorAccountType","regAQualified","regCfQualified","regDQualified","accountId","setupStatus","systemReviewLog"]},"nullable":true},"trades":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"investorAccountId":{"nullable":true},"investorAccount":{"nullable":true},"offering":{"nullable":true},"accountId":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6","accountId":"account_00041061050r3gg28a1c60t3gf","nullable":true},"account":{"nullable":true},"offeringId":{"nullable":true},"paymentMethodId":{"nullable":true},"paymentMethod":{"nullable":true},"userId":{"nullable":true},"tradeNumber":{"type":"string"},"ip":{"type":"string","nullable":true},"tid":{"type":"string","nullable":true},"investmentType":{"type":"string","enum":["INDIVIDUAL","JOINT","ENTITY"]},"purchasedShares":{"type":"integer"},"bonusShares":{"type":"integer","nullable":true},"totalNumberOfShares":{"type":"integer"},"pricePerShare":{"type":"number","multipleOf":0.01},"lineItems":{"type":"array","items":{}},"adjustments":{"type":"array","items":{}},"transactions":{"type":"array","items":{}},"totalAmount":{"type":"number","multipleOf":0.01,"nullable":true},"tradeStatus":{"type":"string","enum":["CART","PLACED","IN_REVIEW","NEEDS_INFO","NEEDS_PAYMENT_INFO","FUNDING","CANCELLED","SETTLED","IMPORT_ERROR","ERROR","UPDATE_PAYMENT_METHOD"]},"tradeStatusUnmapped":{"type":"string","nullable":true},"tradeDate":{"type":"string","format":"date-time","nullable":true},"saStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW"]},"saStatusUnmapped":{"type":"string","nullable":true},"saUrl":{"type":"string","nullable":true},"saSignedAt":{"type":"string","format":"date-time","nullable":true},"saExtractedNumberOfShares":{"type":"string","nullable":true},"saExtractedTotalAmount":{"type":"string","nullable":true},"saExtractedPricePerShare":{"type":"string","nullable":true},"saExtractedInvestorType":{"type":"string","nullable":true},"saExtractedSigner":{"type":"string","nullable":true},"saExtractedSignatureDate":{"type":"string","format":"date-time","nullable":true},"saExtractedSigner2":{"type":"string","nullable":true},"saExtractedSignatureDate2":{"type":"string","format":"date-time","nullable":true},"saCheck":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"]},"saCheckedAt":{"type":"string","format":"date-time","nullable":true},"saLog":{"type":"object","properties":{"finalStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW"]},"matchResults":{"type":"array","items":{"type":"object","properties":{"tradeLineItemId":{"type":"string","example":"trade_line_item_01kctsycw3fq7sj6hedvy62cja"},"signerName":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"totalAmount":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"investorName":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"numberOfShares":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]}},"required":["tradeLineItemId"]}}},"required":["finalStatus","matchResults"],"nullable":true},"txnTid":{"type":"string","nullable":true},"txnResponse":{"type":"string","nullable":true},"txnPaymentMethod":{"type":"string","enum":["CREDIT_CARD","WIRE","ACH","BANK_ACCOUNT","CHECK","RETIREMENT"],"nullable":true},"txnCurrencyCode":{"type":"string","minLength":3,"maxLength":3,"nullable":true},"txnChargedAmount":{"type":"number","multipleOf":0.01,"nullable":true},"txnDate":{"type":"string","format":"date-time","nullable":true},"txnSettledDate":{"type":"string","format":"date-time","nullable":true},"fundingStatus":{"type":"string","enum":["PENDING","CANCELLED","SETTLED","REFUNDED","DECLINED","FUNDING","AUTHORIZING","FAILED"],"nullable":true},"fundingStatusUnmapped":{"type":"string","nullable":true},"txnCheck":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"],"nullable":true},"txnCheckedAt":{"type":"string","format":"date-time","nullable":true},"txnLog":{"type":"string","nullable":true},"systemReviewCheck":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","WARNING","INCOMPLETE"],"nullable":true},"systemReviewCheckedAt":{"type":"string","format":"date-time","nullable":true},"systemReviewLog":{"type":"string","nullable":true},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"],"nullable":true},"complianceReviewNotes":{"type":"string","nullable":true},"complianceReviewerId":{"type":"string","nullable":true},"issuerId":{"nullable":true},"complianceReviewName":{"type":"string","nullable":true},"complianceReviewAt":{"type":"string","format":"date-time","nullable":true},"tradeType":{"type":"string","enum":["PURCHASE","CONVERSION","TRANSFER"],"nullable":true},"placedAt":{"type":"string","format":"date-time","nullable":true},"platform":{"type":"string"},"cancelledAt":{"type":"string","format":"date-time","nullable":true},"cancelledById":{"type":"string","nullable":true},"cancelledReason":{"type":"string","nullable":true},"cancellationPeriod":{"type":"number","nullable":true},"disbursed":{"type":"boolean"},"tradeAdjustments":{"type":"number","nullable":true},"chargedAmount":{"type":"number","nullable":true},"balance":{"type":"number","nullable":true},"isUncleared24h":{"type":"boolean"},"term":{"type":"number","nullable":true},"exercisePrice":{"type":"number","nullable":true},"warrantPercentage":{"type":"number","nullable":true},"calculationMethod":{"type":"string","enum":["NONE","PRORATA","INCREMENT"],"nullable":true},"incrementThreshold":{"type":"number","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","investorAccountId","accountId","account","offeringId","paymentMethodId","userId","tradeNumber","ip","tid","investmentType","purchasedShares","bonusShares","totalNumberOfShares","pricePerShare","lineItems","adjustments","transactions","totalAmount","tradeStatus","tradeStatusUnmapped","tradeDate","saStatus","saStatusUnmapped","saUrl","saSignedAt","saExtractedNumberOfShares","saExtractedTotalAmount","saExtractedPricePerShare","saExtractedInvestorType","saExtractedSigner","saExtractedSignatureDate","saExtractedSigner2","saExtractedSignatureDate2","saCheck","saCheckedAt","saLog","txnTid","txnResponse","txnPaymentMethod","txnCurrencyCode","txnChargedAmount","txnDate","txnSettledDate","fundingStatus","fundingStatusUnmapped","txnCheck","txnCheckedAt","txnLog","systemReviewCheck","systemReviewCheckedAt","systemReviewLog","complianceReview","complianceReviewNotes","complianceReviewerId","issuerId","complianceReviewName","complianceReviewAt","tradeType","placedAt","platform","cancelledAt","cancelledById","cancelledReason","cancellationPeriod","isUncleared24h","term","exercisePrice","warrantPercentage","calculationMethod","incrementThreshold"]},"nullable":true},"metadata":{"type":"string","nullable":true},"status":{"type":"string","enum":["PENDING","ERROR","VALID","INVALID","NOT_PROCESSED","PROCESSING","PROCESSING_ERROR","REVIEW_ERROR","PROCESSED"]},"reviewLog":{"type":"string","nullable":true},"pipeline":{"type":"string","enum":["NONE","SUBDOCS_PHOENIX","SUBDOCS_GENERAL","AIC_TAX_RETURNS","AIC_ACCOUNT_STATEMENTS","PAY_STUBS"]},"errorMessage":{"type":"string","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","tid","url","fileType","fileName","name","category","label","private","complianceReview","targetTable","targetId","linkedFrom","accountId","userId","metadata","status","reviewLog","pipeline","errorMessage"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/files/preview/{id}":{"get":{"summary":"Preview (stream) a file by id","tags":["files"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"previewFile","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"nullable":true}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/files-public":{"post":{"description":"Upload a public file to the system.\n\n### Example curl request\n\n```bash\ncurl -X POST 'https://dalmore-client-portal-api-prod.onrender.com/api/v1/files-public?name=test&category=application&targetId=trade_01j5tkg6k2fygr0x06fegt27aj' \\\n  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9' \\\n  --form 'file=@\"/Users/local/Desktop/test.csv\"'\n```","summary":"Upload a public file","tags":["filesPublic"],"parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string","example":"file_name"}},{"name":"category","in":"query","required":true,"schema":{"type":"string","maxLength":50,"example":"application"}},{"name":"label","in":"query","required":true,"schema":{"type":"string","enum":["PROOF_OF_INCOME","PROOF_OF_NET_WORTH","EMPLOYEE","TAX_RETURNS","ACCOUNT_STATEMENT","ACCREDITATION_LETTER","LICENSE","IDENTITY_FRONT","IDENTITY_BACK","BAD_ACTOR_REPORT_FILE","OTHER","COMPLIANCE_REQUEST","SUB_DOC","CONTENT_FILE","CSV_EXPORT_FILE","CUSTODIAN_INSTRUCTION_DOCUMENT","LOGO","FAVICON","BACKGROUND_IMAGE","MEMORANDUM","SUBSCRIPTION_AGREEMENT","COVER_ART","ESCROW_AGREEMENT","SS4_LETTER","FORMATION_DOCUMENT","PASSPORT","TRADE_DOCUMENT"],"example":"OTHER"}},{"name":"targetId","in":"query","required":true,"schema":{"type":"string","example":"trades_01j6aqmtfyfwy9spjdcnh7yqk7"}},{"name":"metadata","in":"query","schema":{"type":"string","minLength":2,"maxLength":600000,"nullable":true}}],"operationId":"postFilePublic","responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"url":{"type":"string","format":"uri","example":"https://file-location.com"},"fileType":{"type":"string","example":"pdf"},"fileName":{"type":"string","example":"test.pdf"},"name":{"type":"string","example":"test"},"category":{"type":"string","example":"application"},"label":{"type":"string","example":"other"},"private":{"type":"boolean"},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"]},"targetTable":{"type":"string","enum":["KYCS","AMLS","AICS","KYBS","INDIVIDUALS","LEGAL_ENTITIES","INVESTOR_ACCOUNTS","TRADES","OFFERINGS","ISSUERS","COVERED_PERSONS","PAYMENT_METHODS","NOTES","USERS","ACCOUNTS","PAGES","TASKS","FILES","DATA_RECORD_FILES","ASSETS","SITES","PAGE_REVISIONS","TRADE_LINE_ITEMS","TRANSACTIONS","DISBURSEMENTS","DISBURSEMENT_REVIEWS","ISSUER_PAYMENT_METHODS","SIGNER_BRANDS","THEMES","THEME_SETTINGS","CAP_TABLES","CAP_TABLE_SHARE_CLASSES","CAP_TABLE_ENTRIES","EMAIL_THEMES","EMAIL_THEME_SETTINGS"],"nullable":true},"targetId":{"type":"string","nullable":true},"linkedFrom":{"type":"string","nullable":true},"accountId":{"type":"string","example":"account_01j6aqmtfyfwy9spjdcnh7yqk7"},"userId":{"type":"string","example":"user_01j6aqmtfyfwy9spjdcnh7yqk7"},"kycs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"platform":{"type":"string","example":"KYC Platform"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Passport"},"documentImage":{"type":"string","example":"https://example.com/passport.jpg"},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Document unclear"},"response":{"type":"string","nullable":true,"example":"Submitted clearer document"}},"required":["id","createdAt","updatedAt","deletedAt","tid","platform","individualId","documentType","documentImage","kycStatus","reason","response"]},"nullable":true},"kybs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_kyb_123"},"platform":{"type":"string","example":"KYB Platform"},"legalEntityId":{"type":"string","example":"legal_entity_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Certificate of Incorporation"},"documentImage":{"type":"string","example":"https://example.com/document.pdf"},"kybStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Additional information required"},"response":{"type":"string","nullable":true,"example":"Submitted additional documents"}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","platform","legalEntityId","documentType","documentImage","kybStatus","reason","response"]},"nullable":true},"individuals":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"accountId":{"type":"string"},"account":{},"investorAccountId":{"type":"string"},"investorAccount":{},"role":{"type":"string","enum":["PRIMARY","JOINT"]},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"]},"kycFirstName":{"type":"string","nullable":true},"kycLastName":{"type":"string","nullable":true},"kycDocumentType":{"type":"string","enum":["PASSPORT","DRIVER_LICENSE","STATE_ID"],"nullable":true},"kycDocumentIssuer":{"type":"string","nullable":true},"kycDocumentNumber":{"type":"string","nullable":true},"kycIssuerDate":{"type":"string","nullable":true},"kycExpirationDate":{"type":"string","nullable":true},"kycCheck":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"]},"kycCheckedAt":{"type":"string","format":"date-time","nullable":true},"kycLog":{"type":"string","nullable":true},"kycReviewedById":{"type":"string","nullable":true},"kycReviewedAt":{"type":"string","format":"date-time","nullable":true},"kycDocumentFrontFileId":{"type":"string","nullable":true},"kycDocumentFrontFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"kycDocumentBackFileId":{"type":"string","nullable":true},"kycDocumentBackFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"kycSelfieFileId":{"type":"string","nullable":true},"kycSelfieFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"sanctionsStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"]},"amlStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","ERROR"]},"amlProvider":{"type":"string","enum":["ComplyAdvantage"],"nullable":true},"amlTid":{"type":"string","nullable":true},"amlUrl":{"type":"string","nullable":true},"amlCheckedAt":{"type":"string","format":"date-time","nullable":true},"amlLog":{"type":"string","nullable":true},"amlLogData":{"type":"string","nullable":true},"amlReviewedById":{"type":"string","nullable":true},"amlReviewedAt":{"type":"string","format":"date-time","nullable":true},"liquidNetWorth":{"type":"number","multipleOf":0.01,"nullable":true},"liquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"illiquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"privateSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"aicAccreditationType":{"type":"string","enum":["PENDING","INCOME","NET_WORTH","PROFESSIONAL_CERTIFICATION","KNOWLEDGEABLE_EMPLOYEE"]},"aicExpirationDate":{"type":"string","format":"date-time","nullable":true},"aicQuestionnaire":{"type":"string","nullable":true},"aicStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","PROCESSED"]},"aicCheckedAt":{"type":"string","format":"date-time","nullable":true},"aicLog":{"type":"string","nullable":true},"aicReviewedById":{"type":"string","nullable":true},"aicReviewedAt":{"type":"string","format":"date-time","nullable":true},"iraQuestionnaire":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"hasIraAccounts":{"type":"boolean"},"inSelfDirectedIra":{"type":"boolean"},"custodian":{"type":"string"},"hasOtherQualifiedFunds":{"type":"boolean"}},"required":["id","hasIraAccounts","inSelfDirectedIra","custodian","hasOtherQualifiedFunds"]},"nullable":true},"iraCheck":{"type":"string","enum":["PENDING","APPROVED","NEEDS_REVIEW","REJECTED"]},"iraCheckedAt":{"type":"string","format":"date-time","nullable":true},"iraLog":{"type":"string","nullable":true},"iraReviewedById":{"type":"string","nullable":true},"iraReviewedAt":{"type":"string","format":"date-time","nullable":true},"firstName":{"type":"string"},"lastName":{"type":"string","nullable":true},"dob":{"type":"string","format":"date-time","nullable":true},"isUsCitizenOrGreenCardHolder":{"type":"boolean"},"citizenship":{"type":"string","enum":["AD","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","CU","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","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","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","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","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","YE","YT","ZA","ZM","ZW"],"nullable":true},"ssn":{"type":"string","nullable":true},"lastFour":{"type":"string","nullable":true},"address":{"type":"string","nullable":true},"address2":{"type":"string","nullable":true},"email":{"type":"string","format":"email","nullable":true},"phone":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"state":{"type":"string","nullable":true},"zip":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"kycTid":{"type":"string","nullable":true},"currencyCode":{"type":"string","minLength":3,"maxLength":3,"nullable":true},"investedInCrowdfunding":{"type":"number","nullable":true},"currentAnnualIncome":{"type":"number","nullable":true},"averageAnnualIncome":{"type":"number","nullable":true},"averageHouseholdIncome":{"type":"number","nullable":true},"currentHouseholdIncome":{"type":"number","nullable":true},"householdNetWorth":{"type":"number","nullable":true},"isSolicited":{"type":"boolean"},"isRealEstate":{"type":"boolean"},"iliquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"timeHorizon":{"type":"string","nullable":true},"riskTolerance":{"type":"string","nullable":true},"investmentObjective":{"type":"string","nullable":true},"investmentExperience":{"type":"string","nullable":true},"experienceInPrivate":{"type":"string","nullable":true},"levelOfEducation":{"type":"string","nullable":true},"financialAdvisor":{"type":"boolean"},"occupation":{"type":"string","nullable":true},"employmentStatus":{"type":"string","enum":["EMPLOYED","UNEMPLOYED","SELF_EMPLOYED","RETIRED","STUDENT","OTHER"]},"employerName":{"type":"string","nullable":true},"employerAddressLine1":{"type":"string","nullable":true},"employerAddressLine2":{"type":"string","nullable":true},"employerCity":{"type":"string","nullable":true},"employerState":{"type":"string","nullable":true},"employerZip":{"type":"string","nullable":true},"employerCountry":{"type":"string","nullable":true},"notes":{"type":"string","nullable":true},"kycs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"platform":{"type":"string","example":"KYC Platform"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Passport"},"documentImage":{"type":"string","example":"https://example.com/passport.jpg"},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Document unclear"},"response":{"type":"string","nullable":true,"example":"Submitted clearer document"}},"required":["id","createdAt","updatedAt","deletedAt","tid","platform","individualId","documentType","documentImage","kycStatus","reason","response"]},"nullable":true},"amls":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"provider":{"type":"string","nullable":true,"example":"AML Provider"},"url":{"type":"string","nullable":true,"example":"https://example.com/aml"},"status":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","ERROR"],"example":"PENDING"},"checkedAt":{"type":"string","format":"date-time","nullable":true,"example":"2022-01-01T00:00:00Z"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"}},"required":["id","createdAt","updatedAt","deletedAt","tid","provider","url","status","checkedAt","individualId"]},"nullable":true},"aics":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"individualId":{},"individual":{"nullable":true},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"]},"reviewedById":{"nullable":true},"reviewedBy":{"nullable":true},"reviewedAt":{"type":"string","format":"date-time","nullable":true},"systemReview":{"type":"string","enum":["PENDING","NEEDS_INFO","READY_TO_APPROVE","NEEDS_REVIEW","APPROVED","REJECTED"]},"systemLog":{"type":"array","items":{"type":"object","properties":{"check":{"type":"string","minLength":1},"entered":{"type":"number"},"extracted":{"type":"number"},"result":{"type":"string","enum":["PASS","FAIL"]},"reason":{"type":"string"}},"required":["check","result"]},"nullable":true},"firstName":{"type":"string"},"lastName":{"type":"string"},"method":{"type":"string","enum":["PENDING","INCOME","NET_WORTH","PROFESSIONAL_CERTIFICATION","KNOWLEDGEABLE_EMPLOYEE"]},"incomeData":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer","minimum":2020,"maximum":2025},"filingStatus":{"type":"string","enum":["SINGLE","JOINT"]},"income":{"type":"number","minimum":0,"multipleOf":0.01},"fileId":{}},"required":["year","filingStatus","income","fileId"]},"nullable":true},"netWorthData":{"type":"array","items":{"type":"object","properties":{"institution":{"type":"string","minLength":1,"maxLength":100},"accountType":{"type":"string","enum":["CHECKING","SAVINGS","BROKERAGE","REAL_ESTATE","OTHER"]},"balance":{"type":"number","minimum":0,"multipleOf":0.01},"fileId":{}},"required":["institution","accountType","balance","fileId"]},"nullable":true},"professionalData":{"type":"array","items":{"type":"object","properties":{"professionalType":{"type":"string","enum":["SECURITIES_LICENSES","DIRECTORS","FAMILY_OFFICE"]},"licenseNumber":{"type":"string","minLength":1,"maxLength":50,"nullable":true},"fileId":{"nullable":true}},"required":["professionalType"]},"nullable":true},"employeeData":{"type":"array","items":{"type":"object","properties":{"position":{"type":"string","minLength":1,"maxLength":100},"fileId":{}},"required":["position","fileId"]},"nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","individualId","complianceReview","reviewedById","reviewedAt","systemReview","systemLog","firstName","lastName","method","incomeData","netWorthData","professionalData","employeeData"]},"nullable":true},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]},"setupStep":{"type":"string","enum":["NEW","PERSONAL_INFO","ADDRESS","KYC","INCOME","AIC_QUESTIONS","AIC_FILES"]},"sourceOfIncome":{"type":"string","enum":["EMPLOYED","SELF_EMPLOYED","UNEMPLOYED","RETIREMENT","STUDENT"],"nullable":true},"ownership":{"type":"number","nullable":true},"kycProvider":{"type":"string","nullable":true},"retirementAccountType":{"type":"string","enum":["SELF_DIRECTED","CUSTODIAN_MANAGED"],"nullable":true},"custodianName":{"type":"string","nullable":true},"custodianAccountNumber":{"type":"string","nullable":true},"custodianRepresentativeName":{"type":"string","nullable":true},"custodianEmail":{"type":"string","format":"email","nullable":true},"accredited":{"type":"boolean"}},"required":["id","createdAt","updatedAt","deletedAt","tid","accountId","investorAccountId","role","kycStatus","kycFirstName","kycLastName","kycDocumentType","kycDocumentIssuer","kycDocumentNumber","kycIssuerDate","kycExpirationDate","kycCheck","kycCheckedAt","kycLog","kycReviewedById","kycReviewedAt","kycDocumentFrontFileId","kycDocumentBackFileId","kycSelfieFileId","sanctionsStatus","amlStatus","amlProvider","amlTid","amlUrl","amlCheckedAt","amlLog","amlLogData","amlReviewedById","amlReviewedAt","liquidNetWorth","liquidSecurities","illiquidSecurities","privateSecurities","aicAccreditationType","aicExpirationDate","aicQuestionnaire","aicStatus","aicCheckedAt","aicLog","aicReviewedById","aicReviewedAt","iraQuestionnaire","iraCheck","iraCheckedAt","iraLog","iraReviewedById","iraReviewedAt","firstName","lastName","dob","isUsCitizenOrGreenCardHolder","ssn","lastFour","address","address2","email","phone","city","state","zip","country","kycTid","currencyCode","investedInCrowdfunding","currentAnnualIncome","averageAnnualIncome","averageHouseholdIncome","currentHouseholdIncome","householdNetWorth","isSolicited","isRealEstate","timeHorizon","riskTolerance","investmentObjective","investmentExperience","experienceInPrivate","levelOfEducation","financialAdvisor","occupation","employmentStatus","employerName","employerAddressLine1","employerAddressLine2","employerCity","employerState","employerZip","employerCountry","notes","setupStatus","setupStep","sourceOfIncome","ownership","kycProvider","accredited"]},"nullable":true},"legalEntities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_legal_entity_123","nullable":true},"accountId":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6"},"investorAccountId":{"type":"string","example":"investor_account_01j1xgme5qeqq97gpdztd7e4a7"},"kybStatus":{"example":"PENDING"},"sanctionsStatus":{"example":"PENDING"},"kybs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_kyb_123"},"platform":{"type":"string","example":"KYB Platform"},"legalEntityId":{"type":"string","example":"legal_entity_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Certificate of Incorporation"},"documentImage":{"type":"string","example":"https://example.com/document.pdf"},"kybStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Additional information required"},"response":{"type":"string","nullable":true,"example":"Submitted additional documents"}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","platform","legalEntityId","documentType","documentImage","kybStatus","reason","response"]}},"name":{"type":"string","example":"Acme Corporation"},"ein":{"type":"string","example":"12-3456789","nullable":true},"companyType":{"type":"string","example":"LLC","nullable":true},"streetAddress":{"type":"string","example":"123 Main St","nullable":true},"city":{"type":"string","example":"Anytown","nullable":true},"state":{"type":"string","example":"CA","nullable":true},"zip":{"type":"string","example":"12345","nullable":true},"country":{"type":"string","example":"USA","nullable":true},"phone":{"type":"string","example":"+12124567890","nullable":true},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","accountId","investorAccountId","kybStatus","sanctionsStatus","name","state","setupStatus"]},"nullable":true},"investorAccounts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"investorAccountType":{"type":"string","enum":["INDIVIDUAL","JOINT","RETIREMENT","LEGAL_ENTITY"]},"user":{"nullable":true},"userId":{"type":"string","nullable":true},"email":{"type":"string","format":"email","nullable":true},"name":{"type":"string","nullable":true},"regAQualified":{"type":"boolean"},"regCfQualified":{"type":"boolean"},"regDQualified":{"type":"boolean"},"accountId":{"type":"string"},"account":{},"trades":{"type":"array","items":{}},"individuals":{"type":"array","items":{}},"legalEntities":{"type":"array","items":{}},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]},"systemReviewLog":{"type":"string","nullable":true},"totalAmount":{"type":"number"},"statusCheck":{},"trustedContacts":{"type":"array","items":{}}},"required":["id","createdAt","updatedAt","deletedAt","tid","investorAccountType","regAQualified","regCfQualified","regDQualified","accountId","setupStatus","systemReviewLog"]},"nullable":true},"trades":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"investorAccountId":{"nullable":true},"investorAccount":{"nullable":true},"offering":{"nullable":true},"accountId":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6","accountId":"account_00041061050r3gg28a1c60t3gf","nullable":true},"account":{"nullable":true},"offeringId":{"nullable":true},"paymentMethodId":{"nullable":true},"paymentMethod":{"nullable":true},"userId":{"nullable":true},"tradeNumber":{"type":"string"},"ip":{"type":"string","nullable":true},"tid":{"type":"string","nullable":true},"investmentType":{"type":"string","enum":["INDIVIDUAL","JOINT","ENTITY"]},"purchasedShares":{"type":"integer"},"bonusShares":{"type":"integer","nullable":true},"totalNumberOfShares":{"type":"integer"},"pricePerShare":{"type":"number","multipleOf":0.01},"lineItems":{"type":"array","items":{}},"adjustments":{"type":"array","items":{}},"transactions":{"type":"array","items":{}},"totalAmount":{"type":"number","multipleOf":0.01,"nullable":true},"tradeStatus":{"type":"string","enum":["CART","PLACED","IN_REVIEW","NEEDS_INFO","NEEDS_PAYMENT_INFO","FUNDING","CANCELLED","SETTLED","IMPORT_ERROR","ERROR","UPDATE_PAYMENT_METHOD"]},"tradeStatusUnmapped":{"type":"string","nullable":true},"tradeDate":{"type":"string","format":"date-time","nullable":true},"saStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW"]},"saStatusUnmapped":{"type":"string","nullable":true},"saUrl":{"type":"string","nullable":true},"saSignedAt":{"type":"string","format":"date-time","nullable":true},"saExtractedNumberOfShares":{"type":"string","nullable":true},"saExtractedTotalAmount":{"type":"string","nullable":true},"saExtractedPricePerShare":{"type":"string","nullable":true},"saExtractedInvestorType":{"type":"string","nullable":true},"saExtractedSigner":{"type":"string","nullable":true},"saExtractedSignatureDate":{"type":"string","format":"date-time","nullable":true},"saExtractedSigner2":{"type":"string","nullable":true},"saExtractedSignatureDate2":{"type":"string","format":"date-time","nullable":true},"saCheck":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"]},"saCheckedAt":{"type":"string","format":"date-time","nullable":true},"saLog":{"type":"object","properties":{"finalStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW"]},"matchResults":{"type":"array","items":{"type":"object","properties":{"tradeLineItemId":{"type":"string","example":"trade_line_item_01kctsycw3fq7sj6hedvy62cja"},"signerName":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"totalAmount":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"investorName":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"numberOfShares":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]}},"required":["tradeLineItemId"]}}},"required":["finalStatus","matchResults"],"nullable":true},"txnTid":{"type":"string","nullable":true},"txnResponse":{"type":"string","nullable":true},"txnPaymentMethod":{"type":"string","enum":["CREDIT_CARD","WIRE","ACH","BANK_ACCOUNT","CHECK","RETIREMENT"],"nullable":true},"txnCurrencyCode":{"type":"string","minLength":3,"maxLength":3,"nullable":true},"txnChargedAmount":{"type":"number","multipleOf":0.01,"nullable":true},"txnDate":{"type":"string","format":"date-time","nullable":true},"txnSettledDate":{"type":"string","format":"date-time","nullable":true},"fundingStatus":{"type":"string","enum":["PENDING","CANCELLED","SETTLED","REFUNDED","DECLINED","FUNDING","AUTHORIZING","FAILED"],"nullable":true},"fundingStatusUnmapped":{"type":"string","nullable":true},"txnCheck":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"],"nullable":true},"txnCheckedAt":{"type":"string","format":"date-time","nullable":true},"txnLog":{"type":"string","nullable":true},"systemReviewCheck":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","WARNING","INCOMPLETE"],"nullable":true},"systemReviewCheckedAt":{"type":"string","format":"date-time","nullable":true},"systemReviewLog":{"type":"string","nullable":true},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"],"nullable":true},"complianceReviewNotes":{"type":"string","nullable":true},"complianceReviewerId":{"type":"string","nullable":true},"issuerId":{"nullable":true},"complianceReviewName":{"type":"string","nullable":true},"complianceReviewAt":{"type":"string","format":"date-time","nullable":true},"tradeType":{"type":"string","enum":["PURCHASE","CONVERSION","TRANSFER"],"nullable":true},"placedAt":{"type":"string","format":"date-time","nullable":true},"platform":{"type":"string"},"cancelledAt":{"type":"string","format":"date-time","nullable":true},"cancelledById":{"type":"string","nullable":true},"cancelledReason":{"type":"string","nullable":true},"cancellationPeriod":{"type":"number","nullable":true},"disbursed":{"type":"boolean"},"tradeAdjustments":{"type":"number","nullable":true},"chargedAmount":{"type":"number","nullable":true},"balance":{"type":"number","nullable":true},"isUncleared24h":{"type":"boolean"},"term":{"type":"number","nullable":true},"exercisePrice":{"type":"number","nullable":true},"warrantPercentage":{"type":"number","nullable":true},"calculationMethod":{"type":"string","enum":["NONE","PRORATA","INCREMENT"],"nullable":true},"incrementThreshold":{"type":"number","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","investorAccountId","accountId","account","offeringId","paymentMethodId","userId","tradeNumber","ip","tid","investmentType","purchasedShares","bonusShares","totalNumberOfShares","pricePerShare","lineItems","adjustments","transactions","totalAmount","tradeStatus","tradeStatusUnmapped","tradeDate","saStatus","saStatusUnmapped","saUrl","saSignedAt","saExtractedNumberOfShares","saExtractedTotalAmount","saExtractedPricePerShare","saExtractedInvestorType","saExtractedSigner","saExtractedSignatureDate","saExtractedSigner2","saExtractedSignatureDate2","saCheck","saCheckedAt","saLog","txnTid","txnResponse","txnPaymentMethod","txnCurrencyCode","txnChargedAmount","txnDate","txnSettledDate","fundingStatus","fundingStatusUnmapped","txnCheck","txnCheckedAt","txnLog","systemReviewCheck","systemReviewCheckedAt","systemReviewLog","complianceReview","complianceReviewNotes","complianceReviewerId","issuerId","complianceReviewName","complianceReviewAt","tradeType","placedAt","platform","cancelledAt","cancelledById","cancelledReason","cancellationPeriod","isUncleared24h","term","exercisePrice","warrantPercentage","calculationMethod","incrementThreshold"]},"nullable":true},"metadata":{"type":"string","nullable":true},"status":{"type":"string","enum":["PENDING","ERROR","VALID","INVALID","NOT_PROCESSED","PROCESSING","PROCESSING_ERROR","REVIEW_ERROR","PROCESSED"]},"reviewLog":{"type":"string","nullable":true},"pipeline":{"type":"string","enum":["NONE","SUBDOCS_PHOENIX","SUBDOCS_GENERAL","AIC_TAX_RETURNS","AIC_ACCOUNT_STATEMENTS","PAY_STUBS"]},"errorMessage":{"type":"string","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","tid","url","fileType","fileName","name","category","label","private","complianceReview","targetTable","targetId","linkedFrom","accountId","userId","metadata","status","reviewLog","pipeline","errorMessage"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"422":{"description":"422","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"422"},"message":{"type":"string","example":"UNPROCESSABLE_ENTITY"},"errors":{"type":"array","items":{"type":"string"},"example":["file is required"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}},"502":{"description":"502","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"502"},"message":{"type":"string","example":"BAD_GATEWAY"},"errors":{"type":"array","items":{"type":"string"},"example":["bad gateway"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]},"get":{"summary":"Get public files","tags":["filesPublic"],"parameters":[{"name":"page","in":"query","schema":{"default":1,"type":"number","nullable":true}},{"name":"limit","in":"query","schema":{"default":10,"type":"number","nullable":true}},{"name":"include","in":"query","schema":{"type":"string","example":"user,account"}},{"name":"targetTable","in":"query","schema":{"type":"string","enum":["KYCS","AMLS","AICS","KYBS","INDIVIDUALS","LEGAL_ENTITIES","INVESTOR_ACCOUNTS","TRADES","OFFERINGS","ISSUERS","COVERED_PERSONS","PAYMENT_METHODS","NOTES","USERS","ACCOUNTS","PAGES","TASKS","FILES","DATA_RECORD_FILES","ASSETS","SITES","PAGE_REVISIONS","TRADE_LINE_ITEMS","TRANSACTIONS","DISBURSEMENTS","DISBURSEMENT_REVIEWS","ISSUER_PAYMENT_METHODS","SIGNER_BRANDS","THEMES","THEME_SETTINGS","CAP_TABLES","CAP_TABLE_SHARE_CLASSES","CAP_TABLE_ENTRIES","EMAIL_THEMES","EMAIL_THEME_SETTINGS"]}},{"name":"targetId","in":"query","schema":{"type":"string"}}],"operationId":"getFilesPublic","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"url":{"type":"string","format":"uri","example":"https://file-location.com"},"fileType":{"type":"string","example":"pdf"},"fileName":{"type":"string","example":"test.pdf"},"name":{"type":"string","example":"test"},"category":{"type":"string","example":"application"},"label":{"type":"string","example":"other"},"private":{"type":"boolean"},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"]},"targetTable":{"type":"string","enum":["KYCS","AMLS","AICS","KYBS","INDIVIDUALS","LEGAL_ENTITIES","INVESTOR_ACCOUNTS","TRADES","OFFERINGS","ISSUERS","COVERED_PERSONS","PAYMENT_METHODS","NOTES","USERS","ACCOUNTS","PAGES","TASKS","FILES","DATA_RECORD_FILES","ASSETS","SITES","PAGE_REVISIONS","TRADE_LINE_ITEMS","TRANSACTIONS","DISBURSEMENTS","DISBURSEMENT_REVIEWS","ISSUER_PAYMENT_METHODS","SIGNER_BRANDS","THEMES","THEME_SETTINGS","CAP_TABLES","CAP_TABLE_SHARE_CLASSES","CAP_TABLE_ENTRIES","EMAIL_THEMES","EMAIL_THEME_SETTINGS"],"nullable":true},"targetId":{"type":"string","nullable":true},"linkedFrom":{"type":"string","nullable":true},"accountId":{"type":"string","example":"account_01j6aqmtfyfwy9spjdcnh7yqk7"},"userId":{"type":"string","example":"user_01j6aqmtfyfwy9spjdcnh7yqk7"},"kycs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"platform":{"type":"string","example":"KYC Platform"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Passport"},"documentImage":{"type":"string","example":"https://example.com/passport.jpg"},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Document unclear"},"response":{"type":"string","nullable":true,"example":"Submitted clearer document"}},"required":["id","createdAt","updatedAt","deletedAt","tid","platform","individualId","documentType","documentImage","kycStatus","reason","response"]},"nullable":true},"kybs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_kyb_123"},"platform":{"type":"string","example":"KYB Platform"},"legalEntityId":{"type":"string","example":"legal_entity_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Certificate of Incorporation"},"documentImage":{"type":"string","example":"https://example.com/document.pdf"},"kybStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Additional information required"},"response":{"type":"string","nullable":true,"example":"Submitted additional documents"}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","platform","legalEntityId","documentType","documentImage","kybStatus","reason","response"]},"nullable":true},"individuals":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"accountId":{"type":"string"},"account":{},"investorAccountId":{"type":"string"},"investorAccount":{},"role":{"type":"string","enum":["PRIMARY","JOINT"]},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"]},"kycFirstName":{"type":"string","nullable":true},"kycLastName":{"type":"string","nullable":true},"kycDocumentType":{"type":"string","enum":["PASSPORT","DRIVER_LICENSE","STATE_ID"],"nullable":true},"kycDocumentIssuer":{"type":"string","nullable":true},"kycDocumentNumber":{"type":"string","nullable":true},"kycIssuerDate":{"type":"string","nullable":true},"kycExpirationDate":{"type":"string","nullable":true},"kycCheck":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"]},"kycCheckedAt":{"type":"string","format":"date-time","nullable":true},"kycLog":{"type":"string","nullable":true},"kycReviewedById":{"type":"string","nullable":true},"kycReviewedAt":{"type":"string","format":"date-time","nullable":true},"kycDocumentFrontFileId":{"type":"string","nullable":true},"kycDocumentFrontFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"kycDocumentBackFileId":{"type":"string","nullable":true},"kycDocumentBackFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"kycSelfieFileId":{"type":"string","nullable":true},"kycSelfieFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"sanctionsStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"]},"amlStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","ERROR"]},"amlProvider":{"type":"string","enum":["ComplyAdvantage"],"nullable":true},"amlTid":{"type":"string","nullable":true},"amlUrl":{"type":"string","nullable":true},"amlCheckedAt":{"type":"string","format":"date-time","nullable":true},"amlLog":{"type":"string","nullable":true},"amlLogData":{"type":"string","nullable":true},"amlReviewedById":{"type":"string","nullable":true},"amlReviewedAt":{"type":"string","format":"date-time","nullable":true},"liquidNetWorth":{"type":"number","multipleOf":0.01,"nullable":true},"liquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"illiquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"privateSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"aicAccreditationType":{"type":"string","enum":["PENDING","INCOME","NET_WORTH","PROFESSIONAL_CERTIFICATION","KNOWLEDGEABLE_EMPLOYEE"]},"aicExpirationDate":{"type":"string","format":"date-time","nullable":true},"aicQuestionnaire":{"type":"string","nullable":true},"aicStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","PROCESSED"]},"aicCheckedAt":{"type":"string","format":"date-time","nullable":true},"aicLog":{"type":"string","nullable":true},"aicReviewedById":{"type":"string","nullable":true},"aicReviewedAt":{"type":"string","format":"date-time","nullable":true},"iraQuestionnaire":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"hasIraAccounts":{"type":"boolean"},"inSelfDirectedIra":{"type":"boolean"},"custodian":{"type":"string"},"hasOtherQualifiedFunds":{"type":"boolean"}},"required":["id","hasIraAccounts","inSelfDirectedIra","custodian","hasOtherQualifiedFunds"]},"nullable":true},"iraCheck":{"type":"string","enum":["PENDING","APPROVED","NEEDS_REVIEW","REJECTED"]},"iraCheckedAt":{"type":"string","format":"date-time","nullable":true},"iraLog":{"type":"string","nullable":true},"iraReviewedById":{"type":"string","nullable":true},"iraReviewedAt":{"type":"string","format":"date-time","nullable":true},"firstName":{"type":"string"},"lastName":{"type":"string","nullable":true},"dob":{"type":"string","format":"date-time","nullable":true},"isUsCitizenOrGreenCardHolder":{"type":"boolean"},"citizenship":{"type":"string","enum":["AD","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","CU","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","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","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","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","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","YE","YT","ZA","ZM","ZW"],"nullable":true},"ssn":{"type":"string","nullable":true},"lastFour":{"type":"string","nullable":true},"address":{"type":"string","nullable":true},"address2":{"type":"string","nullable":true},"email":{"type":"string","format":"email","nullable":true},"phone":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"state":{"type":"string","nullable":true},"zip":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"kycTid":{"type":"string","nullable":true},"currencyCode":{"type":"string","minLength":3,"maxLength":3,"nullable":true},"investedInCrowdfunding":{"type":"number","nullable":true},"currentAnnualIncome":{"type":"number","nullable":true},"averageAnnualIncome":{"type":"number","nullable":true},"averageHouseholdIncome":{"type":"number","nullable":true},"currentHouseholdIncome":{"type":"number","nullable":true},"householdNetWorth":{"type":"number","nullable":true},"isSolicited":{"type":"boolean"},"isRealEstate":{"type":"boolean"},"iliquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"timeHorizon":{"type":"string","nullable":true},"riskTolerance":{"type":"string","nullable":true},"investmentObjective":{"type":"string","nullable":true},"investmentExperience":{"type":"string","nullable":true},"experienceInPrivate":{"type":"string","nullable":true},"levelOfEducation":{"type":"string","nullable":true},"financialAdvisor":{"type":"boolean"},"occupation":{"type":"string","nullable":true},"employmentStatus":{"type":"string","enum":["EMPLOYED","UNEMPLOYED","SELF_EMPLOYED","RETIRED","STUDENT","OTHER"]},"employerName":{"type":"string","nullable":true},"employerAddressLine1":{"type":"string","nullable":true},"employerAddressLine2":{"type":"string","nullable":true},"employerCity":{"type":"string","nullable":true},"employerState":{"type":"string","nullable":true},"employerZip":{"type":"string","nullable":true},"employerCountry":{"type":"string","nullable":true},"notes":{"type":"string","nullable":true},"kycs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"platform":{"type":"string","example":"KYC Platform"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Passport"},"documentImage":{"type":"string","example":"https://example.com/passport.jpg"},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Document unclear"},"response":{"type":"string","nullable":true,"example":"Submitted clearer document"}},"required":["id","createdAt","updatedAt","deletedAt","tid","platform","individualId","documentType","documentImage","kycStatus","reason","response"]},"nullable":true},"amls":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"provider":{"type":"string","nullable":true,"example":"AML Provider"},"url":{"type":"string","nullable":true,"example":"https://example.com/aml"},"status":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","ERROR"],"example":"PENDING"},"checkedAt":{"type":"string","format":"date-time","nullable":true,"example":"2022-01-01T00:00:00Z"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"}},"required":["id","createdAt","updatedAt","deletedAt","tid","provider","url","status","checkedAt","individualId"]},"nullable":true},"aics":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"individualId":{},"individual":{"nullable":true},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"]},"reviewedById":{"nullable":true},"reviewedBy":{"nullable":true},"reviewedAt":{"type":"string","format":"date-time","nullable":true},"systemReview":{"type":"string","enum":["PENDING","NEEDS_INFO","READY_TO_APPROVE","NEEDS_REVIEW","APPROVED","REJECTED"]},"systemLog":{"type":"array","items":{"type":"object","properties":{"check":{"type":"string","minLength":1},"entered":{"type":"number"},"extracted":{"type":"number"},"result":{"type":"string","enum":["PASS","FAIL"]},"reason":{"type":"string"}},"required":["check","result"]},"nullable":true},"firstName":{"type":"string"},"lastName":{"type":"string"},"method":{"type":"string","enum":["PENDING","INCOME","NET_WORTH","PROFESSIONAL_CERTIFICATION","KNOWLEDGEABLE_EMPLOYEE"]},"incomeData":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer","minimum":2020,"maximum":2025},"filingStatus":{"type":"string","enum":["SINGLE","JOINT"]},"income":{"type":"number","minimum":0,"multipleOf":0.01},"fileId":{}},"required":["year","filingStatus","income","fileId"]},"nullable":true},"netWorthData":{"type":"array","items":{"type":"object","properties":{"institution":{"type":"string","minLength":1,"maxLength":100},"accountType":{"type":"string","enum":["CHECKING","SAVINGS","BROKERAGE","REAL_ESTATE","OTHER"]},"balance":{"type":"number","minimum":0,"multipleOf":0.01},"fileId":{}},"required":["institution","accountType","balance","fileId"]},"nullable":true},"professionalData":{"type":"array","items":{"type":"object","properties":{"professionalType":{"type":"string","enum":["SECURITIES_LICENSES","DIRECTORS","FAMILY_OFFICE"]},"licenseNumber":{"type":"string","minLength":1,"maxLength":50,"nullable":true},"fileId":{"nullable":true}},"required":["professionalType"]},"nullable":true},"employeeData":{"type":"array","items":{"type":"object","properties":{"position":{"type":"string","minLength":1,"maxLength":100},"fileId":{}},"required":["position","fileId"]},"nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","individualId","complianceReview","reviewedById","reviewedAt","systemReview","systemLog","firstName","lastName","method","incomeData","netWorthData","professionalData","employeeData"]},"nullable":true},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]},"setupStep":{"type":"string","enum":["NEW","PERSONAL_INFO","ADDRESS","KYC","INCOME","AIC_QUESTIONS","AIC_FILES"]},"sourceOfIncome":{"type":"string","enum":["EMPLOYED","SELF_EMPLOYED","UNEMPLOYED","RETIREMENT","STUDENT"],"nullable":true},"ownership":{"type":"number","nullable":true},"kycProvider":{"type":"string","nullable":true},"retirementAccountType":{"type":"string","enum":["SELF_DIRECTED","CUSTODIAN_MANAGED"],"nullable":true},"custodianName":{"type":"string","nullable":true},"custodianAccountNumber":{"type":"string","nullable":true},"custodianRepresentativeName":{"type":"string","nullable":true},"custodianEmail":{"type":"string","format":"email","nullable":true},"accredited":{"type":"boolean"}},"required":["id","createdAt","updatedAt","deletedAt","tid","accountId","investorAccountId","role","kycStatus","kycFirstName","kycLastName","kycDocumentType","kycDocumentIssuer","kycDocumentNumber","kycIssuerDate","kycExpirationDate","kycCheck","kycCheckedAt","kycLog","kycReviewedById","kycReviewedAt","kycDocumentFrontFileId","kycDocumentBackFileId","kycSelfieFileId","sanctionsStatus","amlStatus","amlProvider","amlTid","amlUrl","amlCheckedAt","amlLog","amlLogData","amlReviewedById","amlReviewedAt","liquidNetWorth","liquidSecurities","illiquidSecurities","privateSecurities","aicAccreditationType","aicExpirationDate","aicQuestionnaire","aicStatus","aicCheckedAt","aicLog","aicReviewedById","aicReviewedAt","iraQuestionnaire","iraCheck","iraCheckedAt","iraLog","iraReviewedById","iraReviewedAt","firstName","lastName","dob","isUsCitizenOrGreenCardHolder","ssn","lastFour","address","address2","email","phone","city","state","zip","country","kycTid","currencyCode","investedInCrowdfunding","currentAnnualIncome","averageAnnualIncome","averageHouseholdIncome","currentHouseholdIncome","householdNetWorth","isSolicited","isRealEstate","timeHorizon","riskTolerance","investmentObjective","investmentExperience","experienceInPrivate","levelOfEducation","financialAdvisor","occupation","employmentStatus","employerName","employerAddressLine1","employerAddressLine2","employerCity","employerState","employerZip","employerCountry","notes","setupStatus","setupStep","sourceOfIncome","ownership","kycProvider","accredited"]},"nullable":true},"legalEntities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_legal_entity_123","nullable":true},"accountId":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6"},"investorAccountId":{"type":"string","example":"investor_account_01j1xgme5qeqq97gpdztd7e4a7"},"kybStatus":{"example":"PENDING"},"sanctionsStatus":{"example":"PENDING"},"kybs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_kyb_123"},"platform":{"type":"string","example":"KYB Platform"},"legalEntityId":{"type":"string","example":"legal_entity_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Certificate of Incorporation"},"documentImage":{"type":"string","example":"https://example.com/document.pdf"},"kybStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Additional information required"},"response":{"type":"string","nullable":true,"example":"Submitted additional documents"}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","platform","legalEntityId","documentType","documentImage","kybStatus","reason","response"]}},"name":{"type":"string","example":"Acme Corporation"},"ein":{"type":"string","example":"12-3456789","nullable":true},"companyType":{"type":"string","example":"LLC","nullable":true},"streetAddress":{"type":"string","example":"123 Main St","nullable":true},"city":{"type":"string","example":"Anytown","nullable":true},"state":{"type":"string","example":"CA","nullable":true},"zip":{"type":"string","example":"12345","nullable":true},"country":{"type":"string","example":"USA","nullable":true},"phone":{"type":"string","example":"+12124567890","nullable":true},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","accountId","investorAccountId","kybStatus","sanctionsStatus","name","state","setupStatus"]},"nullable":true},"investorAccounts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"investorAccountType":{"type":"string","enum":["INDIVIDUAL","JOINT","RETIREMENT","LEGAL_ENTITY"]},"user":{"nullable":true},"userId":{"type":"string","nullable":true},"email":{"type":"string","format":"email","nullable":true},"name":{"type":"string","nullable":true},"regAQualified":{"type":"boolean"},"regCfQualified":{"type":"boolean"},"regDQualified":{"type":"boolean"},"accountId":{"type":"string"},"account":{},"trades":{"type":"array","items":{}},"individuals":{"type":"array","items":{}},"legalEntities":{"type":"array","items":{}},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]},"systemReviewLog":{"type":"string","nullable":true},"totalAmount":{"type":"number"},"statusCheck":{},"trustedContacts":{"type":"array","items":{}}},"required":["id","createdAt","updatedAt","deletedAt","tid","investorAccountType","regAQualified","regCfQualified","regDQualified","accountId","setupStatus","systemReviewLog"]},"nullable":true},"trades":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"investorAccountId":{"nullable":true},"investorAccount":{"nullable":true},"offering":{"nullable":true},"accountId":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6","accountId":"account_00041061050r3gg28a1c60t3gf","nullable":true},"account":{"nullable":true},"offeringId":{"nullable":true},"paymentMethodId":{"nullable":true},"paymentMethod":{"nullable":true},"userId":{"nullable":true},"tradeNumber":{"type":"string"},"ip":{"type":"string","nullable":true},"tid":{"type":"string","nullable":true},"investmentType":{"type":"string","enum":["INDIVIDUAL","JOINT","ENTITY"]},"purchasedShares":{"type":"integer"},"bonusShares":{"type":"integer","nullable":true},"totalNumberOfShares":{"type":"integer"},"pricePerShare":{"type":"number","multipleOf":0.01},"lineItems":{"type":"array","items":{}},"adjustments":{"type":"array","items":{}},"transactions":{"type":"array","items":{}},"totalAmount":{"type":"number","multipleOf":0.01,"nullable":true},"tradeStatus":{"type":"string","enum":["CART","PLACED","IN_REVIEW","NEEDS_INFO","NEEDS_PAYMENT_INFO","FUNDING","CANCELLED","SETTLED","IMPORT_ERROR","ERROR","UPDATE_PAYMENT_METHOD"]},"tradeStatusUnmapped":{"type":"string","nullable":true},"tradeDate":{"type":"string","format":"date-time","nullable":true},"saStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW"]},"saStatusUnmapped":{"type":"string","nullable":true},"saUrl":{"type":"string","nullable":true},"saSignedAt":{"type":"string","format":"date-time","nullable":true},"saExtractedNumberOfShares":{"type":"string","nullable":true},"saExtractedTotalAmount":{"type":"string","nullable":true},"saExtractedPricePerShare":{"type":"string","nullable":true},"saExtractedInvestorType":{"type":"string","nullable":true},"saExtractedSigner":{"type":"string","nullable":true},"saExtractedSignatureDate":{"type":"string","format":"date-time","nullable":true},"saExtractedSigner2":{"type":"string","nullable":true},"saExtractedSignatureDate2":{"type":"string","format":"date-time","nullable":true},"saCheck":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"]},"saCheckedAt":{"type":"string","format":"date-time","nullable":true},"saLog":{"type":"object","properties":{"finalStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW"]},"matchResults":{"type":"array","items":{"type":"object","properties":{"tradeLineItemId":{"type":"string","example":"trade_line_item_01kctsycw3fq7sj6hedvy62cja"},"signerName":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"totalAmount":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"investorName":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"numberOfShares":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]}},"required":["tradeLineItemId"]}}},"required":["finalStatus","matchResults"],"nullable":true},"txnTid":{"type":"string","nullable":true},"txnResponse":{"type":"string","nullable":true},"txnPaymentMethod":{"type":"string","enum":["CREDIT_CARD","WIRE","ACH","BANK_ACCOUNT","CHECK","RETIREMENT"],"nullable":true},"txnCurrencyCode":{"type":"string","minLength":3,"maxLength":3,"nullable":true},"txnChargedAmount":{"type":"number","multipleOf":0.01,"nullable":true},"txnDate":{"type":"string","format":"date-time","nullable":true},"txnSettledDate":{"type":"string","format":"date-time","nullable":true},"fundingStatus":{"type":"string","enum":["PENDING","CANCELLED","SETTLED","REFUNDED","DECLINED","FUNDING","AUTHORIZING","FAILED"],"nullable":true},"fundingStatusUnmapped":{"type":"string","nullable":true},"txnCheck":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"],"nullable":true},"txnCheckedAt":{"type":"string","format":"date-time","nullable":true},"txnLog":{"type":"string","nullable":true},"systemReviewCheck":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","WARNING","INCOMPLETE"],"nullable":true},"systemReviewCheckedAt":{"type":"string","format":"date-time","nullable":true},"systemReviewLog":{"type":"string","nullable":true},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"],"nullable":true},"complianceReviewNotes":{"type":"string","nullable":true},"complianceReviewerId":{"type":"string","nullable":true},"issuerId":{"nullable":true},"complianceReviewName":{"type":"string","nullable":true},"complianceReviewAt":{"type":"string","format":"date-time","nullable":true},"tradeType":{"type":"string","enum":["PURCHASE","CONVERSION","TRANSFER"],"nullable":true},"placedAt":{"type":"string","format":"date-time","nullable":true},"platform":{"type":"string"},"cancelledAt":{"type":"string","format":"date-time","nullable":true},"cancelledById":{"type":"string","nullable":true},"cancelledReason":{"type":"string","nullable":true},"cancellationPeriod":{"type":"number","nullable":true},"disbursed":{"type":"boolean"},"tradeAdjustments":{"type":"number","nullable":true},"chargedAmount":{"type":"number","nullable":true},"balance":{"type":"number","nullable":true},"isUncleared24h":{"type":"boolean"},"term":{"type":"number","nullable":true},"exercisePrice":{"type":"number","nullable":true},"warrantPercentage":{"type":"number","nullable":true},"calculationMethod":{"type":"string","enum":["NONE","PRORATA","INCREMENT"],"nullable":true},"incrementThreshold":{"type":"number","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","investorAccountId","accountId","account","offeringId","paymentMethodId","userId","tradeNumber","ip","tid","investmentType","purchasedShares","bonusShares","totalNumberOfShares","pricePerShare","lineItems","adjustments","transactions","totalAmount","tradeStatus","tradeStatusUnmapped","tradeDate","saStatus","saStatusUnmapped","saUrl","saSignedAt","saExtractedNumberOfShares","saExtractedTotalAmount","saExtractedPricePerShare","saExtractedInvestorType","saExtractedSigner","saExtractedSignatureDate","saExtractedSigner2","saExtractedSignatureDate2","saCheck","saCheckedAt","saLog","txnTid","txnResponse","txnPaymentMethod","txnCurrencyCode","txnChargedAmount","txnDate","txnSettledDate","fundingStatus","fundingStatusUnmapped","txnCheck","txnCheckedAt","txnLog","systemReviewCheck","systemReviewCheckedAt","systemReviewLog","complianceReview","complianceReviewNotes","complianceReviewerId","issuerId","complianceReviewName","complianceReviewAt","tradeType","placedAt","platform","cancelledAt","cancelledById","cancelledReason","cancellationPeriod","isUncleared24h","term","exercisePrice","warrantPercentage","calculationMethod","incrementThreshold"]},"nullable":true},"metadata":{"type":"string","nullable":true},"status":{"type":"string","enum":["PENDING","ERROR","VALID","INVALID","NOT_PROCESSED","PROCESSING","PROCESSING_ERROR","REVIEW_ERROR","PROCESSED"]},"reviewLog":{"type":"string","nullable":true},"pipeline":{"type":"string","enum":["NONE","SUBDOCS_PHOENIX","SUBDOCS_GENERAL","AIC_TAX_RETURNS","AIC_ACCOUNT_STATEMENTS","PAY_STUBS"]},"errorMessage":{"type":"string","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","tid","url","fileType","fileName","name","category","label","private","complianceReview","targetTable","targetId","linkedFrom","accountId","userId","metadata","status","reviewLog","pipeline","errorMessage"]}},"meta":{"type":"object","properties":{"itemCount":{"type":"number","example":1},"totalItems":{"type":"number","example":10},"itemsPerPage":{"type":"number","example":1},"totalPages":{"type":"number","example":10},"currentPage":{"type":"number","example":1}},"required":["itemCount","itemsPerPage","currentPage"]}},"required":["items","meta"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/files-public/{id}/link":{"post":{"summary":"Links a public file to a new resource","tags":["filesPublic"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"linkFilePublic","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"targetId":{"type":"string","example":"trades_01j6aqmtfyfwy9spjdcnh7yqk7"},"label":{"type":"string","enum":["PROOF_OF_INCOME","PROOF_OF_NET_WORTH","EMPLOYEE","TAX_RETURNS","ACCOUNT_STATEMENT","ACCREDITATION_LETTER","LICENSE","IDENTITY_FRONT","IDENTITY_BACK","BAD_ACTOR_REPORT_FILE","OTHER","COMPLIANCE_REQUEST","SUB_DOC","CONTENT_FILE","CSV_EXPORT_FILE","CUSTODIAN_INSTRUCTION_DOCUMENT","LOGO","FAVICON","BACKGROUND_IMAGE","MEMORANDUM","SUBSCRIPTION_AGREEMENT","COVER_ART","ESCROW_AGREEMENT","SS4_LETTER","FORMATION_DOCUMENT","PASSPORT","TRADE_DOCUMENT"],"example":"OTHER"},"category":{"type":"string","minLength":1,"maxLength":50}},"required":["targetId"]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"url":{"type":"string","format":"uri","example":"https://file-location.com"},"fileType":{"type":"string","example":"pdf"},"fileName":{"type":"string","example":"test.pdf"},"name":{"type":"string","example":"test"},"category":{"type":"string","example":"application"},"label":{"type":"string","example":"other"},"private":{"type":"boolean"},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"]},"targetTable":{"type":"string","enum":["KYCS","AMLS","AICS","KYBS","INDIVIDUALS","LEGAL_ENTITIES","INVESTOR_ACCOUNTS","TRADES","OFFERINGS","ISSUERS","COVERED_PERSONS","PAYMENT_METHODS","NOTES","USERS","ACCOUNTS","PAGES","TASKS","FILES","DATA_RECORD_FILES","ASSETS","SITES","PAGE_REVISIONS","TRADE_LINE_ITEMS","TRANSACTIONS","DISBURSEMENTS","DISBURSEMENT_REVIEWS","ISSUER_PAYMENT_METHODS","SIGNER_BRANDS","THEMES","THEME_SETTINGS","CAP_TABLES","CAP_TABLE_SHARE_CLASSES","CAP_TABLE_ENTRIES","EMAIL_THEMES","EMAIL_THEME_SETTINGS"],"nullable":true},"targetId":{"type":"string","nullable":true},"linkedFrom":{"type":"string","nullable":true},"accountId":{"type":"string","example":"account_01j6aqmtfyfwy9spjdcnh7yqk7"},"userId":{"type":"string","example":"user_01j6aqmtfyfwy9spjdcnh7yqk7"},"kycs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"platform":{"type":"string","example":"KYC Platform"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Passport"},"documentImage":{"type":"string","example":"https://example.com/passport.jpg"},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Document unclear"},"response":{"type":"string","nullable":true,"example":"Submitted clearer document"}},"required":["id","createdAt","updatedAt","deletedAt","tid","platform","individualId","documentType","documentImage","kycStatus","reason","response"]},"nullable":true},"kybs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_kyb_123"},"platform":{"type":"string","example":"KYB Platform"},"legalEntityId":{"type":"string","example":"legal_entity_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Certificate of Incorporation"},"documentImage":{"type":"string","example":"https://example.com/document.pdf"},"kybStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Additional information required"},"response":{"type":"string","nullable":true,"example":"Submitted additional documents"}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","platform","legalEntityId","documentType","documentImage","kybStatus","reason","response"]},"nullable":true},"individuals":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"accountId":{"type":"string"},"account":{},"investorAccountId":{"type":"string"},"investorAccount":{},"role":{"type":"string","enum":["PRIMARY","JOINT"]},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"]},"kycFirstName":{"type":"string","nullable":true},"kycLastName":{"type":"string","nullable":true},"kycDocumentType":{"type":"string","enum":["PASSPORT","DRIVER_LICENSE","STATE_ID"],"nullable":true},"kycDocumentIssuer":{"type":"string","nullable":true},"kycDocumentNumber":{"type":"string","nullable":true},"kycIssuerDate":{"type":"string","nullable":true},"kycExpirationDate":{"type":"string","nullable":true},"kycCheck":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"]},"kycCheckedAt":{"type":"string","format":"date-time","nullable":true},"kycLog":{"type":"string","nullable":true},"kycReviewedById":{"type":"string","nullable":true},"kycReviewedAt":{"type":"string","format":"date-time","nullable":true},"kycDocumentFrontFileId":{"type":"string","nullable":true},"kycDocumentFrontFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"kycDocumentBackFileId":{"type":"string","nullable":true},"kycDocumentBackFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"kycSelfieFileId":{"type":"string","nullable":true},"kycSelfieFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"sanctionsStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"]},"amlStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","ERROR"]},"amlProvider":{"type":"string","enum":["ComplyAdvantage"],"nullable":true},"amlTid":{"type":"string","nullable":true},"amlUrl":{"type":"string","nullable":true},"amlCheckedAt":{"type":"string","format":"date-time","nullable":true},"amlLog":{"type":"string","nullable":true},"amlLogData":{"type":"string","nullable":true},"amlReviewedById":{"type":"string","nullable":true},"amlReviewedAt":{"type":"string","format":"date-time","nullable":true},"liquidNetWorth":{"type":"number","multipleOf":0.01,"nullable":true},"liquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"illiquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"privateSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"aicAccreditationType":{"type":"string","enum":["PENDING","INCOME","NET_WORTH","PROFESSIONAL_CERTIFICATION","KNOWLEDGEABLE_EMPLOYEE"]},"aicExpirationDate":{"type":"string","format":"date-time","nullable":true},"aicQuestionnaire":{"type":"string","nullable":true},"aicStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","PROCESSED"]},"aicCheckedAt":{"type":"string","format":"date-time","nullable":true},"aicLog":{"type":"string","nullable":true},"aicReviewedById":{"type":"string","nullable":true},"aicReviewedAt":{"type":"string","format":"date-time","nullable":true},"iraQuestionnaire":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"hasIraAccounts":{"type":"boolean"},"inSelfDirectedIra":{"type":"boolean"},"custodian":{"type":"string"},"hasOtherQualifiedFunds":{"type":"boolean"}},"required":["id","hasIraAccounts","inSelfDirectedIra","custodian","hasOtherQualifiedFunds"]},"nullable":true},"iraCheck":{"type":"string","enum":["PENDING","APPROVED","NEEDS_REVIEW","REJECTED"]},"iraCheckedAt":{"type":"string","format":"date-time","nullable":true},"iraLog":{"type":"string","nullable":true},"iraReviewedById":{"type":"string","nullable":true},"iraReviewedAt":{"type":"string","format":"date-time","nullable":true},"firstName":{"type":"string"},"lastName":{"type":"string","nullable":true},"dob":{"type":"string","format":"date-time","nullable":true},"isUsCitizenOrGreenCardHolder":{"type":"boolean"},"citizenship":{"type":"string","enum":["AD","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","CU","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","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","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","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","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","YE","YT","ZA","ZM","ZW"],"nullable":true},"ssn":{"type":"string","nullable":true},"lastFour":{"type":"string","nullable":true},"address":{"type":"string","nullable":true},"address2":{"type":"string","nullable":true},"email":{"type":"string","format":"email","nullable":true},"phone":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"state":{"type":"string","nullable":true},"zip":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"kycTid":{"type":"string","nullable":true},"currencyCode":{"type":"string","minLength":3,"maxLength":3,"nullable":true},"investedInCrowdfunding":{"type":"number","nullable":true},"currentAnnualIncome":{"type":"number","nullable":true},"averageAnnualIncome":{"type":"number","nullable":true},"averageHouseholdIncome":{"type":"number","nullable":true},"currentHouseholdIncome":{"type":"number","nullable":true},"householdNetWorth":{"type":"number","nullable":true},"isSolicited":{"type":"boolean"},"isRealEstate":{"type":"boolean"},"iliquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"timeHorizon":{"type":"string","nullable":true},"riskTolerance":{"type":"string","nullable":true},"investmentObjective":{"type":"string","nullable":true},"investmentExperience":{"type":"string","nullable":true},"experienceInPrivate":{"type":"string","nullable":true},"levelOfEducation":{"type":"string","nullable":true},"financialAdvisor":{"type":"boolean"},"occupation":{"type":"string","nullable":true},"employmentStatus":{"type":"string","enum":["EMPLOYED","UNEMPLOYED","SELF_EMPLOYED","RETIRED","STUDENT","OTHER"]},"employerName":{"type":"string","nullable":true},"employerAddressLine1":{"type":"string","nullable":true},"employerAddressLine2":{"type":"string","nullable":true},"employerCity":{"type":"string","nullable":true},"employerState":{"type":"string","nullable":true},"employerZip":{"type":"string","nullable":true},"employerCountry":{"type":"string","nullable":true},"notes":{"type":"string","nullable":true},"kycs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"platform":{"type":"string","example":"KYC Platform"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Passport"},"documentImage":{"type":"string","example":"https://example.com/passport.jpg"},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Document unclear"},"response":{"type":"string","nullable":true,"example":"Submitted clearer document"}},"required":["id","createdAt","updatedAt","deletedAt","tid","platform","individualId","documentType","documentImage","kycStatus","reason","response"]},"nullable":true},"amls":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"provider":{"type":"string","nullable":true,"example":"AML Provider"},"url":{"type":"string","nullable":true,"example":"https://example.com/aml"},"status":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","ERROR"],"example":"PENDING"},"checkedAt":{"type":"string","format":"date-time","nullable":true,"example":"2022-01-01T00:00:00Z"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"}},"required":["id","createdAt","updatedAt","deletedAt","tid","provider","url","status","checkedAt","individualId"]},"nullable":true},"aics":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"individualId":{},"individual":{"nullable":true},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"]},"reviewedById":{"nullable":true},"reviewedBy":{"nullable":true},"reviewedAt":{"type":"string","format":"date-time","nullable":true},"systemReview":{"type":"string","enum":["PENDING","NEEDS_INFO","READY_TO_APPROVE","NEEDS_REVIEW","APPROVED","REJECTED"]},"systemLog":{"type":"array","items":{"type":"object","properties":{"check":{"type":"string","minLength":1},"entered":{"type":"number"},"extracted":{"type":"number"},"result":{"type":"string","enum":["PASS","FAIL"]},"reason":{"type":"string"}},"required":["check","result"]},"nullable":true},"firstName":{"type":"string"},"lastName":{"type":"string"},"method":{"type":"string","enum":["PENDING","INCOME","NET_WORTH","PROFESSIONAL_CERTIFICATION","KNOWLEDGEABLE_EMPLOYEE"]},"incomeData":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer","minimum":2020,"maximum":2025},"filingStatus":{"type":"string","enum":["SINGLE","JOINT"]},"income":{"type":"number","minimum":0,"multipleOf":0.01},"fileId":{}},"required":["year","filingStatus","income","fileId"]},"nullable":true},"netWorthData":{"type":"array","items":{"type":"object","properties":{"institution":{"type":"string","minLength":1,"maxLength":100},"accountType":{"type":"string","enum":["CHECKING","SAVINGS","BROKERAGE","REAL_ESTATE","OTHER"]},"balance":{"type":"number","minimum":0,"multipleOf":0.01},"fileId":{}},"required":["institution","accountType","balance","fileId"]},"nullable":true},"professionalData":{"type":"array","items":{"type":"object","properties":{"professionalType":{"type":"string","enum":["SECURITIES_LICENSES","DIRECTORS","FAMILY_OFFICE"]},"licenseNumber":{"type":"string","minLength":1,"maxLength":50,"nullable":true},"fileId":{"nullable":true}},"required":["professionalType"]},"nullable":true},"employeeData":{"type":"array","items":{"type":"object","properties":{"position":{"type":"string","minLength":1,"maxLength":100},"fileId":{}},"required":["position","fileId"]},"nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","individualId","complianceReview","reviewedById","reviewedAt","systemReview","systemLog","firstName","lastName","method","incomeData","netWorthData","professionalData","employeeData"]},"nullable":true},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]},"setupStep":{"type":"string","enum":["NEW","PERSONAL_INFO","ADDRESS","KYC","INCOME","AIC_QUESTIONS","AIC_FILES"]},"sourceOfIncome":{"type":"string","enum":["EMPLOYED","SELF_EMPLOYED","UNEMPLOYED","RETIREMENT","STUDENT"],"nullable":true},"ownership":{"type":"number","nullable":true},"kycProvider":{"type":"string","nullable":true},"retirementAccountType":{"type":"string","enum":["SELF_DIRECTED","CUSTODIAN_MANAGED"],"nullable":true},"custodianName":{"type":"string","nullable":true},"custodianAccountNumber":{"type":"string","nullable":true},"custodianRepresentativeName":{"type":"string","nullable":true},"custodianEmail":{"type":"string","format":"email","nullable":true},"accredited":{"type":"boolean"}},"required":["id","createdAt","updatedAt","deletedAt","tid","accountId","investorAccountId","role","kycStatus","kycFirstName","kycLastName","kycDocumentType","kycDocumentIssuer","kycDocumentNumber","kycIssuerDate","kycExpirationDate","kycCheck","kycCheckedAt","kycLog","kycReviewedById","kycReviewedAt","kycDocumentFrontFileId","kycDocumentBackFileId","kycSelfieFileId","sanctionsStatus","amlStatus","amlProvider","amlTid","amlUrl","amlCheckedAt","amlLog","amlLogData","amlReviewedById","amlReviewedAt","liquidNetWorth","liquidSecurities","illiquidSecurities","privateSecurities","aicAccreditationType","aicExpirationDate","aicQuestionnaire","aicStatus","aicCheckedAt","aicLog","aicReviewedById","aicReviewedAt","iraQuestionnaire","iraCheck","iraCheckedAt","iraLog","iraReviewedById","iraReviewedAt","firstName","lastName","dob","isUsCitizenOrGreenCardHolder","ssn","lastFour","address","address2","email","phone","city","state","zip","country","kycTid","currencyCode","investedInCrowdfunding","currentAnnualIncome","averageAnnualIncome","averageHouseholdIncome","currentHouseholdIncome","householdNetWorth","isSolicited","isRealEstate","timeHorizon","riskTolerance","investmentObjective","investmentExperience","experienceInPrivate","levelOfEducation","financialAdvisor","occupation","employmentStatus","employerName","employerAddressLine1","employerAddressLine2","employerCity","employerState","employerZip","employerCountry","notes","setupStatus","setupStep","sourceOfIncome","ownership","kycProvider","accredited"]},"nullable":true},"legalEntities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_legal_entity_123","nullable":true},"accountId":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6"},"investorAccountId":{"type":"string","example":"investor_account_01j1xgme5qeqq97gpdztd7e4a7"},"kybStatus":{"example":"PENDING"},"sanctionsStatus":{"example":"PENDING"},"kybs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_kyb_123"},"platform":{"type":"string","example":"KYB Platform"},"legalEntityId":{"type":"string","example":"legal_entity_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Certificate of Incorporation"},"documentImage":{"type":"string","example":"https://example.com/document.pdf"},"kybStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Additional information required"},"response":{"type":"string","nullable":true,"example":"Submitted additional documents"}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","platform","legalEntityId","documentType","documentImage","kybStatus","reason","response"]}},"name":{"type":"string","example":"Acme Corporation"},"ein":{"type":"string","example":"12-3456789","nullable":true},"companyType":{"type":"string","example":"LLC","nullable":true},"streetAddress":{"type":"string","example":"123 Main St","nullable":true},"city":{"type":"string","example":"Anytown","nullable":true},"state":{"type":"string","example":"CA","nullable":true},"zip":{"type":"string","example":"12345","nullable":true},"country":{"type":"string","example":"USA","nullable":true},"phone":{"type":"string","example":"+12124567890","nullable":true},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","accountId","investorAccountId","kybStatus","sanctionsStatus","name","state","setupStatus"]},"nullable":true},"investorAccounts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"investorAccountType":{"type":"string","enum":["INDIVIDUAL","JOINT","RETIREMENT","LEGAL_ENTITY"]},"user":{"nullable":true},"userId":{"type":"string","nullable":true},"email":{"type":"string","format":"email","nullable":true},"name":{"type":"string","nullable":true},"regAQualified":{"type":"boolean"},"regCfQualified":{"type":"boolean"},"regDQualified":{"type":"boolean"},"accountId":{"type":"string"},"account":{},"trades":{"type":"array","items":{}},"individuals":{"type":"array","items":{}},"legalEntities":{"type":"array","items":{}},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]},"systemReviewLog":{"type":"string","nullable":true},"totalAmount":{"type":"number"},"statusCheck":{},"trustedContacts":{"type":"array","items":{}}},"required":["id","createdAt","updatedAt","deletedAt","tid","investorAccountType","regAQualified","regCfQualified","regDQualified","accountId","setupStatus","systemReviewLog"]},"nullable":true},"trades":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"investorAccountId":{"nullable":true},"investorAccount":{"nullable":true},"offering":{"nullable":true},"accountId":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6","accountId":"account_00041061050r3gg28a1c60t3gf","nullable":true},"account":{"nullable":true},"offeringId":{"nullable":true},"paymentMethodId":{"nullable":true},"paymentMethod":{"nullable":true},"userId":{"nullable":true},"tradeNumber":{"type":"string"},"ip":{"type":"string","nullable":true},"tid":{"type":"string","nullable":true},"investmentType":{"type":"string","enum":["INDIVIDUAL","JOINT","ENTITY"]},"purchasedShares":{"type":"integer"},"bonusShares":{"type":"integer","nullable":true},"totalNumberOfShares":{"type":"integer"},"pricePerShare":{"type":"number","multipleOf":0.01},"lineItems":{"type":"array","items":{}},"adjustments":{"type":"array","items":{}},"transactions":{"type":"array","items":{}},"totalAmount":{"type":"number","multipleOf":0.01,"nullable":true},"tradeStatus":{"type":"string","enum":["CART","PLACED","IN_REVIEW","NEEDS_INFO","NEEDS_PAYMENT_INFO","FUNDING","CANCELLED","SETTLED","IMPORT_ERROR","ERROR","UPDATE_PAYMENT_METHOD"]},"tradeStatusUnmapped":{"type":"string","nullable":true},"tradeDate":{"type":"string","format":"date-time","nullable":true},"saStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW"]},"saStatusUnmapped":{"type":"string","nullable":true},"saUrl":{"type":"string","nullable":true},"saSignedAt":{"type":"string","format":"date-time","nullable":true},"saExtractedNumberOfShares":{"type":"string","nullable":true},"saExtractedTotalAmount":{"type":"string","nullable":true},"saExtractedPricePerShare":{"type":"string","nullable":true},"saExtractedInvestorType":{"type":"string","nullable":true},"saExtractedSigner":{"type":"string","nullable":true},"saExtractedSignatureDate":{"type":"string","format":"date-time","nullable":true},"saExtractedSigner2":{"type":"string","nullable":true},"saExtractedSignatureDate2":{"type":"string","format":"date-time","nullable":true},"saCheck":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"]},"saCheckedAt":{"type":"string","format":"date-time","nullable":true},"saLog":{"type":"object","properties":{"finalStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW"]},"matchResults":{"type":"array","items":{"type":"object","properties":{"tradeLineItemId":{"type":"string","example":"trade_line_item_01kctsycw3fq7sj6hedvy62cja"},"signerName":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"totalAmount":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"investorName":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"numberOfShares":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]}},"required":["tradeLineItemId"]}}},"required":["finalStatus","matchResults"],"nullable":true},"txnTid":{"type":"string","nullable":true},"txnResponse":{"type":"string","nullable":true},"txnPaymentMethod":{"type":"string","enum":["CREDIT_CARD","WIRE","ACH","BANK_ACCOUNT","CHECK","RETIREMENT"],"nullable":true},"txnCurrencyCode":{"type":"string","minLength":3,"maxLength":3,"nullable":true},"txnChargedAmount":{"type":"number","multipleOf":0.01,"nullable":true},"txnDate":{"type":"string","format":"date-time","nullable":true},"txnSettledDate":{"type":"string","format":"date-time","nullable":true},"fundingStatus":{"type":"string","enum":["PENDING","CANCELLED","SETTLED","REFUNDED","DECLINED","FUNDING","AUTHORIZING","FAILED"],"nullable":true},"fundingStatusUnmapped":{"type":"string","nullable":true},"txnCheck":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"],"nullable":true},"txnCheckedAt":{"type":"string","format":"date-time","nullable":true},"txnLog":{"type":"string","nullable":true},"systemReviewCheck":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","WARNING","INCOMPLETE"],"nullable":true},"systemReviewCheckedAt":{"type":"string","format":"date-time","nullable":true},"systemReviewLog":{"type":"string","nullable":true},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"],"nullable":true},"complianceReviewNotes":{"type":"string","nullable":true},"complianceReviewerId":{"type":"string","nullable":true},"issuerId":{"nullable":true},"complianceReviewName":{"type":"string","nullable":true},"complianceReviewAt":{"type":"string","format":"date-time","nullable":true},"tradeType":{"type":"string","enum":["PURCHASE","CONVERSION","TRANSFER"],"nullable":true},"placedAt":{"type":"string","format":"date-time","nullable":true},"platform":{"type":"string"},"cancelledAt":{"type":"string","format":"date-time","nullable":true},"cancelledById":{"type":"string","nullable":true},"cancelledReason":{"type":"string","nullable":true},"cancellationPeriod":{"type":"number","nullable":true},"disbursed":{"type":"boolean"},"tradeAdjustments":{"type":"number","nullable":true},"chargedAmount":{"type":"number","nullable":true},"balance":{"type":"number","nullable":true},"isUncleared24h":{"type":"boolean"},"term":{"type":"number","nullable":true},"exercisePrice":{"type":"number","nullable":true},"warrantPercentage":{"type":"number","nullable":true},"calculationMethod":{"type":"string","enum":["NONE","PRORATA","INCREMENT"],"nullable":true},"incrementThreshold":{"type":"number","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","investorAccountId","accountId","account","offeringId","paymentMethodId","userId","tradeNumber","ip","tid","investmentType","purchasedShares","bonusShares","totalNumberOfShares","pricePerShare","lineItems","adjustments","transactions","totalAmount","tradeStatus","tradeStatusUnmapped","tradeDate","saStatus","saStatusUnmapped","saUrl","saSignedAt","saExtractedNumberOfShares","saExtractedTotalAmount","saExtractedPricePerShare","saExtractedInvestorType","saExtractedSigner","saExtractedSignatureDate","saExtractedSigner2","saExtractedSignatureDate2","saCheck","saCheckedAt","saLog","txnTid","txnResponse","txnPaymentMethod","txnCurrencyCode","txnChargedAmount","txnDate","txnSettledDate","fundingStatus","fundingStatusUnmapped","txnCheck","txnCheckedAt","txnLog","systemReviewCheck","systemReviewCheckedAt","systemReviewLog","complianceReview","complianceReviewNotes","complianceReviewerId","issuerId","complianceReviewName","complianceReviewAt","tradeType","placedAt","platform","cancelledAt","cancelledById","cancelledReason","cancellationPeriod","isUncleared24h","term","exercisePrice","warrantPercentage","calculationMethod","incrementThreshold"]},"nullable":true},"metadata":{"type":"string","nullable":true},"status":{"type":"string","enum":["PENDING","ERROR","VALID","INVALID","NOT_PROCESSED","PROCESSING","PROCESSING_ERROR","REVIEW_ERROR","PROCESSED"]},"reviewLog":{"type":"string","nullable":true},"pipeline":{"type":"string","enum":["NONE","SUBDOCS_PHOENIX","SUBDOCS_GENERAL","AIC_TAX_RETURNS","AIC_ACCOUNT_STATEMENTS","PAY_STUBS"]},"errorMessage":{"type":"string","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","tid","url","fileType","fileName","name","category","label","private","complianceReview","targetTable","targetId","linkedFrom","accountId","userId","metadata","status","reviewLog","pipeline","errorMessage"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"422":{"description":"422","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"422"},"message":{"type":"string","example":"UNPROCESSABLE_ENTITY"},"errors":{"type":"array","items":{"type":"string"},"example":["file is required"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}},"502":{"description":"502","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"502"},"message":{"type":"string","example":"BAD_GATEWAY"},"errors":{"type":"array","items":{"type":"string"},"example":["bad gateway"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/files-public/{id}/unlink":{"post":{"summary":"Unlinks a public file to the parent resource","tags":["filesPublic"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"unlinkFilePublic","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"202":{"description":"202","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"url":{"type":"string","format":"uri","example":"https://file-location.com"},"fileType":{"type":"string","example":"pdf"},"fileName":{"type":"string","example":"test.pdf"},"name":{"type":"string","example":"test"},"category":{"type":"string","example":"application"},"label":{"type":"string","example":"other"},"private":{"type":"boolean"},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"]},"targetTable":{"type":"string","enum":["KYCS","AMLS","AICS","KYBS","INDIVIDUALS","LEGAL_ENTITIES","INVESTOR_ACCOUNTS","TRADES","OFFERINGS","ISSUERS","COVERED_PERSONS","PAYMENT_METHODS","NOTES","USERS","ACCOUNTS","PAGES","TASKS","FILES","DATA_RECORD_FILES","ASSETS","SITES","PAGE_REVISIONS","TRADE_LINE_ITEMS","TRANSACTIONS","DISBURSEMENTS","DISBURSEMENT_REVIEWS","ISSUER_PAYMENT_METHODS","SIGNER_BRANDS","THEMES","THEME_SETTINGS","CAP_TABLES","CAP_TABLE_SHARE_CLASSES","CAP_TABLE_ENTRIES","EMAIL_THEMES","EMAIL_THEME_SETTINGS"],"nullable":true},"targetId":{"type":"string","nullable":true},"linkedFrom":{"type":"string","nullable":true},"accountId":{"type":"string","example":"account_01j6aqmtfyfwy9spjdcnh7yqk7"},"userId":{"type":"string","example":"user_01j6aqmtfyfwy9spjdcnh7yqk7"},"kycs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"platform":{"type":"string","example":"KYC Platform"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Passport"},"documentImage":{"type":"string","example":"https://example.com/passport.jpg"},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Document unclear"},"response":{"type":"string","nullable":true,"example":"Submitted clearer document"}},"required":["id","createdAt","updatedAt","deletedAt","tid","platform","individualId","documentType","documentImage","kycStatus","reason","response"]},"nullable":true},"kybs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_kyb_123"},"platform":{"type":"string","example":"KYB Platform"},"legalEntityId":{"type":"string","example":"legal_entity_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Certificate of Incorporation"},"documentImage":{"type":"string","example":"https://example.com/document.pdf"},"kybStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Additional information required"},"response":{"type":"string","nullable":true,"example":"Submitted additional documents"}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","platform","legalEntityId","documentType","documentImage","kybStatus","reason","response"]},"nullable":true},"individuals":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"accountId":{"type":"string"},"account":{},"investorAccountId":{"type":"string"},"investorAccount":{},"role":{"type":"string","enum":["PRIMARY","JOINT"]},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"]},"kycFirstName":{"type":"string","nullable":true},"kycLastName":{"type":"string","nullable":true},"kycDocumentType":{"type":"string","enum":["PASSPORT","DRIVER_LICENSE","STATE_ID"],"nullable":true},"kycDocumentIssuer":{"type":"string","nullable":true},"kycDocumentNumber":{"type":"string","nullable":true},"kycIssuerDate":{"type":"string","nullable":true},"kycExpirationDate":{"type":"string","nullable":true},"kycCheck":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"]},"kycCheckedAt":{"type":"string","format":"date-time","nullable":true},"kycLog":{"type":"string","nullable":true},"kycReviewedById":{"type":"string","nullable":true},"kycReviewedAt":{"type":"string","format":"date-time","nullable":true},"kycDocumentFrontFileId":{"type":"string","nullable":true},"kycDocumentFrontFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"kycDocumentBackFileId":{"type":"string","nullable":true},"kycDocumentBackFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"kycSelfieFileId":{"type":"string","nullable":true},"kycSelfieFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"sanctionsStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"]},"amlStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","ERROR"]},"amlProvider":{"type":"string","enum":["ComplyAdvantage"],"nullable":true},"amlTid":{"type":"string","nullable":true},"amlUrl":{"type":"string","nullable":true},"amlCheckedAt":{"type":"string","format":"date-time","nullable":true},"amlLog":{"type":"string","nullable":true},"amlLogData":{"type":"string","nullable":true},"amlReviewedById":{"type":"string","nullable":true},"amlReviewedAt":{"type":"string","format":"date-time","nullable":true},"liquidNetWorth":{"type":"number","multipleOf":0.01,"nullable":true},"liquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"illiquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"privateSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"aicAccreditationType":{"type":"string","enum":["PENDING","INCOME","NET_WORTH","PROFESSIONAL_CERTIFICATION","KNOWLEDGEABLE_EMPLOYEE"]},"aicExpirationDate":{"type":"string","format":"date-time","nullable":true},"aicQuestionnaire":{"type":"string","nullable":true},"aicStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","PROCESSED"]},"aicCheckedAt":{"type":"string","format":"date-time","nullable":true},"aicLog":{"type":"string","nullable":true},"aicReviewedById":{"type":"string","nullable":true},"aicReviewedAt":{"type":"string","format":"date-time","nullable":true},"iraQuestionnaire":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"hasIraAccounts":{"type":"boolean"},"inSelfDirectedIra":{"type":"boolean"},"custodian":{"type":"string"},"hasOtherQualifiedFunds":{"type":"boolean"}},"required":["id","hasIraAccounts","inSelfDirectedIra","custodian","hasOtherQualifiedFunds"]},"nullable":true},"iraCheck":{"type":"string","enum":["PENDING","APPROVED","NEEDS_REVIEW","REJECTED"]},"iraCheckedAt":{"type":"string","format":"date-time","nullable":true},"iraLog":{"type":"string","nullable":true},"iraReviewedById":{"type":"string","nullable":true},"iraReviewedAt":{"type":"string","format":"date-time","nullable":true},"firstName":{"type":"string"},"lastName":{"type":"string","nullable":true},"dob":{"type":"string","format":"date-time","nullable":true},"isUsCitizenOrGreenCardHolder":{"type":"boolean"},"citizenship":{"type":"string","enum":["AD","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","CU","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","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","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","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","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","YE","YT","ZA","ZM","ZW"],"nullable":true},"ssn":{"type":"string","nullable":true},"lastFour":{"type":"string","nullable":true},"address":{"type":"string","nullable":true},"address2":{"type":"string","nullable":true},"email":{"type":"string","format":"email","nullable":true},"phone":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"state":{"type":"string","nullable":true},"zip":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"kycTid":{"type":"string","nullable":true},"currencyCode":{"type":"string","minLength":3,"maxLength":3,"nullable":true},"investedInCrowdfunding":{"type":"number","nullable":true},"currentAnnualIncome":{"type":"number","nullable":true},"averageAnnualIncome":{"type":"number","nullable":true},"averageHouseholdIncome":{"type":"number","nullable":true},"currentHouseholdIncome":{"type":"number","nullable":true},"householdNetWorth":{"type":"number","nullable":true},"isSolicited":{"type":"boolean"},"isRealEstate":{"type":"boolean"},"iliquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"timeHorizon":{"type":"string","nullable":true},"riskTolerance":{"type":"string","nullable":true},"investmentObjective":{"type":"string","nullable":true},"investmentExperience":{"type":"string","nullable":true},"experienceInPrivate":{"type":"string","nullable":true},"levelOfEducation":{"type":"string","nullable":true},"financialAdvisor":{"type":"boolean"},"occupation":{"type":"string","nullable":true},"employmentStatus":{"type":"string","enum":["EMPLOYED","UNEMPLOYED","SELF_EMPLOYED","RETIRED","STUDENT","OTHER"]},"employerName":{"type":"string","nullable":true},"employerAddressLine1":{"type":"string","nullable":true},"employerAddressLine2":{"type":"string","nullable":true},"employerCity":{"type":"string","nullable":true},"employerState":{"type":"string","nullable":true},"employerZip":{"type":"string","nullable":true},"employerCountry":{"type":"string","nullable":true},"notes":{"type":"string","nullable":true},"kycs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"platform":{"type":"string","example":"KYC Platform"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Passport"},"documentImage":{"type":"string","example":"https://example.com/passport.jpg"},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Document unclear"},"response":{"type":"string","nullable":true,"example":"Submitted clearer document"}},"required":["id","createdAt","updatedAt","deletedAt","tid","platform","individualId","documentType","documentImage","kycStatus","reason","response"]},"nullable":true},"amls":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"provider":{"type":"string","nullable":true,"example":"AML Provider"},"url":{"type":"string","nullable":true,"example":"https://example.com/aml"},"status":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","ERROR"],"example":"PENDING"},"checkedAt":{"type":"string","format":"date-time","nullable":true,"example":"2022-01-01T00:00:00Z"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"}},"required":["id","createdAt","updatedAt","deletedAt","tid","provider","url","status","checkedAt","individualId"]},"nullable":true},"aics":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"individualId":{},"individual":{"nullable":true},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"]},"reviewedById":{"nullable":true},"reviewedBy":{"nullable":true},"reviewedAt":{"type":"string","format":"date-time","nullable":true},"systemReview":{"type":"string","enum":["PENDING","NEEDS_INFO","READY_TO_APPROVE","NEEDS_REVIEW","APPROVED","REJECTED"]},"systemLog":{"type":"array","items":{"type":"object","properties":{"check":{"type":"string","minLength":1},"entered":{"type":"number"},"extracted":{"type":"number"},"result":{"type":"string","enum":["PASS","FAIL"]},"reason":{"type":"string"}},"required":["check","result"]},"nullable":true},"firstName":{"type":"string"},"lastName":{"type":"string"},"method":{"type":"string","enum":["PENDING","INCOME","NET_WORTH","PROFESSIONAL_CERTIFICATION","KNOWLEDGEABLE_EMPLOYEE"]},"incomeData":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer","minimum":2020,"maximum":2025},"filingStatus":{"type":"string","enum":["SINGLE","JOINT"]},"income":{"type":"number","minimum":0,"multipleOf":0.01},"fileId":{}},"required":["year","filingStatus","income","fileId"]},"nullable":true},"netWorthData":{"type":"array","items":{"type":"object","properties":{"institution":{"type":"string","minLength":1,"maxLength":100},"accountType":{"type":"string","enum":["CHECKING","SAVINGS","BROKERAGE","REAL_ESTATE","OTHER"]},"balance":{"type":"number","minimum":0,"multipleOf":0.01},"fileId":{}},"required":["institution","accountType","balance","fileId"]},"nullable":true},"professionalData":{"type":"array","items":{"type":"object","properties":{"professionalType":{"type":"string","enum":["SECURITIES_LICENSES","DIRECTORS","FAMILY_OFFICE"]},"licenseNumber":{"type":"string","minLength":1,"maxLength":50,"nullable":true},"fileId":{"nullable":true}},"required":["professionalType"]},"nullable":true},"employeeData":{"type":"array","items":{"type":"object","properties":{"position":{"type":"string","minLength":1,"maxLength":100},"fileId":{}},"required":["position","fileId"]},"nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","individualId","complianceReview","reviewedById","reviewedAt","systemReview","systemLog","firstName","lastName","method","incomeData","netWorthData","professionalData","employeeData"]},"nullable":true},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]},"setupStep":{"type":"string","enum":["NEW","PERSONAL_INFO","ADDRESS","KYC","INCOME","AIC_QUESTIONS","AIC_FILES"]},"sourceOfIncome":{"type":"string","enum":["EMPLOYED","SELF_EMPLOYED","UNEMPLOYED","RETIREMENT","STUDENT"],"nullable":true},"ownership":{"type":"number","nullable":true},"kycProvider":{"type":"string","nullable":true},"retirementAccountType":{"type":"string","enum":["SELF_DIRECTED","CUSTODIAN_MANAGED"],"nullable":true},"custodianName":{"type":"string","nullable":true},"custodianAccountNumber":{"type":"string","nullable":true},"custodianRepresentativeName":{"type":"string","nullable":true},"custodianEmail":{"type":"string","format":"email","nullable":true},"accredited":{"type":"boolean"}},"required":["id","createdAt","updatedAt","deletedAt","tid","accountId","investorAccountId","role","kycStatus","kycFirstName","kycLastName","kycDocumentType","kycDocumentIssuer","kycDocumentNumber","kycIssuerDate","kycExpirationDate","kycCheck","kycCheckedAt","kycLog","kycReviewedById","kycReviewedAt","kycDocumentFrontFileId","kycDocumentBackFileId","kycSelfieFileId","sanctionsStatus","amlStatus","amlProvider","amlTid","amlUrl","amlCheckedAt","amlLog","amlLogData","amlReviewedById","amlReviewedAt","liquidNetWorth","liquidSecurities","illiquidSecurities","privateSecurities","aicAccreditationType","aicExpirationDate","aicQuestionnaire","aicStatus","aicCheckedAt","aicLog","aicReviewedById","aicReviewedAt","iraQuestionnaire","iraCheck","iraCheckedAt","iraLog","iraReviewedById","iraReviewedAt","firstName","lastName","dob","isUsCitizenOrGreenCardHolder","ssn","lastFour","address","address2","email","phone","city","state","zip","country","kycTid","currencyCode","investedInCrowdfunding","currentAnnualIncome","averageAnnualIncome","averageHouseholdIncome","currentHouseholdIncome","householdNetWorth","isSolicited","isRealEstate","timeHorizon","riskTolerance","investmentObjective","investmentExperience","experienceInPrivate","levelOfEducation","financialAdvisor","occupation","employmentStatus","employerName","employerAddressLine1","employerAddressLine2","employerCity","employerState","employerZip","employerCountry","notes","setupStatus","setupStep","sourceOfIncome","ownership","kycProvider","accredited"]},"nullable":true},"legalEntities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_legal_entity_123","nullable":true},"accountId":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6"},"investorAccountId":{"type":"string","example":"investor_account_01j1xgme5qeqq97gpdztd7e4a7"},"kybStatus":{"example":"PENDING"},"sanctionsStatus":{"example":"PENDING"},"kybs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_kyb_123"},"platform":{"type":"string","example":"KYB Platform"},"legalEntityId":{"type":"string","example":"legal_entity_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Certificate of Incorporation"},"documentImage":{"type":"string","example":"https://example.com/document.pdf"},"kybStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Additional information required"},"response":{"type":"string","nullable":true,"example":"Submitted additional documents"}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","platform","legalEntityId","documentType","documentImage","kybStatus","reason","response"]}},"name":{"type":"string","example":"Acme Corporation"},"ein":{"type":"string","example":"12-3456789","nullable":true},"companyType":{"type":"string","example":"LLC","nullable":true},"streetAddress":{"type":"string","example":"123 Main St","nullable":true},"city":{"type":"string","example":"Anytown","nullable":true},"state":{"type":"string","example":"CA","nullable":true},"zip":{"type":"string","example":"12345","nullable":true},"country":{"type":"string","example":"USA","nullable":true},"phone":{"type":"string","example":"+12124567890","nullable":true},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","accountId","investorAccountId","kybStatus","sanctionsStatus","name","state","setupStatus"]},"nullable":true},"investorAccounts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"investorAccountType":{"type":"string","enum":["INDIVIDUAL","JOINT","RETIREMENT","LEGAL_ENTITY"]},"user":{"nullable":true},"userId":{"type":"string","nullable":true},"email":{"type":"string","format":"email","nullable":true},"name":{"type":"string","nullable":true},"regAQualified":{"type":"boolean"},"regCfQualified":{"type":"boolean"},"regDQualified":{"type":"boolean"},"accountId":{"type":"string"},"account":{},"trades":{"type":"array","items":{}},"individuals":{"type":"array","items":{}},"legalEntities":{"type":"array","items":{}},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]},"systemReviewLog":{"type":"string","nullable":true},"totalAmount":{"type":"number"},"statusCheck":{},"trustedContacts":{"type":"array","items":{}}},"required":["id","createdAt","updatedAt","deletedAt","tid","investorAccountType","regAQualified","regCfQualified","regDQualified","accountId","setupStatus","systemReviewLog"]},"nullable":true},"trades":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"investorAccountId":{"nullable":true},"investorAccount":{"nullable":true},"offering":{"nullable":true},"accountId":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6","accountId":"account_00041061050r3gg28a1c60t3gf","nullable":true},"account":{"nullable":true},"offeringId":{"nullable":true},"paymentMethodId":{"nullable":true},"paymentMethod":{"nullable":true},"userId":{"nullable":true},"tradeNumber":{"type":"string"},"ip":{"type":"string","nullable":true},"tid":{"type":"string","nullable":true},"investmentType":{"type":"string","enum":["INDIVIDUAL","JOINT","ENTITY"]},"purchasedShares":{"type":"integer"},"bonusShares":{"type":"integer","nullable":true},"totalNumberOfShares":{"type":"integer"},"pricePerShare":{"type":"number","multipleOf":0.01},"lineItems":{"type":"array","items":{}},"adjustments":{"type":"array","items":{}},"transactions":{"type":"array","items":{}},"totalAmount":{"type":"number","multipleOf":0.01,"nullable":true},"tradeStatus":{"type":"string","enum":["CART","PLACED","IN_REVIEW","NEEDS_INFO","NEEDS_PAYMENT_INFO","FUNDING","CANCELLED","SETTLED","IMPORT_ERROR","ERROR","UPDATE_PAYMENT_METHOD"]},"tradeStatusUnmapped":{"type":"string","nullable":true},"tradeDate":{"type":"string","format":"date-time","nullable":true},"saStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW"]},"saStatusUnmapped":{"type":"string","nullable":true},"saUrl":{"type":"string","nullable":true},"saSignedAt":{"type":"string","format":"date-time","nullable":true},"saExtractedNumberOfShares":{"type":"string","nullable":true},"saExtractedTotalAmount":{"type":"string","nullable":true},"saExtractedPricePerShare":{"type":"string","nullable":true},"saExtractedInvestorType":{"type":"string","nullable":true},"saExtractedSigner":{"type":"string","nullable":true},"saExtractedSignatureDate":{"type":"string","format":"date-time","nullable":true},"saExtractedSigner2":{"type":"string","nullable":true},"saExtractedSignatureDate2":{"type":"string","format":"date-time","nullable":true},"saCheck":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"]},"saCheckedAt":{"type":"string","format":"date-time","nullable":true},"saLog":{"type":"object","properties":{"finalStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW"]},"matchResults":{"type":"array","items":{"type":"object","properties":{"tradeLineItemId":{"type":"string","example":"trade_line_item_01kctsycw3fq7sj6hedvy62cja"},"signerName":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"totalAmount":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"investorName":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"numberOfShares":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]}},"required":["tradeLineItemId"]}}},"required":["finalStatus","matchResults"],"nullable":true},"txnTid":{"type":"string","nullable":true},"txnResponse":{"type":"string","nullable":true},"txnPaymentMethod":{"type":"string","enum":["CREDIT_CARD","WIRE","ACH","BANK_ACCOUNT","CHECK","RETIREMENT"],"nullable":true},"txnCurrencyCode":{"type":"string","minLength":3,"maxLength":3,"nullable":true},"txnChargedAmount":{"type":"number","multipleOf":0.01,"nullable":true},"txnDate":{"type":"string","format":"date-time","nullable":true},"txnSettledDate":{"type":"string","format":"date-time","nullable":true},"fundingStatus":{"type":"string","enum":["PENDING","CANCELLED","SETTLED","REFUNDED","DECLINED","FUNDING","AUTHORIZING","FAILED"],"nullable":true},"fundingStatusUnmapped":{"type":"string","nullable":true},"txnCheck":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"],"nullable":true},"txnCheckedAt":{"type":"string","format":"date-time","nullable":true},"txnLog":{"type":"string","nullable":true},"systemReviewCheck":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","WARNING","INCOMPLETE"],"nullable":true},"systemReviewCheckedAt":{"type":"string","format":"date-time","nullable":true},"systemReviewLog":{"type":"string","nullable":true},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"],"nullable":true},"complianceReviewNotes":{"type":"string","nullable":true},"complianceReviewerId":{"type":"string","nullable":true},"issuerId":{"nullable":true},"complianceReviewName":{"type":"string","nullable":true},"complianceReviewAt":{"type":"string","format":"date-time","nullable":true},"tradeType":{"type":"string","enum":["PURCHASE","CONVERSION","TRANSFER"],"nullable":true},"placedAt":{"type":"string","format":"date-time","nullable":true},"platform":{"type":"string"},"cancelledAt":{"type":"string","format":"date-time","nullable":true},"cancelledById":{"type":"string","nullable":true},"cancelledReason":{"type":"string","nullable":true},"cancellationPeriod":{"type":"number","nullable":true},"disbursed":{"type":"boolean"},"tradeAdjustments":{"type":"number","nullable":true},"chargedAmount":{"type":"number","nullable":true},"balance":{"type":"number","nullable":true},"isUncleared24h":{"type":"boolean"},"term":{"type":"number","nullable":true},"exercisePrice":{"type":"number","nullable":true},"warrantPercentage":{"type":"number","nullable":true},"calculationMethod":{"type":"string","enum":["NONE","PRORATA","INCREMENT"],"nullable":true},"incrementThreshold":{"type":"number","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","investorAccountId","accountId","account","offeringId","paymentMethodId","userId","tradeNumber","ip","tid","investmentType","purchasedShares","bonusShares","totalNumberOfShares","pricePerShare","lineItems","adjustments","transactions","totalAmount","tradeStatus","tradeStatusUnmapped","tradeDate","saStatus","saStatusUnmapped","saUrl","saSignedAt","saExtractedNumberOfShares","saExtractedTotalAmount","saExtractedPricePerShare","saExtractedInvestorType","saExtractedSigner","saExtractedSignatureDate","saExtractedSigner2","saExtractedSignatureDate2","saCheck","saCheckedAt","saLog","txnTid","txnResponse","txnPaymentMethod","txnCurrencyCode","txnChargedAmount","txnDate","txnSettledDate","fundingStatus","fundingStatusUnmapped","txnCheck","txnCheckedAt","txnLog","systemReviewCheck","systemReviewCheckedAt","systemReviewLog","complianceReview","complianceReviewNotes","complianceReviewerId","issuerId","complianceReviewName","complianceReviewAt","tradeType","placedAt","platform","cancelledAt","cancelledById","cancelledReason","cancellationPeriod","isUncleared24h","term","exercisePrice","warrantPercentage","calculationMethod","incrementThreshold"]},"nullable":true},"metadata":{"type":"string","nullable":true},"status":{"type":"string","enum":["PENDING","ERROR","VALID","INVALID","NOT_PROCESSED","PROCESSING","PROCESSING_ERROR","REVIEW_ERROR","PROCESSED"]},"reviewLog":{"type":"string","nullable":true},"pipeline":{"type":"string","enum":["NONE","SUBDOCS_PHOENIX","SUBDOCS_GENERAL","AIC_TAX_RETURNS","AIC_ACCOUNT_STATEMENTS","PAY_STUBS"]},"errorMessage":{"type":"string","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","tid","url","fileType","fileName","name","category","label","private","complianceReview","targetTable","targetId","linkedFrom","accountId","userId","metadata","status","reviewLog","pipeline","errorMessage"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"422":{"description":"422","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"422"},"message":{"type":"string","example":"UNPROCESSABLE_ENTITY"},"errors":{"type":"array","items":{"type":"string"},"example":["file is required"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}},"502":{"description":"502","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"502"},"message":{"type":"string","example":"BAD_GATEWAY"},"errors":{"type":"array","items":{"type":"string"},"example":["bad gateway"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/files-public/{id}":{"get":{"summary":"Get public file by id","tags":["filesPublic"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"getFilePublic","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"url":{"type":"string","format":"uri","example":"https://file-location.com"},"fileType":{"type":"string","example":"pdf"},"fileName":{"type":"string","example":"test.pdf"},"name":{"type":"string","example":"test"},"category":{"type":"string","example":"application"},"label":{"type":"string","example":"other"},"private":{"type":"boolean"},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"]},"targetTable":{"type":"string","enum":["KYCS","AMLS","AICS","KYBS","INDIVIDUALS","LEGAL_ENTITIES","INVESTOR_ACCOUNTS","TRADES","OFFERINGS","ISSUERS","COVERED_PERSONS","PAYMENT_METHODS","NOTES","USERS","ACCOUNTS","PAGES","TASKS","FILES","DATA_RECORD_FILES","ASSETS","SITES","PAGE_REVISIONS","TRADE_LINE_ITEMS","TRANSACTIONS","DISBURSEMENTS","DISBURSEMENT_REVIEWS","ISSUER_PAYMENT_METHODS","SIGNER_BRANDS","THEMES","THEME_SETTINGS","CAP_TABLES","CAP_TABLE_SHARE_CLASSES","CAP_TABLE_ENTRIES","EMAIL_THEMES","EMAIL_THEME_SETTINGS"],"nullable":true},"targetId":{"type":"string","nullable":true},"linkedFrom":{"type":"string","nullable":true},"accountId":{"type":"string","example":"account_01j6aqmtfyfwy9spjdcnh7yqk7"},"userId":{"type":"string","example":"user_01j6aqmtfyfwy9spjdcnh7yqk7"},"kycs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"platform":{"type":"string","example":"KYC Platform"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Passport"},"documentImage":{"type":"string","example":"https://example.com/passport.jpg"},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Document unclear"},"response":{"type":"string","nullable":true,"example":"Submitted clearer document"}},"required":["id","createdAt","updatedAt","deletedAt","tid","platform","individualId","documentType","documentImage","kycStatus","reason","response"]},"nullable":true},"kybs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_kyb_123"},"platform":{"type":"string","example":"KYB Platform"},"legalEntityId":{"type":"string","example":"legal_entity_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Certificate of Incorporation"},"documentImage":{"type":"string","example":"https://example.com/document.pdf"},"kybStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Additional information required"},"response":{"type":"string","nullable":true,"example":"Submitted additional documents"}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","platform","legalEntityId","documentType","documentImage","kybStatus","reason","response"]},"nullable":true},"individuals":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"accountId":{"type":"string"},"account":{},"investorAccountId":{"type":"string"},"investorAccount":{},"role":{"type":"string","enum":["PRIMARY","JOINT"]},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"]},"kycFirstName":{"type":"string","nullable":true},"kycLastName":{"type":"string","nullable":true},"kycDocumentType":{"type":"string","enum":["PASSPORT","DRIVER_LICENSE","STATE_ID"],"nullable":true},"kycDocumentIssuer":{"type":"string","nullable":true},"kycDocumentNumber":{"type":"string","nullable":true},"kycIssuerDate":{"type":"string","nullable":true},"kycExpirationDate":{"type":"string","nullable":true},"kycCheck":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"]},"kycCheckedAt":{"type":"string","format":"date-time","nullable":true},"kycLog":{"type":"string","nullable":true},"kycReviewedById":{"type":"string","nullable":true},"kycReviewedAt":{"type":"string","format":"date-time","nullable":true},"kycDocumentFrontFileId":{"type":"string","nullable":true},"kycDocumentFrontFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"kycDocumentBackFileId":{"type":"string","nullable":true},"kycDocumentBackFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"kycSelfieFileId":{"type":"string","nullable":true},"kycSelfieFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"sanctionsStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"]},"amlStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","ERROR"]},"amlProvider":{"type":"string","enum":["ComplyAdvantage"],"nullable":true},"amlTid":{"type":"string","nullable":true},"amlUrl":{"type":"string","nullable":true},"amlCheckedAt":{"type":"string","format":"date-time","nullable":true},"amlLog":{"type":"string","nullable":true},"amlLogData":{"type":"string","nullable":true},"amlReviewedById":{"type":"string","nullable":true},"amlReviewedAt":{"type":"string","format":"date-time","nullable":true},"liquidNetWorth":{"type":"number","multipleOf":0.01,"nullable":true},"liquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"illiquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"privateSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"aicAccreditationType":{"type":"string","enum":["PENDING","INCOME","NET_WORTH","PROFESSIONAL_CERTIFICATION","KNOWLEDGEABLE_EMPLOYEE"]},"aicExpirationDate":{"type":"string","format":"date-time","nullable":true},"aicQuestionnaire":{"type":"string","nullable":true},"aicStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","PROCESSED"]},"aicCheckedAt":{"type":"string","format":"date-time","nullable":true},"aicLog":{"type":"string","nullable":true},"aicReviewedById":{"type":"string","nullable":true},"aicReviewedAt":{"type":"string","format":"date-time","nullable":true},"iraQuestionnaire":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"hasIraAccounts":{"type":"boolean"},"inSelfDirectedIra":{"type":"boolean"},"custodian":{"type":"string"},"hasOtherQualifiedFunds":{"type":"boolean"}},"required":["id","hasIraAccounts","inSelfDirectedIra","custodian","hasOtherQualifiedFunds"]},"nullable":true},"iraCheck":{"type":"string","enum":["PENDING","APPROVED","NEEDS_REVIEW","REJECTED"]},"iraCheckedAt":{"type":"string","format":"date-time","nullable":true},"iraLog":{"type":"string","nullable":true},"iraReviewedById":{"type":"string","nullable":true},"iraReviewedAt":{"type":"string","format":"date-time","nullable":true},"firstName":{"type":"string"},"lastName":{"type":"string","nullable":true},"dob":{"type":"string","format":"date-time","nullable":true},"isUsCitizenOrGreenCardHolder":{"type":"boolean"},"citizenship":{"type":"string","enum":["AD","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","CU","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","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","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","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","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","YE","YT","ZA","ZM","ZW"],"nullable":true},"ssn":{"type":"string","nullable":true},"lastFour":{"type":"string","nullable":true},"address":{"type":"string","nullable":true},"address2":{"type":"string","nullable":true},"email":{"type":"string","format":"email","nullable":true},"phone":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"state":{"type":"string","nullable":true},"zip":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"kycTid":{"type":"string","nullable":true},"currencyCode":{"type":"string","minLength":3,"maxLength":3,"nullable":true},"investedInCrowdfunding":{"type":"number","nullable":true},"currentAnnualIncome":{"type":"number","nullable":true},"averageAnnualIncome":{"type":"number","nullable":true},"averageHouseholdIncome":{"type":"number","nullable":true},"currentHouseholdIncome":{"type":"number","nullable":true},"householdNetWorth":{"type":"number","nullable":true},"isSolicited":{"type":"boolean"},"isRealEstate":{"type":"boolean"},"iliquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"timeHorizon":{"type":"string","nullable":true},"riskTolerance":{"type":"string","nullable":true},"investmentObjective":{"type":"string","nullable":true},"investmentExperience":{"type":"string","nullable":true},"experienceInPrivate":{"type":"string","nullable":true},"levelOfEducation":{"type":"string","nullable":true},"financialAdvisor":{"type":"boolean"},"occupation":{"type":"string","nullable":true},"employmentStatus":{"type":"string","enum":["EMPLOYED","UNEMPLOYED","SELF_EMPLOYED","RETIRED","STUDENT","OTHER"]},"employerName":{"type":"string","nullable":true},"employerAddressLine1":{"type":"string","nullable":true},"employerAddressLine2":{"type":"string","nullable":true},"employerCity":{"type":"string","nullable":true},"employerState":{"type":"string","nullable":true},"employerZip":{"type":"string","nullable":true},"employerCountry":{"type":"string","nullable":true},"notes":{"type":"string","nullable":true},"kycs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"platform":{"type":"string","example":"KYC Platform"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Passport"},"documentImage":{"type":"string","example":"https://example.com/passport.jpg"},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Document unclear"},"response":{"type":"string","nullable":true,"example":"Submitted clearer document"}},"required":["id","createdAt","updatedAt","deletedAt","tid","platform","individualId","documentType","documentImage","kycStatus","reason","response"]},"nullable":true},"amls":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"provider":{"type":"string","nullable":true,"example":"AML Provider"},"url":{"type":"string","nullable":true,"example":"https://example.com/aml"},"status":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","ERROR"],"example":"PENDING"},"checkedAt":{"type":"string","format":"date-time","nullable":true,"example":"2022-01-01T00:00:00Z"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"}},"required":["id","createdAt","updatedAt","deletedAt","tid","provider","url","status","checkedAt","individualId"]},"nullable":true},"aics":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"individualId":{},"individual":{"nullable":true},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"]},"reviewedById":{"nullable":true},"reviewedBy":{"nullable":true},"reviewedAt":{"type":"string","format":"date-time","nullable":true},"systemReview":{"type":"string","enum":["PENDING","NEEDS_INFO","READY_TO_APPROVE","NEEDS_REVIEW","APPROVED","REJECTED"]},"systemLog":{"type":"array","items":{"type":"object","properties":{"check":{"type":"string","minLength":1},"entered":{"type":"number"},"extracted":{"type":"number"},"result":{"type":"string","enum":["PASS","FAIL"]},"reason":{"type":"string"}},"required":["check","result"]},"nullable":true},"firstName":{"type":"string"},"lastName":{"type":"string"},"method":{"type":"string","enum":["PENDING","INCOME","NET_WORTH","PROFESSIONAL_CERTIFICATION","KNOWLEDGEABLE_EMPLOYEE"]},"incomeData":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer","minimum":2020,"maximum":2025},"filingStatus":{"type":"string","enum":["SINGLE","JOINT"]},"income":{"type":"number","minimum":0,"multipleOf":0.01},"fileId":{}},"required":["year","filingStatus","income","fileId"]},"nullable":true},"netWorthData":{"type":"array","items":{"type":"object","properties":{"institution":{"type":"string","minLength":1,"maxLength":100},"accountType":{"type":"string","enum":["CHECKING","SAVINGS","BROKERAGE","REAL_ESTATE","OTHER"]},"balance":{"type":"number","minimum":0,"multipleOf":0.01},"fileId":{}},"required":["institution","accountType","balance","fileId"]},"nullable":true},"professionalData":{"type":"array","items":{"type":"object","properties":{"professionalType":{"type":"string","enum":["SECURITIES_LICENSES","DIRECTORS","FAMILY_OFFICE"]},"licenseNumber":{"type":"string","minLength":1,"maxLength":50,"nullable":true},"fileId":{"nullable":true}},"required":["professionalType"]},"nullable":true},"employeeData":{"type":"array","items":{"type":"object","properties":{"position":{"type":"string","minLength":1,"maxLength":100},"fileId":{}},"required":["position","fileId"]},"nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","individualId","complianceReview","reviewedById","reviewedAt","systemReview","systemLog","firstName","lastName","method","incomeData","netWorthData","professionalData","employeeData"]},"nullable":true},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]},"setupStep":{"type":"string","enum":["NEW","PERSONAL_INFO","ADDRESS","KYC","INCOME","AIC_QUESTIONS","AIC_FILES"]},"sourceOfIncome":{"type":"string","enum":["EMPLOYED","SELF_EMPLOYED","UNEMPLOYED","RETIREMENT","STUDENT"],"nullable":true},"ownership":{"type":"number","nullable":true},"kycProvider":{"type":"string","nullable":true},"retirementAccountType":{"type":"string","enum":["SELF_DIRECTED","CUSTODIAN_MANAGED"],"nullable":true},"custodianName":{"type":"string","nullable":true},"custodianAccountNumber":{"type":"string","nullable":true},"custodianRepresentativeName":{"type":"string","nullable":true},"custodianEmail":{"type":"string","format":"email","nullable":true},"accredited":{"type":"boolean"}},"required":["id","createdAt","updatedAt","deletedAt","tid","accountId","investorAccountId","role","kycStatus","kycFirstName","kycLastName","kycDocumentType","kycDocumentIssuer","kycDocumentNumber","kycIssuerDate","kycExpirationDate","kycCheck","kycCheckedAt","kycLog","kycReviewedById","kycReviewedAt","kycDocumentFrontFileId","kycDocumentBackFileId","kycSelfieFileId","sanctionsStatus","amlStatus","amlProvider","amlTid","amlUrl","amlCheckedAt","amlLog","amlLogData","amlReviewedById","amlReviewedAt","liquidNetWorth","liquidSecurities","illiquidSecurities","privateSecurities","aicAccreditationType","aicExpirationDate","aicQuestionnaire","aicStatus","aicCheckedAt","aicLog","aicReviewedById","aicReviewedAt","iraQuestionnaire","iraCheck","iraCheckedAt","iraLog","iraReviewedById","iraReviewedAt","firstName","lastName","dob","isUsCitizenOrGreenCardHolder","ssn","lastFour","address","address2","email","phone","city","state","zip","country","kycTid","currencyCode","investedInCrowdfunding","currentAnnualIncome","averageAnnualIncome","averageHouseholdIncome","currentHouseholdIncome","householdNetWorth","isSolicited","isRealEstate","timeHorizon","riskTolerance","investmentObjective","investmentExperience","experienceInPrivate","levelOfEducation","financialAdvisor","occupation","employmentStatus","employerName","employerAddressLine1","employerAddressLine2","employerCity","employerState","employerZip","employerCountry","notes","setupStatus","setupStep","sourceOfIncome","ownership","kycProvider","accredited"]},"nullable":true},"legalEntities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_legal_entity_123","nullable":true},"accountId":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6"},"investorAccountId":{"type":"string","example":"investor_account_01j1xgme5qeqq97gpdztd7e4a7"},"kybStatus":{"example":"PENDING"},"sanctionsStatus":{"example":"PENDING"},"kybs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_kyb_123"},"platform":{"type":"string","example":"KYB Platform"},"legalEntityId":{"type":"string","example":"legal_entity_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Certificate of Incorporation"},"documentImage":{"type":"string","example":"https://example.com/document.pdf"},"kybStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Additional information required"},"response":{"type":"string","nullable":true,"example":"Submitted additional documents"}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","platform","legalEntityId","documentType","documentImage","kybStatus","reason","response"]}},"name":{"type":"string","example":"Acme Corporation"},"ein":{"type":"string","example":"12-3456789","nullable":true},"companyType":{"type":"string","example":"LLC","nullable":true},"streetAddress":{"type":"string","example":"123 Main St","nullable":true},"city":{"type":"string","example":"Anytown","nullable":true},"state":{"type":"string","example":"CA","nullable":true},"zip":{"type":"string","example":"12345","nullable":true},"country":{"type":"string","example":"USA","nullable":true},"phone":{"type":"string","example":"+12124567890","nullable":true},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","accountId","investorAccountId","kybStatus","sanctionsStatus","name","state","setupStatus"]},"nullable":true},"investorAccounts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"investorAccountType":{"type":"string","enum":["INDIVIDUAL","JOINT","RETIREMENT","LEGAL_ENTITY"]},"user":{"nullable":true},"userId":{"type":"string","nullable":true},"email":{"type":"string","format":"email","nullable":true},"name":{"type":"string","nullable":true},"regAQualified":{"type":"boolean"},"regCfQualified":{"type":"boolean"},"regDQualified":{"type":"boolean"},"accountId":{"type":"string"},"account":{},"trades":{"type":"array","items":{}},"individuals":{"type":"array","items":{}},"legalEntities":{"type":"array","items":{}},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]},"systemReviewLog":{"type":"string","nullable":true},"totalAmount":{"type":"number"},"statusCheck":{},"trustedContacts":{"type":"array","items":{}}},"required":["id","createdAt","updatedAt","deletedAt","tid","investorAccountType","regAQualified","regCfQualified","regDQualified","accountId","setupStatus","systemReviewLog"]},"nullable":true},"trades":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"investorAccountId":{"nullable":true},"investorAccount":{"nullable":true},"offering":{"nullable":true},"accountId":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6","accountId":"account_00041061050r3gg28a1c60t3gf","nullable":true},"account":{"nullable":true},"offeringId":{"nullable":true},"paymentMethodId":{"nullable":true},"paymentMethod":{"nullable":true},"userId":{"nullable":true},"tradeNumber":{"type":"string"},"ip":{"type":"string","nullable":true},"tid":{"type":"string","nullable":true},"investmentType":{"type":"string","enum":["INDIVIDUAL","JOINT","ENTITY"]},"purchasedShares":{"type":"integer"},"bonusShares":{"type":"integer","nullable":true},"totalNumberOfShares":{"type":"integer"},"pricePerShare":{"type":"number","multipleOf":0.01},"lineItems":{"type":"array","items":{}},"adjustments":{"type":"array","items":{}},"transactions":{"type":"array","items":{}},"totalAmount":{"type":"number","multipleOf":0.01,"nullable":true},"tradeStatus":{"type":"string","enum":["CART","PLACED","IN_REVIEW","NEEDS_INFO","NEEDS_PAYMENT_INFO","FUNDING","CANCELLED","SETTLED","IMPORT_ERROR","ERROR","UPDATE_PAYMENT_METHOD"]},"tradeStatusUnmapped":{"type":"string","nullable":true},"tradeDate":{"type":"string","format":"date-time","nullable":true},"saStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW"]},"saStatusUnmapped":{"type":"string","nullable":true},"saUrl":{"type":"string","nullable":true},"saSignedAt":{"type":"string","format":"date-time","nullable":true},"saExtractedNumberOfShares":{"type":"string","nullable":true},"saExtractedTotalAmount":{"type":"string","nullable":true},"saExtractedPricePerShare":{"type":"string","nullable":true},"saExtractedInvestorType":{"type":"string","nullable":true},"saExtractedSigner":{"type":"string","nullable":true},"saExtractedSignatureDate":{"type":"string","format":"date-time","nullable":true},"saExtractedSigner2":{"type":"string","nullable":true},"saExtractedSignatureDate2":{"type":"string","format":"date-time","nullable":true},"saCheck":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"]},"saCheckedAt":{"type":"string","format":"date-time","nullable":true},"saLog":{"type":"object","properties":{"finalStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW"]},"matchResults":{"type":"array","items":{"type":"object","properties":{"tradeLineItemId":{"type":"string","example":"trade_line_item_01kctsycw3fq7sj6hedvy62cja"},"signerName":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"totalAmount":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"investorName":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"numberOfShares":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]}},"required":["tradeLineItemId"]}}},"required":["finalStatus","matchResults"],"nullable":true},"txnTid":{"type":"string","nullable":true},"txnResponse":{"type":"string","nullable":true},"txnPaymentMethod":{"type":"string","enum":["CREDIT_CARD","WIRE","ACH","BANK_ACCOUNT","CHECK","RETIREMENT"],"nullable":true},"txnCurrencyCode":{"type":"string","minLength":3,"maxLength":3,"nullable":true},"txnChargedAmount":{"type":"number","multipleOf":0.01,"nullable":true},"txnDate":{"type":"string","format":"date-time","nullable":true},"txnSettledDate":{"type":"string","format":"date-time","nullable":true},"fundingStatus":{"type":"string","enum":["PENDING","CANCELLED","SETTLED","REFUNDED","DECLINED","FUNDING","AUTHORIZING","FAILED"],"nullable":true},"fundingStatusUnmapped":{"type":"string","nullable":true},"txnCheck":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"],"nullable":true},"txnCheckedAt":{"type":"string","format":"date-time","nullable":true},"txnLog":{"type":"string","nullable":true},"systemReviewCheck":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","WARNING","INCOMPLETE"],"nullable":true},"systemReviewCheckedAt":{"type":"string","format":"date-time","nullable":true},"systemReviewLog":{"type":"string","nullable":true},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"],"nullable":true},"complianceReviewNotes":{"type":"string","nullable":true},"complianceReviewerId":{"type":"string","nullable":true},"issuerId":{"nullable":true},"complianceReviewName":{"type":"string","nullable":true},"complianceReviewAt":{"type":"string","format":"date-time","nullable":true},"tradeType":{"type":"string","enum":["PURCHASE","CONVERSION","TRANSFER"],"nullable":true},"placedAt":{"type":"string","format":"date-time","nullable":true},"platform":{"type":"string"},"cancelledAt":{"type":"string","format":"date-time","nullable":true},"cancelledById":{"type":"string","nullable":true},"cancelledReason":{"type":"string","nullable":true},"cancellationPeriod":{"type":"number","nullable":true},"disbursed":{"type":"boolean"},"tradeAdjustments":{"type":"number","nullable":true},"chargedAmount":{"type":"number","nullable":true},"balance":{"type":"number","nullable":true},"isUncleared24h":{"type":"boolean"},"term":{"type":"number","nullable":true},"exercisePrice":{"type":"number","nullable":true},"warrantPercentage":{"type":"number","nullable":true},"calculationMethod":{"type":"string","enum":["NONE","PRORATA","INCREMENT"],"nullable":true},"incrementThreshold":{"type":"number","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","investorAccountId","accountId","account","offeringId","paymentMethodId","userId","tradeNumber","ip","tid","investmentType","purchasedShares","bonusShares","totalNumberOfShares","pricePerShare","lineItems","adjustments","transactions","totalAmount","tradeStatus","tradeStatusUnmapped","tradeDate","saStatus","saStatusUnmapped","saUrl","saSignedAt","saExtractedNumberOfShares","saExtractedTotalAmount","saExtractedPricePerShare","saExtractedInvestorType","saExtractedSigner","saExtractedSignatureDate","saExtractedSigner2","saExtractedSignatureDate2","saCheck","saCheckedAt","saLog","txnTid","txnResponse","txnPaymentMethod","txnCurrencyCode","txnChargedAmount","txnDate","txnSettledDate","fundingStatus","fundingStatusUnmapped","txnCheck","txnCheckedAt","txnLog","systemReviewCheck","systemReviewCheckedAt","systemReviewLog","complianceReview","complianceReviewNotes","complianceReviewerId","issuerId","complianceReviewName","complianceReviewAt","tradeType","placedAt","platform","cancelledAt","cancelledById","cancelledReason","cancellationPeriod","isUncleared24h","term","exercisePrice","warrantPercentage","calculationMethod","incrementThreshold"]},"nullable":true},"metadata":{"type":"string","nullable":true},"status":{"type":"string","enum":["PENDING","ERROR","VALID","INVALID","NOT_PROCESSED","PROCESSING","PROCESSING_ERROR","REVIEW_ERROR","PROCESSED"]},"reviewLog":{"type":"string","nullable":true},"pipeline":{"type":"string","enum":["NONE","SUBDOCS_PHOENIX","SUBDOCS_GENERAL","AIC_TAX_RETURNS","AIC_ACCOUNT_STATEMENTS","PAY_STUBS"]},"errorMessage":{"type":"string","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","tid","url","fileType","fileName","name","category","label","private","complianceReview","targetTable","targetId","linkedFrom","accountId","userId","metadata","status","reviewLog","pipeline","errorMessage"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]},"patch":{"summary":"Update public file by id","tags":["filesPublic"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"patchFilePublic","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":50},"category":{"type":"string","maxLength":50},"label":{"type":"string","enum":["PROOF_OF_INCOME","PROOF_OF_NET_WORTH","EMPLOYEE","TAX_RETURNS","ACCOUNT_STATEMENT","ACCREDITATION_LETTER","LICENSE","IDENTITY_FRONT","IDENTITY_BACK","BAD_ACTOR_REPORT_FILE","OTHER","COMPLIANCE_REQUEST","SUB_DOC","CONTENT_FILE","CSV_EXPORT_FILE","CUSTODIAN_INSTRUCTION_DOCUMENT","LOGO","FAVICON","BACKGROUND_IMAGE","MEMORANDUM","SUBSCRIPTION_AGREEMENT","COVER_ART","ESCROW_AGREEMENT","SS4_LETTER","FORMATION_DOCUMENT","PASSPORT","TRADE_DOCUMENT"],"example":"OTHER"},"metadata":{"type":"string","minLength":2,"maxLength":600000,"nullable":true}},"required":["name","category","label"]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"url":{"type":"string","format":"uri","example":"https://file-location.com"},"fileType":{"type":"string","example":"pdf"},"fileName":{"type":"string","example":"test.pdf"},"name":{"type":"string","example":"test"},"category":{"type":"string","example":"application"},"label":{"type":"string","example":"other"},"private":{"type":"boolean"},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"]},"targetTable":{"type":"string","enum":["KYCS","AMLS","AICS","KYBS","INDIVIDUALS","LEGAL_ENTITIES","INVESTOR_ACCOUNTS","TRADES","OFFERINGS","ISSUERS","COVERED_PERSONS","PAYMENT_METHODS","NOTES","USERS","ACCOUNTS","PAGES","TASKS","FILES","DATA_RECORD_FILES","ASSETS","SITES","PAGE_REVISIONS","TRADE_LINE_ITEMS","TRANSACTIONS","DISBURSEMENTS","DISBURSEMENT_REVIEWS","ISSUER_PAYMENT_METHODS","SIGNER_BRANDS","THEMES","THEME_SETTINGS","CAP_TABLES","CAP_TABLE_SHARE_CLASSES","CAP_TABLE_ENTRIES","EMAIL_THEMES","EMAIL_THEME_SETTINGS"],"nullable":true},"targetId":{"type":"string","nullable":true},"linkedFrom":{"type":"string","nullable":true},"accountId":{"type":"string","example":"account_01j6aqmtfyfwy9spjdcnh7yqk7"},"userId":{"type":"string","example":"user_01j6aqmtfyfwy9spjdcnh7yqk7"},"kycs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"platform":{"type":"string","example":"KYC Platform"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Passport"},"documentImage":{"type":"string","example":"https://example.com/passport.jpg"},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Document unclear"},"response":{"type":"string","nullable":true,"example":"Submitted clearer document"}},"required":["id","createdAt","updatedAt","deletedAt","tid","platform","individualId","documentType","documentImage","kycStatus","reason","response"]},"nullable":true},"kybs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_kyb_123"},"platform":{"type":"string","example":"KYB Platform"},"legalEntityId":{"type":"string","example":"legal_entity_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Certificate of Incorporation"},"documentImage":{"type":"string","example":"https://example.com/document.pdf"},"kybStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Additional information required"},"response":{"type":"string","nullable":true,"example":"Submitted additional documents"}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","platform","legalEntityId","documentType","documentImage","kybStatus","reason","response"]},"nullable":true},"individuals":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"accountId":{"type":"string"},"account":{},"investorAccountId":{"type":"string"},"investorAccount":{},"role":{"type":"string","enum":["PRIMARY","JOINT"]},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"]},"kycFirstName":{"type":"string","nullable":true},"kycLastName":{"type":"string","nullable":true},"kycDocumentType":{"type":"string","enum":["PASSPORT","DRIVER_LICENSE","STATE_ID"],"nullable":true},"kycDocumentIssuer":{"type":"string","nullable":true},"kycDocumentNumber":{"type":"string","nullable":true},"kycIssuerDate":{"type":"string","nullable":true},"kycExpirationDate":{"type":"string","nullable":true},"kycCheck":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"]},"kycCheckedAt":{"type":"string","format":"date-time","nullable":true},"kycLog":{"type":"string","nullable":true},"kycReviewedById":{"type":"string","nullable":true},"kycReviewedAt":{"type":"string","format":"date-time","nullable":true},"kycDocumentFrontFileId":{"type":"string","nullable":true},"kycDocumentFrontFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"kycDocumentBackFileId":{"type":"string","nullable":true},"kycDocumentBackFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"kycSelfieFileId":{"type":"string","nullable":true},"kycSelfieFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"sanctionsStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"]},"amlStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","ERROR"]},"amlProvider":{"type":"string","enum":["ComplyAdvantage"],"nullable":true},"amlTid":{"type":"string","nullable":true},"amlUrl":{"type":"string","nullable":true},"amlCheckedAt":{"type":"string","format":"date-time","nullable":true},"amlLog":{"type":"string","nullable":true},"amlLogData":{"type":"string","nullable":true},"amlReviewedById":{"type":"string","nullable":true},"amlReviewedAt":{"type":"string","format":"date-time","nullable":true},"liquidNetWorth":{"type":"number","multipleOf":0.01,"nullable":true},"liquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"illiquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"privateSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"aicAccreditationType":{"type":"string","enum":["PENDING","INCOME","NET_WORTH","PROFESSIONAL_CERTIFICATION","KNOWLEDGEABLE_EMPLOYEE"]},"aicExpirationDate":{"type":"string","format":"date-time","nullable":true},"aicQuestionnaire":{"type":"string","nullable":true},"aicStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","PROCESSED"]},"aicCheckedAt":{"type":"string","format":"date-time","nullable":true},"aicLog":{"type":"string","nullable":true},"aicReviewedById":{"type":"string","nullable":true},"aicReviewedAt":{"type":"string","format":"date-time","nullable":true},"iraQuestionnaire":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"hasIraAccounts":{"type":"boolean"},"inSelfDirectedIra":{"type":"boolean"},"custodian":{"type":"string"},"hasOtherQualifiedFunds":{"type":"boolean"}},"required":["id","hasIraAccounts","inSelfDirectedIra","custodian","hasOtherQualifiedFunds"]},"nullable":true},"iraCheck":{"type":"string","enum":["PENDING","APPROVED","NEEDS_REVIEW","REJECTED"]},"iraCheckedAt":{"type":"string","format":"date-time","nullable":true},"iraLog":{"type":"string","nullable":true},"iraReviewedById":{"type":"string","nullable":true},"iraReviewedAt":{"type":"string","format":"date-time","nullable":true},"firstName":{"type":"string"},"lastName":{"type":"string","nullable":true},"dob":{"type":"string","format":"date-time","nullable":true},"isUsCitizenOrGreenCardHolder":{"type":"boolean"},"citizenship":{"type":"string","enum":["AD","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","CU","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","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","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","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","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","YE","YT","ZA","ZM","ZW"],"nullable":true},"ssn":{"type":"string","nullable":true},"lastFour":{"type":"string","nullable":true},"address":{"type":"string","nullable":true},"address2":{"type":"string","nullable":true},"email":{"type":"string","format":"email","nullable":true},"phone":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"state":{"type":"string","nullable":true},"zip":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"kycTid":{"type":"string","nullable":true},"currencyCode":{"type":"string","minLength":3,"maxLength":3,"nullable":true},"investedInCrowdfunding":{"type":"number","nullable":true},"currentAnnualIncome":{"type":"number","nullable":true},"averageAnnualIncome":{"type":"number","nullable":true},"averageHouseholdIncome":{"type":"number","nullable":true},"currentHouseholdIncome":{"type":"number","nullable":true},"householdNetWorth":{"type":"number","nullable":true},"isSolicited":{"type":"boolean"},"isRealEstate":{"type":"boolean"},"iliquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"timeHorizon":{"type":"string","nullable":true},"riskTolerance":{"type":"string","nullable":true},"investmentObjective":{"type":"string","nullable":true},"investmentExperience":{"type":"string","nullable":true},"experienceInPrivate":{"type":"string","nullable":true},"levelOfEducation":{"type":"string","nullable":true},"financialAdvisor":{"type":"boolean"},"occupation":{"type":"string","nullable":true},"employmentStatus":{"type":"string","enum":["EMPLOYED","UNEMPLOYED","SELF_EMPLOYED","RETIRED","STUDENT","OTHER"]},"employerName":{"type":"string","nullable":true},"employerAddressLine1":{"type":"string","nullable":true},"employerAddressLine2":{"type":"string","nullable":true},"employerCity":{"type":"string","nullable":true},"employerState":{"type":"string","nullable":true},"employerZip":{"type":"string","nullable":true},"employerCountry":{"type":"string","nullable":true},"notes":{"type":"string","nullable":true},"kycs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"platform":{"type":"string","example":"KYC Platform"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Passport"},"documentImage":{"type":"string","example":"https://example.com/passport.jpg"},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Document unclear"},"response":{"type":"string","nullable":true,"example":"Submitted clearer document"}},"required":["id","createdAt","updatedAt","deletedAt","tid","platform","individualId","documentType","documentImage","kycStatus","reason","response"]},"nullable":true},"amls":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"provider":{"type":"string","nullable":true,"example":"AML Provider"},"url":{"type":"string","nullable":true,"example":"https://example.com/aml"},"status":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","ERROR"],"example":"PENDING"},"checkedAt":{"type":"string","format":"date-time","nullable":true,"example":"2022-01-01T00:00:00Z"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"}},"required":["id","createdAt","updatedAt","deletedAt","tid","provider","url","status","checkedAt","individualId"]},"nullable":true},"aics":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"individualId":{},"individual":{"nullable":true},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"]},"reviewedById":{"nullable":true},"reviewedBy":{"nullable":true},"reviewedAt":{"type":"string","format":"date-time","nullable":true},"systemReview":{"type":"string","enum":["PENDING","NEEDS_INFO","READY_TO_APPROVE","NEEDS_REVIEW","APPROVED","REJECTED"]},"systemLog":{"type":"array","items":{"type":"object","properties":{"check":{"type":"string","minLength":1},"entered":{"type":"number"},"extracted":{"type":"number"},"result":{"type":"string","enum":["PASS","FAIL"]},"reason":{"type":"string"}},"required":["check","result"]},"nullable":true},"firstName":{"type":"string"},"lastName":{"type":"string"},"method":{"type":"string","enum":["PENDING","INCOME","NET_WORTH","PROFESSIONAL_CERTIFICATION","KNOWLEDGEABLE_EMPLOYEE"]},"incomeData":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer","minimum":2020,"maximum":2025},"filingStatus":{"type":"string","enum":["SINGLE","JOINT"]},"income":{"type":"number","minimum":0,"multipleOf":0.01},"fileId":{}},"required":["year","filingStatus","income","fileId"]},"nullable":true},"netWorthData":{"type":"array","items":{"type":"object","properties":{"institution":{"type":"string","minLength":1,"maxLength":100},"accountType":{"type":"string","enum":["CHECKING","SAVINGS","BROKERAGE","REAL_ESTATE","OTHER"]},"balance":{"type":"number","minimum":0,"multipleOf":0.01},"fileId":{}},"required":["institution","accountType","balance","fileId"]},"nullable":true},"professionalData":{"type":"array","items":{"type":"object","properties":{"professionalType":{"type":"string","enum":["SECURITIES_LICENSES","DIRECTORS","FAMILY_OFFICE"]},"licenseNumber":{"type":"string","minLength":1,"maxLength":50,"nullable":true},"fileId":{"nullable":true}},"required":["professionalType"]},"nullable":true},"employeeData":{"type":"array","items":{"type":"object","properties":{"position":{"type":"string","minLength":1,"maxLength":100},"fileId":{}},"required":["position","fileId"]},"nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","individualId","complianceReview","reviewedById","reviewedAt","systemReview","systemLog","firstName","lastName","method","incomeData","netWorthData","professionalData","employeeData"]},"nullable":true},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]},"setupStep":{"type":"string","enum":["NEW","PERSONAL_INFO","ADDRESS","KYC","INCOME","AIC_QUESTIONS","AIC_FILES"]},"sourceOfIncome":{"type":"string","enum":["EMPLOYED","SELF_EMPLOYED","UNEMPLOYED","RETIREMENT","STUDENT"],"nullable":true},"ownership":{"type":"number","nullable":true},"kycProvider":{"type":"string","nullable":true},"retirementAccountType":{"type":"string","enum":["SELF_DIRECTED","CUSTODIAN_MANAGED"],"nullable":true},"custodianName":{"type":"string","nullable":true},"custodianAccountNumber":{"type":"string","nullable":true},"custodianRepresentativeName":{"type":"string","nullable":true},"custodianEmail":{"type":"string","format":"email","nullable":true},"accredited":{"type":"boolean"}},"required":["id","createdAt","updatedAt","deletedAt","tid","accountId","investorAccountId","role","kycStatus","kycFirstName","kycLastName","kycDocumentType","kycDocumentIssuer","kycDocumentNumber","kycIssuerDate","kycExpirationDate","kycCheck","kycCheckedAt","kycLog","kycReviewedById","kycReviewedAt","kycDocumentFrontFileId","kycDocumentBackFileId","kycSelfieFileId","sanctionsStatus","amlStatus","amlProvider","amlTid","amlUrl","amlCheckedAt","amlLog","amlLogData","amlReviewedById","amlReviewedAt","liquidNetWorth","liquidSecurities","illiquidSecurities","privateSecurities","aicAccreditationType","aicExpirationDate","aicQuestionnaire","aicStatus","aicCheckedAt","aicLog","aicReviewedById","aicReviewedAt","iraQuestionnaire","iraCheck","iraCheckedAt","iraLog","iraReviewedById","iraReviewedAt","firstName","lastName","dob","isUsCitizenOrGreenCardHolder","ssn","lastFour","address","address2","email","phone","city","state","zip","country","kycTid","currencyCode","investedInCrowdfunding","currentAnnualIncome","averageAnnualIncome","averageHouseholdIncome","currentHouseholdIncome","householdNetWorth","isSolicited","isRealEstate","timeHorizon","riskTolerance","investmentObjective","investmentExperience","experienceInPrivate","levelOfEducation","financialAdvisor","occupation","employmentStatus","employerName","employerAddressLine1","employerAddressLine2","employerCity","employerState","employerZip","employerCountry","notes","setupStatus","setupStep","sourceOfIncome","ownership","kycProvider","accredited"]},"nullable":true},"legalEntities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_legal_entity_123","nullable":true},"accountId":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6"},"investorAccountId":{"type":"string","example":"investor_account_01j1xgme5qeqq97gpdztd7e4a7"},"kybStatus":{"example":"PENDING"},"sanctionsStatus":{"example":"PENDING"},"kybs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_kyb_123"},"platform":{"type":"string","example":"KYB Platform"},"legalEntityId":{"type":"string","example":"legal_entity_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Certificate of Incorporation"},"documentImage":{"type":"string","example":"https://example.com/document.pdf"},"kybStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Additional information required"},"response":{"type":"string","nullable":true,"example":"Submitted additional documents"}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","platform","legalEntityId","documentType","documentImage","kybStatus","reason","response"]}},"name":{"type":"string","example":"Acme Corporation"},"ein":{"type":"string","example":"12-3456789","nullable":true},"companyType":{"type":"string","example":"LLC","nullable":true},"streetAddress":{"type":"string","example":"123 Main St","nullable":true},"city":{"type":"string","example":"Anytown","nullable":true},"state":{"type":"string","example":"CA","nullable":true},"zip":{"type":"string","example":"12345","nullable":true},"country":{"type":"string","example":"USA","nullable":true},"phone":{"type":"string","example":"+12124567890","nullable":true},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","accountId","investorAccountId","kybStatus","sanctionsStatus","name","state","setupStatus"]},"nullable":true},"investorAccounts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"investorAccountType":{"type":"string","enum":["INDIVIDUAL","JOINT","RETIREMENT","LEGAL_ENTITY"]},"user":{"nullable":true},"userId":{"type":"string","nullable":true},"email":{"type":"string","format":"email","nullable":true},"name":{"type":"string","nullable":true},"regAQualified":{"type":"boolean"},"regCfQualified":{"type":"boolean"},"regDQualified":{"type":"boolean"},"accountId":{"type":"string"},"account":{},"trades":{"type":"array","items":{}},"individuals":{"type":"array","items":{}},"legalEntities":{"type":"array","items":{}},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]},"systemReviewLog":{"type":"string","nullable":true},"totalAmount":{"type":"number"},"statusCheck":{},"trustedContacts":{"type":"array","items":{}}},"required":["id","createdAt","updatedAt","deletedAt","tid","investorAccountType","regAQualified","regCfQualified","regDQualified","accountId","setupStatus","systemReviewLog"]},"nullable":true},"trades":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"investorAccountId":{"nullable":true},"investorAccount":{"nullable":true},"offering":{"nullable":true},"accountId":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6","accountId":"account_00041061050r3gg28a1c60t3gf","nullable":true},"account":{"nullable":true},"offeringId":{"nullable":true},"paymentMethodId":{"nullable":true},"paymentMethod":{"nullable":true},"userId":{"nullable":true},"tradeNumber":{"type":"string"},"ip":{"type":"string","nullable":true},"tid":{"type":"string","nullable":true},"investmentType":{"type":"string","enum":["INDIVIDUAL","JOINT","ENTITY"]},"purchasedShares":{"type":"integer"},"bonusShares":{"type":"integer","nullable":true},"totalNumberOfShares":{"type":"integer"},"pricePerShare":{"type":"number","multipleOf":0.01},"lineItems":{"type":"array","items":{}},"adjustments":{"type":"array","items":{}},"transactions":{"type":"array","items":{}},"totalAmount":{"type":"number","multipleOf":0.01,"nullable":true},"tradeStatus":{"type":"string","enum":["CART","PLACED","IN_REVIEW","NEEDS_INFO","NEEDS_PAYMENT_INFO","FUNDING","CANCELLED","SETTLED","IMPORT_ERROR","ERROR","UPDATE_PAYMENT_METHOD"]},"tradeStatusUnmapped":{"type":"string","nullable":true},"tradeDate":{"type":"string","format":"date-time","nullable":true},"saStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW"]},"saStatusUnmapped":{"type":"string","nullable":true},"saUrl":{"type":"string","nullable":true},"saSignedAt":{"type":"string","format":"date-time","nullable":true},"saExtractedNumberOfShares":{"type":"string","nullable":true},"saExtractedTotalAmount":{"type":"string","nullable":true},"saExtractedPricePerShare":{"type":"string","nullable":true},"saExtractedInvestorType":{"type":"string","nullable":true},"saExtractedSigner":{"type":"string","nullable":true},"saExtractedSignatureDate":{"type":"string","format":"date-time","nullable":true},"saExtractedSigner2":{"type":"string","nullable":true},"saExtractedSignatureDate2":{"type":"string","format":"date-time","nullable":true},"saCheck":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"]},"saCheckedAt":{"type":"string","format":"date-time","nullable":true},"saLog":{"type":"object","properties":{"finalStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW"]},"matchResults":{"type":"array","items":{"type":"object","properties":{"tradeLineItemId":{"type":"string","example":"trade_line_item_01kctsycw3fq7sj6hedvy62cja"},"signerName":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"totalAmount":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"investorName":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"numberOfShares":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]}},"required":["tradeLineItemId"]}}},"required":["finalStatus","matchResults"],"nullable":true},"txnTid":{"type":"string","nullable":true},"txnResponse":{"type":"string","nullable":true},"txnPaymentMethod":{"type":"string","enum":["CREDIT_CARD","WIRE","ACH","BANK_ACCOUNT","CHECK","RETIREMENT"],"nullable":true},"txnCurrencyCode":{"type":"string","minLength":3,"maxLength":3,"nullable":true},"txnChargedAmount":{"type":"number","multipleOf":0.01,"nullable":true},"txnDate":{"type":"string","format":"date-time","nullable":true},"txnSettledDate":{"type":"string","format":"date-time","nullable":true},"fundingStatus":{"type":"string","enum":["PENDING","CANCELLED","SETTLED","REFUNDED","DECLINED","FUNDING","AUTHORIZING","FAILED"],"nullable":true},"fundingStatusUnmapped":{"type":"string","nullable":true},"txnCheck":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"],"nullable":true},"txnCheckedAt":{"type":"string","format":"date-time","nullable":true},"txnLog":{"type":"string","nullable":true},"systemReviewCheck":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","WARNING","INCOMPLETE"],"nullable":true},"systemReviewCheckedAt":{"type":"string","format":"date-time","nullable":true},"systemReviewLog":{"type":"string","nullable":true},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"],"nullable":true},"complianceReviewNotes":{"type":"string","nullable":true},"complianceReviewerId":{"type":"string","nullable":true},"issuerId":{"nullable":true},"complianceReviewName":{"type":"string","nullable":true},"complianceReviewAt":{"type":"string","format":"date-time","nullable":true},"tradeType":{"type":"string","enum":["PURCHASE","CONVERSION","TRANSFER"],"nullable":true},"placedAt":{"type":"string","format":"date-time","nullable":true},"platform":{"type":"string"},"cancelledAt":{"type":"string","format":"date-time","nullable":true},"cancelledById":{"type":"string","nullable":true},"cancelledReason":{"type":"string","nullable":true},"cancellationPeriod":{"type":"number","nullable":true},"disbursed":{"type":"boolean"},"tradeAdjustments":{"type":"number","nullable":true},"chargedAmount":{"type":"number","nullable":true},"balance":{"type":"number","nullable":true},"isUncleared24h":{"type":"boolean"},"term":{"type":"number","nullable":true},"exercisePrice":{"type":"number","nullable":true},"warrantPercentage":{"type":"number","nullable":true},"calculationMethod":{"type":"string","enum":["NONE","PRORATA","INCREMENT"],"nullable":true},"incrementThreshold":{"type":"number","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","investorAccountId","accountId","account","offeringId","paymentMethodId","userId","tradeNumber","ip","tid","investmentType","purchasedShares","bonusShares","totalNumberOfShares","pricePerShare","lineItems","adjustments","transactions","totalAmount","tradeStatus","tradeStatusUnmapped","tradeDate","saStatus","saStatusUnmapped","saUrl","saSignedAt","saExtractedNumberOfShares","saExtractedTotalAmount","saExtractedPricePerShare","saExtractedInvestorType","saExtractedSigner","saExtractedSignatureDate","saExtractedSigner2","saExtractedSignatureDate2","saCheck","saCheckedAt","saLog","txnTid","txnResponse","txnPaymentMethod","txnCurrencyCode","txnChargedAmount","txnDate","txnSettledDate","fundingStatus","fundingStatusUnmapped","txnCheck","txnCheckedAt","txnLog","systemReviewCheck","systemReviewCheckedAt","systemReviewLog","complianceReview","complianceReviewNotes","complianceReviewerId","issuerId","complianceReviewName","complianceReviewAt","tradeType","placedAt","platform","cancelledAt","cancelledById","cancelledReason","cancellationPeriod","isUncleared24h","term","exercisePrice","warrantPercentage","calculationMethod","incrementThreshold"]},"nullable":true},"metadata":{"type":"string","nullable":true},"status":{"type":"string","enum":["PENDING","ERROR","VALID","INVALID","NOT_PROCESSED","PROCESSING","PROCESSING_ERROR","REVIEW_ERROR","PROCESSED"]},"reviewLog":{"type":"string","nullable":true},"pipeline":{"type":"string","enum":["NONE","SUBDOCS_PHOENIX","SUBDOCS_GENERAL","AIC_TAX_RETURNS","AIC_ACCOUNT_STATEMENTS","PAY_STUBS"]},"errorMessage":{"type":"string","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","tid","url","fileType","fileName","name","category","label","private","complianceReview","targetTable","targetId","linkedFrom","accountId","userId","metadata","status","reviewLog","pipeline","errorMessage"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/files-public/preview/{id}":{"get":{"summary":"Preview (stream) a public file by id","tags":["filesPublic"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"previewFilePublic","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"nullable":true}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/individuals/":{"post":{"summary":"Create individual","tags":["individuals"],"parameters":[],"operationId":"createIndividual","requestBody":{"description":"Body","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"lastName":{"type":"string"},"investorAccountId":{"type":"string"},"firstName":{"type":"string"},"dob":{"type":"string","format":"date-time","nullable":true},"isUsCitizenOrGreenCardHolder":{"type":"boolean"},"citizenship":{"type":"string","enum":["AD","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","CU","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","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","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","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","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","YE","YT","ZA","ZM","ZW"]},"ssn":{"type":"string","minLength":9,"maxLength":9,"nullable":true},"currencyCode":{"type":"string","minLength":3,"maxLength":3},"email":{"type":"string","format":"email","example":"john.doe@example.com"},"role":{"type":"string","enum":["PRIMARY","JOINT"]},"phone":{"type":"string","nullable":true,"example":"+12124567890"},"ownership":{"type":"number","minimum":0,"maximum":100,"nullable":true},"setupStep":{"type":"string","enum":["NEW","PERSONAL_INFO","ADDRESS","KYC","INCOME","AIC_QUESTIONS","AIC_FILES"]},"liquidNetWorth":{"type":"number","multipleOf":0.01,"minimum":0,"maximum":10000000,"nullable":true},"currentAnnualIncome":{"type":"number","minimum":0,"maximum":10000000,"nullable":true},"sourceOfIncome":{"type":"string","enum":["EMPLOYED","SELF_EMPLOYED","UNEMPLOYED","RETIREMENT","STUDENT"],"nullable":true},"employerName":{"type":"string","minLength":1,"maxLength":255,"nullable":true},"investedInCrowdfunding":{"type":"number","minimum":0,"maximum":10000000,"nullable":true},"retirementAccountType":{"type":"string","enum":["SELF_DIRECTED","CUSTODIAN_MANAGED"],"nullable":true},"custodianName":{"type":"string","nullable":true},"custodianAccountNumber":{"type":"string","nullable":true},"custodianRepresentativeName":{"type":"string","nullable":true},"custodianEmail":{"type":"string","format":"email","nullable":true},"tid":{"type":"string"}},"required":["investorAccountId","role"]},{"allOf":[{"allOf":[{"type":"object","properties":{"address":{"type":"string","minLength":2,"nullable":true},"address2":{"type":"string","nullable":true},"city":{"type":"string","minLength":2,"maxLength":30,"nullable":true}}},{"type":"object","properties":{"country":{"type":"string","enum":["AD","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","CU","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","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","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","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","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","YE","YT","ZA","ZM","ZW"],"nullable":true},"state":{"type":"string","nullable":true}}}]},{"type":"object","properties":{"country":{"type":"string","enum":["AD","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","CU","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","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","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","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","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","YE","YT","ZA","ZM","ZW"],"nullable":true},"zip":{"type":"string","nullable":true}}}]}]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"accountId":{"type":"string"},"account":{},"investorAccountId":{"type":"string"},"investorAccount":{},"role":{"type":"string","enum":["PRIMARY","JOINT"]},"firstName":{"type":"string"},"lastName":{"type":"string","nullable":true},"dob":{"type":"string","format":"date-time","nullable":true},"isUsCitizenOrGreenCardHolder":{"type":"boolean"},"ssn":{"type":"string","nullable":true},"lastFour":{"type":"string","nullable":true},"address":{"type":"string","nullable":true},"address2":{"type":"string","nullable":true},"email":{"type":"string","format":"email","nullable":true},"phone":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"citizenship":{"type":"string","nullable":true},"state":{"type":"string","nullable":true},"zip":{"type":"string","nullable":true},"currencyCode":{"type":"string","minLength":3,"maxLength":3,"nullable":true},"financialAdvisor":{"type":"boolean"},"occupation":{"type":"string","nullable":true},"employmentStatus":{"type":"string","enum":["EMPLOYED","UNEMPLOYED","SELF_EMPLOYED","RETIRED","STUDENT","OTHER"]},"employerName":{"type":"string","nullable":true},"employerAddressLine1":{"type":"string","nullable":true},"employerAddressLine2":{"type":"string","nullable":true},"employerCity":{"type":"string","nullable":true},"employerState":{"type":"string","nullable":true},"employerZip":{"type":"string","nullable":true},"employerCountry":{"type":"string","nullable":true},"kycDocumentType":{"type":"string","enum":["PASSPORT","DRIVER_LICENSE","STATE_ID"],"nullable":true},"kycDocumentIssuer":{"type":"string","nullable":true},"kycExpirationDate":{"type":"string","nullable":true},"kycIssuerDate":{"type":"string","nullable":true},"kycDocumentNumber":{"type":"string","nullable":true},"kycFirstName":{"type":"string","nullable":true},"kycLastName":{"type":"string","nullable":true},"ownership":{"type":"number","nullable":true},"householdNetWorth":{"type":"number","nullable":true},"liquidNetWorth":{"type":"number","multipleOf":0.01,"nullable":true},"currentHouseholdIncome":{"type":"number","nullable":true},"currentAnnualIncome":{"type":"number","nullable":true},"investedInCrowdfunding":{"type":"number","nullable":true},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]},"setupStep":{"type":"string","enum":["NEW","PERSONAL_INFO","ADDRESS","KYC","INCOME","AIC_QUESTIONS","AIC_FILES"]},"sourceOfIncome":{"type":"string","enum":["EMPLOYED","SELF_EMPLOYED","UNEMPLOYED","RETIREMENT","STUDENT"],"nullable":true},"aicQuestionnaire":{"type":"string","nullable":true},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"]},"kycProvider":{"type":"string","nullable":true},"kycTid":{"type":"string","nullable":true},"aicAccreditationType":{"type":"string","enum":["PENDING","INCOME","NET_WORTH","PROFESSIONAL_CERTIFICATION","KNOWLEDGEABLE_EMPLOYEE"]},"accredited":{"type":"boolean"},"retirementAccountType":{"type":"string","enum":["SELF_DIRECTED","CUSTODIAN_MANAGED"],"nullable":true},"custodianName":{"type":"string","nullable":true},"custodianAccountNumber":{"type":"string","nullable":true},"custodianRepresentativeName":{"type":"string","nullable":true},"custodianEmail":{"type":"string","format":"email","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","tid","accountId","investorAccountId","role","firstName","lastName","dob","isUsCitizenOrGreenCardHolder","ssn","lastFour","address","address2","email","phone","city","country","citizenship","state","zip","currencyCode","financialAdvisor","occupation","employmentStatus","employerName","employerAddressLine1","employerAddressLine2","employerCity","employerState","employerZip","employerCountry","kycDocumentType","kycDocumentIssuer","kycExpirationDate","kycIssuerDate","kycDocumentNumber","kycFirstName","kycLastName","ownership","householdNetWorth","liquidNetWorth","currentHouseholdIncome","currentAnnualIncome","investedInCrowdfunding","setupStatus","setupStep","sourceOfIncome","aicQuestionnaire","kycStatus","kycProvider","kycTid","aicAccreditationType","accredited","retirementAccountType","custodianName","custodianAccountNumber","custodianRepresentativeName","custodianEmail"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/individuals/{id}":{"patch":{"summary":"Update individual","tags":["individuals"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"updateIndividual","requestBody":{"description":"Body","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"lastName":{"type":"string","minLength":2,"maxLength":20},"firstName":{"type":"string","minLength":2,"maxLength":20},"kycFirstName":{"type":"string","minLength":2,"maxLength":20},"kycLastName":{"type":"string","minLength":2,"maxLength":20},"dob":{"type":"string","format":"date-time","nullable":true},"currencyCode":{"type":"string","minLength":3,"maxLength":3},"phone":{"type":"string","nullable":true,"example":"+12124567890"},"email":{"type":"string","format":"email","example":"john.doe@example.com"},"ownership":{"type":"number","minimum":0,"maximum":100,"nullable":true},"isUsCitizenOrGreenCardHolder":{"type":"boolean"},"citizenship":{"type":"string","enum":["AD","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","CU","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","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","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","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","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","YE","YT","ZA","ZM","ZW"]},"ssn":{"type":"string","minLength":9,"maxLength":9,"nullable":true},"kycDocumentType":{"type":"string","enum":["PASSPORT","DRIVER_LICENSE","STATE_ID"]},"kycDocumentIssuer":{"type":"string","minLength":2,"maxLength":100},"kycExpirationDate":{"type":"string","format":"date-time","nullable":true},"kycIssuerDate":{"type":"string","format":"date-time","nullable":true},"kycDocumentNumber":{"type":"string"},"householdNetWorth":{"type":"number","minimum":0,"maximum":10000000,"nullable":true},"liquidNetWorth":{"type":"number","multipleOf":0.01,"minimum":0,"maximum":10000000,"nullable":true},"currentHouseholdIncome":{"type":"number","minimum":0,"maximum":10000000,"nullable":true},"currentAnnualIncome":{"type":"number","minimum":0,"maximum":10000000,"nullable":true},"investedInCrowdfunding":{"type":"number","minimum":0,"maximum":10000000,"nullable":true},"setupStep":{"type":"string","enum":["NEW","PERSONAL_INFO","ADDRESS","KYC","INCOME","AIC_QUESTIONS","AIC_FILES"]},"employerName":{"type":"string","minLength":1,"maxLength":255,"nullable":true},"sourceOfIncome":{"type":"string","enum":["EMPLOYED","SELF_EMPLOYED","UNEMPLOYED","RETIREMENT","STUDENT"],"nullable":true},"aicQuestionnaire":{"type":"string"},"kycProvider":{"type":"string","minLength":1,"maxLength":255},"aicAccreditationType":{"type":"string","enum":["PENDING","INCOME","NET_WORTH","PROFESSIONAL_CERTIFICATION","KNOWLEDGEABLE_EMPLOYEE"]},"accredited":{"type":"boolean"},"retirementAccountType":{"type":"string","enum":["SELF_DIRECTED","CUSTODIAN_MANAGED"],"nullable":true},"custodianName":{"type":"string","nullable":true},"custodianAccountNumber":{"type":"string","nullable":true},"custodianRepresentativeName":{"type":"string","nullable":true},"custodianEmail":{"type":"string","format":"email","nullable":true}}},{"allOf":[{"allOf":[{"type":"object","properties":{"address":{"type":"string","minLength":2,"nullable":true},"address2":{"type":"string","nullable":true},"city":{"type":"string","minLength":2,"maxLength":30,"nullable":true}}},{"type":"object","properties":{"country":{"type":"string","enum":["AD","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","CU","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","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","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","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","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","YE","YT","ZA","ZM","ZW"],"nullable":true},"state":{"type":"string","nullable":true}}}]},{"type":"object","properties":{"country":{"type":"string","enum":["AD","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","CU","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","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","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","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","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","YE","YT","ZA","ZM","ZW"],"nullable":true},"zip":{"type":"string","nullable":true}}}]}]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"accountId":{"type":"string"},"account":{},"investorAccountId":{"type":"string"},"investorAccount":{},"role":{"type":"string","enum":["PRIMARY","JOINT"]},"firstName":{"type":"string"},"lastName":{"type":"string","nullable":true},"dob":{"type":"string","format":"date-time","nullable":true},"isUsCitizenOrGreenCardHolder":{"type":"boolean"},"ssn":{"type":"string","nullable":true},"lastFour":{"type":"string","nullable":true},"address":{"type":"string","nullable":true},"address2":{"type":"string","nullable":true},"email":{"type":"string","format":"email","nullable":true},"phone":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"citizenship":{"type":"string","nullable":true},"state":{"type":"string","nullable":true},"zip":{"type":"string","nullable":true},"currencyCode":{"type":"string","minLength":3,"maxLength":3,"nullable":true},"financialAdvisor":{"type":"boolean"},"occupation":{"type":"string","nullable":true},"employmentStatus":{"type":"string","enum":["EMPLOYED","UNEMPLOYED","SELF_EMPLOYED","RETIRED","STUDENT","OTHER"]},"employerName":{"type":"string","nullable":true},"employerAddressLine1":{"type":"string","nullable":true},"employerAddressLine2":{"type":"string","nullable":true},"employerCity":{"type":"string","nullable":true},"employerState":{"type":"string","nullable":true},"employerZip":{"type":"string","nullable":true},"employerCountry":{"type":"string","nullable":true},"kycDocumentType":{"type":"string","enum":["PASSPORT","DRIVER_LICENSE","STATE_ID"],"nullable":true},"kycDocumentIssuer":{"type":"string","nullable":true},"kycExpirationDate":{"type":"string","nullable":true},"kycIssuerDate":{"type":"string","nullable":true},"kycDocumentNumber":{"type":"string","nullable":true},"kycFirstName":{"type":"string","nullable":true},"kycLastName":{"type":"string","nullable":true},"ownership":{"type":"number","nullable":true},"householdNetWorth":{"type":"number","nullable":true},"liquidNetWorth":{"type":"number","multipleOf":0.01,"nullable":true},"currentHouseholdIncome":{"type":"number","nullable":true},"currentAnnualIncome":{"type":"number","nullable":true},"investedInCrowdfunding":{"type":"number","nullable":true},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]},"setupStep":{"type":"string","enum":["NEW","PERSONAL_INFO","ADDRESS","KYC","INCOME","AIC_QUESTIONS","AIC_FILES"]},"sourceOfIncome":{"type":"string","enum":["EMPLOYED","SELF_EMPLOYED","UNEMPLOYED","RETIREMENT","STUDENT"],"nullable":true},"aicQuestionnaire":{"type":"string","nullable":true},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"]},"kycProvider":{"type":"string","nullable":true},"kycTid":{"type":"string","nullable":true},"aicAccreditationType":{"type":"string","enum":["PENDING","INCOME","NET_WORTH","PROFESSIONAL_CERTIFICATION","KNOWLEDGEABLE_EMPLOYEE"]},"accredited":{"type":"boolean"},"retirementAccountType":{"type":"string","enum":["SELF_DIRECTED","CUSTODIAN_MANAGED"],"nullable":true},"custodianName":{"type":"string","nullable":true},"custodianAccountNumber":{"type":"string","nullable":true},"custodianRepresentativeName":{"type":"string","nullable":true},"custodianEmail":{"type":"string","format":"email","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","tid","accountId","investorAccountId","role","firstName","lastName","dob","isUsCitizenOrGreenCardHolder","ssn","lastFour","address","address2","email","phone","city","country","citizenship","state","zip","currencyCode","financialAdvisor","occupation","employmentStatus","employerName","employerAddressLine1","employerAddressLine2","employerCity","employerState","employerZip","employerCountry","kycDocumentType","kycDocumentIssuer","kycExpirationDate","kycIssuerDate","kycDocumentNumber","kycFirstName","kycLastName","ownership","householdNetWorth","liquidNetWorth","currentHouseholdIncome","currentAnnualIncome","investedInCrowdfunding","setupStatus","setupStep","sourceOfIncome","aicQuestionnaire","kycStatus","kycProvider","kycTid","aicAccreditationType","accredited","retirementAccountType","custodianName","custodianAccountNumber","custodianRepresentativeName","custodianEmail"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]},"get":{"summary":"Get individual by id","tags":["individuals"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"include","in":"query","schema":{"type":"string","example":"account,investorAccount,kycs,amls,kycReviewedBy,amlReviewedBy,aicReviewedBy,iraReviewedBy"}}],"operationId":"getIndividual","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"accountId":{"type":"string"},"account":{},"investorAccountId":{"type":"string"},"investorAccount":{},"role":{"type":"string","enum":["PRIMARY","JOINT"]},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"]},"kycFirstName":{"type":"string","nullable":true},"kycLastName":{"type":"string","nullable":true},"kycDocumentType":{"type":"string","enum":["PASSPORT","DRIVER_LICENSE","STATE_ID"],"nullable":true},"kycDocumentIssuer":{"type":"string","nullable":true},"kycDocumentNumber":{"type":"string","nullable":true},"kycIssuerDate":{"type":"string","nullable":true},"kycExpirationDate":{"type":"string","nullable":true},"kycCheck":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"]},"kycCheckedAt":{"type":"string","format":"date-time","nullable":true},"kycLog":{"type":"string","nullable":true},"kycReviewedById":{"type":"string","nullable":true},"kycReviewedAt":{"type":"string","format":"date-time","nullable":true},"kycDocumentFrontFileId":{"type":"string","nullable":true},"kycDocumentFrontFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"kycDocumentBackFileId":{"type":"string","nullable":true},"kycDocumentBackFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"kycSelfieFileId":{"type":"string","nullable":true},"kycSelfieFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"sanctionsStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"]},"amlStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","ERROR"]},"amlProvider":{"type":"string","enum":["ComplyAdvantage"],"nullable":true},"amlTid":{"type":"string","nullable":true},"amlUrl":{"type":"string","nullable":true},"amlCheckedAt":{"type":"string","format":"date-time","nullable":true},"amlLog":{"type":"string","nullable":true},"amlLogData":{"type":"string","nullable":true},"amlReviewedById":{"type":"string","nullable":true},"amlReviewedAt":{"type":"string","format":"date-time","nullable":true},"liquidNetWorth":{"type":"number","multipleOf":0.01,"nullable":true},"liquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"illiquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"privateSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"aicAccreditationType":{"type":"string","enum":["PENDING","INCOME","NET_WORTH","PROFESSIONAL_CERTIFICATION","KNOWLEDGEABLE_EMPLOYEE"]},"aicExpirationDate":{"type":"string","format":"date-time","nullable":true},"aicQuestionnaire":{"type":"string","nullable":true},"aicStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","PROCESSED"]},"aicCheckedAt":{"type":"string","format":"date-time","nullable":true},"aicLog":{"type":"string","nullable":true},"aicReviewedById":{"type":"string","nullable":true},"aicReviewedAt":{"type":"string","format":"date-time","nullable":true},"iraQuestionnaire":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"hasIraAccounts":{"type":"boolean"},"inSelfDirectedIra":{"type":"boolean"},"custodian":{"type":"string"},"hasOtherQualifiedFunds":{"type":"boolean"}},"required":["id","hasIraAccounts","inSelfDirectedIra","custodian","hasOtherQualifiedFunds"]},"nullable":true},"iraCheck":{"type":"string","enum":["PENDING","APPROVED","NEEDS_REVIEW","REJECTED"]},"iraCheckedAt":{"type":"string","format":"date-time","nullable":true},"iraLog":{"type":"string","nullable":true},"iraReviewedById":{"type":"string","nullable":true},"iraReviewedAt":{"type":"string","format":"date-time","nullable":true},"firstName":{"type":"string"},"lastName":{"type":"string","nullable":true},"dob":{"type":"string","format":"date-time","nullable":true},"isUsCitizenOrGreenCardHolder":{"type":"boolean"},"citizenship":{"type":"string","enum":["AD","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","CU","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","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","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","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","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","YE","YT","ZA","ZM","ZW"],"nullable":true},"ssn":{"type":"string","nullable":true},"lastFour":{"type":"string","nullable":true},"address":{"type":"string","nullable":true},"address2":{"type":"string","nullable":true},"email":{"type":"string","format":"email","nullable":true},"phone":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"state":{"type":"string","nullable":true},"zip":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"kycTid":{"type":"string","nullable":true},"currencyCode":{"type":"string","minLength":3,"maxLength":3,"nullable":true},"investedInCrowdfunding":{"type":"number","nullable":true},"currentAnnualIncome":{"type":"number","nullable":true},"averageAnnualIncome":{"type":"number","nullable":true},"averageHouseholdIncome":{"type":"number","nullable":true},"currentHouseholdIncome":{"type":"number","nullable":true},"householdNetWorth":{"type":"number","nullable":true},"isSolicited":{"type":"boolean"},"isRealEstate":{"type":"boolean"},"iliquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"timeHorizon":{"type":"string","nullable":true},"riskTolerance":{"type":"string","nullable":true},"investmentObjective":{"type":"string","nullable":true},"investmentExperience":{"type":"string","nullable":true},"experienceInPrivate":{"type":"string","nullable":true},"levelOfEducation":{"type":"string","nullable":true},"financialAdvisor":{"type":"boolean"},"occupation":{"type":"string","nullable":true},"employmentStatus":{"type":"string","enum":["EMPLOYED","UNEMPLOYED","SELF_EMPLOYED","RETIRED","STUDENT","OTHER"]},"employerName":{"type":"string","nullable":true},"employerAddressLine1":{"type":"string","nullable":true},"employerAddressLine2":{"type":"string","nullable":true},"employerCity":{"type":"string","nullable":true},"employerState":{"type":"string","nullable":true},"employerZip":{"type":"string","nullable":true},"employerCountry":{"type":"string","nullable":true},"notes":{"type":"string","nullable":true},"kycs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"platform":{"type":"string","example":"KYC Platform"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Passport"},"documentImage":{"type":"string","example":"https://example.com/passport.jpg"},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Document unclear"},"response":{"type":"string","nullable":true,"example":"Submitted clearer document"}},"required":["id","createdAt","updatedAt","deletedAt","tid","platform","individualId","documentType","documentImage","kycStatus","reason","response"]},"nullable":true},"amls":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"provider":{"type":"string","nullable":true,"example":"AML Provider"},"url":{"type":"string","nullable":true,"example":"https://example.com/aml"},"status":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","ERROR"],"example":"PENDING"},"checkedAt":{"type":"string","format":"date-time","nullable":true,"example":"2022-01-01T00:00:00Z"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"}},"required":["id","createdAt","updatedAt","deletedAt","tid","provider","url","status","checkedAt","individualId"]},"nullable":true},"aics":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"individualId":{},"individual":{"nullable":true},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"]},"reviewedById":{"nullable":true},"reviewedBy":{"nullable":true},"reviewedAt":{"type":"string","format":"date-time","nullable":true},"systemReview":{"type":"string","enum":["PENDING","NEEDS_INFO","READY_TO_APPROVE","NEEDS_REVIEW","APPROVED","REJECTED"]},"systemLog":{"type":"array","items":{"type":"object","properties":{"check":{"type":"string","minLength":1},"entered":{"type":"number"},"extracted":{"type":"number"},"result":{"type":"string","enum":["PASS","FAIL"]},"reason":{"type":"string"}},"required":["check","result"]},"nullable":true},"firstName":{"type":"string"},"lastName":{"type":"string"},"method":{"type":"string","enum":["PENDING","INCOME","NET_WORTH","PROFESSIONAL_CERTIFICATION","KNOWLEDGEABLE_EMPLOYEE"]},"incomeData":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer","minimum":2020,"maximum":2025},"filingStatus":{"type":"string","enum":["SINGLE","JOINT"]},"income":{"type":"number","minimum":0,"multipleOf":0.01},"fileId":{}},"required":["year","filingStatus","income","fileId"]},"nullable":true},"netWorthData":{"type":"array","items":{"type":"object","properties":{"institution":{"type":"string","minLength":1,"maxLength":100},"accountType":{"type":"string","enum":["CHECKING","SAVINGS","BROKERAGE","REAL_ESTATE","OTHER"]},"balance":{"type":"number","minimum":0,"multipleOf":0.01},"fileId":{}},"required":["institution","accountType","balance","fileId"]},"nullable":true},"professionalData":{"type":"array","items":{"type":"object","properties":{"professionalType":{"type":"string","enum":["SECURITIES_LICENSES","DIRECTORS","FAMILY_OFFICE"]},"licenseNumber":{"type":"string","minLength":1,"maxLength":50,"nullable":true},"fileId":{"nullable":true}},"required":["professionalType"]},"nullable":true},"employeeData":{"type":"array","items":{"type":"object","properties":{"position":{"type":"string","minLength":1,"maxLength":100},"fileId":{}},"required":["position","fileId"]},"nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","individualId","complianceReview","reviewedById","reviewedAt","systemReview","systemLog","firstName","lastName","method","incomeData","netWorthData","professionalData","employeeData"]},"nullable":true},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]},"setupStep":{"type":"string","enum":["NEW","PERSONAL_INFO","ADDRESS","KYC","INCOME","AIC_QUESTIONS","AIC_FILES"]},"sourceOfIncome":{"type":"string","enum":["EMPLOYED","SELF_EMPLOYED","UNEMPLOYED","RETIREMENT","STUDENT"],"nullable":true},"ownership":{"type":"number","nullable":true},"kycProvider":{"type":"string","nullable":true},"retirementAccountType":{"type":"string","enum":["SELF_DIRECTED","CUSTODIAN_MANAGED"],"nullable":true},"custodianName":{"type":"string","nullable":true},"custodianAccountNumber":{"type":"string","nullable":true},"custodianRepresentativeName":{"type":"string","nullable":true},"custodianEmail":{"type":"string","format":"email","nullable":true},"accredited":{"type":"boolean"}},"required":["id","createdAt","updatedAt","deletedAt","tid","accountId","investorAccountId","role","kycStatus","kycFirstName","kycLastName","kycDocumentType","kycDocumentIssuer","kycDocumentNumber","kycIssuerDate","kycExpirationDate","kycCheck","kycCheckedAt","kycLog","kycReviewedById","kycReviewedAt","kycDocumentFrontFileId","kycDocumentBackFileId","kycSelfieFileId","sanctionsStatus","amlStatus","amlProvider","amlTid","amlUrl","amlCheckedAt","amlLog","amlLogData","amlReviewedById","amlReviewedAt","liquidNetWorth","liquidSecurities","illiquidSecurities","privateSecurities","aicAccreditationType","aicExpirationDate","aicQuestionnaire","aicStatus","aicCheckedAt","aicLog","aicReviewedById","aicReviewedAt","iraQuestionnaire","iraCheck","iraCheckedAt","iraLog","iraReviewedById","iraReviewedAt","firstName","lastName","dob","isUsCitizenOrGreenCardHolder","ssn","lastFour","address","address2","email","phone","city","state","zip","country","kycTid","currencyCode","investedInCrowdfunding","currentAnnualIncome","averageAnnualIncome","averageHouseholdIncome","currentHouseholdIncome","householdNetWorth","isSolicited","isRealEstate","timeHorizon","riskTolerance","investmentObjective","investmentExperience","experienceInPrivate","levelOfEducation","financialAdvisor","occupation","employmentStatus","employerName","employerAddressLine1","employerAddressLine2","employerCity","employerState","employerZip","employerCountry","notes","setupStatus","setupStep","sourceOfIncome","ownership","kycProvider","accredited"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/individuals":{"get":{"summary":"Get individuals","tags":["individuals"],"parameters":[{"name":"page","in":"query","schema":{"default":1,"type":"number","nullable":true}},{"name":"limit","in":"query","schema":{"default":10,"type":"number","nullable":true}},{"name":"kycStatus","in":"query","schema":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"]}},{"name":"amlStatus","in":"query","schema":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","ERROR"]}},{"name":"aicStatus","in":"query","schema":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","PROCESSED"]}},{"name":"accountId","in":"query","schema":{"type":"string"}},{"name":"search","in":"query","schema":{"type":"string","maxLength":50}},{"name":"investorAccountType","in":"query","schema":{"type":"string","enum":["INDIVIDUAL","JOINT","RETIREMENT","LEGAL_ENTITY"]}},{"name":"include","in":"query","schema":{"type":"string","example":"account,investorAccount,kycs,amls,kycReviewedBy,amlReviewedBy,aicReviewedBy,iraReviewedBy"}}],"operationId":"getIndividuals","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"accountId":{"type":"string"},"account":{},"investorAccountId":{"type":"string"},"investorAccount":{},"role":{"type":"string","enum":["PRIMARY","JOINT"]},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"]},"kycFirstName":{"type":"string","nullable":true},"kycLastName":{"type":"string","nullable":true},"kycDocumentType":{"type":"string","enum":["PASSPORT","DRIVER_LICENSE","STATE_ID"],"nullable":true},"kycDocumentIssuer":{"type":"string","nullable":true},"kycDocumentNumber":{"type":"string","nullable":true},"kycIssuerDate":{"type":"string","nullable":true},"kycExpirationDate":{"type":"string","nullable":true},"kycCheck":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"]},"kycCheckedAt":{"type":"string","format":"date-time","nullable":true},"kycLog":{"type":"string","nullable":true},"kycReviewedById":{"type":"string","nullable":true},"kycReviewedAt":{"type":"string","format":"date-time","nullable":true},"kycDocumentFrontFileId":{"type":"string","nullable":true},"kycDocumentFrontFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"kycDocumentBackFileId":{"type":"string","nullable":true},"kycDocumentBackFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"kycSelfieFileId":{"type":"string","nullable":true},"kycSelfieFile":{"type":"object","properties":{},"nullable":true,"example":"see File object"},"sanctionsStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"]},"amlStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","ERROR"]},"amlProvider":{"type":"string","enum":["ComplyAdvantage"],"nullable":true},"amlTid":{"type":"string","nullable":true},"amlUrl":{"type":"string","nullable":true},"amlCheckedAt":{"type":"string","format":"date-time","nullable":true},"amlLog":{"type":"string","nullable":true},"amlLogData":{"type":"string","nullable":true},"amlReviewedById":{"type":"string","nullable":true},"amlReviewedAt":{"type":"string","format":"date-time","nullable":true},"liquidNetWorth":{"type":"number","multipleOf":0.01,"nullable":true},"liquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"illiquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"privateSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"aicAccreditationType":{"type":"string","enum":["PENDING","INCOME","NET_WORTH","PROFESSIONAL_CERTIFICATION","KNOWLEDGEABLE_EMPLOYEE"]},"aicExpirationDate":{"type":"string","format":"date-time","nullable":true},"aicQuestionnaire":{"type":"string","nullable":true},"aicStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","PROCESSED"]},"aicCheckedAt":{"type":"string","format":"date-time","nullable":true},"aicLog":{"type":"string","nullable":true},"aicReviewedById":{"type":"string","nullable":true},"aicReviewedAt":{"type":"string","format":"date-time","nullable":true},"iraQuestionnaire":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"hasIraAccounts":{"type":"boolean"},"inSelfDirectedIra":{"type":"boolean"},"custodian":{"type":"string"},"hasOtherQualifiedFunds":{"type":"boolean"}},"required":["id","hasIraAccounts","inSelfDirectedIra","custodian","hasOtherQualifiedFunds"]},"nullable":true},"iraCheck":{"type":"string","enum":["PENDING","APPROVED","NEEDS_REVIEW","REJECTED"]},"iraCheckedAt":{"type":"string","format":"date-time","nullable":true},"iraLog":{"type":"string","nullable":true},"iraReviewedById":{"type":"string","nullable":true},"iraReviewedAt":{"type":"string","format":"date-time","nullable":true},"firstName":{"type":"string"},"lastName":{"type":"string","nullable":true},"dob":{"type":"string","format":"date-time","nullable":true},"isUsCitizenOrGreenCardHolder":{"type":"boolean"},"citizenship":{"type":"string","enum":["AD","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","CU","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","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","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","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","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","YE","YT","ZA","ZM","ZW"],"nullable":true},"ssn":{"type":"string","nullable":true},"lastFour":{"type":"string","nullable":true},"address":{"type":"string","nullable":true},"address2":{"type":"string","nullable":true},"email":{"type":"string","format":"email","nullable":true},"phone":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"state":{"type":"string","nullable":true},"zip":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"kycTid":{"type":"string","nullable":true},"currencyCode":{"type":"string","minLength":3,"maxLength":3,"nullable":true},"investedInCrowdfunding":{"type":"number","nullable":true},"currentAnnualIncome":{"type":"number","nullable":true},"averageAnnualIncome":{"type":"number","nullable":true},"averageHouseholdIncome":{"type":"number","nullable":true},"currentHouseholdIncome":{"type":"number","nullable":true},"householdNetWorth":{"type":"number","nullable":true},"isSolicited":{"type":"boolean"},"isRealEstate":{"type":"boolean"},"iliquidSecurities":{"type":"number","multipleOf":0.01,"nullable":true},"timeHorizon":{"type":"string","nullable":true},"riskTolerance":{"type":"string","nullable":true},"investmentObjective":{"type":"string","nullable":true},"investmentExperience":{"type":"string","nullable":true},"experienceInPrivate":{"type":"string","nullable":true},"levelOfEducation":{"type":"string","nullable":true},"financialAdvisor":{"type":"boolean"},"occupation":{"type":"string","nullable":true},"employmentStatus":{"type":"string","enum":["EMPLOYED","UNEMPLOYED","SELF_EMPLOYED","RETIRED","STUDENT","OTHER"]},"employerName":{"type":"string","nullable":true},"employerAddressLine1":{"type":"string","nullable":true},"employerAddressLine2":{"type":"string","nullable":true},"employerCity":{"type":"string","nullable":true},"employerState":{"type":"string","nullable":true},"employerZip":{"type":"string","nullable":true},"employerCountry":{"type":"string","nullable":true},"notes":{"type":"string","nullable":true},"kycs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"platform":{"type":"string","example":"KYC Platform"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Passport"},"documentImage":{"type":"string","example":"https://example.com/passport.jpg"},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Document unclear"},"response":{"type":"string","nullable":true,"example":"Submitted clearer document"}},"required":["id","createdAt","updatedAt","deletedAt","tid","platform","individualId","documentType","documentImage","kycStatus","reason","response"]},"nullable":true},"amls":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"provider":{"type":"string","nullable":true,"example":"AML Provider"},"url":{"type":"string","nullable":true,"example":"https://example.com/aml"},"status":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","ERROR"],"example":"PENDING"},"checkedAt":{"type":"string","format":"date-time","nullable":true,"example":"2022-01-01T00:00:00Z"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"}},"required":["id","createdAt","updatedAt","deletedAt","tid","provider","url","status","checkedAt","individualId"]},"nullable":true},"aics":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"individualId":{},"individual":{"nullable":true},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"]},"reviewedById":{"nullable":true},"reviewedBy":{"nullable":true},"reviewedAt":{"type":"string","format":"date-time","nullable":true},"systemReview":{"type":"string","enum":["PENDING","NEEDS_INFO","READY_TO_APPROVE","NEEDS_REVIEW","APPROVED","REJECTED"]},"systemLog":{"type":"array","items":{"type":"object","properties":{"check":{"type":"string","minLength":1},"entered":{"type":"number"},"extracted":{"type":"number"},"result":{"type":"string","enum":["PASS","FAIL"]},"reason":{"type":"string"}},"required":["check","result"]},"nullable":true},"firstName":{"type":"string"},"lastName":{"type":"string"},"method":{"type":"string","enum":["PENDING","INCOME","NET_WORTH","PROFESSIONAL_CERTIFICATION","KNOWLEDGEABLE_EMPLOYEE"]},"incomeData":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer","minimum":2020,"maximum":2025},"filingStatus":{"type":"string","enum":["SINGLE","JOINT"]},"income":{"type":"number","minimum":0,"multipleOf":0.01},"fileId":{}},"required":["year","filingStatus","income","fileId"]},"nullable":true},"netWorthData":{"type":"array","items":{"type":"object","properties":{"institution":{"type":"string","minLength":1,"maxLength":100},"accountType":{"type":"string","enum":["CHECKING","SAVINGS","BROKERAGE","REAL_ESTATE","OTHER"]},"balance":{"type":"number","minimum":0,"multipleOf":0.01},"fileId":{}},"required":["institution","accountType","balance","fileId"]},"nullable":true},"professionalData":{"type":"array","items":{"type":"object","properties":{"professionalType":{"type":"string","enum":["SECURITIES_LICENSES","DIRECTORS","FAMILY_OFFICE"]},"licenseNumber":{"type":"string","minLength":1,"maxLength":50,"nullable":true},"fileId":{"nullable":true}},"required":["professionalType"]},"nullable":true},"employeeData":{"type":"array","items":{"type":"object","properties":{"position":{"type":"string","minLength":1,"maxLength":100},"fileId":{}},"required":["position","fileId"]},"nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","individualId","complianceReview","reviewedById","reviewedAt","systemReview","systemLog","firstName","lastName","method","incomeData","netWorthData","professionalData","employeeData"]},"nullable":true},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]},"setupStep":{"type":"string","enum":["NEW","PERSONAL_INFO","ADDRESS","KYC","INCOME","AIC_QUESTIONS","AIC_FILES"]},"sourceOfIncome":{"type":"string","enum":["EMPLOYED","SELF_EMPLOYED","UNEMPLOYED","RETIREMENT","STUDENT"],"nullable":true},"ownership":{"type":"number","nullable":true},"kycProvider":{"type":"string","nullable":true},"retirementAccountType":{"type":"string","enum":["SELF_DIRECTED","CUSTODIAN_MANAGED"],"nullable":true},"custodianName":{"type":"string","nullable":true},"custodianAccountNumber":{"type":"string","nullable":true},"custodianRepresentativeName":{"type":"string","nullable":true},"custodianEmail":{"type":"string","format":"email","nullable":true},"accredited":{"type":"boolean"}},"required":["id","createdAt","updatedAt","deletedAt","tid","accountId","investorAccountId","role","kycStatus","kycFirstName","kycLastName","kycDocumentType","kycDocumentIssuer","kycDocumentNumber","kycIssuerDate","kycExpirationDate","kycCheck","kycCheckedAt","kycLog","kycReviewedById","kycReviewedAt","kycDocumentFrontFileId","kycDocumentBackFileId","kycSelfieFileId","sanctionsStatus","amlStatus","amlProvider","amlTid","amlUrl","amlCheckedAt","amlLog","amlLogData","amlReviewedById","amlReviewedAt","liquidNetWorth","liquidSecurities","illiquidSecurities","privateSecurities","aicAccreditationType","aicExpirationDate","aicQuestionnaire","aicStatus","aicCheckedAt","aicLog","aicReviewedById","aicReviewedAt","iraQuestionnaire","iraCheck","iraCheckedAt","iraLog","iraReviewedById","iraReviewedAt","firstName","lastName","dob","isUsCitizenOrGreenCardHolder","ssn","lastFour","address","address2","email","phone","city","state","zip","country","kycTid","currencyCode","investedInCrowdfunding","currentAnnualIncome","averageAnnualIncome","averageHouseholdIncome","currentHouseholdIncome","householdNetWorth","isSolicited","isRealEstate","timeHorizon","riskTolerance","investmentObjective","investmentExperience","experienceInPrivate","levelOfEducation","financialAdvisor","occupation","employmentStatus","employerName","employerAddressLine1","employerAddressLine2","employerCity","employerState","employerZip","employerCountry","notes","setupStatus","setupStep","sourceOfIncome","ownership","kycProvider","accredited"]}},"meta":{"type":"object","properties":{"itemCount":{"type":"number","example":1},"totalItems":{"type":"number","example":10},"itemsPerPage":{"type":"number","example":1},"totalPages":{"type":"number","example":10},"currentPage":{"type":"number","example":1}},"required":["itemCount","itemsPerPage","currentPage"]}},"required":["items","meta"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/investor-accounts":{"post":{"summary":"Create investor account ","tags":["investorAccounts"],"parameters":[],"operationId":"createInvestorAccount","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"investorAccountType":{"type":"string","enum":["INDIVIDUAL","JOINT","RETIREMENT","LEGAL_ENTITY"]},"email":{"type":"string","format":"email"},"name":{"type":"string","minLength":1,"maxLength":100},"tid":{"type":"string"},"userId":{}},"required":["investorAccountType","userId"]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"investorAccountType":{"type":"string","enum":["INDIVIDUAL","JOINT","RETIREMENT","LEGAL_ENTITY"]},"user":{"nullable":true},"userId":{"type":"string","nullable":true},"email":{"type":"string","format":"email","nullable":true},"name":{"type":"string","nullable":true},"regAQualified":{"type":"boolean"},"regCfQualified":{"type":"boolean"},"regDQualified":{"type":"boolean"},"accountId":{"type":"string"},"account":{},"trades":{"type":"array","items":{}},"individuals":{"type":"array","items":{}},"legalEntities":{"type":"array","items":{}},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]},"systemReviewLog":{"type":"string","nullable":true},"totalAmount":{"type":"number"},"statusCheck":{},"trustedContacts":{"type":"array","items":{}}},"required":["id","createdAt","updatedAt","deletedAt","tid","investorAccountType","regAQualified","regCfQualified","regDQualified","accountId","setupStatus","systemReviewLog"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]},"get":{"summary":"Get investor accounts","tags":["investorAccounts"],"parameters":[{"name":"page","in":"query","schema":{"default":1,"type":"number","nullable":true}},{"name":"limit","in":"query","schema":{"default":10,"type":"number","nullable":true}},{"name":"include","in":"query","schema":{"type":"string","example":"account,trades,individuals,legalEntities,trustedContacts"}},{"name":"investorAccountType","in":"query","schema":{"type":"string","enum":["INDIVIDUAL","JOINT","RETIREMENT","LEGAL_ENTITY"]}},{"name":"kycStatus","in":"query","schema":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"]}},{"name":"kybStatus","in":"query","schema":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"]}},{"name":"amlStatus","in":"query","schema":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","ERROR"]}},{"name":"aicStatus","in":"query","schema":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","PROCESSED"]}},{"name":"offeringId","in":"query","schema":{}},{"name":"regAQualified","in":"query","schema":{"type":"boolean"}},{"name":"regCfQualified","in":"query","schema":{"type":"boolean"}},{"name":"regDQualified","in":"query","schema":{"type":"boolean"}},{"name":"email","in":"query","schema":{"type":"string"}},{"name":"accountId","in":"query","schema":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6","accountId":"account_00041061050r3gg28a1c60t3gf"}},{"name":"userType","in":"query","schema":{"type":"string","enum":["USER","LEAD","INVESTOR","DEMO"]}},{"name":"startDate","in":"query","schema":{"type":"string","nullable":true,"example":"05/20/1990"}},{"name":"endDate","in":"query","schema":{"type":"string","nullable":true,"example":"05/20/1990"}},{"name":"userId","in":"query","schema":{"type":"string"}}],"operationId":"getInvestorAccounts","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"investorAccountType":{"type":"string","enum":["INDIVIDUAL","JOINT","RETIREMENT","LEGAL_ENTITY"]},"user":{"nullable":true},"userId":{"type":"string","nullable":true},"email":{"type":"string","format":"email","nullable":true},"name":{"type":"string","nullable":true},"regAQualified":{"type":"boolean"},"regCfQualified":{"type":"boolean"},"regDQualified":{"type":"boolean"},"accountId":{"type":"string"},"account":{},"trades":{"type":"array","items":{}},"individuals":{"type":"array","items":{}},"legalEntities":{"type":"array","items":{}},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]},"systemReviewLog":{"type":"string","nullable":true},"totalAmount":{"type":"number"},"statusCheck":{},"trustedContacts":{"type":"array","items":{}}},"required":["id","createdAt","updatedAt","deletedAt","tid","investorAccountType","regAQualified","regCfQualified","regDQualified","accountId","setupStatus","systemReviewLog"]}},"meta":{"type":"object","properties":{"itemCount":{"type":"number","example":1},"totalItems":{"type":"number","example":10},"itemsPerPage":{"type":"number","example":1},"totalPages":{"type":"number","example":10},"currentPage":{"type":"number","example":1}},"required":["itemCount","itemsPerPage","currentPage"]}},"required":["items","meta"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/investor-accounts/{id}":{"patch":{"summary":"Update investor account ","tags":["investorAccounts"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"updateInvestorAccount","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"email":{"type":"string","format":"email","example":"john.doe@example.com"}}}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"investorAccountType":{"type":"string","enum":["INDIVIDUAL","JOINT","RETIREMENT","LEGAL_ENTITY"]},"user":{"nullable":true},"userId":{"type":"string","nullable":true},"email":{"type":"string","format":"email","nullable":true},"name":{"type":"string","nullable":true},"regAQualified":{"type":"boolean"},"regCfQualified":{"type":"boolean"},"regDQualified":{"type":"boolean"},"accountId":{"type":"string"},"account":{},"trades":{"type":"array","items":{}},"individuals":{"type":"array","items":{}},"legalEntities":{"type":"array","items":{}},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]},"systemReviewLog":{"type":"string","nullable":true},"totalAmount":{"type":"number"},"statusCheck":{},"trustedContacts":{"type":"array","items":{}}},"required":["id","createdAt","updatedAt","deletedAt","tid","investorAccountType","regAQualified","regCfQualified","regDQualified","accountId","setupStatus","systemReviewLog"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]},"get":{"summary":"Get investor account by id","tags":["investorAccounts"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"include","in":"query","schema":{"type":"string","example":"account,trades,individuals,legalEntities,trustedContacts"}}],"operationId":"getInvestorAccount","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","nullable":true},"investorAccountType":{"type":"string","enum":["INDIVIDUAL","JOINT","RETIREMENT","LEGAL_ENTITY"]},"user":{"nullable":true},"userId":{"type":"string","nullable":true},"email":{"type":"string","format":"email","nullable":true},"name":{"type":"string","nullable":true},"regAQualified":{"type":"boolean"},"regCfQualified":{"type":"boolean"},"regDQualified":{"type":"boolean"},"accountId":{"type":"string"},"account":{},"trades":{"type":"array","items":{}},"individuals":{"type":"array","items":{}},"legalEntities":{"type":"array","items":{}},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]},"systemReviewLog":{"type":"string","nullable":true},"totalAmount":{"type":"number"},"statusCheck":{},"trustedContacts":{"type":"array","items":{}}},"required":["id","createdAt","updatedAt","deletedAt","tid","investorAccountType","regAQualified","regCfQualified","regDQualified","accountId","setupStatus","systemReviewLog"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/issuer-payment-methods":{"get":{"summary":"Get issuer payment methods","tags":["issuerPaymentMethods"],"parameters":[{"name":"page","in":"query","schema":{"default":1,"type":"number","nullable":true}},{"name":"limit","in":"query","schema":{"default":10,"type":"number","nullable":true}},{"name":"issuerId","in":"query","required":true,"schema":{"type":"string","example":"issuer_01jdq2crwke8xskjd840cj79pw"}},{"name":"enabled","in":"query","schema":{"type":"string","example":"true"}},{"name":"include","in":"query","schema":{"type":"string","example":"issuer,integration"}}],"operationId":"getIssuerPaymentMethods","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"paymentMethodType":{"type":"string","enum":["CREDIT_CARD","WIRE","ACH","BANK_ACCOUNT","CHECK","RETIREMENT"],"example":"CREDIT_CARD"},"paymentMethodProvider":{"type":"string","enum":["STRIPE","PLAID","OTHER"],"example":"STRIPE"},"enabled":{"type":"boolean","example":true},"issuerId":{"type":"string","example":"issuer_01jdq2crwke8xskjd840cj79pw"},"config":{"nullable":true},"issuer":{"type":"object","properties":{"id":{"type":"string","example":"issuer_01jdq2crwke8xskjd840cj79pw"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"legalName":{"type":"string","nullable":true,"example":"Fund.co LLC"},"dba":{"type":"string","nullable":true,"example":"Fund Consulting Services"},"title":{"type":"string","nullable":true,"example":"Issuer Title"},"description":{"type":"string","nullable":true,"example":"Fund Consulting Services"},"ein":{"type":"string","pattern":"^\\d{9}$","nullable":true,"example":"123456789"},"type":{"type":"string","enum":["LLC","S_CORP","C_CORP"],"example":"LLC"},"address":{"type":"string","nullable":true,"example":"1234 Main St, Apt 101"},"address2":{"type":"string","nullable":true,"example":"Apt 202"},"city":{"type":"string","nullable":true,"example":"Los Angeles"},"state":{"type":"string","nullable":true,"example":"CA"},"zip":{"type":"string","nullable":true,"example":"90015"},"country":{"type":"string","nullable":true,"example":"United States"},"accountId":{"type":"string"},"account":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"name":{"type":"string","example":"Dalmore"},"status":{"type":"string","enum":["ONBOARDING","LIVE","OVERDUE","SUSPENDED","INACTIVE"],"example":"LIVE"},"managedBy":{"type":"string","enum":["DALMORE","ISSUER"],"nullable":true,"example":"DALMORE"},"platform":{"type":"string","enum":["DALMORE","IMPORT"],"example":"IMPORT"},"onboardingReviewerId":{"type":"string","nullable":true,"example":"user_01j1xgme5mfrasd02hmfwsy13a"},"onboardingReviewAt":{"type":"string","format":"date-time","nullable":true},"allowPendingComplianceReview":{"type":"boolean","example":false}},"required":["id","createdAt","updatedAt","deletedAt","name","status","managedBy","platform","onboardingReviewerId","onboardingReviewAt","allowPendingComplianceReview"],"nullable":true},"ss4LetterFileId":{"type":"string","nullable":true},"formationDocumentFileId":{"type":"string","nullable":true},"formationDocument":{"nullable":true},"status":{"type":"string","enum":["REJECTED","IN_REVIEW","ADDITIONAL_INFO","SUBMITTED","IN_PROGRESS","APPROVED"],"example":"SUBMITTED"},"coverArtId":{"type":"string","nullable":true},"coverArt":{"nullable":true},"doi":{"type":"string","format":"date-time","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","legalName","dba","title","description","ein","type","address","address2","city","state","zip","country","accountId","ss4LetterFileId","formationDocumentFileId","status","coverArtId","doi"],"nullable":true},"integration":{"type":"object","properties":{"id":{"type":"string"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"integrationStatus":{"type":"string","enum":["PENDING","CONNECTED","DISCONNECTED"],"example":"PENDING"},"issuerPaymentMethodId":{"type":"string"},"integrationAccountId":{"type":"string","nullable":true},"integrationAccountEmail":{"type":"string","nullable":true},"integrationAccountLink":{"type":"string","nullable":true},"integrationAccountLinkExpiresAt":{"oneOf":[{"type":"number"},{"type":"number"}],"nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","integrationStatus","issuerPaymentMethodId","integrationAccountId","integrationAccountEmail","integrationAccountLink","integrationAccountLinkExpiresAt"],"nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","paymentMethodType","paymentMethodProvider","enabled","issuerId"]}},"meta":{"type":"object","properties":{"itemCount":{"type":"number","example":1},"totalItems":{"type":"number","example":10},"itemsPerPage":{"type":"number","example":1},"totalPages":{"type":"number","example":10},"currentPage":{"type":"number","example":1}},"required":["itemCount","itemsPerPage","currentPage"]}},"required":["items","meta"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/issuers":{"get":{"summary":"Get Issuers","tags":["issuers"],"parameters":[{"name":"page","in":"query","schema":{"default":1,"type":"number","nullable":true}},{"name":"limit","in":"query","schema":{"default":10,"type":"number","nullable":true}},{"name":"include","in":"query","schema":{"type":"string","example":"account,offerings,coveredPersons"}},{"name":"accountId","in":"query","schema":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6","accountId":"account_00041061050r3gg28a1c60t3gf"}},{"name":"ein","in":"query","schema":{"type":"string","pattern":"^\\d{9}$","example":"123456789"}},{"name":"legalName","in":"query","schema":{"type":"string","example":"Fund.co LLC"}},{"name":"type","in":"query","schema":{"type":"string","enum":["LLC","S_CORP","C_CORP"],"example":"C_CORP"}},{"name":"status","in":"query","schema":{"type":"string","enum":["REJECTED","IN_REVIEW","ADDITIONAL_INFO","SUBMITTED","IN_PROGRESS","APPROVED"],"example":"SUBMITTED"}}],"operationId":"getIssuers","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"issuer_01jdq2crwke8xskjd840cj79pw"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"legalName":{"type":"string","nullable":true,"example":"Fund.co LLC"},"dba":{"type":"string","nullable":true,"example":"Fund Consulting Services"},"title":{"type":"string","nullable":true,"example":"Issuer Title"},"description":{"type":"string","nullable":true,"example":"Fund Consulting Services"},"ein":{"type":"string","pattern":"^\\d{9}$","nullable":true,"example":"123456789"},"type":{"type":"string","enum":["LLC","S_CORP","C_CORP"],"example":"LLC"},"address":{"type":"string","nullable":true,"example":"1234 Main St, Apt 101"},"address2":{"type":"string","nullable":true,"example":"Apt 202"},"city":{"type":"string","nullable":true,"example":"Los Angeles"},"state":{"type":"string","nullable":true,"example":"CA"},"zip":{"type":"string","nullable":true,"example":"90015"},"country":{"type":"string","nullable":true,"example":"United States"},"accountId":{"type":"string"},"account":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"name":{"type":"string","example":"Dalmore"},"status":{"type":"string","enum":["ONBOARDING","LIVE","OVERDUE","SUSPENDED","INACTIVE"],"example":"LIVE"},"managedBy":{"type":"string","enum":["DALMORE","ISSUER"],"nullable":true,"example":"DALMORE"},"platform":{"type":"string","enum":["DALMORE","IMPORT"],"example":"IMPORT"},"onboardingReviewerId":{"type":"string","nullable":true,"example":"user_01j1xgme5mfrasd02hmfwsy13a"},"onboardingReviewAt":{"type":"string","format":"date-time","nullable":true},"allowPendingComplianceReview":{"type":"boolean","example":false}},"required":["id","createdAt","updatedAt","deletedAt","name","status","managedBy","platform","onboardingReviewerId","onboardingReviewAt","allowPendingComplianceReview"],"nullable":true},"ss4LetterFileId":{"type":"string","nullable":true},"formationDocumentFileId":{"type":"string","nullable":true},"formationDocument":{"nullable":true},"status":{"type":"string","enum":["REJECTED","IN_REVIEW","ADDITIONAL_INFO","SUBMITTED","IN_PROGRESS","APPROVED"],"example":"SUBMITTED"},"coverArtId":{"type":"string","nullable":true},"coverArt":{"nullable":true},"doi":{"type":"string","format":"date-time","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","legalName","dba","title","description","ein","type","address","address2","city","state","zip","country","accountId","ss4LetterFileId","formationDocumentFileId","status","coverArtId","doi"]}},"meta":{"type":"object","properties":{"itemCount":{"type":"number","example":1},"totalItems":{"type":"number","example":10},"itemsPerPage":{"type":"number","example":1},"totalPages":{"type":"number","example":10},"currentPage":{"type":"number","example":1}},"required":["itemCount","itemsPerPage","currentPage"]}},"required":["items","meta"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]},"post":{"summary":"Create an issuer","tags":["issuers"],"parameters":[],"operationId":"postIssuer","requestBody":{"description":"Body","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":150,"nullable":true,"example":"Issuer Title"},"description":{"type":"string","minLength":1,"maxLength":1000,"nullable":true,"example":"Fund Consulting Services"},"legalName":{"type":"string","minLength":1,"maxLength":100,"example":"Fund.co LLC"},"dba":{"type":"string","minLength":1,"maxLength":100,"nullable":true,"example":"Fund Consulting Services"},"doi":{"type":"string","nullable":true,"example":"MM/DD/YYYY"},"ein":{"type":"string","pattern":"^\\d{9}$","nullable":true,"example":"123456789"},"type":{"type":"string","enum":["LLC","S_CORP","C_CORP"],"example":"LLC"}},"required":["legalName","type"]},{"allOf":[{"allOf":[{"type":"object","properties":{"address":{"type":"string","minLength":2,"nullable":true},"address2":{"type":"string","nullable":true},"city":{"type":"string","minLength":2,"maxLength":30,"nullable":true}}},{"type":"object","properties":{"country":{"type":"string","enum":["AD","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","CU","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","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","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","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","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","YE","YT","ZA","ZM","ZW"],"nullable":true},"state":{"type":"string","nullable":true}}}]},{"type":"object","properties":{"country":{"type":"string","enum":["AD","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","CU","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","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","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","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","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","YE","YT","ZA","ZM","ZW"],"nullable":true},"zip":{"type":"string","nullable":true}}}]}]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"issuer_01jdq2crwke8xskjd840cj79pw"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"legalName":{"type":"string","nullable":true,"example":"Fund.co LLC"},"dba":{"type":"string","nullable":true,"example":"Fund Consulting Services"},"title":{"type":"string","nullable":true,"example":"Issuer Title"},"description":{"type":"string","nullable":true,"example":"Fund Consulting Services"},"ein":{"type":"string","pattern":"^\\d{9}$","nullable":true,"example":"123456789"},"type":{"type":"string","enum":["LLC","S_CORP","C_CORP"],"example":"LLC"},"address":{"type":"string","nullable":true,"example":"1234 Main St, Apt 101"},"address2":{"type":"string","nullable":true,"example":"Apt 202"},"city":{"type":"string","nullable":true,"example":"Los Angeles"},"state":{"type":"string","nullable":true,"example":"CA"},"zip":{"type":"string","nullable":true,"example":"90015"},"country":{"type":"string","nullable":true,"example":"United States"},"accountId":{"type":"string"},"account":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"name":{"type":"string","example":"Dalmore"},"status":{"type":"string","enum":["ONBOARDING","LIVE","OVERDUE","SUSPENDED","INACTIVE"],"example":"LIVE"},"managedBy":{"type":"string","enum":["DALMORE","ISSUER"],"nullable":true,"example":"DALMORE"},"platform":{"type":"string","enum":["DALMORE","IMPORT"],"example":"IMPORT"},"onboardingReviewerId":{"type":"string","nullable":true,"example":"user_01j1xgme5mfrasd02hmfwsy13a"},"onboardingReviewAt":{"type":"string","format":"date-time","nullable":true},"allowPendingComplianceReview":{"type":"boolean","example":false}},"required":["id","createdAt","updatedAt","deletedAt","name","status","managedBy","platform","onboardingReviewerId","onboardingReviewAt","allowPendingComplianceReview"],"nullable":true},"ss4LetterFileId":{"type":"string","nullable":true},"formationDocumentFileId":{"type":"string","nullable":true},"formationDocument":{"nullable":true},"status":{"type":"string","enum":["REJECTED","IN_REVIEW","ADDITIONAL_INFO","SUBMITTED","IN_PROGRESS","APPROVED"],"example":"SUBMITTED"},"coverArtId":{"type":"string","nullable":true},"coverArt":{"nullable":true},"doi":{"type":"string","format":"date-time","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","legalName","dba","title","description","ein","type","address","address2","city","state","zip","country","accountId","ss4LetterFileId","formationDocumentFileId","status","coverArtId","doi"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/issuers/{id}":{"get":{"summary":"Get issuer by id","tags":["issuers"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","example":"issuer_01jdq2crwke8xskjd840cj79pw"}},{"name":"include","in":"query","schema":{"type":"string","example":"account,offerings,coveredPersons"}}],"operationId":"getIssuer","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"issuer_01jdq2crwke8xskjd840cj79pw"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"legalName":{"type":"string","nullable":true,"example":"Fund.co LLC"},"dba":{"type":"string","nullable":true,"example":"Fund Consulting Services"},"title":{"type":"string","nullable":true,"example":"Issuer Title"},"description":{"type":"string","nullable":true,"example":"Fund Consulting Services"},"ein":{"type":"string","pattern":"^\\d{9}$","nullable":true,"example":"123456789"},"type":{"type":"string","enum":["LLC","S_CORP","C_CORP"],"example":"LLC"},"address":{"type":"string","nullable":true,"example":"1234 Main St, Apt 101"},"address2":{"type":"string","nullable":true,"example":"Apt 202"},"city":{"type":"string","nullable":true,"example":"Los Angeles"},"state":{"type":"string","nullable":true,"example":"CA"},"zip":{"type":"string","nullable":true,"example":"90015"},"country":{"type":"string","nullable":true,"example":"United States"},"accountId":{"type":"string"},"account":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"name":{"type":"string","example":"Dalmore"},"status":{"type":"string","enum":["ONBOARDING","LIVE","OVERDUE","SUSPENDED","INACTIVE"],"example":"LIVE"},"managedBy":{"type":"string","enum":["DALMORE","ISSUER"],"nullable":true,"example":"DALMORE"},"platform":{"type":"string","enum":["DALMORE","IMPORT"],"example":"IMPORT"},"onboardingReviewerId":{"type":"string","nullable":true,"example":"user_01j1xgme5mfrasd02hmfwsy13a"},"onboardingReviewAt":{"type":"string","format":"date-time","nullable":true},"allowPendingComplianceReview":{"type":"boolean","example":false}},"required":["id","createdAt","updatedAt","deletedAt","name","status","managedBy","platform","onboardingReviewerId","onboardingReviewAt","allowPendingComplianceReview"],"nullable":true},"ss4LetterFileId":{"type":"string","nullable":true},"formationDocumentFileId":{"type":"string","nullable":true},"formationDocument":{"nullable":true},"status":{"type":"string","enum":["REJECTED","IN_REVIEW","ADDITIONAL_INFO","SUBMITTED","IN_PROGRESS","APPROVED"],"example":"SUBMITTED"},"coverArtId":{"type":"string","nullable":true},"coverArt":{"nullable":true},"doi":{"type":"string","format":"date-time","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","legalName","dba","title","description","ein","type","address","address2","city","state","zip","country","accountId","ss4LetterFileId","formationDocumentFileId","status","coverArtId","doi"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]},"put":{"summary":"Update issuer","tags":["issuers"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","example":"issuer_01jdq2crwke8xskjd840cj79pw"}}],"operationId":"updateIssuer","requestBody":{"description":"Body","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":150,"nullable":true,"example":"Issuer Title"},"description":{"type":"string","minLength":1,"maxLength":1000,"nullable":true,"example":"Fund Consulting Services"},"legalName":{"type":"string","minLength":1,"maxLength":100,"example":"Fund.co LLC"},"dba":{"type":"string","minLength":1,"maxLength":100,"nullable":true,"example":"Fund Consulting Services"},"doi":{"type":"string","nullable":true,"example":"MM/DD/YYYY"},"ein":{"type":"string","pattern":"^\\d{9}$","nullable":true,"example":"123456789"},"type":{"type":"string","enum":["LLC","S_CORP","C_CORP"],"example":"LLC"},"ss4LetterFileId":{"nullable":true},"formationDocumentFileId":{"nullable":true},"coverArtId":{"nullable":true}}},{"allOf":[{"allOf":[{"type":"object","properties":{"address":{"type":"string","minLength":2,"nullable":true},"address2":{"type":"string","nullable":true},"city":{"type":"string","minLength":2,"maxLength":30,"nullable":true}}},{"type":"object","properties":{"country":{"type":"string","enum":["AD","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","CU","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","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","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","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","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","YE","YT","ZA","ZM","ZW"],"nullable":true},"state":{"type":"string","nullable":true}}}]},{"type":"object","properties":{"country":{"type":"string","enum":["AD","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","CU","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","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","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","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","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","YE","YT","ZA","ZM","ZW"],"nullable":true},"zip":{"type":"string","nullable":true}}}]}]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"issuer_01jdq2crwke8xskjd840cj79pw"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"legalName":{"type":"string","nullable":true,"example":"Fund.co LLC"},"dba":{"type":"string","nullable":true,"example":"Fund Consulting Services"},"title":{"type":"string","nullable":true,"example":"Issuer Title"},"description":{"type":"string","nullable":true,"example":"Fund Consulting Services"},"ein":{"type":"string","pattern":"^\\d{9}$","nullable":true,"example":"123456789"},"type":{"type":"string","enum":["LLC","S_CORP","C_CORP"],"example":"LLC"},"address":{"type":"string","nullable":true,"example":"1234 Main St, Apt 101"},"address2":{"type":"string","nullable":true,"example":"Apt 202"},"city":{"type":"string","nullable":true,"example":"Los Angeles"},"state":{"type":"string","nullable":true,"example":"CA"},"zip":{"type":"string","nullable":true,"example":"90015"},"country":{"type":"string","nullable":true,"example":"United States"},"accountId":{"type":"string"},"account":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"name":{"type":"string","example":"Dalmore"},"status":{"type":"string","enum":["ONBOARDING","LIVE","OVERDUE","SUSPENDED","INACTIVE"],"example":"LIVE"},"managedBy":{"type":"string","enum":["DALMORE","ISSUER"],"nullable":true,"example":"DALMORE"},"platform":{"type":"string","enum":["DALMORE","IMPORT"],"example":"IMPORT"},"onboardingReviewerId":{"type":"string","nullable":true,"example":"user_01j1xgme5mfrasd02hmfwsy13a"},"onboardingReviewAt":{"type":"string","format":"date-time","nullable":true},"allowPendingComplianceReview":{"type":"boolean","example":false}},"required":["id","createdAt","updatedAt","deletedAt","name","status","managedBy","platform","onboardingReviewerId","onboardingReviewAt","allowPendingComplianceReview"],"nullable":true},"ss4LetterFileId":{"type":"string","nullable":true},"formationDocumentFileId":{"type":"string","nullable":true},"formationDocument":{"nullable":true},"status":{"type":"string","enum":["REJECTED","IN_REVIEW","ADDITIONAL_INFO","SUBMITTED","IN_PROGRESS","APPROVED"],"example":"SUBMITTED"},"coverArtId":{"type":"string","nullable":true},"coverArt":{"nullable":true},"doi":{"type":"string","format":"date-time","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","legalName","dba","title","description","ein","type","address","address2","city","state","zip","country","accountId","ss4LetterFileId","formationDocumentFileId","status","coverArtId","doi"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/kycs/{id}":{"post":{"summary":"Create KYC record for individual","tags":["kyc"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"createKyc","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"kycFirstName":{"type":"string","minLength":2,"maxLength":150,"example":"John"},"kycLastName":{"type":"string","minLength":2,"maxLength":150,"example":"Doe"},"kycDocumentType":{"type":"string","enum":["PASSPORT","DRIVER_LICENSE","STATE_ID"],"example":"DRIVER_LICENSE"},"kycDocumentId":{"type":"string","minLength":4,"maxLength":50,"example":"D1234567"},"kycDocumentIssuer":{"type":"string","enum":["AL","AK","AZ","AR","CA","CO","CT","DE","FL","GA","HI","ID","IL","IN","IA","KS","KY","LA","ME","MD","MA","MI","MN","MS","MO","MT","NE","NV","NH","NJ","NM","NY","NC","ND","OH","OK","OR","PA","RI","SC","SD","TN","TX","UT","VT","VA","WA","WV","WI","WY","AD","AE","AF","AG","AI","AM","AO","AQ","AS","AT","AU","AW","AX","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BL","BM","BN","BO","BQ","BR","BS","BT","BV","BW","BY","BZ","CC","CD","CF","CG","CH","CI","CK","CL","CM","CN","CR","CU","CV","CW","CX","CY","CZ","DJ","DK","DM","DO","DZ","EC","EE","EG","EH","ER","ES","ET","FI","FJ","FK","FM","FO","FR","GB","GD","GE","GF","GG","GH","GI","GL","GM","GN","GP","GQ","GR","GS","GT","GU","GW","GY","HK","HM","HN","HR","HT","HU","IE","IM","IO","IQ","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KZ","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MC","MF","MG","MH","MK","ML","MM","MP","MQ","MR","MU","MV","MW","MX","MY","MZ","NA","NF","NG","NI","NL","NO","NP","NR","NU","NZ","OM","PE","PF","PG","PH","PK","PL","PM","PN","PR","PS","PT","PW","PY","QA","RE","RO","RS","RU","RW","SA","SB","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","SZ","TC","TD","TF","TG","TH","TJ","TK","TL","TM","TO","TR","TT","TV","TW","TZ","UA","UG","UM","US","UY","UZ","VC","VE","VG","VI","VN","VU","WF","WS","YE","YT","ZA","ZM","ZW"],"example":"CA"},"kycDocumentIssuedDate":{"type":"string","nullable":true,"example":"05/20/1990"},"kycDocumentExpirationDate":{"type":"string","nullable":true,"example":"05/20/1990"},"kycDocumentDob":{"type":"string","nullable":true,"example":"05/20/1990"},"kycProvider":{"type":"string","enum":["WITH_PERSONA"]},"kycLog":{"type":"string","example":"{\"review\":\"Approved\",\"inquiry_id\":\"inq_123\"}"},"kycDocumentFrontFileId":{"example":"file_01j5y5ghx8fvc83dmx3pznq7hv"},"kycDocumentBackFileId":{"example":"file_01j5y5ghx8fvc83dmx3pznq7hv"},"kycSelfieFileId":{"example":"file_01j5y5ghx8fvc83dmx3pznq7hv"}},"required":["kycFirstName","kycLastName","kycDocumentType","kycDocumentId","kycDocumentIssuer","kycDocumentIssuedDate","kycDocumentExpirationDate","kycDocumentDob","kycProvider","kycLog","kycDocumentFrontFileId"]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"platform":{"type":"string","example":"KYC Platform"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Passport"},"documentImage":{"type":"string","example":"https://example.com/passport.jpg"},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Document unclear"},"response":{"type":"string","nullable":true,"example":"Submitted clearer document"}},"required":["id","createdAt","updatedAt","deletedAt","tid","platform","individualId","documentType","documentImage","kycStatus","reason","response"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]},"patch":{"summary":"Update KYC record for individual","tags":["kyc"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"updateKyc","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"kycFirstName":{"type":"string","minLength":2,"maxLength":150,"example":"John"},"kycLastName":{"type":"string","minLength":2,"maxLength":150,"example":"Doe"},"kycDocumentType":{"type":"string","enum":["PASSPORT","DRIVER_LICENSE","STATE_ID"],"example":"DRIVER_LICENSE"},"kycDocumentId":{"type":"string","minLength":4,"maxLength":50,"example":"D1234567"},"kycDocumentIssuer":{"type":"string","enum":["AL","AK","AZ","AR","CA","CO","CT","DE","FL","GA","HI","ID","IL","IN","IA","KS","KY","LA","ME","MD","MA","MI","MN","MS","MO","MT","NE","NV","NH","NJ","NM","NY","NC","ND","OH","OK","OR","PA","RI","SC","SD","TN","TX","UT","VT","VA","WA","WV","WI","WY","AD","AE","AF","AG","AI","AM","AO","AQ","AS","AT","AU","AW","AX","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BL","BM","BN","BO","BQ","BR","BS","BT","BV","BW","BY","BZ","CC","CD","CF","CG","CH","CI","CK","CL","CM","CN","CR","CU","CV","CW","CX","CY","CZ","DJ","DK","DM","DO","DZ","EC","EE","EG","EH","ER","ES","ET","FI","FJ","FK","FM","FO","FR","GB","GD","GE","GF","GG","GH","GI","GL","GM","GN","GP","GQ","GR","GS","GT","GU","GW","GY","HK","HM","HN","HR","HT","HU","IE","IM","IO","IQ","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KZ","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MC","MF","MG","MH","MK","ML","MM","MP","MQ","MR","MU","MV","MW","MX","MY","MZ","NA","NF","NG","NI","NL","NO","NP","NR","NU","NZ","OM","PE","PF","PG","PH","PK","PL","PM","PN","PR","PS","PT","PW","PY","QA","RE","RO","RS","RU","RW","SA","SB","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","SZ","TC","TD","TF","TG","TH","TJ","TK","TL","TM","TO","TR","TT","TV","TW","TZ","UA","UG","UM","US","UY","UZ","VC","VE","VG","VI","VN","VU","WF","WS","YE","YT","ZA","ZM","ZW"],"example":"CA"},"kycDocumentIssuedDate":{"type":"string","nullable":true,"example":"01/15/2020"},"kycDocumentExpirationDate":{"type":"string","nullable":true,"example":"01/15/2030"},"kycDocumentDob":{"type":"string","nullable":true,"example":"05/20/1990"},"kycProvider":{"type":"string","enum":["WITH_PERSONA"]},"kycLog":{"type":"string","example":"{\"review\":\"Approved\",\"inquiry_id\":\"inq_123\"}"},"kycDocumentFrontFileId":{"example":"file_01j5y5ghx8fvc83dmx3pznq7hv"},"kycDocumentBackFileId":{"example":"file_01j5y5ghx8fvc83dmx3pznq7hv"},"kycSelfieFileId":{"example":"file_01j5y5ghx8fvc83dmx3pznq7hv"}}}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"tid":{"type":"string","example":"third_party_kyc_123","nullable":true},"platform":{"type":"string","example":"KYC Platform"},"individualId":{"type":"string","example":"individual_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Passport"},"documentImage":{"type":"string","example":"https://example.com/passport.jpg"},"kycStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","CANCELLED","RESUBMIT","ERROR"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Document unclear"},"response":{"type":"string","nullable":true,"example":"Submitted clearer document"}},"required":["id","createdAt","updatedAt","deletedAt","tid","platform","individualId","documentType","documentImage","kycStatus","reason","response"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/legal-entities/":{"post":{"summary":"Create Legal Entity","tags":["legalEntities"],"parameters":[],"operationId":"createLegalEntity","requestBody":{"description":"Body","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"investorAccountId":{"type":"string"},"name":{"type":"string","minLength":2,"maxLength":50},"ein":{"type":"string","minLength":9,"maxLength":9},"email":{"type":"string","format":"email","example":"john.doe@example.com"},"companyType":{"type":"string","minLength":2,"maxLength":50},"phone":{"type":"string","nullable":true,"example":"+12124567890"},"dateOfIncorporation":{"nullable":true},"stateOfIncorporation":{"type":"string","enum":["AL","AK","AZ","AR","CA","CO","CT","DE","FL","GA","HI","ID","IL","IN","IA","KS","KY","LA","ME","MD","MA","MI","MN","MS","MO","MT","NE","NV","NH","NJ","NM","NY","NC","ND","OH","OK","OR","PA","RI","SC","SD","TN","TX","UT","VT","VA","WA","WV","WI","WY"],"example":"CA"}},"required":["investorAccountId","name"]},{"allOf":[{"allOf":[{"type":"object","properties":{"address":{"type":"string","minLength":2,"nullable":true},"address2":{"type":"string","nullable":true},"city":{"type":"string","minLength":2,"maxLength":30,"nullable":true}}},{"type":"object","properties":{"country":{"type":"string","enum":["AD","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","CU","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","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","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","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","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","YE","YT","ZA","ZM","ZW"],"nullable":true},"state":{"type":"string","nullable":true}}}]},{"type":"object","properties":{"country":{"type":"string","enum":["AD","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","CU","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","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","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","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","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","YE","YT","ZA","ZM","ZW"],"nullable":true},"zip":{"type":"string","nullable":true}}}]}]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"accountId":{"type":"string"},"investorAccountId":{"type":"string"},"name":{"type":"string","minLength":2,"maxLength":50},"ein":{"type":"string","minLength":9,"maxLength":9,"nullable":true},"email":{"type":"string","format":"email","nullable":true},"companyType":{"type":"string","nullable":true},"address":{"type":"string","nullable":true},"address2":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"state":{"type":"string","nullable":true},"zip":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true},"dateOfIncorporation":{"type":"string","format":"date-time","nullable":true},"stateOfIncorporation":{"type":"string","nullable":true},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]}},"required":["id","accountId","investorAccountId","name","email","companyType","address","address2","city","state","zip","country","phone","dateOfIncorporation","stateOfIncorporation","setupStatus"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]},"get":{"summary":"Get legalEntities","tags":["legalEntities"],"parameters":[{"name":"page","in":"query","schema":{"default":1,"type":"number","nullable":true}},{"name":"limit","in":"query","schema":{"default":10,"type":"number","nullable":true}},{"name":"kybStatus","in":"query","schema":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"]}},{"name":"sanctionsStatus","in":"query","schema":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"]}},{"name":"include","in":"query","schema":{"type":"string","example":"kybs"}}],"operationId":"getLegalEntities","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_legal_entity_123","nullable":true},"accountId":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6"},"investorAccountId":{"type":"string","example":"investor_account_01j1xgme5qeqq97gpdztd7e4a7"},"kybStatus":{"example":"PENDING"},"sanctionsStatus":{"example":"PENDING"},"kybs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_kyb_123"},"platform":{"type":"string","example":"KYB Platform"},"legalEntityId":{"type":"string","example":"legal_entity_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Certificate of Incorporation"},"documentImage":{"type":"string","example":"https://example.com/document.pdf"},"kybStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Additional information required"},"response":{"type":"string","nullable":true,"example":"Submitted additional documents"}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","platform","legalEntityId","documentType","documentImage","kybStatus","reason","response"]}},"name":{"type":"string","example":"Acme Corporation"},"ein":{"type":"string","example":"12-3456789","nullable":true},"companyType":{"type":"string","example":"LLC","nullable":true},"streetAddress":{"type":"string","example":"123 Main St","nullable":true},"city":{"type":"string","example":"Anytown","nullable":true},"state":{"type":"string","example":"CA","nullable":true},"zip":{"type":"string","example":"12345","nullable":true},"country":{"type":"string","example":"USA","nullable":true},"phone":{"type":"string","example":"+12124567890","nullable":true},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","accountId","investorAccountId","kybStatus","sanctionsStatus","name","state","setupStatus"]}},"meta":{"type":"object","properties":{"itemCount":{"type":"number","example":1},"totalItems":{"type":"number","example":10},"itemsPerPage":{"type":"number","example":1},"totalPages":{"type":"number","example":10},"currentPage":{"type":"number","example":1}},"required":["itemCount","itemsPerPage","currentPage"]}},"required":["items","meta"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/legal-entities/{id}":{"patch":{"summary":"Update Legal Entity","tags":["legalEntities"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"updateLegalEntity","requestBody":{"description":"Body","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","minLength":2,"maxLength":50},"ein":{"type":"string","minLength":9,"maxLength":9},"email":{"type":"string","format":"email","example":"john.doe@example.com"},"companyType":{"type":"string","minLength":2,"maxLength":50},"phone":{"type":"string","nullable":true,"example":"+12124567890"},"dateOfIncorporation":{"nullable":true},"stateOfIncorporation":{"type":"string"}}},{"allOf":[{"allOf":[{"type":"object","properties":{"address":{"type":"string","minLength":2,"nullable":true},"address2":{"type":"string","nullable":true},"city":{"type":"string","minLength":2,"maxLength":30,"nullable":true}}},{"type":"object","properties":{"country":{"type":"string","enum":["AD","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","CU","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","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","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","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","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","YE","YT","ZA","ZM","ZW"],"nullable":true},"state":{"type":"string","nullable":true}}}]},{"type":"object","properties":{"country":{"type":"string","enum":["AD","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","CU","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","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","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","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","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","YE","YT","ZA","ZM","ZW"],"nullable":true},"zip":{"type":"string","nullable":true}}}]}]}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"accountId":{"type":"string"},"investorAccountId":{"type":"string"},"name":{"type":"string","minLength":2,"maxLength":50},"ein":{"type":"string","minLength":9,"maxLength":9,"nullable":true},"email":{"type":"string","format":"email","nullable":true},"companyType":{"type":"string","nullable":true},"address":{"type":"string","nullable":true},"address2":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"state":{"type":"string","nullable":true},"zip":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true},"dateOfIncorporation":{"type":"string","format":"date-time","nullable":true},"stateOfIncorporation":{"type":"string","nullable":true},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]}},"required":["id","accountId","investorAccountId","name","email","companyType","address","address2","city","state","zip","country","phone","dateOfIncorporation","stateOfIncorporation","setupStatus"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]},"get":{"summary":"Get legalEntity by id","tags":["legalEntities"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"include","in":"query","schema":{"type":"string","example":"kybs"}}],"operationId":"getLegalEntity","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_legal_entity_123","nullable":true},"accountId":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6"},"investorAccountId":{"type":"string","example":"investor_account_01j1xgme5qeqq97gpdztd7e4a7"},"kybStatus":{"example":"PENDING"},"sanctionsStatus":{"example":"PENDING"},"kybs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"thirdPartyId":{"type":"string","example":"third_party_kyb_123"},"platform":{"type":"string","example":"KYB Platform"},"legalEntityId":{"type":"string","example":"legal_entity_01j1xgme5qeqq97gpdztd7e4a6"},"documentType":{"type":"string","example":"Certificate of Incorporation"},"documentImage":{"type":"string","example":"https://example.com/document.pdf"},"kybStatus":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED"],"example":"PENDING"},"reason":{"type":"string","nullable":true,"example":"Additional information required"},"response":{"type":"string","nullable":true,"example":"Submitted additional documents"}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","platform","legalEntityId","documentType","documentImage","kybStatus","reason","response"]}},"name":{"type":"string","example":"Acme Corporation"},"ein":{"type":"string","example":"12-3456789","nullable":true},"companyType":{"type":"string","example":"LLC","nullable":true},"streetAddress":{"type":"string","example":"123 Main St","nullable":true},"city":{"type":"string","example":"Anytown","nullable":true},"state":{"type":"string","example":"CA","nullable":true},"zip":{"type":"string","example":"12345","nullable":true},"country":{"type":"string","example":"USA","nullable":true},"phone":{"type":"string","example":"+12124567890","nullable":true},"setupStatus":{"type":"string","enum":["IN_PROGRESS","COMPLETE"]}},"required":["id","createdAt","updatedAt","deletedAt","thirdPartyId","accountId","investorAccountId","kybStatus","sanctionsStatus","name","state","setupStatus"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/offerings":{"get":{"summary":"Get offerings","tags":["offerings"],"parameters":[{"name":"page","in":"query","schema":{"default":1,"type":"number","nullable":true}},{"name":"limit","in":"query","schema":{"default":10,"type":"number","nullable":true}},{"name":"include","in":"query","schema":{"type":"string","example":"account,issuer,trades,assets,disbursements,draftVersion,publishedVersion,revisions,onboardingReviewedBy,bankAccount,escrowAccount,shareClass"}},{"name":"issuerName","in":"query","schema":{"type":"string"}},{"name":"name","in":"query","schema":{"type":"string"}},{"name":"accountId","in":"query","schema":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6","accountId":"account_00041061050r3gg28a1c60t3gf"}},{"name":"issuerId","in":"query","schema":{}},{"name":"type","in":"query","schema":{"type":"string","enum":["REG_A","REG_CF","REG_D","S1","EXCHANGE_NOTE"]}},{"name":"status","in":"query","schema":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"]}},{"name":"enabled","in":"query","schema":{"type":"boolean"}},{"name":"managedBy","in":"query","schema":{"type":"string","enum":["DALMORE","ISSUER"]}},{"name":"versioningType","in":"query","schema":{"type":"string","enum":["PUBLISHED","DRAFT"]}},{"name":"onboardingStatus","in":"query","schema":{"type":"string","enum":["IN_REVIEW","COMPLETED"]}},{"name":"complianceReview","in":"query","schema":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"]}}],"operationId":"getOfferings","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"name":{"type":"string"},"tid":{"type":"string","nullable":true},"type":{"type":"string","enum":["REG_A","REG_CF","REG_D","S1","EXCHANGE_NOTE"],"nullable":true},"description":{"type":"string","nullable":true},"raiseAmount":{"type":"number","nullable":true},"targetAmount":{"type":"number","nullable":true},"minInvestment":{"type":"number","nullable":true},"maxInvestment":{"type":"number","nullable":true},"contingencyAmount":{"type":"number","nullable":true},"startAt":{"type":"string","format":"date-time","nullable":true},"endAt":{"type":"string","format":"date-time","nullable":true},"platform":{"type":"string"},"platformSettings":{"type":"string","nullable":true},"enabled":{"type":"boolean"},"accountId":{"type":"string","nullable":true},"account":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"name":{"type":"string","example":"Dalmore"},"status":{"type":"string","enum":["ONBOARDING","LIVE","OVERDUE","SUSPENDED","INACTIVE"],"example":"LIVE"},"managedBy":{"type":"string","enum":["DALMORE","ISSUER"],"nullable":true,"example":"DALMORE"},"platform":{"type":"string","enum":["DALMORE","IMPORT"],"example":"IMPORT"},"onboardingReviewerId":{"type":"string","nullable":true,"example":"user_01j1xgme5mfrasd02hmfwsy13a"},"onboardingReviewAt":{"type":"string","format":"date-time","nullable":true},"allowPendingComplianceReview":{"type":"boolean","example":false}},"required":["id","createdAt","updatedAt","deletedAt","name","status","managedBy","platform","onboardingReviewerId","onboardingReviewAt","allowPendingComplianceReview"],"nullable":true},"issuer":{"nullable":true},"issuerId":{"type":"string","nullable":true},"coverArtId":{"nullable":true},"coverArt":{"nullable":true},"cancellationPeriod":{"type":"number","nullable":true},"memorandumId":{"nullable":true},"subscriptionAgreementId":{"nullable":true},"managedBy":{"type":"string","enum":["DALMORE","ISSUER"],"nullable":true},"valuationCap":{"type":"number","nullable":true},"showTotalRaised":{"type":"boolean"},"hasEscrow":{"type":"boolean"},"escrowAgreementFileId":{"type":"string","nullable":true},"bankAccountId":{"type":"string","nullable":true},"bankAccount":{"nullable":true},"escrowAccountId":{"type":"string","nullable":true},"escrowAccount":{"nullable":true},"warrantsEnabled":{"type":"boolean"},"totalShares":{"type":"number","nullable":true},"warrantTermYears":{"type":"number","nullable":true},"exercisePrice":{"type":"number","nullable":true},"warrantPercentage":{"type":"number","nullable":true},"calculationMethod":{"type":"string","enum":["NONE","PRORATA","INCREMENT"],"nullable":true},"incrementThreshold":{"type":"number","nullable":true},"fullyDilutedShares":{"type":"number","nullable":true},"shareClassId":{"type":"string","nullable":true},"soldOut":{"type":"boolean"}},"required":["id","createdAt","updatedAt","deletedAt","name","tid","type","description","raiseAmount","targetAmount","minInvestment","maxInvestment","contingencyAmount","startAt","endAt","platform","platformSettings","enabled","accountId","issuerId","coverArt","cancellationPeriod","managedBy","valuationCap"]}},"meta":{"type":"object","properties":{"itemCount":{"type":"number","example":1},"totalItems":{"type":"number","example":10},"itemsPerPage":{"type":"number","example":1},"totalPages":{"type":"number","example":10},"currentPage":{"type":"number","example":1}},"required":["itemCount","itemsPerPage","currentPage"]}},"required":["items","meta"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]},"post":{"summary":"[ADMIN] Create offering","tags":["offerings"],"parameters":[],"operationId":"postOffering","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"issuerId":{"type":"string","example":"issuer_01jdq2crwke8xskjd840cj79pw"},"shareClassId":{"nullable":true,"example":"cap_table_share_class_01j1xgme..."},"name":{"type":"string","minLength":2,"maxLength":150,"example":"Airbnb IPO"},"type":{"type":"string","enum":["REG_A","REG_CF","REG_D","S1","EXCHANGE_NOTE"],"example":"REG_D"},"targetAmount":{"type":"number","minimum":0.01,"maximum":10000000000,"example":120000},"raiseAmount":{"type":"number","minimum":0,"maximum":10000000000,"example":200000},"minInvestment":{"type":"number","minimum":0,"maximum":10000000000,"example":1000},"maxInvestment":{"type":"number","minimum":0,"maximum":10000000000,"example":20000},"contingencyAmount":{"type":"number","minimum":0,"maximum":10000000000,"example":5000},"startAt":{"type":"string","nullable":true,"example":"10/20/2024"},"endAt":{"type":"string","nullable":true,"example":"10/27/2024"},"active":{"type":"boolean","example":true},"cancellationPeriod":{"type":"number","minimum":1,"maximum":30,"example":4,"nullable":true},"description":{"nullable":true},"managedBy":{"type":"string","enum":["DALMORE","ISSUER"]},"assetName":{"type":"string","minLength":2,"maxLength":50,"example":"Asset name"},"assetType":{"type":"string","enum":["BOND","STOCK","PROMISSORY_NOTE"],"example":"STOCK"},"pricePerUnit":{"type":"number","minimum":0.01,"maximum":10000000000,"nullable":true,"example":2000},"totalUnits":{"type":"number","minimum":1,"maximum":10000000000,"nullable":true,"example":5200},"yield":{"type":"number","minimum":0.01,"maximum":10000000000,"nullable":true,"example":1200},"duration":{"type":"number","minimum":1,"maximum":1000,"nullable":true,"example":1},"durationType":{"type":"string","enum":["DAYS","WEEKS","MONTHS","YEARS"],"nullable":true,"example":"DAYS"},"template":{"default":"STANDARD","type":"string","enum":["STANDARD","TIERED"],"example":"STANDARD"},"tiers":{"type":"array","items":{"type":"number","minimum":0,"exclusiveMinimum":0},"nullable":true},"enableBonus":{"default":false,"type":"boolean"},"hasEscrow":{"type":"boolean"},"bankAccountId":{"nullable":true},"escrowAccountId":{"nullable":true},"interestRate":{"type":"number","minimum":0.01,"maximum":100,"nullable":true,"example":10},"bonusTiers":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["PERCENTAGE","FIXED"],"example":"PERCENTAGE"},"value":{"type":"number","minimum":0,"exclusiveMinimum":0,"maximum":1000000,"example":50},"startAmount":{"type":"number","minimum":0,"exclusiveMinimum":0,"maximum":999999999,"example":100},"endAmount":{"type":"number","minimum":0,"exclusiveMinimum":0,"maximum":999999999,"example":200}},"required":["type","value","startAmount","endAmount"]}},"warrantsEnabled":{"default":false,"type":"boolean","example":false},"totalShares":{"type":"integer","minimum":0,"exclusiveMinimum":0,"maximum":10000000000,"nullable":true,"example":1000},"warrantTermYears":{"type":"integer","minimum":0,"exclusiveMinimum":0,"maximum":10000000000,"nullable":true,"example":10},"exercisePrice":{"type":"number","minimum":0.01,"maximum":10000000000,"nullable":true,"example":100},"warrantPercentage":{"type":"number","minimum":0,"exclusiveMinimum":0,"maximum":100,"nullable":true,"example":10},"calculationMethod":{"type":"string","enum":["NONE","PRORATA","INCREMENT"],"nullable":true,"example":"NONE"},"incrementThreshold":{"type":"number","minimum":0.01,"maximum":10000000000,"nullable":true,"example":10},"showTotalRaised":{"default":true,"type":"boolean"}},"required":["issuerId","name","type","targetAmount","assetName","assetType","pricePerUnit","totalUnits"]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"name":{"type":"string"},"tid":{"type":"string","nullable":true},"type":{"type":"string","enum":["REG_A","REG_CF","REG_D","S1","EXCHANGE_NOTE"],"nullable":true},"description":{"type":"string","nullable":true},"raiseAmount":{"type":"number","nullable":true},"targetAmount":{"type":"number","nullable":true},"minInvestment":{"type":"number","nullable":true},"maxInvestment":{"type":"number","nullable":true},"contingencyAmount":{"type":"number","nullable":true},"startAt":{"type":"string","format":"date-time","nullable":true},"endAt":{"type":"string","format":"date-time","nullable":true},"platform":{"type":"string"},"platformSettings":{"type":"string","nullable":true},"enabled":{"type":"boolean"},"accountId":{"type":"string","nullable":true},"account":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"name":{"type":"string","example":"Dalmore"},"status":{"type":"string","enum":["ONBOARDING","LIVE","OVERDUE","SUSPENDED","INACTIVE"],"example":"LIVE"},"managedBy":{"type":"string","enum":["DALMORE","ISSUER"],"nullable":true,"example":"DALMORE"},"platform":{"type":"string","enum":["DALMORE","IMPORT"],"example":"IMPORT"},"onboardingReviewerId":{"type":"string","nullable":true,"example":"user_01j1xgme5mfrasd02hmfwsy13a"},"onboardingReviewAt":{"type":"string","format":"date-time","nullable":true},"allowPendingComplianceReview":{"type":"boolean","example":false}},"required":["id","createdAt","updatedAt","deletedAt","name","status","managedBy","platform","onboardingReviewerId","onboardingReviewAt","allowPendingComplianceReview"],"nullable":true},"issuer":{"nullable":true},"issuerId":{"type":"string","nullable":true},"coverArtId":{"nullable":true},"coverArt":{"nullable":true},"cancellationPeriod":{"type":"number","nullable":true},"memorandumId":{"nullable":true},"subscriptionAgreementId":{"nullable":true},"managedBy":{"type":"string","enum":["DALMORE","ISSUER"],"nullable":true},"valuationCap":{"type":"number","nullable":true},"showTotalRaised":{"type":"boolean"},"hasEscrow":{"type":"boolean"},"escrowAgreementFileId":{"type":"string","nullable":true},"bankAccountId":{"type":"string","nullable":true},"bankAccount":{"nullable":true},"escrowAccountId":{"type":"string","nullable":true},"escrowAccount":{"nullable":true},"warrantsEnabled":{"type":"boolean"},"totalShares":{"type":"number","nullable":true},"warrantTermYears":{"type":"number","nullable":true},"exercisePrice":{"type":"number","nullable":true},"warrantPercentage":{"type":"number","nullable":true},"calculationMethod":{"type":"string","enum":["NONE","PRORATA","INCREMENT"],"nullable":true},"incrementThreshold":{"type":"number","nullable":true},"fullyDilutedShares":{"type":"number","nullable":true},"shareClassId":{"type":"string","nullable":true},"soldOut":{"type":"boolean"}},"required":["id","createdAt","updatedAt","deletedAt","name","tid","type","description","raiseAmount","targetAmount","minInvestment","maxInvestment","contingencyAmount","startAt","endAt","platform","platformSettings","enabled","accountId","issuerId","coverArt","cancellationPeriod","managedBy","valuationCap"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/offerings/summary":{"get":{"summary":"Get offerings summary","tags":["offerings"],"parameters":[{"name":"page","in":"query","schema":{"default":1,"type":"number","nullable":true}},{"name":"limit","in":"query","schema":{"default":10,"type":"number","nullable":true}},{"name":"accountId","in":"query","schema":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6","accountId":"account_00041061050r3gg28a1c60t3gf"}},{"name":"hasPendingTrades","in":"query","schema":{"type":"boolean","nullable":true}}],"operationId":"getOfferingsSummary","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"account":{"type":"object","properties":{"id":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6","accountId":"account_00041061050r3gg28a1c60t3gf"},"name":{"type":"string"}},"required":["id","name"]},"trades":{"type":"object","properties":{"total":{"type":"number"},"tradeReview":{"type":"number"},"readyForDisbursement":{"type":"number"}},"required":["total","tradeReview","readyForDisbursement"]}},"required":["id","name","account","trades"]}},"meta":{"type":"object","properties":{"itemCount":{"type":"number","example":1},"totalItems":{"type":"number","example":10},"itemsPerPage":{"type":"number","example":1},"totalPages":{"type":"number","example":10},"currentPage":{"type":"number","example":1}},"required":["itemCount","itemsPerPage","currentPage"]}},"required":["items","meta"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/offerings/{id}":{"get":{"summary":"Get offering by id","tags":["offerings"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"include","in":"query","schema":{"type":"string","example":"account,issuer,trades,assets,disbursements,draftVersion,publishedVersion,revisions,onboardingReviewedBy,bankAccount,escrowAccount,shareClass"}}],"operationId":"getOffering","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"name":{"type":"string"},"tid":{"type":"string","nullable":true},"type":{"type":"string","enum":["REG_A","REG_CF","REG_D","S1","EXCHANGE_NOTE"],"nullable":true},"description":{"type":"string","nullable":true},"raiseAmount":{"type":"number","nullable":true},"targetAmount":{"type":"number","nullable":true},"minInvestment":{"type":"number","nullable":true},"maxInvestment":{"type":"number","nullable":true},"contingencyAmount":{"type":"number","nullable":true},"startAt":{"type":"string","format":"date-time","nullable":true},"endAt":{"type":"string","format":"date-time","nullable":true},"platform":{"type":"string"},"platformSettings":{"type":"string","nullable":true},"enabled":{"type":"boolean"},"accountId":{"type":"string","nullable":true},"account":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"name":{"type":"string","example":"Dalmore"},"status":{"type":"string","enum":["ONBOARDING","LIVE","OVERDUE","SUSPENDED","INACTIVE"],"example":"LIVE"},"managedBy":{"type":"string","enum":["DALMORE","ISSUER"],"nullable":true,"example":"DALMORE"},"platform":{"type":"string","enum":["DALMORE","IMPORT"],"example":"IMPORT"},"onboardingReviewerId":{"type":"string","nullable":true,"example":"user_01j1xgme5mfrasd02hmfwsy13a"},"onboardingReviewAt":{"type":"string","format":"date-time","nullable":true},"allowPendingComplianceReview":{"type":"boolean","example":false}},"required":["id","createdAt","updatedAt","deletedAt","name","status","managedBy","platform","onboardingReviewerId","onboardingReviewAt","allowPendingComplianceReview"],"nullable":true},"issuer":{"nullable":true},"issuerId":{"type":"string","nullable":true},"coverArtId":{"nullable":true},"coverArt":{"nullable":true},"cancellationPeriod":{"type":"number","nullable":true},"memorandumId":{"nullable":true},"subscriptionAgreementId":{"nullable":true},"managedBy":{"type":"string","enum":["DALMORE","ISSUER"],"nullable":true},"valuationCap":{"type":"number","nullable":true},"showTotalRaised":{"type":"boolean"},"hasEscrow":{"type":"boolean"},"escrowAgreementFileId":{"type":"string","nullable":true},"bankAccountId":{"type":"string","nullable":true},"bankAccount":{"nullable":true},"escrowAccountId":{"type":"string","nullable":true},"escrowAccount":{"nullable":true},"warrantsEnabled":{"type":"boolean"},"totalShares":{"type":"number","nullable":true},"warrantTermYears":{"type":"number","nullable":true},"exercisePrice":{"type":"number","nullable":true},"warrantPercentage":{"type":"number","nullable":true},"calculationMethod":{"type":"string","enum":["NONE","PRORATA","INCREMENT"],"nullable":true},"incrementThreshold":{"type":"number","nullable":true},"fullyDilutedShares":{"type":"number","nullable":true},"shareClassId":{"type":"string","nullable":true},"soldOut":{"type":"boolean"}},"required":["id","createdAt","updatedAt","deletedAt","name","tid","type","description","raiseAmount","targetAmount","minInvestment","maxInvestment","contingencyAmount","startAt","endAt","platform","platformSettings","enabled","accountId","issuerId","coverArt","cancellationPeriod","managedBy","valuationCap"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]},"patch":{"summary":"Update offering by id","tags":["offerings"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"patchOffering","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"shareClassId":{"nullable":true,"example":"cap_table_share_class_01j1xgme..."},"name":{"type":"string","minLength":2,"maxLength":150,"example":"Airbnb IPO"},"type":{"type":"string","enum":["REG_A","REG_CF","REG_D","S1","EXCHANGE_NOTE"],"example":"REG_D"},"targetAmount":{"type":"number","minimum":0,"maximum":10000000000,"example":120000},"minInvestment":{"type":"number","minimum":0,"maximum":10000000000,"nullable":true,"example":1000},"maxInvestment":{"type":"number","minimum":0,"maximum":10000000000,"nullable":true,"example":20000},"contingencyAmount":{"type":"number","minimum":0,"maximum":10000000000,"nullable":true,"example":5000},"startAt":{"type":"string","nullable":true,"example":"10/20/2024"},"endAt":{"type":"string","nullable":true,"example":"10/27/2024"},"cancellationPeriod":{"type":"number","minimum":1,"maximum":30,"example":4,"nullable":true},"description":{"nullable":true},"memorandumId":{"nullable":true},"subscriptionAgreementId":{"nullable":true},"coverArtId":{"nullable":true},"showTotalRaised":{"type":"boolean"},"issuerId":{"type":"string","example":"issuer_01jdq2crwke8xskjd840cj79pw"},"assetName":{"type":"string","minLength":2,"maxLength":50,"example":"Z"},"assetType":{"type":"string","enum":["BOND","STOCK","PROMISSORY_NOTE"],"example":"STOCK"},"pricePerUnit":{"type":"number","minimum":0.01,"maximum":10000000000,"nullable":true,"example":2000},"totalUnits":{"type":"number","minimum":1,"maximum":10000000000,"nullable":true,"example":5200},"yield":{"type":"number","minimum":0.01,"maximum":10000000000,"nullable":true,"example":1200},"duration":{"type":"number","minimum":1,"maximum":1000,"nullable":true,"example":1},"durationType":{"type":"string","enum":["DAYS","WEEKS","MONTHS","YEARS"],"nullable":true,"example":"DAYS"},"template":{"default":"STANDARD","type":"string","enum":["STANDARD","TIERED"],"example":"STANDARD","nullable":true},"tiers":{"type":"array","items":{"type":"number","minimum":0,"exclusiveMinimum":0},"nullable":true},"enabled":{"type":"boolean"},"enableBonus":{"type":"boolean"},"hasEscrow":{"type":"boolean"},"escrowAgreementFileId":{"nullable":true},"bankAccountId":{"nullable":true},"escrowAccountId":{"nullable":true},"interestRate":{"type":"number","minimum":0.01,"maximum":100,"nullable":true,"example":10},"bonusTiers":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["PERCENTAGE","FIXED"],"example":"PERCENTAGE"},"value":{"type":"number","minimum":0,"exclusiveMinimum":0,"maximum":1000000,"example":50},"startAmount":{"type":"number","minimum":0,"exclusiveMinimum":0,"maximum":999999999,"example":100},"endAmount":{"type":"number","minimum":0,"exclusiveMinimum":0,"maximum":999999999,"example":200}},"required":["type","value","startAmount","endAmount"]}},"warrantsEnabled":{"type":"boolean","example":false},"totalShares":{"type":"integer","minimum":0,"exclusiveMinimum":0,"maximum":10000000000,"nullable":true,"example":1000},"warrantTermYears":{"type":"integer","minimum":0,"exclusiveMinimum":0,"maximum":10000000000,"nullable":true,"example":10},"exercisePrice":{"type":"number","minimum":0.01,"maximum":10000000000,"nullable":true,"example":100},"warrantPercentage":{"type":"number","minimum":0,"exclusiveMinimum":0,"maximum":100,"nullable":true,"example":10},"calculationMethod":{"type":"string","enum":["NONE","PRORATA","INCREMENT"],"nullable":true,"example":"NONE"},"incrementThreshold":{"type":"number","minimum":0.01,"maximum":10000000000,"nullable":true,"example":10}}}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"name":{"type":"string"},"tid":{"type":"string","nullable":true},"type":{"type":"string","enum":["REG_A","REG_CF","REG_D","S1","EXCHANGE_NOTE"],"nullable":true},"description":{"type":"string","nullable":true},"raiseAmount":{"type":"number","nullable":true},"targetAmount":{"type":"number","nullable":true},"minInvestment":{"type":"number","nullable":true},"maxInvestment":{"type":"number","nullable":true},"contingencyAmount":{"type":"number","nullable":true},"startAt":{"type":"string","format":"date-time","nullable":true},"endAt":{"type":"string","format":"date-time","nullable":true},"platform":{"type":"string"},"platformSettings":{"type":"string","nullable":true},"enabled":{"type":"boolean"},"accountId":{"type":"string","nullable":true},"account":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"name":{"type":"string","example":"Dalmore"},"status":{"type":"string","enum":["ONBOARDING","LIVE","OVERDUE","SUSPENDED","INACTIVE"],"example":"LIVE"},"managedBy":{"type":"string","enum":["DALMORE","ISSUER"],"nullable":true,"example":"DALMORE"},"platform":{"type":"string","enum":["DALMORE","IMPORT"],"example":"IMPORT"},"onboardingReviewerId":{"type":"string","nullable":true,"example":"user_01j1xgme5mfrasd02hmfwsy13a"},"onboardingReviewAt":{"type":"string","format":"date-time","nullable":true},"allowPendingComplianceReview":{"type":"boolean","example":false}},"required":["id","createdAt","updatedAt","deletedAt","name","status","managedBy","platform","onboardingReviewerId","onboardingReviewAt","allowPendingComplianceReview"],"nullable":true},"issuer":{"nullable":true},"issuerId":{"type":"string","nullable":true},"coverArtId":{"nullable":true},"coverArt":{"nullable":true},"cancellationPeriod":{"type":"number","nullable":true},"memorandumId":{"nullable":true},"subscriptionAgreementId":{"nullable":true},"managedBy":{"type":"string","enum":["DALMORE","ISSUER"],"nullable":true},"valuationCap":{"type":"number","nullable":true},"showTotalRaised":{"type":"boolean"},"hasEscrow":{"type":"boolean"},"escrowAgreementFileId":{"type":"string","nullable":true},"bankAccountId":{"type":"string","nullable":true},"bankAccount":{"nullable":true},"escrowAccountId":{"type":"string","nullable":true},"escrowAccount":{"nullable":true},"warrantsEnabled":{"type":"boolean"},"totalShares":{"type":"number","nullable":true},"warrantTermYears":{"type":"number","nullable":true},"exercisePrice":{"type":"number","nullable":true},"warrantPercentage":{"type":"number","nullable":true},"calculationMethod":{"type":"string","enum":["NONE","PRORATA","INCREMENT"],"nullable":true},"incrementThreshold":{"type":"number","nullable":true},"fullyDilutedShares":{"type":"number","nullable":true},"shareClassId":{"type":"string","nullable":true},"soldOut":{"type":"boolean"}},"required":["id","createdAt","updatedAt","deletedAt","name","tid","type","description","raiseAmount","targetAmount","minInvestment","maxInvestment","contingencyAmount","startAt","endAt","platform","platformSettings","enabled","accountId","issuerId","coverArt","cancellationPeriod","managedBy","valuationCap"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/payment-methods":{"get":{"summary":"Get payment methods for a user","tags":["paymentMethods"],"parameters":[{"name":"userId","in":"query","required":true,"schema":{"type":"string"}}],"operationId":"getPaymentMethods","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"paymentMethodType":{"type":"string","enum":["CREDIT_CARD","WIRE","ACH","BANK_ACCOUNT","CHECK","RETIREMENT"]},"paymentMethodProvider":{"type":"string","enum":["STRIPE","PLAID","OTHER"]},"status":{"type":"string","enum":["PENDING","VERIFIED","CANCELLED","ERRORED"]},"clientSecret":{"type":"string","nullable":true},"tid":{"type":"string","nullable":true},"name":{"type":"string"},"last4":{"type":"string","nullable":true},"brand":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"userId":{"type":"string","nullable":true}},"required":["id","paymentMethodType","paymentMethodProvider","status","clientSecret","tid","name","last4","brand","country","userId"]}}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]},"post":{"summary":"Create payment method for a user","tags":["paymentMethods"],"parameters":[{"name":"userId","in":"query","required":true,"schema":{"type":"string"}}],"operationId":"createPaymentMethod","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"paymentMethodType":{"type":"string","enum":["CREDIT_CARD","WIRE","ACH","BANK_ACCOUNT","CHECK","RETIREMENT"]},"paymentMethodProvider":{"type":"string","enum":["STRIPE","PLAID","OTHER"]},"status":{"type":"string","enum":["PENDING","VERIFIED","CANCELLED","ERRORED"]},"clientSecret":{"type":"string","minLength":1,"maxLength":255},"tid":{"type":"string"},"name":{"type":"string","minLength":2,"maxLength":30},"last4":{"type":"string","minLength":4,"maxLength":4},"brand":{"type":"string","minLength":2,"maxLength":30},"country":{"type":"string","enum":["AD","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","CU","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","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","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","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","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","YE","YT","ZA","ZM","ZW"]}},"required":["paymentMethodType","paymentMethodProvider","tid","name","last4"]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"paymentMethodType":{"type":"string","enum":["CREDIT_CARD","WIRE","ACH","BANK_ACCOUNT","CHECK","RETIREMENT"]},"paymentMethodProvider":{"type":"string","enum":["STRIPE","PLAID","OTHER"]},"status":{"type":"string","enum":["PENDING","VERIFIED","CANCELLED","ERRORED"]},"clientSecret":{"type":"string","nullable":true},"tid":{"type":"string","nullable":true},"name":{"type":"string"},"last4":{"type":"string","nullable":true},"brand":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"userId":{"type":"string","nullable":true}},"required":["id","paymentMethodType","paymentMethodProvider","status","clientSecret","tid","name","last4","brand","country","userId"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/payment-methods/intent":{"post":{"summary":"Create payment method setup intent for a user","tags":["paymentMethods"],"parameters":[{"name":"userId","in":"query","required":true,"schema":{"type":"string"}}],"operationId":"createSetupIntent","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"paymentMethodType":{"type":"string","enum":["card","us_bank_account","ach"]}},"required":["paymentMethodType"]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","enum":["setup_intent"]},"application":{"type":"string","nullable":true},"cancellation_reason":{"type":"string","nullable":true},"client_secret":{"type":"string"},"created":{"type":"number"},"customer":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"flow_directions":{"type":"string","nullable":true},"last_setup_error":{"type":"string","nullable":true},"latest_attempt":{"type":"string","nullable":true},"livemode":{"type":"boolean"},"mandate":{"type":"string","nullable":true},"metadata":{"type":"object","additionalProperties":{"nullable":true}},"next_action":{"type":"string","nullable":true},"on_behalf_of":{"type":"string","nullable":true},"payment_method":{"type":"string","nullable":true},"payment_method_options":{"type":"object","properties":{"card":{"type":"object","properties":{"mandate_options":{"type":"string","nullable":true},"network":{"type":"string","nullable":true},"request_three_d_secure":{"type":"string"}},"required":["mandate_options","network","request_three_d_secure"]}},"required":["card"]},"payment_method_types":{"type":"array","items":{"type":"string"}},"single_use_mandate":{"type":"string","nullable":true},"status":{"type":"string"},"usage":{"type":"string"}},"required":["id","object","application","cancellation_reason","client_secret","created","customer","description","flow_directions","last_setup_error","latest_attempt","livemode","mandate","metadata","next_action","on_behalf_of","payment_method","payment_method_options","payment_method_types","single_use_mandate","status","usage"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/review/kyc":{"post":{"summary":"Post KYC review for individuals","tags":["review"],"parameters":[{"name":"userId","in":"query","required":true,"schema":{"type":"string"}}],"operationId":"postReviewKyc","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"individualIds":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":100},"status":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","IN_REVIEW","ADDITIONAL_INFO","SUBMITTED","IN_PROGRESS","CANCELLED","SETTLED","REFUNDED","RESUBMIT","FUNDED","COMPLETED","SIGNED","DECLINED","CART","PLACED","NEEDS_INFO","NEEDS_PAYMENT_INFO","FUNDING","CHARGED","NEW","IMPORT_ERROR","ERROR","UPDATE_PAYMENT_METHOD","RE_SIGN","RESET_2FA","FORGOT_PASSWORD","RESET_PASSWORD","TWO_FACTOR_LOGIN","LOGIN","FAILED","AUTHORIZING","VALID","DELETED","REVOKED","WARNING","READY_TO_APPROVE","INCOMPLETE","RE_PROCESS","INVALID","NOT_PROCESSED","PROCESSING","PROCESSING_ERROR","REVIEW_ERROR","PROCESSED","SAVE","ACCEPTED","ONBOARDING","LIVE","OVERDUE","SUSPENDED","INACTIVE","PARTIALLY_REFUNDED","VOIDED","REFUND_INITIATED","REFUND_COMPLETED","REFUND_FAILED","VOID_INITIATED","VOID_COMPLETED","VOID_FAILED","RESTORE","JOIN","ACTIVE","LOCKED","ENABLED","DISABLED","PROCESSING_VOID","PROCESSING_REFUND","PAUSED","CLOSED"]}},"required":["individualIds","status"]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"individualsUpdated":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":100},"status":{"type":"string","enum":["NEEDS_REVIEW","PENDING","APPROVED","REJECTED","IN_REVIEW","ADDITIONAL_INFO","SUBMITTED","IN_PROGRESS","CANCELLED","SETTLED","REFUNDED","RESUBMIT","FUNDED","COMPLETED","SIGNED","DECLINED","CART","PLACED","NEEDS_INFO","NEEDS_PAYMENT_INFO","FUNDING","CHARGED","NEW","IMPORT_ERROR","ERROR","UPDATE_PAYMENT_METHOD","RE_SIGN","RESET_2FA","FORGOT_PASSWORD","RESET_PASSWORD","TWO_FACTOR_LOGIN","LOGIN","FAILED","AUTHORIZING","VALID","DELETED","REVOKED","WARNING","READY_TO_APPROVE","INCOMPLETE","RE_PROCESS","INVALID","NOT_PROCESSED","PROCESSING","PROCESSING_ERROR","REVIEW_ERROR","PROCESSED","SAVE","ACCEPTED","ONBOARDING","LIVE","OVERDUE","SUSPENDED","INACTIVE","PARTIALLY_REFUNDED","VOIDED","REFUND_INITIATED","REFUND_COMPLETED","REFUND_FAILED","VOID_INITIATED","VOID_COMPLETED","VOID_FAILED","RESTORE","JOIN","ACTIVE","LOCKED","ENABLED","DISABLED","PROCESSING_VOID","PROCESSING_REFUND","PAUSED","CLOSED"]},"reviewedBy":{"type":"string"},"targetObject":{"nullable":true}},"required":["individualsUpdated","status","reviewedBy"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/secure-request/":{"post":{"summary":"Create Secure Request","tags":["secureRequests"],"parameters":[],"operationId":"postSecureRequest","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"payload":{"type":"object","additionalProperties":{"nullable":true}},"template":{"type":"string","enum":["default","northcap"],"nullable":true,"description":"Template name"}},"required":["payload","template"]}}}},"responses":{"202":{"description":"202","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"payload":{"type":"object","additionalProperties":{"nullable":true}},"ipAddress":{"type":"string","nullable":true},"template":{"type":"string","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","payload","ipAddress","template"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}}}},"/clients/api/v1/sites/{id}":{"get":{"summary":"get site by id","tags":["sites"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"include","in":"query","schema":{"type":"string","example":"account"}},{"name":"url","in":"query","schema":{"type":"string"}},{"name":"accountId","in":"query","schema":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6","accountId":"account_00041061050r3gg28a1c60t3gf"}},{"name":"enabled","in":"query","schema":{"type":"boolean"}}],"operationId":"getSite","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"accountId":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6","accountId":"account_00041061050r3gg28a1c60t3gf","nullable":true},"account":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"name":{"type":"string","example":"Dalmore"},"status":{"type":"string","enum":["ONBOARDING","LIVE","OVERDUE","SUSPENDED","INACTIVE"],"example":"LIVE"},"managedBy":{"type":"string","enum":["DALMORE","ISSUER"],"nullable":true,"example":"DALMORE"},"platform":{"type":"string","enum":["DALMORE","IMPORT"],"example":"IMPORT"},"onboardingReviewerId":{"type":"string","nullable":true,"example":"user_01j1xgme5mfrasd02hmfwsy13a"},"onboardingReviewAt":{"type":"string","format":"date-time","nullable":true},"allowPendingComplianceReview":{"type":"boolean","example":false}},"required":["id","createdAt","updatedAt","deletedAt","name","status","managedBy","platform","onboardingReviewerId","onboardingReviewAt","allowPendingComplianceReview"],"nullable":true},"title":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"keywords":{"type":"string","nullable":true},"logo":{"nullable":true},"favicon":{"nullable":true},"backgroundImage":{"nullable":true},"domain":{"type":"string"},"customDomain":{"type":"string","nullable":true},"enabled":{"default":false,"type":"boolean"},"message":{"type":"string","nullable":true},"withPersonaThemeId":{"type":"string","nullable":true},"gaIds":{"type":"array","items":{"type":"string"},"nullable":true},"investorAccountTypes":{"type":"object","properties":{"individual":{"type":"boolean"},"joint":{"type":"boolean"},"entity":{"type":"boolean"},"retirement":{"type":"boolean"}},"required":["individual","joint","entity","retirement"],"nullable":true},"tagline":{"type":"string","nullable":true},"supportEmail":{"type":"string"},"senderEmail":{"type":"string"},"trackingPixelCode":{"type":"string","nullable":true},"conversionPixelCode":{"type":"string","nullable":true},"demoEmail":{"type":"string","nullable":true},"demoPassword":{"type":"string","nullable":true},"publicOfferings":{"default":false,"type":"boolean"},"publicPages":{"default":false,"type":"boolean"},"publicDataRooms":{"default":false,"type":"boolean"}},"required":["id","createdAt","updatedAt","deletedAt","accountId","title","description","keywords","logo","favicon","backgroundImage","domain","customDomain","message","withPersonaThemeId","gaIds","investorAccountTypes","tagline","supportEmail","senderEmail","trackingPixelCode","conversionPixelCode","demoEmail","demoPassword"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/sites/":{"get":{"summary":"query sites by url","tags":["sites"],"parameters":[{"name":"page","in":"query","schema":{"default":1,"type":"number","nullable":true}},{"name":"limit","in":"query","schema":{"default":10,"type":"number","nullable":true}},{"name":"url","in":"query","schema":{"type":"string"}},{"name":"accountId","in":"query","schema":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6","accountId":"account_00041061050r3gg28a1c60t3gf"}},{"name":"enabled","in":"query","schema":{"type":"boolean"}},{"name":"include","in":"query","schema":{"type":"string","example":"account"}}],"operationId":"getSites","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"accountId":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6","accountId":"account_00041061050r3gg28a1c60t3gf","nullable":true},"account":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"name":{"type":"string","example":"Dalmore"},"status":{"type":"string","enum":["ONBOARDING","LIVE","OVERDUE","SUSPENDED","INACTIVE"],"example":"LIVE"},"managedBy":{"type":"string","enum":["DALMORE","ISSUER"],"nullable":true,"example":"DALMORE"},"platform":{"type":"string","enum":["DALMORE","IMPORT"],"example":"IMPORT"},"onboardingReviewerId":{"type":"string","nullable":true,"example":"user_01j1xgme5mfrasd02hmfwsy13a"},"onboardingReviewAt":{"type":"string","format":"date-time","nullable":true},"allowPendingComplianceReview":{"type":"boolean","example":false}},"required":["id","createdAt","updatedAt","deletedAt","name","status","managedBy","platform","onboardingReviewerId","onboardingReviewAt","allowPendingComplianceReview"],"nullable":true},"title":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"keywords":{"type":"string","nullable":true},"logo":{"nullable":true},"favicon":{"nullable":true},"backgroundImage":{"nullable":true},"domain":{"type":"string"},"customDomain":{"type":"string","nullable":true},"enabled":{"default":false,"type":"boolean"},"message":{"type":"string","nullable":true},"withPersonaThemeId":{"type":"string","nullable":true},"gaIds":{"type":"array","items":{"type":"string"},"nullable":true},"investorAccountTypes":{"type":"object","properties":{"individual":{"type":"boolean"},"joint":{"type":"boolean"},"entity":{"type":"boolean"},"retirement":{"type":"boolean"}},"required":["individual","joint","entity","retirement"],"nullable":true},"tagline":{"type":"string","nullable":true},"supportEmail":{"type":"string"},"senderEmail":{"type":"string"},"trackingPixelCode":{"type":"string","nullable":true},"conversionPixelCode":{"type":"string","nullable":true},"demoEmail":{"type":"string","nullable":true},"demoPassword":{"type":"string","nullable":true},"publicOfferings":{"default":false,"type":"boolean"},"publicPages":{"default":false,"type":"boolean"},"publicDataRooms":{"default":false,"type":"boolean"}},"required":["id","createdAt","updatedAt","deletedAt","accountId","title","description","keywords","logo","favicon","backgroundImage","domain","customDomain","message","withPersonaThemeId","gaIds","investorAccountTypes","tagline","supportEmail","senderEmail","trackingPixelCode","conversionPixelCode","demoEmail","demoPassword"]}},"meta":{"type":"object","properties":{"itemCount":{"type":"number","example":1},"totalItems":{"type":"number","example":10},"itemsPerPage":{"type":"number","example":1},"totalPages":{"type":"number","example":10},"currentPage":{"type":"number","example":1}},"required":["itemCount","itemsPerPage","currentPage"]}},"required":["items","meta"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/trade-line-items/":{"post":{"summary":"Create Trade Line Item","tags":["tradeLineItems"],"parameters":[{"name":"reset","in":"query","schema":{"default":"false","type":"string"}},{"name":"userId","in":"query","required":true,"schema":{"type":"string"}}],"operationId":"postTradeLineItem","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"assetId":{"type":"string","example":"asset_00041061050r3gg28a1c60t3gf"},"quantity":{"type":"number","minimum":0,"maximum":1000000000}},"required":["assetId","quantity"]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"assetName":{"type":"string","nullable":true},"total":{"type":"number"},"pricePerShare":{"type":"number"},"id":{"type":"string","example":"trade_line_item_01kctsycw3fq7sj6hedvy62cja"},"quantity":{"type":"number"}},"required":["assetName","total","pricePerShare","id","quantity"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/trade-line-items/{id}":{"patch":{"summary":"Update Trade Line Item - Can delete if you pass quantity = 0","tags":["tradeLineItems"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","example":"trade_line_item_01kctsycw3fq7sj6hedvy62cja"}}],"operationId":"updateTradeLineItem","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"trade_line_item_01kctsycw3fq7sj6hedvy62cja"},"quantity":{"type":"number","minimum":0,"maximum":1000000000}},"required":["quantity"]}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"assetName":{"type":"string","nullable":true},"total":{"type":"number"},"pricePerShare":{"type":"number"},"id":{"type":"string","example":"trade_line_item_01kctsycw3fq7sj6hedvy62cja"},"quantity":{"type":"number"}},"required":["assetName","total","pricePerShare","id","quantity"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/trades/{id}":{"get":{"summary":"Get trade by id - id could be either the entity id or tid","tags":["trades"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"oneOf":[{"type":"string"},{"type":"string","minLength":1,"maxLength":50,"example":"tid_00041061050r3gg28a1c60t3gf"}]}},{"name":"investmentType","in":"query","schema":{"type":"string","enum":["INDIVIDUAL","JOINT","ENTITY"]}},{"name":"tradeStatus","in":"query","schema":{"type":"string","enum":["CART","PLACED","IN_REVIEW","NEEDS_INFO","NEEDS_PAYMENT_INFO","FUNDING","CANCELLED","SETTLED","IMPORT_ERROR","ERROR","UPDATE_PAYMENT_METHOD"]}},{"name":"saStatus","in":"query","schema":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW"]}},{"name":"saCheck","in":"query","schema":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"]}},{"name":"txnPaymentMethod","in":"query","schema":{"type":"string","enum":["CREDIT_CARD","WIRE","ACH","BANK_ACCOUNT","CHECK","RETIREMENT"]}},{"name":"fundingStatus","in":"query","schema":{"type":"string","enum":["PENDING","CANCELLED","SETTLED","REFUNDED","DECLINED","FUNDING","AUTHORIZING","FAILED"]}},{"name":"txnCheck","in":"query","schema":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"]}},{"name":"systemReviewCheck","in":"query","schema":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","WARNING","INCOMPLETE"]}},{"name":"complianceReview","in":"query","schema":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"]}},{"name":"beenDisbursed","in":"query","schema":{"type":"string","enum":["true","false"]}},{"name":"search","in":"query","schema":{"type":"string","example":"Mike"}},{"name":"offeringId","in":"query","schema":{"example":"offering_00041061050r3gg28a1c60t3gf"}},{"name":"from","in":"query","schema":{"type":"string","nullable":true,"example":"MM/DD/YYYY"}},{"name":"to","in":"query","schema":{"type":"string","nullable":true,"example":"MM/DD/YYYY"}},{"name":"minAmount","in":"query","schema":{"example":"2500.00"}},{"name":"maxAmount","in":"query","schema":{"example":"15000000.50"}},{"name":"managedBy","in":"query","schema":{"type":"string","enum":["DALMORE","ISSUER"]}},{"name":"investorAccountId","in":"query","schema":{}},{"name":"include","in":"query","schema":{"type":"string","example":"tradeDisbursements,adjustments,account,issuer,lineItems,transactions,investorAccount,offering,paymentMethod"}}],"operationId":"getTrade","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"investorAccountId":{"nullable":true},"investorAccount":{"nullable":true},"offering":{"nullable":true},"accountId":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6","accountId":"account_00041061050r3gg28a1c60t3gf","nullable":true},"account":{"nullable":true},"offeringId":{"nullable":true},"paymentMethodId":{"nullable":true},"paymentMethod":{"nullable":true},"userId":{"nullable":true},"tradeNumber":{"type":"string"},"ip":{"type":"string","nullable":true},"tid":{"type":"string","nullable":true},"investmentType":{"type":"string","enum":["INDIVIDUAL","JOINT","ENTITY"]},"purchasedShares":{"type":"integer"},"bonusShares":{"type":"integer","nullable":true},"totalNumberOfShares":{"type":"integer"},"pricePerShare":{"type":"number","multipleOf":0.01},"lineItems":{"type":"array","items":{}},"adjustments":{"type":"array","items":{}},"transactions":{"type":"array","items":{}},"totalAmount":{"type":"number","multipleOf":0.01,"nullable":true},"tradeStatus":{"type":"string","enum":["CART","PLACED","IN_REVIEW","NEEDS_INFO","NEEDS_PAYMENT_INFO","FUNDING","CANCELLED","SETTLED","IMPORT_ERROR","ERROR","UPDATE_PAYMENT_METHOD"]},"tradeStatusUnmapped":{"type":"string","nullable":true},"tradeDate":{"type":"string","format":"date-time","nullable":true},"saStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW"]},"saStatusUnmapped":{"type":"string","nullable":true},"saUrl":{"type":"string","nullable":true},"saSignedAt":{"type":"string","format":"date-time","nullable":true},"saExtractedNumberOfShares":{"type":"string","nullable":true},"saExtractedTotalAmount":{"type":"string","nullable":true},"saExtractedPricePerShare":{"type":"string","nullable":true},"saExtractedInvestorType":{"type":"string","nullable":true},"saExtractedSigner":{"type":"string","nullable":true},"saExtractedSignatureDate":{"type":"string","format":"date-time","nullable":true},"saExtractedSigner2":{"type":"string","nullable":true},"saExtractedSignatureDate2":{"type":"string","format":"date-time","nullable":true},"saCheck":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"]},"saCheckedAt":{"type":"string","format":"date-time","nullable":true},"saLog":{"type":"object","properties":{"finalStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW"]},"matchResults":{"type":"array","items":{"type":"object","properties":{"tradeLineItemId":{"type":"string","example":"trade_line_item_01kctsycw3fq7sj6hedvy62cja"},"signerName":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"totalAmount":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"investorName":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"numberOfShares":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]}},"required":["tradeLineItemId"]}}},"required":["finalStatus","matchResults"],"nullable":true},"txnTid":{"type":"string","nullable":true},"txnResponse":{"type":"string","nullable":true},"txnPaymentMethod":{"type":"string","enum":["CREDIT_CARD","WIRE","ACH","BANK_ACCOUNT","CHECK","RETIREMENT"],"nullable":true},"txnCurrencyCode":{"type":"string","minLength":3,"maxLength":3,"nullable":true},"txnChargedAmount":{"type":"number","multipleOf":0.01,"nullable":true},"txnDate":{"type":"string","format":"date-time","nullable":true},"txnSettledDate":{"type":"string","format":"date-time","nullable":true},"fundingStatus":{"type":"string","enum":["PENDING","CANCELLED","SETTLED","REFUNDED","DECLINED","FUNDING","AUTHORIZING","FAILED"],"nullable":true},"fundingStatusUnmapped":{"type":"string","nullable":true},"txnCheck":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"],"nullable":true},"txnCheckedAt":{"type":"string","format":"date-time","nullable":true},"txnLog":{"type":"string","nullable":true},"systemReviewCheck":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","WARNING","INCOMPLETE"],"nullable":true},"systemReviewCheckedAt":{"type":"string","format":"date-time","nullable":true},"systemReviewLog":{"type":"string","nullable":true},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"],"nullable":true},"complianceReviewNotes":{"type":"string","nullable":true},"complianceReviewerId":{"type":"string","nullable":true},"issuerId":{"nullable":true},"complianceReviewName":{"type":"string","nullable":true},"complianceReviewAt":{"type":"string","format":"date-time","nullable":true},"tradeType":{"type":"string","enum":["PURCHASE","CONVERSION","TRANSFER"],"nullable":true},"placedAt":{"type":"string","format":"date-time","nullable":true},"platform":{"type":"string"},"cancelledAt":{"type":"string","format":"date-time","nullable":true},"cancelledById":{"type":"string","nullable":true},"cancelledReason":{"type":"string","nullable":true},"cancellationPeriod":{"type":"number","nullable":true},"disbursed":{"type":"boolean"},"tradeAdjustments":{"type":"number","nullable":true},"chargedAmount":{"type":"number","nullable":true},"balance":{"type":"number","nullable":true},"isUncleared24h":{"type":"boolean"},"term":{"type":"number","nullable":true},"exercisePrice":{"type":"number","nullable":true},"warrantPercentage":{"type":"number","nullable":true},"calculationMethod":{"type":"string","enum":["NONE","PRORATA","INCREMENT"],"nullable":true},"incrementThreshold":{"type":"number","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","investorAccountId","accountId","account","offeringId","paymentMethodId","userId","tradeNumber","ip","tid","investmentType","purchasedShares","bonusShares","totalNumberOfShares","pricePerShare","lineItems","adjustments","transactions","totalAmount","tradeStatus","tradeStatusUnmapped","tradeDate","saStatus","saStatusUnmapped","saUrl","saSignedAt","saExtractedNumberOfShares","saExtractedTotalAmount","saExtractedPricePerShare","saExtractedInvestorType","saExtractedSigner","saExtractedSignatureDate","saExtractedSigner2","saExtractedSignatureDate2","saCheck","saCheckedAt","saLog","txnTid","txnResponse","txnPaymentMethod","txnCurrencyCode","txnChargedAmount","txnDate","txnSettledDate","fundingStatus","fundingStatusUnmapped","txnCheck","txnCheckedAt","txnLog","systemReviewCheck","systemReviewCheckedAt","systemReviewLog","complianceReview","complianceReviewNotes","complianceReviewerId","issuerId","complianceReviewName","complianceReviewAt","tradeType","placedAt","platform","cancelledAt","cancelledById","cancelledReason","cancellationPeriod","isUncleared24h","term","exercisePrice","warrantPercentage","calculationMethod","incrementThreshold"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]},"patch":{"summary":"Patch a trade status","tags":["trades"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"oneOf":[{"type":"string"},{"type":"string","minLength":1,"maxLength":50,"example":"tid_00041061050r3gg28a1c60t3gf"}]}}],"operationId":"patchTradeStatus","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"tradeStatus":{"type":"string","enum":["CART","PLACED","IN_REVIEW","NEEDS_INFO","NEEDS_PAYMENT_INFO","FUNDING","CANCELLED","SETTLED","IMPORT_ERROR","ERROR","UPDATE_PAYMENT_METHOD"]}},"required":["tradeStatus"]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"investorAccountId":{"nullable":true},"investorAccount":{"nullable":true},"offering":{"nullable":true},"accountId":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6","accountId":"account_00041061050r3gg28a1c60t3gf","nullable":true},"account":{"nullable":true},"offeringId":{"nullable":true},"paymentMethodId":{"nullable":true},"paymentMethod":{"nullable":true},"userId":{"nullable":true},"tradeNumber":{"type":"string"},"ip":{"type":"string","nullable":true},"tid":{"type":"string","nullable":true},"investmentType":{"type":"string","enum":["INDIVIDUAL","JOINT","ENTITY"]},"purchasedShares":{"type":"integer"},"bonusShares":{"type":"integer","nullable":true},"totalNumberOfShares":{"type":"integer"},"pricePerShare":{"type":"number","multipleOf":0.01},"lineItems":{"type":"array","items":{}},"adjustments":{"type":"array","items":{}},"transactions":{"type":"array","items":{}},"totalAmount":{"type":"number","multipleOf":0.01,"nullable":true},"tradeStatus":{"type":"string","enum":["CART","PLACED","IN_REVIEW","NEEDS_INFO","NEEDS_PAYMENT_INFO","FUNDING","CANCELLED","SETTLED","IMPORT_ERROR","ERROR","UPDATE_PAYMENT_METHOD"]},"tradeStatusUnmapped":{"type":"string","nullable":true},"tradeDate":{"type":"string","format":"date-time","nullable":true},"saStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW"]},"saStatusUnmapped":{"type":"string","nullable":true},"saUrl":{"type":"string","nullable":true},"saSignedAt":{"type":"string","format":"date-time","nullable":true},"saExtractedNumberOfShares":{"type":"string","nullable":true},"saExtractedTotalAmount":{"type":"string","nullable":true},"saExtractedPricePerShare":{"type":"string","nullable":true},"saExtractedInvestorType":{"type":"string","nullable":true},"saExtractedSigner":{"type":"string","nullable":true},"saExtractedSignatureDate":{"type":"string","format":"date-time","nullable":true},"saExtractedSigner2":{"type":"string","nullable":true},"saExtractedSignatureDate2":{"type":"string","format":"date-time","nullable":true},"saCheck":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"]},"saCheckedAt":{"type":"string","format":"date-time","nullable":true},"saLog":{"type":"object","properties":{"finalStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW"]},"matchResults":{"type":"array","items":{"type":"object","properties":{"tradeLineItemId":{"type":"string","example":"trade_line_item_01kctsycw3fq7sj6hedvy62cja"},"signerName":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"totalAmount":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"investorName":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"numberOfShares":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]}},"required":["tradeLineItemId"]}}},"required":["finalStatus","matchResults"],"nullable":true},"txnTid":{"type":"string","nullable":true},"txnResponse":{"type":"string","nullable":true},"txnPaymentMethod":{"type":"string","enum":["CREDIT_CARD","WIRE","ACH","BANK_ACCOUNT","CHECK","RETIREMENT"],"nullable":true},"txnCurrencyCode":{"type":"string","minLength":3,"maxLength":3,"nullable":true},"txnChargedAmount":{"type":"number","multipleOf":0.01,"nullable":true},"txnDate":{"type":"string","format":"date-time","nullable":true},"txnSettledDate":{"type":"string","format":"date-time","nullable":true},"fundingStatus":{"type":"string","enum":["PENDING","CANCELLED","SETTLED","REFUNDED","DECLINED","FUNDING","AUTHORIZING","FAILED"],"nullable":true},"fundingStatusUnmapped":{"type":"string","nullable":true},"txnCheck":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"],"nullable":true},"txnCheckedAt":{"type":"string","format":"date-time","nullable":true},"txnLog":{"type":"string","nullable":true},"systemReviewCheck":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","WARNING","INCOMPLETE"],"nullable":true},"systemReviewCheckedAt":{"type":"string","format":"date-time","nullable":true},"systemReviewLog":{"type":"string","nullable":true},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"],"nullable":true},"complianceReviewNotes":{"type":"string","nullable":true},"complianceReviewerId":{"type":"string","nullable":true},"issuerId":{"nullable":true},"complianceReviewName":{"type":"string","nullable":true},"complianceReviewAt":{"type":"string","format":"date-time","nullable":true},"tradeType":{"type":"string","enum":["PURCHASE","CONVERSION","TRANSFER"],"nullable":true},"placedAt":{"type":"string","format":"date-time","nullable":true},"platform":{"type":"string"},"cancelledAt":{"type":"string","format":"date-time","nullable":true},"cancelledById":{"type":"string","nullable":true},"cancelledReason":{"type":"string","nullable":true},"cancellationPeriod":{"type":"number","nullable":true},"disbursed":{"type":"boolean"},"tradeAdjustments":{"type":"number","nullable":true},"chargedAmount":{"type":"number","nullable":true},"balance":{"type":"number","nullable":true},"isUncleared24h":{"type":"boolean"},"term":{"type":"number","nullable":true},"exercisePrice":{"type":"number","nullable":true},"warrantPercentage":{"type":"number","nullable":true},"calculationMethod":{"type":"string","enum":["NONE","PRORATA","INCREMENT"],"nullable":true},"incrementThreshold":{"type":"number","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","investorAccountId","accountId","account","offeringId","paymentMethodId","userId","tradeNumber","ip","tid","investmentType","purchasedShares","bonusShares","totalNumberOfShares","pricePerShare","lineItems","adjustments","transactions","totalAmount","tradeStatus","tradeStatusUnmapped","tradeDate","saStatus","saStatusUnmapped","saUrl","saSignedAt","saExtractedNumberOfShares","saExtractedTotalAmount","saExtractedPricePerShare","saExtractedInvestorType","saExtractedSigner","saExtractedSignatureDate","saExtractedSigner2","saExtractedSignatureDate2","saCheck","saCheckedAt","saLog","txnTid","txnResponse","txnPaymentMethod","txnCurrencyCode","txnChargedAmount","txnDate","txnSettledDate","fundingStatus","fundingStatusUnmapped","txnCheck","txnCheckedAt","txnLog","systemReviewCheck","systemReviewCheckedAt","systemReviewLog","complianceReview","complianceReviewNotes","complianceReviewerId","issuerId","complianceReviewName","complianceReviewAt","tradeType","placedAt","platform","cancelledAt","cancelledById","cancelledReason","cancellationPeriod","isUncleared24h","term","exercisePrice","warrantPercentage","calculationMethod","incrementThreshold"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/trades":{"get":{"summary":"Get trades","tags":["trades"],"parameters":[{"name":"page","in":"query","schema":{"default":1,"type":"number","nullable":true}},{"name":"limit","in":"query","schema":{"default":10,"type":"number","nullable":true}},{"name":"investmentType","in":"query","schema":{"type":"string","enum":["INDIVIDUAL","JOINT","ENTITY"]}},{"name":"tradeStatus","in":"query","schema":{"type":"string","enum":["CART","PLACED","IN_REVIEW","NEEDS_INFO","NEEDS_PAYMENT_INFO","FUNDING","CANCELLED","SETTLED","IMPORT_ERROR","ERROR","UPDATE_PAYMENT_METHOD"]}},{"name":"saStatus","in":"query","schema":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW"]}},{"name":"saCheck","in":"query","schema":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"]}},{"name":"txnPaymentMethod","in":"query","schema":{"type":"string","enum":["CREDIT_CARD","WIRE","ACH","BANK_ACCOUNT","CHECK","RETIREMENT"]}},{"name":"fundingStatus","in":"query","schema":{"type":"string","enum":["PENDING","CANCELLED","SETTLED","REFUNDED","DECLINED","FUNDING","AUTHORIZING","FAILED"]}},{"name":"txnCheck","in":"query","schema":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"]}},{"name":"systemReviewCheck","in":"query","schema":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","WARNING","INCOMPLETE"]}},{"name":"complianceReview","in":"query","schema":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"]}},{"name":"beenDisbursed","in":"query","schema":{"type":"string","enum":["true","false"]}},{"name":"search","in":"query","schema":{"type":"string","example":"Mike"}},{"name":"offeringId","in":"query","schema":{"example":"offering_00041061050r3gg28a1c60t3gf"}},{"name":"from","in":"query","schema":{"type":"string","nullable":true,"example":"MM/DD/YYYY"}},{"name":"to","in":"query","schema":{"type":"string","nullable":true,"example":"MM/DD/YYYY"}},{"name":"minAmount","in":"query","schema":{"example":"2500.00"}},{"name":"maxAmount","in":"query","schema":{"example":"15000000.50"}},{"name":"managedBy","in":"query","schema":{"type":"string","enum":["DALMORE","ISSUER"]}},{"name":"investorAccountId","in":"query","schema":{}},{"name":"include","in":"query","schema":{"type":"string","example":"tradeDisbursements,adjustments,account,issuer,lineItems,transactions,investorAccount,offering,paymentMethod"}}],"operationId":"getTrades","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"investorAccountId":{"nullable":true},"investorAccount":{"nullable":true},"offering":{"nullable":true},"accountId":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6","accountId":"account_00041061050r3gg28a1c60t3gf","nullable":true},"account":{"nullable":true},"offeringId":{"nullable":true},"paymentMethodId":{"nullable":true},"paymentMethod":{"nullable":true},"userId":{"nullable":true},"tradeNumber":{"type":"string"},"ip":{"type":"string","nullable":true},"tid":{"type":"string","nullable":true},"investmentType":{"type":"string","enum":["INDIVIDUAL","JOINT","ENTITY"]},"purchasedShares":{"type":"integer"},"bonusShares":{"type":"integer","nullable":true},"totalNumberOfShares":{"type":"integer"},"pricePerShare":{"type":"number","multipleOf":0.01},"lineItems":{"type":"array","items":{}},"adjustments":{"type":"array","items":{}},"transactions":{"type":"array","items":{}},"totalAmount":{"type":"number","multipleOf":0.01,"nullable":true},"tradeStatus":{"type":"string","enum":["CART","PLACED","IN_REVIEW","NEEDS_INFO","NEEDS_PAYMENT_INFO","FUNDING","CANCELLED","SETTLED","IMPORT_ERROR","ERROR","UPDATE_PAYMENT_METHOD"]},"tradeStatusUnmapped":{"type":"string","nullable":true},"tradeDate":{"type":"string","format":"date-time","nullable":true},"saStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW"]},"saStatusUnmapped":{"type":"string","nullable":true},"saUrl":{"type":"string","nullable":true},"saSignedAt":{"type":"string","format":"date-time","nullable":true},"saExtractedNumberOfShares":{"type":"string","nullable":true},"saExtractedTotalAmount":{"type":"string","nullable":true},"saExtractedPricePerShare":{"type":"string","nullable":true},"saExtractedInvestorType":{"type":"string","nullable":true},"saExtractedSigner":{"type":"string","nullable":true},"saExtractedSignatureDate":{"type":"string","format":"date-time","nullable":true},"saExtractedSigner2":{"type":"string","nullable":true},"saExtractedSignatureDate2":{"type":"string","format":"date-time","nullable":true},"saCheck":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"]},"saCheckedAt":{"type":"string","format":"date-time","nullable":true},"saLog":{"type":"object","properties":{"finalStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW"]},"matchResults":{"type":"array","items":{"type":"object","properties":{"tradeLineItemId":{"type":"string","example":"trade_line_item_01kctsycw3fq7sj6hedvy62cja"},"signerName":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"totalAmount":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"investorName":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]},"numberOfShares":{"type":"object","properties":{"actual":{"type":"string","minLength":1,"maxLength":200},"status":{"type":"string","enum":["MATCHED","UNMATCHED"]},"extracted":{"type":"string","minLength":1,"maxLength":200},"corrected":{"type":"string","minLength":1,"maxLength":200,"nullable":true}},"required":["actual","status","extracted"]}},"required":["tradeLineItemId"]}}},"required":["finalStatus","matchResults"],"nullable":true},"txnTid":{"type":"string","nullable":true},"txnResponse":{"type":"string","nullable":true},"txnPaymentMethod":{"type":"string","enum":["CREDIT_CARD","WIRE","ACH","BANK_ACCOUNT","CHECK","RETIREMENT"],"nullable":true},"txnCurrencyCode":{"type":"string","minLength":3,"maxLength":3,"nullable":true},"txnChargedAmount":{"type":"number","multipleOf":0.01,"nullable":true},"txnDate":{"type":"string","format":"date-time","nullable":true},"txnSettledDate":{"type":"string","format":"date-time","nullable":true},"fundingStatus":{"type":"string","enum":["PENDING","CANCELLED","SETTLED","REFUNDED","DECLINED","FUNDING","AUTHORIZING","FAILED"],"nullable":true},"fundingStatusUnmapped":{"type":"string","nullable":true},"txnCheck":{"type":"string","enum":["PENDING","NEEDS_REVIEW","APPROVED","REJECTED"],"nullable":true},"txnCheckedAt":{"type":"string","format":"date-time","nullable":true},"txnLog":{"type":"string","nullable":true},"systemReviewCheck":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","WARNING","INCOMPLETE"],"nullable":true},"systemReviewCheckedAt":{"type":"string","format":"date-time","nullable":true},"systemReviewLog":{"type":"string","nullable":true},"complianceReview":{"type":"string","enum":["PENDING","APPROVED","REJECTED","NEEDS_REVIEW","CANCELLED","READY_TO_APPROVE"],"nullable":true},"complianceReviewNotes":{"type":"string","nullable":true},"complianceReviewerId":{"type":"string","nullable":true},"issuerId":{"nullable":true},"complianceReviewName":{"type":"string","nullable":true},"complianceReviewAt":{"type":"string","format":"date-time","nullable":true},"tradeType":{"type":"string","enum":["PURCHASE","CONVERSION","TRANSFER"],"nullable":true},"placedAt":{"type":"string","format":"date-time","nullable":true},"platform":{"type":"string"},"cancelledAt":{"type":"string","format":"date-time","nullable":true},"cancelledById":{"type":"string","nullable":true},"cancelledReason":{"type":"string","nullable":true},"cancellationPeriod":{"type":"number","nullable":true},"disbursed":{"type":"boolean"},"tradeAdjustments":{"type":"number","nullable":true},"chargedAmount":{"type":"number","nullable":true},"balance":{"type":"number","nullable":true},"isUncleared24h":{"type":"boolean"},"term":{"type":"number","nullable":true},"exercisePrice":{"type":"number","nullable":true},"warrantPercentage":{"type":"number","nullable":true},"calculationMethod":{"type":"string","enum":["NONE","PRORATA","INCREMENT"],"nullable":true},"incrementThreshold":{"type":"number","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","investorAccountId","accountId","account","offeringId","paymentMethodId","userId","tradeNumber","ip","tid","investmentType","purchasedShares","bonusShares","totalNumberOfShares","pricePerShare","lineItems","adjustments","transactions","totalAmount","tradeStatus","tradeStatusUnmapped","tradeDate","saStatus","saStatusUnmapped","saUrl","saSignedAt","saExtractedNumberOfShares","saExtractedTotalAmount","saExtractedPricePerShare","saExtractedInvestorType","saExtractedSigner","saExtractedSignatureDate","saExtractedSigner2","saExtractedSignatureDate2","saCheck","saCheckedAt","saLog","txnTid","txnResponse","txnPaymentMethod","txnCurrencyCode","txnChargedAmount","txnDate","txnSettledDate","fundingStatus","fundingStatusUnmapped","txnCheck","txnCheckedAt","txnLog","systemReviewCheck","systemReviewCheckedAt","systemReviewLog","complianceReview","complianceReviewNotes","complianceReviewerId","issuerId","complianceReviewName","complianceReviewAt","tradeType","placedAt","platform","cancelledAt","cancelledById","cancelledReason","cancellationPeriod","isUncleared24h","term","exercisePrice","warrantPercentage","calculationMethod","incrementThreshold"]}},"meta":{"type":"object","properties":{"itemCount":{"type":"number","example":1},"totalItems":{"type":"number","example":10},"itemsPerPage":{"type":"number","example":1},"totalPages":{"type":"number","example":10},"currentPage":{"type":"number","example":1}},"required":["itemCount","itemsPerPage","currentPage"]}},"required":["items","meta"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/trades/":{"post":{"summary":"Create Trades","tags":["trades"],"parameters":[],"operationId":"createTrades","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"investorAccountId":{},"investmentType":{"type":"string","enum":["INDIVIDUAL","JOINT","ENTITY"]}}}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"entityprefix_01j1xgme5qeqq97gpdztd7e4a6"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"investorAccountId":{"nullable":true},"accountId":{"type":"string"},"offeringId":{"type":"string","nullable":true},"tid":{"type":"string","nullable":true},"investmentType":{"type":"string","enum":["INDIVIDUAL","JOINT","ENTITY"]},"purchasedShares":{"type":"integer"},"bonusShares":{"type":"integer","nullable":true},"totalNumberOfShares":{"type":"integer"},"pricePerShare":{"type":"number","multipleOf":0.01},"totalAmount":{"type":"number","multipleOf":0.01,"nullable":true},"tradeStatus":{"type":"string","enum":["CART","PLACED","IN_REVIEW","NEEDS_INFO","NEEDS_PAYMENT_INFO","FUNDING","CANCELLED","SETTLED","IMPORT_ERROR","ERROR","UPDATE_PAYMENT_METHOD"]},"tradeStatusUnmapped":{"type":"string","nullable":true},"tradeDate":{"type":"string","format":"date-time","nullable":true},"paymentMethodId":{"nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","investorAccountId","accountId","offeringId","tid","investmentType","purchasedShares","bonusShares","totalNumberOfShares","pricePerShare","totalAmount","tradeStatus","tradeStatusUnmapped","tradeDate","paymentMethodId"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/trades/line-items":{"post":{"summary":"Create a Line Item","tags":["trades"],"parameters":[{"name":"reset","in":"query","schema":{"default":"false","type":"string"}}],"operationId":"postLineItem","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"assetId":{"type":"string","example":"asset_00041061050r3gg28a1c60t3gf"},"quantity":{"type":"number","minimum":0,"maximum":1000000000}},"required":["assetId","quantity"]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"assetName":{"type":"string","nullable":true},"total":{"type":"number"},"pricePerShare":{"type":"number"},"id":{"type":"string","example":"trade_line_item_01kctsycw3fq7sj6hedvy62cja"},"quantity":{"type":"number"}},"required":["assetName","total","pricePerShare","id","quantity"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/trades/{id}/attach-subdoc":{"post":{"summary":"Attach subdoc to trade","tags":["trades"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"oneOf":[{"type":"string"},{"type":"string","minLength":1,"maxLength":50,"example":"tid_00041061050r3gg28a1c60t3gf"}]}}],"operationId":"postAttachSubdoc","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"lineItemId":{"type":"string","example":"trade_line_item_01kctsycw3fq7sj6hedvy62cja"},"fileId":{"example":"file_01je6ht4b8fbmttkzh2hs82xqp"},"primarySignatureStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW","RE_SIGN"],"example":"SIGNED"},"secondarySignatureStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW","RE_SIGN"],"example":"SIGNED"}},"required":["lineItemId","fileId","primarySignatureStatus"]}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]},"put":{"summary":"Update attached subdoc for trade","tags":["trades"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"oneOf":[{"type":"string"},{"type":"string","minLength":1,"maxLength":50,"example":"tid_00041061050r3gg28a1c60t3gf"}]}}],"operationId":"putAttachSubdoc","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"lineItemId":{"type":"string","example":"trade_line_item_01kctsycw3fq7sj6hedvy62cja"},"fileId":{"example":"file_01je6ht4b8fbmttkzh2hs82xqp"},"primarySignatureStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW","RE_SIGN"],"example":"SIGNED"},"secondarySignatureStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW","RE_SIGN"],"example":"SIGNED"}}}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/trades/{id}/sign":{"patch":{"summary":"Update subdoc signature statuses for trade","tags":["trades"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"oneOf":[{"type":"string"},{"type":"string","minLength":1,"maxLength":50,"example":"tid_00041061050r3gg28a1c60t3gf"}]}}],"operationId":"patchSubdocSign","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"lineItemId":{"type":"string","example":"trade_line_item_01kctsycw3fq7sj6hedvy62cja","description":"Optional. If not provided, updates the first line item with an attached subdoc. Required for trades with multiple line items."},"primarySignatureStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW","RE_SIGN"],"example":"SIGNED","description":"Primary signer signature status"},"secondarySignatureStatus":{"type":"string","enum":["PENDING","SIGNED","DECLINED","NEEDS_REVIEW","RE_SIGN"],"example":"SIGNED","description":"Secondary signer signature status. Only applicable for JOINT investor accounts."}}}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/transactions":{"post":{"summary":"Create a transaction","tags":["transactions"],"parameters":[],"operationId":"postTransaction","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"tid":{"type":"string","minLength":3,"maxLength":64,"example":"TXN8A7B6C5"},"tradeId":{"example":"trade_01j5y5ghx5fg68d663j1fvy2x7"},"name":{"type":"string","minLength":1,"maxLength":255,"example":"John Doe"},"chargedAt":{"type":"string","nullable":true,"example":"05/20/1990"},"amount":{"type":"number","minimum":0,"exclusiveMinimum":0,"maximum":9999999999,"example":2000},"userId":{"example":"user_01j5y5ghx5fg68d663j1fvy2x7"}},"required":["tid","tradeId","name","chargedAt","amount","userId"]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"__entity":{"type":"string","example":"Entity"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.539Z"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}],"example":"2026-03-27T15:47:09.540Z","nullable":true},"accountId":{"type":"string","example":"account_01j1xgme5qeqq97gpdztd7e4a6","accountId":"account_00041061050r3gg28a1c60t3gf"},"type":{"type":"string","enum":["CHARGE","REFUND","ADJUSTMENT"]},"provider":{"type":"string","enum":["STRIPE","PLAID","OTHER"]},"status":{"type":"string","enum":["PENDING","CHARGED","APPROVED","SETTLED","REFUNDED","CANCELLED","DECLINED","FAILED","AUTHORIZING","FUNDING","PARTIALLY_REFUNDED","VOIDED","PROCESSING_VOID","PROCESSING_REFUND"]},"tid":{"type":"string","nullable":true},"amount":{"type":"number"},"currencyCode":{"type":"string"},"tradeId":{"nullable":true},"paymentMethodId":{"nullable":true},"paymentMethod":{"nullable":true},"trade":{"nullable":true},"errorMessage":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"chargedAt":{"type":"string","nullable":true,"example":"05/20/1990"},"totalPaidBalance":{"type":"number","nullable":true}},"required":["id","createdAt","updatedAt","deletedAt","accountId","type","provider","status","tid","amount","currencyCode","tradeId","paymentMethodId","errorMessage","description"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"500"},"message":{"type":"string","example":"INTERNAL_SERVER_ERROR"},"errors":{"type":"array","items":{"type":"string"},"example":["error occurred"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/webhooks/subscribe":{"post":{"description":"Creates a new webhook subscription for the specified event types. Used by Zapier REST Hook.","summary":"Subscribe to webhook events","tags":["webhooks"],"parameters":[],"operationId":"subscribe","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"targetUrl":{"type":"string","format":"uri"},"eventTypes":{"type":"array","items":{"type":"string"},"minItems":1},"name":{"type":"string"}},"required":["targetUrl","eventTypes"]}}}},"responses":{"201":{"description":"201","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"hook0SubscriptionId":{"type":"string","nullable":true}},"required":["id","hook0SubscriptionId"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"400"},"message":{"type":"string","example":"BAD_REQUEST"},"errors":{"type":"array","items":{"type":"string"},"example":["invalid email"]}},"required":["status","message","errors"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/webhooks/{id}":{"delete":{"description":"Deletes a webhook subscription by ID. Used by Zapier REST Hook.","summary":"Unsubscribe from webhook","tags":["webhooks"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"operationId":"unsubscribe","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"204":{"description":"204","content":{"application/json":{"schema":{}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"404"},"message":{"type":"string","example":"NOT_FOUND"},"errors":{"type":"array","items":{"type":"string"},"example":["User not found"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/webhooks":{"get":{"description":"Returns a paginated list of webhook subscriptions.","summary":"List webhook subscriptions","tags":["webhooks"],"parameters":[{"name":"page","in":"query","schema":{"default":1,"type":"number","nullable":true}},{"name":"limit","in":"query","schema":{"default":10,"type":"number","nullable":true}}],"operationId":"list","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"targetUrl":{"type":"string","format":"uri"},"eventTypes":{"type":"array","items":{"type":"string"}},"name":{"type":"string","nullable":true},"enabled":{"type":"boolean"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","targetUrl","eventTypes","name","enabled","createdAt","updatedAt"]}},"meta":{"type":"object","properties":{"itemCount":{"type":"number","example":1},"totalItems":{"type":"number","example":10},"itemsPerPage":{"type":"number","example":1},"totalPages":{"type":"number","example":10},"currentPage":{"type":"number","example":1}},"required":["itemCount","itemsPerPage","currentPage"]}},"required":["items","meta"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/webhooks/trigger-types":{"get":{"description":"Returns a list of event types that can be subscribed to for triggers.","summary":"Get available trigger types","tags":["webhooks"],"parameters":[],"operationId":"triggerTypes","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"eventType":{"type":"string"},"displayName":{"type":"string"},"description":{"type":"string"},"source":{"type":"string","enum":["api","external","both"]}},"required":["eventType","displayName","description","source"]}}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/webhooks/action-types":{"get":{"description":"Returns a list of API endpoints available as Zapier actions.","summary":"Get available action types","tags":["webhooks"],"parameters":[],"operationId":"actionTypes","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"displayName":{"type":"string"},"description":{"type":"string"},"method":{"type":"string","enum":["GET","POST","PATCH","PUT","DELETE"]},"endpoint":{"type":"string"},"noun":{"type":"string"}},"required":["key","displayName","description","method","endpoint","noun"]}}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}},"/clients/api/v1/webhooks/perform/{eventType}":{"get":{"description":"Returns recent events for a specific event type. Used as a polling fallback by Zapier.","summary":"Perform list for event type","tags":["webhooks"],"parameters":[{"name":"eventType","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"default":50,"type":"number","nullable":true}}],"operationId":"performList","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":{}}}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"401"},"message":{"type":"string","example":"UNAUTHORIZED"},"errors":{"type":"array","items":{"type":"string"},"example":["unauthorized"]}},"required":["status","message","errors"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"number","example":"403"},"message":{"type":"string","example":"FORBIDDEN"},"errors":{"type":"array","items":{"type":"string"},"example":["forbidden resource"]}},"required":["status","message","errors"]}}}}},"security":[{"api_key":[]}]}}},"info":{"title":"Dalmore Clients API","description":"Dalmore Clients API Description","version":"1","contact":{}},"tags":[],"servers":[{"url":"https://platform.dalmoregroup.com"}],"components":{"securitySchemes":{"api_key":{"type":"apiKey","in":"header","name":"X-API-KEY"}}},"externalDocs":{"description":"Postman Clients Collection","url":"/clients-json"}}