# Retrieve Application Status

Retrieve the detailed status of an application

Endpoint: GET /v1/applications/{application_id}/status
Version: 1.1.2
Security: OAuth2Flow

## Path parameters:

  - `id` (string, required)
    Application ID

## Header parameters:

  - `Authorization` (string)
    OAuth bearer token (see authentication flows)

  - `x-l2f-request-id` (string)
    Optional Unique ID per request, useful for fault resolution/diagnosis and audit.

## Response 200 fields (application/json):

  - `data` (object, required)

  - `data.id` (string, required)
    Unique Identifier for the application

  - `data.status` (string, required)
    Status of the application
    Enum: "INCOMPLETE", "READY_FOR_SUBMISSION", "SUBMITTED", "PROCESSING", "CHANGES_REQUESTED", "REJECTED", "APPROVED"

  - `data.application_errors` (array)
    List of errors with the application.
    Enum: "MISSING_BENEFICIAL_OWNER", "MISSING_OFFICER", "MISSING_INDIVIDUAL", "TERMS_AND_CONDITIONS_NOT_ACCEPTED", "MISSING_AUTHORIZED_PERSON", "MISSING_CONTROL_PERSON"

  - `data.validation_errors` (array)
    List of validation errors with the application.

  - `data.validation_errors.field_name` (string, required)
    Application field to be corrected
    Enum: "customer_id", "account_to_open", "product_type", "asset_type", "id", "information_attested", "registered_name", "trading_name", "registered_number", "registered_address.unit_number", "registered_address.address_line1", "registered_address.address_line2", "registered_address.address_line3", "registered_address.city", "registered_address.state", "registered_address.postal_code", "registered_address.country_code", "telephone_number", "website_address", "state_of_incorporation", "country_of_incorporation", "corporate_entity_type", "contact_title", "contact_first_name", "contact_last_name", "contact_telephone_number", "contact_email_address", "physical_address.unit_number", "physical_address.address_line1", "physical_address.address_line2", "physical_address.address_line3", "physical_address.city", "physical_address.state", "physical_address.postal_code", "physical_address.country_code", "primary_business", "description_of_business_nature", "is_charitable", "business_jurisdictions", "funds_send_receive_jurisdictions", "new_york_office", "engage_in_activities", "regulated_status", "regulation_agency_regulation_number", "control_exemption_reason", "vendors_and_counterparties", "primary_source_of_funds", "total_investable_assets", "total_assets", "asset_allocation_to_crypto", "investment_experience_crypto", "investment_strategy_crypto", "initial_deposit_source", "ongoing_deposit_source", "frequency_of_crypto_transactions", "crypto_investment_plans", "investment_proceeds_use", "expected_crypto_assets", "perform_transfers_with_unhosted_wallets", "known_unhosted_wallet_addresses", "trades_per_month", "usd_value_of_crypto", "frequency_of_transactions", "monthly_crypto_investment_deposit", "monthly_investment_deposit", "monthly_crypto_deposits", "monthly_deposits", "monthly_crypto_investment_withdrawal", "monthly_investment_withdrawal", "monthly_crypto_withdrawals", "monthly_withdrawals", "trade_internationally", "trade_jurisdictions"

  - `data.validation_errors.status` (string, required)
    Error status of the field
    Enum: "INCOMPLETE", "READY_FOR_SUBMISSION", "CHANGES_REQUESTED", "APPROVED"

  - `data.validation_errors.description` (string)
    Additional supporting error details

  - `data.application_document_errors` (array)
    List of document errors with the application.

  - `data.application_document_errors.document_id` (string, required)
    Unique identifier of the document
    Enum: "MISSING", "SUBMITTED", "CHANGES_REQUESTED", "REJECTED", "APPROVED"

  - `data.application_document_errors.document` (string, required)
    Document Type the error occurred on
    Enum: "ANNUAL_REPORT", "BENEFICIAL_OWNERSHIP_CERTIFICATE", "BILL_OF_LADING", "CONTRACT", "DRIVERS_LICENCE_BACK", "DRIVERS_LICENCE_FRONT", "FINANCIAL_STATEMENT", "GOVERNMENT_ID_BACK", "GOVERNMENT_ID_FRONT", "INCORPORATION_DOCUMENTS", "INVOICE", "LEASE_AGREEMENT", "LLC_AGREEMENT", "OWNERSHIP_STRUCTURE_CHART", "PARTNERSHIP_AGREEMENT", "PASSPORT", "POWER_OF_ATTORNEY", "REGULATORY_LICENSE", "SELFIE", "SOCIAL_SECURITY_CARD", "UTILITY_BILL"

  - `data.application_document_errors.status` (string, required)
    Status of the document upload
    Enum: "MISSING", "SUBMITTED", "CHANGES_REQUESTED", "REJECTED", "APPROVED"

  - `data.application_document_errors.mandatory` (boolean, required)
    Indicates if the document is mandatory

  - `data.application_individual_errors` (array)
    ONLY for corporate applications. List of errors for the submitted individuals

  - `data.application_individual_errors.individual_id` (string)

  - `data.application_individual_errors.validation_errors` (array)

  - `data.application_individual_errors.validation_errors.field_name` (string, required)
    Individual field to be corrected
    Enum: "id", "person_role", "person_status", "first_name", "middle_name", "last_name", "email_address", "mailing_address.unit_number", "mailing_address.address_line1", "mailing_address.address_line2", "mailing_address.address_line3", "mailing_address.city", "mailing_address.state", "mailing_address.postal_code", "mailing_address.country_code", "telephone_number", "tax_reference_number", "passport_number", "nationality", "citizenship", "date_of_birth", "percentage_ownership", "title", "us_residency_status"

  - `data.application_individual_errors.document_errors` (array)

  - `data.created_date` (string, required)
    Date when the application was created

  - `data.status_update_date` (string, required)
    Date when the application was updated

## Response 400 fields (application/json):

  - `errors` (array)
    Error List

  - `errors.code` (string)
    Layer2 Standard Error Code

  - `errors.description` (string)
    Error Description

## Response 401 fields (application/json):

  - `errors` (array)
    Error List

  - `errors.code` (string)
    Layer2 Standard Error Code

  - `errors.description` (string)
    Error Description

## Response 404 fields (application/json):

  - `errors` (array)
    Error List

  - `errors.code` (string)
    Layer2 Standard Error Code

  - `errors.description` (string)
    Error Description

## Response 500 fields (application/json):

  - `errors` (array)
    Error List

  - `errors.code` (string)
    Layer2 Standard Error Code

  - `errors.description` (string)
    Error Description