# Get Account Application Detail Retrieves detailed information about a specific account application. # OpenAPI definition ```json { "info": { "title": "Webull Open API Reference", "description": "application.yml\\ncom\\ni18n\\nMETA-INF\\nstatic\\n\\r\\n", "contact": { "name": "", "url": "", "email": "" }, "version": "2.0", "x-logo": { "url": "static/png/logo.png" } }, "servers": [ { "url": "https://broker-api.sandbox.webull.com" } ], "path": "/broker/accounts/applications/get", "method": "get", "tags": [ "Accounts" ], "description": "Retrieves detailed information about a specific account application.", "operationId": "getAccountApplicationDetail", "parameters": [ { "name": "application_id", "in": "query", "description": "Unique identifier of the account application to retrieve details for.", "required": true, "schema": { "type": "string" }, "example": "a1b2c3d4e5f60718293a4b5c6d7e8f90" }, { "name": "x-app-key", "in": "header", "description": "A unique identifier issued to a developer for accessing an application's API.", "required": true, "schema": { "type": "string" } }, { "name": "x-app-secret", "in": "header", "description": "A unique key issued to developers to access the application's API.", "required": true, "schema": { "type": "string" } }, { "name": "x-timestamp", "in": "header", "description": "Timestamp of the request, follows ISO8601 format: YYYY-MM-DDThh:mm:ssZ, e.g. 2023-07-16T19:23:51Z, only supports UTC time zone.", "required": true, "schema": { "type": "string" } }, { "name": "x-signature-version", "in": "header", "description": "Signature algorithm version, default is 1.0.", "required": true, "schema": { "type": "string", "default": "1.0" }, "examples": { "1.0": { "value": "1.0" } } }, { "name": "x-signature-algorithm", "in": "header", "description": "Signature algorithm, default is HMAC-SHA1.", "required": true, "schema": { "type": "string", "default": "HMAC-SHA1" }, "examples": { "HMAC-SHA1": { "value": "HMAC-SHA1" } } }, { "name": "x-signature-nonce", "in": "header", "description": "Signature unique random number.", "required": true, "schema": { "type": "string" } }, { "name": "x-version", "in": "header", "description": "API interface version. Supported values: `v2`, `v3`.", "required": true, "schema": { "type": "string", "default": "v3" }, "examples": { "v3": { "value": "v3" } } }, { "name": "x-signature", "in": "header", "description": "A signature is a unique digital fingerprint, typically encrypted, that verifies the authenticity and integrity of a message or transaction, ensuring it has not been tampered with during transmission.", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "required": [ "additional_infos", "application_id", "contact_info", "customer_info", "disclosure_info", "employment_info", "financial_info", "tax_info" ], "type": "object", "properties": { "application_id": { "type": "string", "description": "Application ID", "example": "APP123456789" }, "resubmission_codes": { "type": "array", "description": "Resubmission Code, only present for resubmission applications", "example": [ "OCR_SUSPENDED", "CIP_SUSPENDED" ], "items": { "type": "string", "description": "Application Resubmission Code", "example": "[\"OCR_SUSPENDED\",\"CIP_SUSPENDED\"]", "enum": [ "OCR_SUSPENDED", "CIP_SUSPENDED", "NOT_A_GOVERNMENT_ISSUED", "EXPIRED_ID", "ID_CARD_ILLEGIBLE", "ID_ON_SCREEN", "UNMATCHED_ID_NUMBER_WITH_THE_ID_PICTURE", "UNMATCHED_SSN_PICTURE", "UNMATCHED_ID_EXPIRE_DATE", "UNMATCHED_NATIONALITY_WITH_THE_ID_PICTURE", "UNMATCHED_NAME_WITH_THE_ID_PICTURE", "UNMATCHED_DOB_WITH_THE_ID_PICTURE", "SELFIE_NOT_MEET_THE_REQUIREMENTS", "NEED_407_LETTERS" ] } }, "customer_info": { "required": [ "country_of_citizenship", "date_of_birth", "first_name", "gender", "id_doc_type", "id_expiry_date", "id_number", "ip_address", "last_name", "marital_status", "num_dependents", "permanent_resident" ], "type": "object", "properties": { "ip_address": { "type": "string", "description": "The IP address when the user submits the application.", "example": "0.0.0.0" }, "first_name": { "type": "string", "description": "First name", "example": "John" }, "middle_name": { "type": "string", "description": "Middle name", "example": "A" }, "last_name": { "type": "string", "description": "Last name", "example": "Doe" }, "date_of_birth": { "type": "string", "description": "Date of birth", "example": "1990-01-01" }, "gender": { "type": "string", "description": "Gender. Allowed values: F (Female), M (Male).", "example": "M" }, "country_of_citizenship": { "type": "string", "description": "Country of citizenship. Value must be obtained from the Master Data API with data_type = COUNTRY", "example": "US" }, "id_doc_type": { "type": "string", "description": "Type of identification document. Value must be obtained from the Master Data API with data_type = ID_DOC_TYPE.", "example": "PASSPORT" }, "picture_front_doc_id": { "type": "string", "description": "Picture front document id", "example": "DOC123456789" }, "picture_back_doc_id": { "type": "string", "description": "Picture back document id", "example": "DOC987654321" }, "id_number": { "type": "string", "description": "Number of the identification document.", "example": "X1234567" }, "id_expiry_date": { "type": "string", "description": "Expiration date of the identification document.", "example": "2030-12-31" }, "selfie_img_key": { "type": "string", "description": "User’s selfie, face photo, or liveness document id", "example": "SELFIE123456789" }, "tax_id_doc_id": { "type": "string", "description": "Tax ID or SSN document id for tax/SSN verification", "example": "TAXID123456789" }, "permanent_resident": { "type": "string", "description": "Permanent resident. Allowed values: YES, NO.", "example": "NO" }, "marital_status": { "type": "string", "description": "The user's marital status. Value must be obtained from the Master Data API with data_type = MARITAL_STATUS.", "example": "SINGLE" }, "num_dependents": { "type": "integer", "description": "Num dependents", "format": "int32", "example": 1 }, "ext_attr_list": { "type": "array", "description": "Ext attr list", "items": { "required": [ "name", "value" ], "type": "object", "properties": { "name": { "type": "string", "description": "Attribute Name", "example": "custom_attribute_1" }, "value": { "type": "string", "description": "Attribute Value", "example": "custom_value_1" } }, "description": "Extended Attributes", "title": "ExtAttr" } } }, "description": "Customer Info", "title": "CustomerInfo" }, "contact_info": { "required": [ "email_address", "id_address", "phone_country", "phone_number" ], "type": "object", "properties": { "phone_country": { "type": "string", "description": "Phone country. The value must be a valid ISO 3166-1 alpha-3 country code in uppercase format (3-letter code).", "example": "USA" }, "phone_number": { "type": "string", "description": "Phone number", "example": "+1-2025550143" }, "email_address": { "type": "string", "description": "Email address", "example": "demo@example.com" }, "id_address": { "required": [ "city", "country", "postal_code", "state", "street_address" ], "type": "object", "properties": { "country": { "type": "string", "description": "Country. The value must be a valid ISO 3166-1 alpha-3 country code in uppercase format (3-letter code).", "example": "USA" }, "state": { "type": "string", "description": "State. The value must follow the ISO 3166-2 subdivision standard and include the country code prefix. Format: ISO 3166-1 alpha-3 country code followed by a hyphen and the subdivision code (for example: USA-CA).", "example": "USA-CA" }, "city": { "type": "string", "description": "City.", "example": "San Francisco" }, "street_address": { "type": "string", "description": "Street address", "example": "123 Main St" }, "postal_code": { "type": "string", "description": "Postal code", "example": "94105" }, "neighborhood_code": { "type": "string", "description": "Neighborhood code.", "example": "NBHD12345" }, "apartment_number": { "type": "string", "description": "Apartment number.", "example": "Apt 4B" }, "building_number": { "type": "string", "description": "Building number.", "example": "Building 5" } }, "description": "Address Info", "title": "AddressInfo" }, "mail_address": { "required": [ "city", "country", "postal_code", "state", "street_address" ], "type": "object", "properties": { "country": { "type": "string", "description": "Country. The value must be a valid ISO 3166-1 alpha-3 country code in uppercase format (3-letter code).", "example": "USA" }, "state": { "type": "string", "description": "State. The value must follow the ISO 3166-2 subdivision standard and include the country code prefix. Format: ISO 3166-1 alpha-3 country code followed by a hyphen and the subdivision code (for example: USA-CA).", "example": "USA-CA" }, "city": { "type": "string", "description": "City.", "example": "San Francisco" }, "street_address": { "type": "string", "description": "Street address", "example": "123 Main St" }, "postal_code": { "type": "string", "description": "Postal code", "example": "94105" }, "neighborhood_code": { "type": "string", "description": "Neighborhood code.", "example": "NBHD12345" }, "apartment_number": { "type": "string", "description": "Apartment number.", "example": "Apt 4B" }, "building_number": { "type": "string", "description": "Building number.", "example": "Building 5" } }, "description": "Address Info", "title": "AddressInfo" } }, "description": "Contact Information", "title": "ContactInfo" }, "trusted_contact_info": { "required": [ "first_name", "last_name", "phone_country", "phone_number", "relationship", "trusted_address" ], "type": "object", "properties": { "first_name": { "type": "string", "description": "First name of the trusted contact.", "example": "John" }, "middle_name": { "type": "string", "description": "Middle name of the trusted contact.", "example": "A." }, "last_name": { "type": "string", "description": "Last name of the trusted contact.", "example": "Doe" }, "phone_country": { "type": "string", "description": "Phone country. The value must be a valid ISO 3166-1 alpha-3 country code in uppercase format (3-letter code).", "example": "USA" }, "phone_number": { "type": "string", "description": "Phone number", "example": "+1-2025550143" }, "relationship": { "type": "string", "description": "Relationship between the account holder and the trusted contact person. ", "example": "Parent" }, "trusted_address": { "required": [ "city", "country", "postal_code", "state", "street_address" ], "type": "object", "properties": { "country": { "type": "string", "description": "Country. The value must be a valid ISO 3166-1 alpha-3 country code in uppercase format (3-letter code).", "example": "USA" }, "state": { "type": "string", "description": "State. The value must follow the ISO 3166-2 subdivision standard and include the country code prefix. Format: ISO 3166-1 alpha-3 country code followed by a hyphen and the subdivision code (for example: USA-CA).", "example": "USA-CA" }, "city": { "type": "string", "description": "City.", "example": "San Francisco" }, "street_address": { "type": "string", "description": "Street address", "example": "123 Main St" }, "postal_code": { "type": "string", "description": "Postal code", "example": "94105" }, "neighborhood_code": { "type": "string", "description": "Neighborhood code.", "example": "NBHD12345" }, "apartment_number": { "type": "string", "description": "Apartment number.", "example": "Apt 4B" }, "building_number": { "type": "string", "description": "Building number.", "example": "Building 5" } }, "description": "Trusted Contact Address", "title": "TrustedContactAddress" } }, "description": "Trusted Contact Info", "title": "TrustedContactInfo" }, "employment_info": { "required": [ "company_name", "employment_address", "employment_type", "occupation", "position", "years_employed" ], "type": "object", "properties": { "employment_type": { "type": "string", "description": "Type of employment. Value must be obtained from the Master Data API with data_type = EMPLOYMENT_TYPE.", "example": "EMPLOYED" }, "company_name": { "type": "string", "description": "Name of the applicant current employer.", "example": "Tech Corp" }, "occupation": { "type": "string", "description": "Specific occupation under the employment type. Value must be obtained from the Master Data API with data_type = OCCUPATION.", "example": "ACCOUNTING_AUDITING" }, "position": { "type": "string", "description": "Position. Value must be obtained from the Master Data API with data_type = POSITION", "example": "SECRETARY" }, "years_employed": { "type": "string", "description": "Total duration (in years) the applicant has been employed with the current employer. Decimal values are allowed to represent partial years (e.g. 1.5).", "example": "1.5" }, "employment_address": { "required": [ "city", "country", "postal_code", "state", "street_address" ], "type": "object", "properties": { "country": { "type": "string", "description": "Country. The value must be a valid ISO 3166-1 alpha-3 country code in uppercase format (3-letter code).", "example": "USA" }, "state": { "type": "string", "description": "State. The value must follow the ISO 3166-2 subdivision standard and include the country code prefix. Format: ISO 3166-1 alpha-3 country code followed by a hyphen and the subdivision code (for example: USA-CA).", "example": "USA-CA" }, "city": { "type": "string", "description": "City.", "example": "San Francisco" }, "street_address": { "type": "string", "description": "Street address", "example": "123 Main St" }, "postal_code": { "type": "string", "description": "Postal code", "example": "94105" }, "neighborhood_code": { "type": "string", "description": "Neighborhood code.", "example": "NBHD12345" }, "apartment_number": { "type": "string", "description": "Apartment number.", "example": "Apt 4B" }, "building_number": { "type": "string", "description": "Building number.", "example": "Building 5" } }, "description": "Employment Address", "title": "EmploymentAddress" } }, "description": "Employment Info", "title": "EmploymentInfo" }, "financial_info": { "required": [ "annual_income", "liquid_net_worth", "liquidity_needs", "total_net_worth" ], "type": "object", "properties": { "liquidity_needs": { "type": "string", "description": "Indicates the client liquidity needs or preference for cash accessibility. Value must be obtained from the Master Data API with data_type = LIQUIDITY_NEEDS.", "example": "VERY_IMPORTANT" }, "annual_income": { "type": "string", "description": "Annual income. Value must be obtained from the Master Data API with data_type = ANNUAL_INCOME.", "example": "LEVEL1" }, "total_net_worth": { "type": "string", "description": "Client's total net worth (USD). Value must be obtained from the Master Data API with data_type = TOTAL_NET_WORTH.", "example": "LEVEL1" }, "liquid_net_worth": { "type": "string", "description": "Liquidity assets. Value must be obtained from the Master Data API with data_type = LIQUID_NET_WORTH.", "example": "LEVEL1" } }, "description": "Financial Info", "title": "FinancialInfo" }, "disclosure_info": { "required": [ "is_cftc_or_nfa_registered", "is_company_control_person", "is_politically_exposed" ], "type": "object", "properties": { "is_politically_exposed": { "type": "boolean", "description": "Indicates whether the account holder or any close associate or immediate family member is a Politically Exposed Person (PEP). If true, the politically_exposed_info object must be provided with detailed disclosure information. Please note: PEP accounts are currently not supported. Any request submitted with is_politically_exposed = true will be rejected and a failure response will be returned.", "example": false }, "politically_exposed_info": { "type": "object", "properties": { "pep_organization": { "type": "string", "description": "Name of the related political organization.", "example": "United Nations" }, "immediate_family": { "type": "array", "description": "Name of family members, including former spouses.", "example": "Secretary-General", "items": { "type": "string", "description": "Name of family members, including former spouses.", "example": "Secretary-General" } } }, "description": "Politically Exposed Info", "title": "PoliticallyExposedInfo" }, "is_cftc_or_nfa_registered": { "type": "boolean", "description": "Indicates whether the applicant is registered with the CFTC or is a member of the NFA.", "example": false }, "is_company_control_person": { "type": "boolean", "description": "Indicates whether the applicant is a control person of a public company. If true, `public_company_infos` must be provided with details of the companies controlled.", "example": false }, "public_company_infos": { "type": "array", "description": "List of public companies controlled by the applicant. Each item must include the company stock symbol.", "items": { "required": [ "symbol" ], "type": "object", "properties": { "symbol": { "type": "string", "description": "Stock symbol of the public company controlled by the applicant, as listed on the exchange.", "example": "AAPL" } }, "description": "Public Company Info", "title": "PublicCompanyInfo" } } }, "description": "Disclosure Info", "title": "DisclosureInfo" }, "tax_info": { "required": [ "tax_id", "tax_type" ], "type": "object", "properties": { "tax_type": { "type": "string", "description": "Tax Type. Value must be obtained from the Master Data API with data_type = TAX_TYPE.", "example": "SSN" }, "tax_id": { "type": "string", "description": "Tax ID", "example": "123-45-6789" } }, "description": "Tax Info", "title": "TaxInfo" }, "w8ben_info": { "required": [ "foreign_tax_id", "sign_date", "treaty_country" ], "type": "object", "properties": { "foreign_tax_id": { "type": "string", "description": "Foreign tax ID (FTIN) issued by non-U.S. authority (W-8BEN Line 6)" }, "treaty_country": { "type": "string", "description": "Tax treaty country for reduced withholding. The value must be a valid ISO 3166-1 alpha-3 country code in uppercase format (3-letter code)." }, "sign_date": { "type": "string", "description": "Date when the W-8BEN form was signed by the customer. The date should be in ISO 8601 format (YYYY-MM-DD).", "example": "2026-03-09" } }, "description": "W8ben Info", "title": "W8benInfo" }, "additional_infos": { "type": "array", "description": "Additional Information for the application review process. ", "items": { "required": [ "form_code", "is_exchange_or_finra_affiliated", "rep_code", "status" ], "type": "object", "properties": { "status": { "type": "string", "description": "Application Status", "enum": [ "SUBMITTED", "PENDING_REVIEW", "ACTION_REQUIRED", "REJECTED", "APPROVED" ] }, "form_code": { "type": "string", "description": "Form code", "example": "BROKERAGE_ADDITIONAL_FORM" }, "rep_code": { "type": "string", "description": "Rep code", "example": "REP001" }, "account_id": { "type": "string", "description": "Unique account identifier. Populated only when the status is APPROVED; otherwise, this field is empty.", "example": "5RHU6AG2HQRSC7JC2D772Q534A" }, "account_number": { "type": "string", "description": "Account number. Populated only when the status is APPROVED; otherwise, this field is empty.", "example": "CUA0900026" }, "is_exchange_or_finra_affiliated": { "type": "boolean", "description": "Indicates whether the applicant is employed by, or directly associated with, an exchange or a FINRA member firm. If true, exchange_affiliations details must be provided.", "example": false }, "exchange_or_finra_affiliations": { "type": "array", "description": "List of the applicant affiliations with exchanges or FINRA member firms. Required if is_exchange_or_finra_affiliated is true.", "items": { "required": [ "city", "company_name", "country", "postal_code", "state", "street_address" ], "type": "object", "properties": { "company_name": { "type": "string", "description": "Company name", "example": "Finance Corp" }, "country": { "type": "string", "description": "Country of the affiliated exchange or FINRA firm. The value must be a valid ISO 3166-1 alpha-3 country code in uppercase format (3-letter code).", "example": "USA" }, "state": { "type": "string", "description": "State or province of the affiliated exchange or FINRA firm. The value must follow the ISO 3166-2 subdivision standard and include the country code prefix. Format: -", "example": "USA-NY" }, "city": { "type": "string", "description": "City of the affiliated exchange or FINRA firm.", "example": "New York" }, "street_address": { "type": "string", "description": "Street address", "example": "456 Finance St" }, "postal_code": { "type": "string", "description": "Postal code", "example": "10005" } }, "description": "Exchange Affiliations", "title": "ExchangeAffiliations" } }, "investment_experience": { "type": "string", "description": "Investment experience. Value must be obtained from the Master Data API with data_type = INVESTMENT_EXPERIENCE." }, "investment_knowledge": { "type": "string", "description": "Investment knowledge. Value must be obtained from the Master Data API with data_type = INVESTMENT_KNOWLEDGE. Note: For Event Contract , the value of this field should be obtained from the Master Data API with data_type = INVESTMENT_KNOWLEDGE_V2 instead." }, "investment_objective": { "type": "string", "description": "Investment objective. Value must be obtained from the Master Data API with data_type = INVESTMENT_OBJECTIVE." }, "trade_per_year": { "type": "string", "description": "Trade per year. Value must be obtained from the Master Data API with data_type = TRADE_PER_YEAR." }, "time_horizon": { "type": "string", "description": "Time horizon. Value must be obtained from the Master Data API with data_type = TIME_HORIZON." } }, "description": "Additional Info", "title": "AdditionalInfo" } }, "document_attachments": { "type": "array", "description": "Document Attachments", "items": { "required": [ "doc_type", "document_id" ], "type": "object", "properties": { "doc_type": { "type": "string", "description": "Document Type" }, "document_id": { "type": "string", "description": "Document ID" } }, "description": "Document Attachments", "title": "DocumentAttachments" } } }, "description": "Account Application Detail Result", "title": "AccountApplicationDetailResult" } } } }, "401": { "description": "Unauthorized: Authentication required", "content": { "application/json": { "schema": { "type": "object", "properties": { "error_code": { "type": "string", "description": "Internal logic error code", "example": "UNAUTHORIZED" }, "message": { "type": "string", "description": "Error message", "example": "Insufficient permission" } } } } } }, "417": { "description": "A business logic error triggered when the request cannot be processed due to domain-specific constraints.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error_code": { "type": "string", "description": "Internal logic error code", "example": "INVALID_PARAMETER" }, "message": { "type": "string", "description": "Error message", "example": "Parameter error, phone" } } } } } }, "500": { "description": "Internal Server Error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error_code": { "type": "string", "description": "Internal logic error code", "example": "SYSTEM_ERROR" }, "message": { "type": "string", "description": "Error message", "example": "Internal Server Error" } } } } } } }, "postman": { "name": "Get Account Application Detail", "description": { "content": "Retrieves detailed information about a specific account application.", "type": "text/plain" }, "url": { "path": [ "broker", "accounts", "applications", "get" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "(Required) Unique identifier of the account application to retrieve details for.", "type": "text/plain" }, "key": "application_id", "value": "" } ], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "(Required) A unique identifier issued to a developer for accessing an application's API.", "type": "text/plain" }, "key": "x-app-key", "value": "" }, { "disabled": false, "description": { "content": "(Required) A unique key issued to developers to access the application's API.", "type": "text/plain" }, "key": "x-app-secret", "value": "" }, { "disabled": false, "description": { "content": "(Required) Timestamp of the request, follows ISO8601 format: YYYY-MM-DDThh:mm:ssZ, e.g. 2023-07-16T19:23:51Z, only supports UTC time zone.", "type": "text/plain" }, "key": "x-timestamp", "value": "" }, { "disabled": false, "description": { "content": "(Required) Signature algorithm version, default is 1.0.", "type": "text/plain" }, "key": "x-signature-version", "value": "" }, { "disabled": false, "description": { "content": "(Required) Signature algorithm, default is HMAC-SHA1.", "type": "text/plain" }, "key": "x-signature-algorithm", "value": "" }, { "disabled": false, "description": { "content": "(Required) Signature unique random number.", "type": "text/plain" }, "key": "x-signature-nonce", "value": "" }, { "disabled": false, "description": { "content": "(Required) API interface version. Supported values: `v2`, `v3`.", "type": "text/plain" }, "key": "x-version", "value": "" }, { "disabled": false, "description": { "content": "(Required) A signature is a unique digital fingerprint, typically encrypted, that verifies the authenticity and integrity of a message or transaction, ensuring it has not been tampered with during transmission.", "type": "text/plain" }, "key": "x-signature", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET" } } ```