--- title: "Retrieve an application by client application ID" method: GET path: "/v0/applications" tags: ["Compliance"] --- # Retrieve an application by client application ID `GET /v0/applications` ## Request - Base URL: `https://api.sandbox.lead.bank` - URL: `https://api.sandbox.lead.bank/v0/applications` - Auth: HTTP bearer Retrieves an application by the `client_application_id` you assigned, supplied as a query parameter: `GET /v0/applications?client_application_id=...`. This is the filtered form of the applications collection and is distinct from `GET /v0/applications/{id}`, which takes the server-generated Application ID (`application_*`). The response body is identical to `GET /v0/applications/{id}`. ## Query parameters - `client_application_id` string, required ## Response `200` Application object retrieved successfully. - Application: An application object representing a credit application - `id` string: Unique identifier for the application. Prefixed with `application_`. - `client_application_id` string: Client-provided identifier for the application. Optional: present only for applications created via file upload, and omitted for applications created through the API, which are identified solely by their server-generated ID. - `created_at` string, date-time: Lead server-generated ISO 8601 timestamp when the application was created. - `updated_at` string, date-time: Lead server-generated ISO 8601 timestamp when the application was last updated. - `status` 'approved' | 'declined' | 'canceled': Terminal state of the application. Possible values: `approved`, `declined`, `canceled`. - `entities` ApplicationEntities: Entity relationships associated with the application (response only) - `account_holder_type` 'consumer' | 'commercial': Denotes whether the application is for a consumer or commercial account. `consumer` if all account holders are individuals; `commercial` if all account holders are businesses or sole proprietors. - `account_holders` EntityID[]: List of entity IDs that are account holders - `authorized_signers` EntityID[]: List of entity IDs that are authorized signers - `details` ApplicationDetails: Application details (response, all properties optional) - `product_name` string: Your internal product name. This tells Lead's Due Diligence team which product this application, if approved, would open an account for. - `credit` ApplicationCredit: Credit details for an application (response, all properties optional) - `is_secured` boolean: Indicates if this is a secured credit/deposit product. `true` if the product is secured (collateral attached); `false` otherwise. - `is_mla` boolean: `true` if the applicant is subject to the Military Lending Act; `false` otherwise. - `currency` 'AED' | 'AFN' | 'ALL' | 'AMD' | 'AOA' | 'ARS' | 'AUD' | 'AWG' | 'AZN' | 'BAM' | 'BBD' | 'BDT' | 'BGN' | 'BHD' | 'BIF' | 'BMD' | 'BND' | 'BOB' | 'BRL' | 'BSD' | 'BTN' | 'BWP' | 'BYN' | 'BZD' | 'CAD' | 'CDF' | 'CHF' | 'CLP' | 'CNH' | 'CNY' | 'COP' | 'CRC' | 'CUC' | 'CUP' | 'CVE' | 'CZK' | 'DJF' | 'DKK' | 'DOP' | 'DZD' | 'EGP' | 'ERN' | 'ETB' | 'EUR' | 'FJD' | 'FKP' | 'GBP' | 'GEL' | 'GGP' | 'GHS' | 'GIP' | 'GMD' | 'GNF' | 'GTQ' | 'GYD' | 'HKD' | 'HNL' | 'HTG' | 'HUF' | 'IDR' | 'ILS' | 'IMP' | 'INR' | 'IQD' | 'IRR' | 'ISK' | 'JEP' | 'JMD' | 'JOD' | 'JPY' | 'KES' | 'KGS' | 'KHR' | 'KMF' | 'KPW' | 'KRW' | 'KWD' | 'KYD' | 'KZT' | 'LAK' | 'LBP' | 'LKR' | 'LRD' | 'LSL' | 'LYD' | 'MAD' | 'MDL' | 'MGA' | 'MKD' | 'MMK' | 'MNT' | 'MOP' | 'MRU' | 'MUR' | 'MVR' | 'MWK' | 'MXN' | 'MYR' | 'MZN' | 'NAD' | 'NGN' | 'NIO' | 'NOK' | 'NPR' | 'NZD' | 'OMR' | 'PAB' | 'PEN' | 'PGK' | 'PHP' | 'PKR' | 'PLN' | 'PYG' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'RWF' | 'SAR' | 'SBD' | 'SCR' | 'SDG' | 'SEK' | 'SGD' | 'SHP' | 'SLE' | 'SOS' | 'SRD' | 'SSP' | 'STD' | 'STN' | 'SVC' | 'SYP' | 'SZL' | 'THB' | 'TJS' | 'TMT' | 'TND' | 'TOP' | 'TRY' | 'TTD' | 'TWD' | 'TZS' | 'UAH' | 'UGX' | 'USD' | 'UYU' | 'UYW' | 'UZS' | 'VES' | 'VND' | 'VUV' | 'WST' | 'XAF' | 'XCD' | 'XCG' | 'XMW' | 'XOF' | 'XPF' | 'YER' | 'ZAR' | 'ZMW' | 'ZWG': A three-letter currency code as defined in ISO 4217 - `underwriting_grade` string: Your internal underwriting grade for the applicant. Accepts any string mapped to your specific scoring framework. - `limit` integer: The credit limit assigned to the applicant, in minor units (e.g., cents). - `max_limit` integer: The maximum credit limit the applicant was approved for based on original underwriting, in minor units (e.g., cents). - `report` ApplicationCreditReport: Credit report information (response, all properties optional) - `score` integer: Credit score returned by the bureau. Supported range is 300-850. Mutually exclusive with `non_score_value`. - `non_score_value` 'unestablished' | 'frozen': Indicates the state of a credit file when a numeric score is not available. Mutually exclusive with `score`. - `pulled_at` string, date-time: ISO 8601 timestamp when the credit report was pulled. - `source` 'equifax' | 'transunion' | 'experian': Credit bureau that issued the report. Possible values: `equifax`, `experian`, `transunion`. - `adverse_action_notice` ApplicationAdverseActionNotice: Adverse action notice information (response, all properties optional) - `delivered_at` string, date-time: ISO 8601 timestamp when the adverse action notice was sent to the applicant. - `reason` string: The reason stated in the adverse action notice. - `delivery_method` 'email' | 'text' | 'other': How the notice was delivered to the applicant. Possible values: `email`, `text`, `other`. - `decision` ApplicationDecision: Decision-related information (response, all properties optional) - `decided_at` string, date-time: ISO 8601 timestamp when the underwriting decision was made. - `reason` string: The reason for the decision. - `exception_approval_reason` string: This should only be provided if the decision was made as an exception to underwriting criteria. Reason for exception approval, if this decision was made as an exception to the traditional underwriting process. - `documents` ApplicationComplianceDocument[]: Documents associated with the application - `document_id` string: Unique identifier for the document being referenced. Please use the file name of the file delivered to Lead's `/documents` SFTP directory. - `type` 'aan' | 'loan_agreement' | 'loc_agreement' | 'truth_in_lending_document' | 'ach_authorization' | 'notice_of_incompleteness' | 'credit_score_notice' | 'offer_summary' | 'personal_guarantee' | 'consumer_credit_auth' | 'partner_privacy_policy' | 'lead_privacy_policy' | 'terms_of_use' | 'esign_agreement' | 'credit_pull_consent' | 'fcra_notice' | 'tcpa_consent' | 'patriot_act_notice' | 'mla_notice' | 'pre_approval_terms' | 'eft_authorization' | 'prohibited_industry_certification' | 'decision_maker_document' | 'bo_certification' | 'missed_payments_policy' | 'consent_to_link_account' | 'consent_to_link_hsa' | 'negative_option_consent' | 'lead_funds_transfer_agreement' | 'deposit_agreement' | 'cardholder_agreement' | 'periodic_statement' | 'autopay_authorization': Type of document associated with an application - `displayed_at` string, date-time: ISO 8601 timestamp when the document was displayed to the applicant. Present on disclosure documents. - `consented_at` string, date-time: ISO 8601 timestamp when the applicant consented to the document. Present on consent documents. - `version` string: It is recommended to use this for static documents uploaded once and uploaded for many users. Uploads with a new version should have a different document_id as well. - `metadata` object: Arbitrary metadata associated with the application ## Other responses - `400`: The request could not be processed (e.g. missing client_application_id). - `401`: Valid access token was not used to call the API. - `403`: Valid access token lacks the proper scopes. - `404`: client_application_id passed in is not found. - `429`: Rate limit exceeded. - `500`: Server error. Please try your request again. ## Changes - **2026-11-03** `2c659854496e`: 1 info - endpoint added [Operation history](https://skmtc.dev/lead/apis/lead-bank/changes/v0/applications/get.md) --- [API](https://skmtc.dev/lead/apis/lead-bank.md) - [All operations](https://skmtc.dev/lead/apis/lead-bank/llms.txt) - [OpenAPI document](https://skmtc.dev/lead/apis/lead-bank/revisions/2c659854496e?raw)