--- title: "Get An Account by ID" method: GET path: "/v1/accounts/{account_id}" tags: ["Accounts"] --- # Get An Account by ID `GET /v1/accounts/{account_id}` ## Request - Base URL: `https://broker-api.giftcity.sandbox.in.alpaca.markets` - URL: `https://broker-api.giftcity.sandbox.in.alpaca.markets/v1/accounts/{account_id}` - Auth: HTTP basic You can query a specific account that you submitted to Alpaca by passing into the query the account_id associated with the account you're retrieving. ## Response `200` Will return an AccountExtended if an account with account_id exists, otherwise will throw an error. - AccountExtended: Represents an account with all data available. If your api response is missing some of these fields, there is a good chance you are using a route that returns `Account` instances instead of these. - `account_name` string - `account_number` string, nullable, required - `account_sub_type` 'traditional' | 'roth': IRA Account only Possible values are: - traditional - roth - `account_type` 'trading' | 'custodial' | 'donor_advised' | 'ira' | 'trust' | 'omnibus_non_disclosed' | 'omnibus_sub' | 'hsa' | 'joint', required: The account type returned for the account. - `agreements` Agreement[] - `agreement` 'margin_agreement' | 'account_agreement' | 'customer_agreement' | 'crypto_agreement' | 'options_agreement', required: - margin_agreement: Alpaca Margin Agreement - account_agreement: Alpaca Account Agreement - customer_agreement: Alpaca Customer Agreement - crypto_agreement: Alpaca Crypto agreement - options_agreement: Alpaca Option agreement - custodial_customer_agreement: Alpaca Custodial Customer agreement - `ip_address` string, ipv4, required: The ip_address the signed agreements were sent from by the user. - `revision` string: The agreement revision. The format is XX.YYYY.MM where XX is an incrementing revision number, YYYY is the year and MM is the month. If the revision is not specified in a POST or PATCH request, the active revision will be used, which will align with the [Alpaca Documents Library](https://alpaca.markets/disclosures). - `signed_at` string, date-time, required: The timestamp the agreement was signed. - `allow_instant_ach` boolean: Determines whether the account is enabled for Instant ACH by the partner. - `beneficiaries` Beneficiary[] - `date_of_birth` string, date, required: Date of birth in YYYY-MM-DD format. It cannot be in the future. - `family_name` string, required: Beneficiary family name. - `given_name` string, required: Beneficiary given name. - `middle_name` string, nullable: Beneficiary middle name. Omit this field or send null when the beneficiary has no middle name. An empty string is rejected. Account responses always include the field and use null when it is unset. - `relationship` 'spouse' | 'other', required: Relationship of the beneficiary to the account holder. - `share_pct` string, decimal, required: Share of the account allocated to this beneficiary, as a decimal string. The value must be greater than 0 and at most 100, with at most two decimal places. - `tax_id` string, required: Beneficiary tax identifier. Create and update requests require a USA SSN. Account responses always return the masked value `xxx-xx-xxxx`. - `tax_id_type` 'USA_SSN', required: Tax identifier type. - `type` 'primary' | 'contingent', required: Whether this beneficiary is primary or contingent. An account with beneficiaries needs at least one primary beneficiary. The `share_pct` values of all primary beneficiaries must add up to 100, and the `share_pct` values of all contingent beneficiaries, if any, must also add up to 100. - `cash_interest` AccountCashInterestResponse: The configuration and status of the account's USD cash interest program - `USD` AccountCashInterestProgram - `apr_tier_name` string: The unique name of the APR tier for a specific program - `status` string: The status of the account within a cash interest program. One of: - **ACTIVE** The account is enrolled and eligible for idle cash to be swept at the end of day (EOD). - **INACTIVE** The account is not enrolled due to it either not being eligible (e.g. the updated Alpaca Customer Agreement has not been signed), an APR tier needs to be assigned, or they have been unenrolled. - **PENDING_CHANGE** An enrollment, APR Tier change, or unenrollment is in progress - `contact` Contact: Contact is the model for the account owner contact information. - `city` string, required - `country` string: country code in ISO 3166-1 alpha-3 format, representing the country the person/entity resides in. - `email_address` string, email, required - `phone_number` string, nullable: Phone number should include the country code, format: "+15555555555" - `postal_code` string - `state` string: Required if the country or country_of_tax_residence (in the identity model below) is 'USA'. - `street_address` StreetAddress[], required: The user's street address. If multiple lines in address, pass in as additional array elements. Maximum of 3 objects in array - `unit` string: The specific apartment number if applicable - `created_at` string, date-time, required - `crypto_status` 'INACTIVE' | 'PAPER_ONLY' | 'ONBOARDING' | 'SUBMITTED' | 'SUBMISSION_FAILED' | 'ACTION_REQUIRED' | 'ACCOUNT_UPDATED' | 'APPROVAL_PENDING' | 'APPROVED' | 'REJECTED' | 'ACTIVE' | 'ACCOUNT_CLOSED': Designates the current status of this account Possible Values: - **INACTIVE** Account not set to trade given asset. - **PAPER_ONLY** The account is limited to paper trading. - **ONBOARDING** An application is expected for this user, but has not been submitted yet. - **SUBMITTED** The application has been submitted and is being processed. - **SUBMISSION_FAILED** Used to display if failure on submission - **ACTION_REQUIRED** The application requires manual action. - **ACCOUNT_UPDATED** Used to display when Account has been modified by user - **APPROVAL_PENDING** Initial value. The application approval process is in progress. - **APPROVED** The account application has been approved, and waiting to be ACTIVE - **REJECTED** The account application is rejected for some reason - **ACTIVE** The account is fully active. Trading and funding are processed under this status. - **ACCOUNT_CLOSED** The account is closed. - `currency` string, required: "USD" // US Dollar "JPY" // Japanese Yen "EUR" // Euro "CAD" // Canadian Dollar "GBP" // British Pound Sterling "CHF" // Swiss Franc "TRY" // Turkish Lira "AUD" // Australian Dollar "CZK" // Czech Koruna "SEK" // Swedish Krona "DKK" // Danish Krone "SGD" // Singapore Dollar "HKD" // Hong Kong Dollar "HUF" // Hungarian Forint "NZD" // New Zealand Dollar "NOK" // Norwegian Krone "PLN" // Poland Złoty - `custodial_account_type` string: Represents the type of custodial account based on the state where the beneficiary resides. This value is returned only when the `country_of_tax_residence` is `USA`. For other countries, this property is not included in the response. **Possible Return Values** `CustodianTypeUTMA` - Indicates that the custodial account is governed by the Uniform Transfers to Minors Act. `CustodianTypeUGMA` - Indicates that the custodial account is governed by the Uniform Gifts to Minors Act. - `disclosures` Disclosures: Disclosures fields denote if the account owner falls under each category defined by FINRA rule. The client has to ask questions for the end user and the values should reflect their answers. If one of the answers is true (yes), the account goes into ACTION_REQUIRED status. - `context` DisclosureContextAnnotation[], nullable: Array of annotations describing the rationale for marking `is_control_person`, `is_affiliated_exchange_or_finra`, and/or `immediate_family_exposed` as true - `company_city` string: Required for FINRA affiliations and controlled firms. - `company_compliance_email` string: Required for FINRA affiliations and controlled firms. - `company_country` string: Required for FINRA affiliations and controlled firms. - `company_name` string: Required for FINRA affiliations and controlled firms. - `company_state` string: Required if and only if `company_country` is `USA`. - `company_street_address` string: Required for FINRA affiliations and controlled firms. - `context_type` 'CONTROLLED_FIRM' | 'IMMEDIATE_FAMILY_EXPOSED' | 'AFFILIATE_FIRM', required: Specifies the type of disclosure annotation. Valid types are FINRA affiliations, for users affiliated with or employed by a FINRA member firm, a Stock Exchange Member, FINRA, Registered Investment Advisor, or a Municipal Securities Broker/Dealer; Company control relationships, for senior executives, and 10% or greater shareholders, of a publicly traded company; and immediate family members of politically exposed individuals. - `family_name` string: Required for immediate family members of politically exposed persons. - `given_name` string: Required for immediate family members of politically exposed persons. - `employer_address` string: The employer's address if the user is employed. - `employer_name` string: The name of the employer if the user is employed. - `employment_position` string: The user's position if they are employed. - `employment_sector` 'agriculture' | 'business_management' | 'computers_and_it' | 'construction' | 'education' | 'finance' | 'government' | 'healthcare' | 'hospitality' | 'manufacturing' | 'marketing' | 'media' | 'other' | 'science' | 'self_employed' | 'transportation' | 'not_employed': The industry sector of employment. If the `employment_status` is `unemployed` or `student`, set this property to `not_employed`. If the `employment_status` is `retired`, set this to `self_employed`. - `employment_status` 'unemployed' | 'employed' | 'student' | 'retired': One of the following: `employed`, `unemployed`, `retired`, or `student`. - `immediate_family_exposed` boolean, required: If your user's immediate family member (sibling, husband/wife, child, parent) is either politically exposed or holds a control position. - `is_affiliated_exchange_or_finra` boolean, required: Whether user is affiliated with any exchanges or FINRA. - `is_control_person` boolean, required: Whether user holds a controlling position in a publicly traded company, member of the board of directors or has policy making abilities in a publicly traded company. - `is_politically_exposed` boolean, required: Whether the user is politically exposed. - `documents` OwnerDocument[]: The documents associated with the primary owner of the account - `created_at` string, date-time, required - `document_sub_type` string: The sub-type of the document. This is a free-form property. - `document_type` 'account_approval_letter' | 'address_verification' | 'cip_result' | 'company_formation' | 'date_of_birth_verification' | 'entity_operating_document' | 'entity_registration' | 'hio_declaration_form' | 'identity_verification' | 'limited_trading_authorization' | 'pep_declaration_form' | 'tax_id_verification' | 'w8ben' | 'w9', required: The type of the owner document - `id` string, uuid, required - `mime_type` string - `enabled_assets` EnabledAssetClass[] - `fpsl` AccountFPSLResponse: The account's Fully Paid Securities Lending (FPSL) configuration. This is only returned for accounts that have FPSL enabled. - `US` AccountFPSLItem - `status` string: The status of the account for this FPSL market. One of: - **ACTIVE** The account is successfully enrolled for FPSL for this market. - **INACTIVE** The account is not enrolled for FPSL for this market due to it either not being eligible, an FPSL tier has not been assigned, or it has been unenrolled. - `tier_id` string, uuid: The id of the FPSL tier for this market - `id` string, uuid, required - `identity` Identity: Identity is the model to provide account owner's identity information. - `annual_income_max` string, decimal: The upper bound of the user's annual income. - `annual_income_min` string, decimal: The lower bound of the user's annual income. - `country_of_birth` string: [ISO 3166-1 alpha-3](https://www.iso.org/iso-3166-country-codes.html). - `country_of_citizenship` string: [ISO 3166-1 alpha-3](https://www.iso.org/iso-3166-country-codes.html). - `country_of_tax_residence` string, required: [ISO 3166-1 alpha-3](https://www.iso.org/iso-3166-country-codes.html). - `date_of_birth` string, date, required: The date of birth in "YYYY-MM-DD" format. - `date_of_departure_from_usa` string, date: Required if `visa_type` = B1 or B2 - `family_name` string, required: The last name (surname) of the user. - `funding_source` string[], required: Can be one or more of the following: `employment_income`, `investments`, `inheritance`, `business_income`, `savings`, `family`. - `given_name` string, required: The first/given name of the user. - `investment_experience_with_options` 'none' | '1_to_5_years' | 'over_5_years': The user's level of expertise and familiarity with investing in Options. - `investment_experience_with_stocks` 'none' | '1_to_5_years' | 'over_5_years': The user's level of expertise and familiarity with investing in US Equities. - `investment_objective` 'generate_income' | 'preserve_wealth' | 'market_speculation' | 'growth' | 'balance_preserve_wealth_with_growth': The user's investment objective. This field is deprecated. Please use the top level `investment_objective` field. - `investment_time_horizon` 'less_than_1_year' | '1_to_2_years' | '3_to_5_years' | '6_to_10_years' | 'more_than_10_years': The expected period of time the user plan to invest to achieve his/her financial goal(s). This field is deprecated. Please use the top level `investment_time_horizon` field. - `liquid_net_worth_max` string, decimal: The upper bound of the user's liquid net worth. - `liquid_net_worth_min` string, decimal: The lower bound of the user's liquid net worth. - `liquidity_needs` 'very_important' | 'important' | 'somewhat_important' | 'does_not_matter': The user's ability to quickly and easily convert all or part of their investments in this account to cash without significant loss in value. This field is deprecated. Please use the top level `liquidity_needs` field. - `marital_status` 'SINGLE' | 'MARRIED' | 'DIVORCED' | 'WIDOWED': The marital status of the user. - `middle_name` string: The middle name of the user. - `number_of_dependents` integer: The number of dependents the user has. - `permanent_resident` boolean: Only used to collect permanent residence status in the USA. - `risk_tolerance` 'conservative' | 'moderate' | 'significant_risk': The user's investment risk tolerance. This field is deprecated. Please use the top level `risk_tolerance` field. - `tax_id` string: If this is provided, `tax_id_type` is required. - `tax_id_type` 'USA_SSN' | 'USA_ITIN' | 'ARG_AG_CUIT' | 'AUS_TFN' | 'AUS_ABN' | 'BOL_NIT' | 'BRA_CPF' | 'CHL_RUT' | 'COL_NIT' | 'CRI_NITE' | 'DEU_TAX_ID' | 'DOM_RNC' | 'ECU_RUC' | 'FRA_SPI' | 'GBR_UTR' | 'GBR_NINO' | 'GTM_NIT' | 'HND_RTN' | 'HUN_TIN' | 'IDN_KTP' | 'IND_PAN' | 'ISR_TAX_ID' | 'ITA_TAX_ID' | 'JPN_TAX_ID' | 'MEX_RFC' | 'NIC_RUC' | 'NLD_TIN' | 'PAN_RUC' | 'PER_RUC' | 'PRY_RUC' | 'SGP_NRIC' | 'SGP_FIN' | 'SGP_ASGD' | 'SGP_ITR' | 'SLV_NIT' | 'SWE_TAX_ID' | 'URY_RUT' | 'VEN_RIF' | 'NATIONAL_ID' | 'PASSPORT' | 'PERMANENT_RESIDENT' | 'DRIVER_LICENSE' | 'OTHER_GOV_ID' | 'NOT_SPECIFIED': An Enum of the various kinds of Tax ID formats Alpaca supports. Possible Values are: - **USA_SSN** USA Social Security Number - **USA_ITIN** USA Individual Taxpayer Identification Number - **ARG_AR_CUIT** Argentina CUIT - **AUS_TFN** Australian Tax File Number - **AUS_ABN** Australian Business Number - **BOL_NIT** Bolivia NIT - **BRA_CPF** Brazil CPF - **CHL_RUT** Chile RUT - **COL_NIT** Colombia NIT - **CRI_NITE** Costa Rica NITE - **DEU_TAX_ID** Germany Tax ID (Identifikationsnummer) - **DOM_RNC** Dominican Republic RNC - **ECU_RUC** Ecuador RUC - **FRA_SPI** France SPI (Reference Tax Number) - **GBR_UTR** UK UTR (Unique Taxpayer Reference) - **GBR_NINO** UK NINO (National Insurance Number) - **GTM_NIT** Guatemala NIT - **HND_RTN** Honduras RTN - **HUN_TIN** Hungary TIN Number - **IDN_KTP** Indonesia KTP - **IND_PAN** India PAN Number - **ISR_TAX_ID** Israel Tax ID (Teudat Zehut) - **ITA_TAX_ID** Italy Tax ID (Codice Fiscale) - **JPN_TAX_ID** Japan Tax ID (Kojin Bango) - **MEX_RFC** Mexico RFC - **NIC_RUC** Nicaragua RUC - **NLD_TIN** Netherlands TIN Number - **PAN_RUC** Panama RUC - **PER_RUC** Peru RUC - **PRY_RUC** Paraguay RUC - **SGP_NRIC** Singapore NRIC - **SGP_FIN** Singapore FIN - **SGP_ASGD** Singapore ASGD - **SGP_ITR** Singapore ITR - **SLV_NIT** El Salvador NIT - **SWE_TAX_ID** Sweden Tax ID (Personnummer) - **URY_RUT** Uruguay RUT - **VEN_RIF** Venezuela RIF - **NATIONAL_ID** National ID number, if a tax ID number is not available - **PASSPORT** Passport number, if a tax ID number is not available - **PERMANENT_RESIDENT** Permanent resident number, if a tax ID number is not available - **DRIVER_LICENSE** Driver's license number, if a tax ID number is not available - **OTHER_GOV_ID** Other government issued identifier, if a tax ID number is not available - **NOT_SPECIFIED** Other Tax IDs - `total_net_worth_max` string, decimal: The upper bound of the user's total net worth. - `total_net_worth_min` string, decimal: The lower bound of the user's total net worth. - `visa_expiration_date` string, date: Required if `visa_type` is set. - `visa_type` string: Only used to collect visa types for users residing in the USA. - `instant_ach_blocked` boolean: Indicates whether the account is blocked for Instant ACH by Alpaca. Defaults to false when the partner creates the account. If the partner has set allow_instant_ach to true but instant_ach_blocked is true, then the account is blocked for Instant ACH irrespective of the fact that the partner has it enabled. - `investment_objective` 'generate_income' | 'preserve_wealth' | 'market_speculation' | 'growth' | 'balance_preserve_wealth_with_growth': The user's investment objective. This field should be used instead of the deprecated `investment_objective` under identity. - `investment_time_horizon` 'less_than_1_year' | '1_to_2_years' | '3_to_5_years' | '6_to_10_years' | 'more_than_10_years': The expected period of time the user plan to invest to achieve his/her financial goal(s). This field should be used instead of the deprecated `investment_time_horizon` under identity. - `kyc_results` KYCResults, nullable: Holds information about the result of KYC. `accept`, `indeterminate`, and `reject` are nullable sets represented as objects. Each property name is a KYC reason identifier, and every property value is always an empty object (`{}`) carrying no nested data. For example: ```json { "IDENTITY_VERIFICATION": {}, "WATCHLIST_HIT": {} } ``` Interpret each reason together with its enclosing result category and `additional_information`. Documented reason identifiers: - `IDENTITY_VERIFICATION`: A government-issued identity document is required to verify the account owner's identity. - `TAX_IDENTIFICATION`: A tax identification document is required to verify the account owner's tax identification number. - `ADDRESS_VERIFICATION`: Additional documentation, such as a government-issued ID or statement, may be required to verify the account owner's residential address. - `DATE_OF_BIRTH`: A government-issued identity document is required to verify the account owner's date of birth. - `SELFIE_VERIFICATION`: A live selfie of the account owner is required to verify identity. - `PEP`: The account owner disclosed politically exposed person status, and additional information may be required. - `FAMILY_MEMBER_PEP`: The account owner disclosed that an immediate family member is politically exposed, and additional information may be required. - `CONTROL_PERSON`: Additional company information may be required because the account owner disclosed a control position. - `AFFILIATED`: Additional firm information may be required because the account owner disclosed an affiliation with FINRA or an exchange. - `VISA_TYPE_OTHER`: The account owner's visa type and expiration date may be required because the submitted visa type was "other." - `W8BEN_CORRECTION`: A new W-8BEN with corrected identifying information is required. - `COUNTRY_NOT_SUPPORTED`: The account owner's country of tax residence or legal residence is not supported for this account. - `WATCHLIST_HIT`: Watchlist screening returned a result that requires further review; no action is needed from the account owner unless separately requested. - `OTHER`: See `additional_information` for a custom message describing what is required from the account owner. - `OTHER_PARTNER`: See `additional_information` for a custom message intended for the Broker API partner. - `CITIZENSHIP_COUNTRY_NOT_SUPPORTED`: The account owner's country of citizenship is not supported for this account. - `DIFFERING_COUNTRY`: A submitted identity document was issued by a country different from the account owner's country of tax residence. - `WL_PEP_SCREENING`: Watchlist screening returned a result related to possible political exposure. - `WL_LEGAL_REGULATORY_WARNING`: Watchlist screening returned a legal or regulatory warning result. - `UNDER_MINIMUM_AGE`: The account owner does not meet the minimum age requirement for this account. - `PEP_FOREIGN`: The account owner disclosed foreign politically exposed person status, and additional information may be required. - `FAMILY_MEMBER_PEP_FOREIGN`: The account owner disclosed that an immediate family member has foreign politically exposed person status, and additional information may be required. - `DISCRETIONARY`: The account is designated for discretionary trading by a registered investment adviser and requires review. - `HIO`: Additional information and a declaration form may be required because the account owner disclosed being the head of an international organization. - `INTERNAL_CHECK`: A non-specific account-opening check contributed to the KYC outcome; no more specific reason is available. - `compromised_document`: The identity document check indicated that the document may be compromised. - `data_comparison`: Data extracted from the identity document did not pass comparison checks and requires review. - `image_integrity`: A document or selfie image did not pass image-integrity checks and requires review. The set of reason identifiers is extensible, so integrations must tolerate and preserve unrecognized values. - `accept` KYCResultTypeSet, nullable: A nullable set of KYC reason identifiers represented as property names with empty object values. See `KYCResults` for documented identifiers and interpretation guidance. - `additional_information` string: Used to display a custom message. - `indeterminate` KYCResultTypeSet, nullable: A nullable set of KYC reason identifiers represented as property names with empty object values. See `KYCResults` for documented identifiers and interpretation guidance. - `reject` KYCResultTypeSet, nullable: A nullable set of KYC reason identifiers represented as property names with empty object values. See `KYCResults` for documented identifiers and interpretation guidance. - `summary` string: Either `pass` or `fail`. Used to indicate if KYC has completed and passed or not. This field is used for internal purposes only. - `last_equity` string, decimal, required - `liquidity_needs` 'very_important' | 'important' | 'somewhat_important' | 'does_not_matter': The user's ability to quickly and easily convert to cash all or a portion of the investments in this account without experiencing significant loss in value. This field should be used instead of the deprecated `liquidity_needs` under identity. - `minor_identity` CustodialAccountMinorIdentity: Represents Identity information for a minor that an account of type "custodial" is for - `country_of_birth` string - `country_of_citizenship` string - `country_of_tax_residence` string, required - `date_of_birth` string, date, required - `email` string, email, required - `family_name` string, required - `given_name` string, required - `state` string, required - `tax_id` string - `tax_id_type` 'USA_SSN' | 'USA_ITIN' | 'ARG_AG_CUIT' | 'AUS_TFN' | 'AUS_ABN' | 'BOL_NIT' | 'BRA_CPF' | 'CHL_RUT' | 'COL_NIT' | 'CRI_NITE' | 'DEU_TAX_ID' | 'DOM_RNC' | 'ECU_RUC' | 'FRA_SPI' | 'GBR_UTR' | 'GBR_NINO' | 'GTM_NIT' | 'HND_RTN' | 'HUN_TIN' | 'IDN_KTP' | 'IND_PAN' | 'ISR_TAX_ID' | 'ITA_TAX_ID' | 'JPN_TAX_ID' | 'MEX_RFC' | 'NIC_RUC' | 'NLD_TIN' | 'PAN_RUC' | 'PER_RUC' | 'PRY_RUC' | 'SGP_NRIC' | 'SGP_FIN' | 'SGP_ASGD' | 'SGP_ITR' | 'SLV_NIT' | 'SWE_TAX_ID' | 'URY_RUT' | 'VEN_RIF' | 'NATIONAL_ID' | 'PASSPORT' | 'PERMANENT_RESIDENT' | 'DRIVER_LICENSE' | 'OTHER_GOV_ID' | 'NOT_SPECIFIED', required: An Enum of the various kinds of Tax ID formats Alpaca supports. Possible Values are: - **USA_SSN** USA Social Security Number - **USA_ITIN** USA Individual Taxpayer Identification Number - **ARG_AR_CUIT** Argentina CUIT - **AUS_TFN** Australian Tax File Number - **AUS_ABN** Australian Business Number - **BOL_NIT** Bolivia NIT - **BRA_CPF** Brazil CPF - **CHL_RUT** Chile RUT - **COL_NIT** Colombia NIT - **CRI_NITE** Costa Rica NITE - **DEU_TAX_ID** Germany Tax ID (Identifikationsnummer) - **DOM_RNC** Dominican Republic RNC - **ECU_RUC** Ecuador RUC - **FRA_SPI** France SPI (Reference Tax Number) - **GBR_UTR** UK UTR (Unique Taxpayer Reference) - **GBR_NINO** UK NINO (National Insurance Number) - **GTM_NIT** Guatemala NIT - **HND_RTN** Honduras RTN - **HUN_TIN** Hungary TIN Number - **IDN_KTP** Indonesia KTP - **IND_PAN** India PAN Number - **ISR_TAX_ID** Israel Tax ID (Teudat Zehut) - **ITA_TAX_ID** Italy Tax ID (Codice Fiscale) - **JPN_TAX_ID** Japan Tax ID (Kojin Bango) - **MEX_RFC** Mexico RFC - **NIC_RUC** Nicaragua RUC - **NLD_TIN** Netherlands TIN Number - **PAN_RUC** Panama RUC - **PER_RUC** Peru RUC - **PRY_RUC** Paraguay RUC - **SGP_NRIC** Singapore NRIC - **SGP_FIN** Singapore FIN - **SGP_ASGD** Singapore ASGD - **SGP_ITR** Singapore ITR - **SLV_NIT** El Salvador NIT - **SWE_TAX_ID** Sweden Tax ID (Personnummer) - **URY_RUT** Uruguay RUT - **VEN_RIF** Venezuela RIF - **NATIONAL_ID** National ID number, if a tax ID number is not available - **PASSPORT** Passport number, if a tax ID number is not available - **PERMANENT_RESIDENT** Permanent resident number, if a tax ID number is not available - **DRIVER_LICENSE** Driver's license number, if a tax ID number is not available - **OTHER_GOV_ID** Other government issued identifier, if a tax ID number is not available - **NOT_SPECIFIED** Other Tax IDs - `primary_account_holder_id` string, uuid, nullable: UUID of the account's primary holder when available; otherwise `null`. - `risk_tolerance` 'conservative' | 'moderate' | 'significant_risk': The user's investment risk tolerance. This field should be used instead of the deprecated `risk_tolerance` under identity. - `status` 'INACTIVE' | 'PAPER_ONLY' | 'ONBOARDING' | 'SUBMITTED' | 'SUBMISSION_FAILED' | 'ACTION_REQUIRED' | 'ACCOUNT_UPDATED' | 'APPROVAL_PENDING' | 'APPROVED' | 'REJECTED' | 'ACTIVE' | 'ACCOUNT_CLOSED', required: Designates the current status of this account Possible Values: - **INACTIVE** Account not set to trade given asset. - **PAPER_ONLY** The account is limited to paper trading. - **ONBOARDING** An application is expected for this user, but has not been submitted yet. - **SUBMITTED** The application has been submitted and is being processed. - **SUBMISSION_FAILED** Used to display if failure on submission - **ACTION_REQUIRED** The application requires manual action. - **ACCOUNT_UPDATED** Used to display when Account has been modified by user - **APPROVAL_PENDING** Initial value. The application approval process is in progress. - **APPROVED** The account application has been approved, and waiting to be ACTIVE - **REJECTED** The account application is rejected for some reason - **ACTIVE** The account is fully active. Trading and funding are processed under this status. - **ACCOUNT_CLOSED** The account is closed. - `trading_configurations` AccountConfigurations: Represents additional configuration settings for an account - `disable_overnight_trading` boolean: If true, overnight trading is disabled. - `fractional_trading` boolean: If true, account is able to participate in fractional trading - `max_margin_multiplier` string: Can be "1" or "2" - `max_options_trading_level` 0 | 1 | 2 | 3: The desired maximum options trading level. 0=disabled, 1=Covered Call/Cash-Secured Put, 2=Long Call/Put, 3=Spreads/Straddles. - `no_shorting` boolean: If true, account becomes long-only mode. - `ptp_no_exception_entry` boolean: If set to true then Alpaca will accept orders for PTP symbols with no exception. Default is false. - `suspend_trade` boolean: If true, new orders are blocked. - `trade_confirm_email` 'all' | 'none': all or none. If none, emails for order fills are not sent. - `trusted_contact` union: This model input is optional. However, the client should make a reasonable effort to obtain the trusted contact information. See [FINRA Notice 17-11](https://www.finra.org/sites/default/files/Regulatory-Notice-17-11.pdf) for more details. At least one of the following is required: - `email_address` - `phone_number` - `street_address` - object - `city` string: Required if `street_address` is set. - `country` string: The country in [ISO 3166-1 alpha-3](https://www.iso.org/iso-3166-country-codes.html) format. Required if `street_address` is set. - `email_address` string, email, required: At least one of `email_address`, `phone_number`, or `street_address` is required. - `family_name` string, required - `given_name` string, required - `phone_number` string: At least one of `email_address`, `phone_number`, or `street_address` is required. - `postal_code` string: Required if `street_address` is set. - `state` string: Required if `street_address` is set. - `street_address` string[]: At least one of `email_address`, `phone_number`, or `street_address` is required. - object - `city` string: Required if `street_address` is set. - `country` string: The country in [ISO 3166-1 alpha-3](https://www.iso.org/iso-3166-country-codes.html) format. Required if `street_address` is set. - `email_address` string, email: At least one of `email_address`, `phone_number`, or `street_address` is required. - `family_name` string, required - `given_name` string, required - `phone_number` string, required: At least one of `email_address`, `phone_number`, or `street_address` is required. - `postal_code` string: Required if `street_address` is set. - `state` string: Required if `street_address` is set. - `street_address` string[]: At least one of `email_address`, `phone_number`, or `street_address` is required. - object - `city` string: Required if `street_address` is set. - `country` string: The country in [ISO 3166-1 alpha-3](https://www.iso.org/iso-3166-country-codes.html) format. Required if `street_address` is set. - `email_address` string, email: At least one of `email_address`, `phone_number`, or `street_address` is required. - `family_name` string, required - `given_name` string, required - `phone_number` string: At least one of `email_address`, `phone_number`, or `street_address` is required. - `postal_code` string: Required if `street_address` is set. - `state` string: Required if `street_address` is set. - `street_address` string[], required: At least one of `email_address`, `phone_number`, or `street_address` is required. - `usd` object: values in USD. This is returned for LCT (non-USD) accounts only. - `last_equity` string, decimal --- [API](https://skmtc.dev/alpacahq/apis/broker-api.md) - [All operations](https://skmtc.dev/alpacahq/apis/broker-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alpacahq/apis/broker-api/revisions/381b1ecb3ccc?raw)