GET/application/detail/{id}

Get Application

Returns the full application detail — business info, individuals, application state, KYC verifications, documents, and asks (action items).

Returns Business + Individuals for a BUSINESS application and IndividualPlus for an INDIVIDUAL_PLUS application. Action-item lists (Asks, Kyc, Documents) are ordered with missing items first, then rejected, submitted, and approved last.

  • Kyc[].IndividualId — pass to POST /simulate/kyc-status in test environments.
  • Kyc[].Link — the verification page URL for the individual to complete KYC.
  • Documents[].Individual_id — present only for individual-level documents; pass as uboId on upload.
  • Documents[].RecordId — present when a document record exists (submitted or rejected); absent for missing/not-yet-uploaded items.
  • Documents[].DocumentType — use as the type query param when uploading via POST /application/document/upload.
  • ApplicationState.Remark — populated when state is missing or rejected.

Path variables

FieldTypeRequiredPossible valuesDescription
idstringRequired

Application ID (same as the ID returned from submit-form or submit-individual-plus).

Headers

FieldTypeRequiredPossible valuesDescription
session-tokenstringRequired

SessionToken obtained from the Create GMA Session endpoint. All secured endpoints require this header.

Response

FieldTypePossible valuesDescription
ResponseCodeinteger200 | 201 | 204 | 301 | 400 | 401 | 403 | 404 | 410 | 422 | 500 | 503

API result code in the response envelope. Indicates success or the error category (e.g. 200 success, 400 bad request, 401 unauthorized).

ResponseMessagestringSuccess | Created | NoContent | BadRequest | Unauthorized | Forbidden | NotFound | Gone | UnprocessableContent | ServerError | ResourceMoved | ServiceUnAvailable | UnProcessableEntity

Human-readable label paired with ResponseCode (e.g. Success, BadRequest, Unauthorized). Use with ResponseCode to interpret the outcome.

ResponseDataobjectPlease refer to below example for response body

Full application detail. `ApplicationType` is `BUSINESS` or `INDIVIDUAL_PLUS`. `Business` and `Individuals` are present for Business applications; `IndividualPlus` is present for Individual Plus applications. `ApplicationState.State` reflects the current overall status; `ApplicationState.Remark` is populated when state is `missing` or `rejected`. `Asks[].AskedAt` is the Unix timestamp when the question was asked. `Kyc[].IndividualId` identifies the individual — pass to `POST /simulate/kyc-status`. `Kyc[].Link` is the KYC verification URL for the individual. `Documents[].Individual_id` is present only for individual-level documents; pass as `uboId` on upload. `Documents[].RecordId` is present when a document record exists (submitted or rejected). `Documents[].DocumentType` is the `type` value to use when uploading via `/application/document/upload`.

ApplicationState.Statestring (enum)missing | submitted | approved | rejected | draft

Current state of the application.

Example response

{
  "ResponseCode": 200,
  "ResponseMessage": "Success",
  "ResponseData": {
    "ApplicationId": "6a4763a25f39cb7aee21f0e3",
    "ApplicationNo": "BP-260703-I",
    "ApplicationType": "BUSINESS",
    "Type": 1,
    "Business": {
      "Version": 10,
      "Id": "6a4763a25f39cb7aee21f0e3",
      "Type": 1,
      "CreatedAt": 1783063458,
      "UpdatedAt": 1783335911,
      "EntityType": "Limited_Liability_Company",
      "AmountOfInitialDeposit": 10000,
      "AverageBalance": 50000,
      "BusinessName": "Example Broker Managed LLC",
      "DoingBusinessAs": "Example BM",
      "BusinessTaxId": "12-3456789",
      "Ein": "12-3456789",
      "BusinessRegistrationNumber": "REG-1234565",
      "BusinessFormationDate": "20200101",
      "BusinessRegistrationCountry": "US",
      "BusinessIndustryType": "information",
      "InOperation": true,
      "OperationStartDate": "20200101",
      "SignerFirstName": "John",
      "SignerLastName": "Smith",
      "Tnc": true,
      "AcceptDelarationAggrement": true,
      "Signature": "John Smith",
      "Address": {
        "City": "New York",
        "State": "NY",
        "Country": "US",
        "PinCode": "10001",
        "Street": "5th Avenue",
        "BuildingNumber": "100"
      },
      "AddressList": [
        {
          "City": "New York",
          "State": "NY",
          "Country": "US",
          "PinCode": "10001",
          "Street": "5th Avenue",
          "BuildingNumber": "100",
          "Type": "REGISTERED"
        },
        {
          "City": "New York",
          "State": "NY",
          "Country": "US",
          "PinCode": "10001",
          "Street": "5th Avenue",
          "BuildingNumber": "100",
          "Type": "MAILING"
        }
      ],
      "HasBusinessPlan": true,
      "Businesses": [
        "Other"
      ],
      "BusinessOther": "Software services",
      "PrimaryBusinessActivities": "Software development",
      "BusinessProductServices": "SaaS platform",
      "CustomerDescription": "Small businesses",
      "BusSourceOfFunds": [
        "revenue_from_business_operations"
      ],
      "IllegalImmoralDisclosure": [
        "none_of_the_above"
      ],
      "DepositReasons": [
        "receiving_funds_against_invoices_from_customer"
      ],
      "PaymentReasons": [
        "technology_and_it"
      ],
      "DepositLocations": [
        "usa"
      ],
      "PaymentLocations": [
        "usa"
      ],
      "HasEntity": false,
      "Entities": [],
      "Penalty": false,
      "Litigation": false,
      "LiquidFunds": false,
      "BankAccountAnotherFinancialInstitution": false,
      "MobilePhone": "5551112222",
      "LandlinePhone": "1134960000",
      "Website": true,
      "Url": "https://example.com",
      "Engage": "Online and direct sales",
      "EmpCount": "1_10",
      "InternationalCustomers": [
        "None_of_the_above"
      ],
      "HasCoinConversionPlan": false,
      "HasCryptoConversionPlan": false,
      "DealsInCryptocurrency": false
    },
    "Individuals": [
      {
        "Version": 0,
        "Id": "6a4763a25f39cb7aee21f0e9",
        "ApplicationId": "6a4763a25f39cb7aee21f0e3",
        "FirstName": "John",
        "LastName": "Smith",
        "MobileCountryCode": 1,
        "MobilePhone": "2125750193",
        "Email": "john.smith@example.com",
        "IsPrimaryUser": true,
        "IsAuthorizedUser": true,
        "CardFree": false
      }
    ],
    "ApplicationState": {
      "State": "missing",
      "RecordType": "business",
      "RecordId": "6a4763a25f39cb7aee21f0e3",
      "Title": "Complete application form",
      "Remark": "Please clarify your primary business activities."
    },
    "Asks": [
      {
        "State": "missing",
        "Question": "Please confirm the registered business address.",
        "AskedAt": 1783332342
      }
    ],
    "Kyc": [
      {
        "State": "missing",
        "IndividualId": "6a4763a25f39cb7aee21f0e9",
        "Title": "Complete KYC for John Smith",
        "Link": "https://kyc.fvbank.us/complete-application/6a4763a25f39cb7aee21f0e9?email=john.smith%40example.com"
      }
    ],
    "Documents": [
      {
        "State": "missing",
        "RecordType": "documents",
        "Title": "Upload proof of Business Tax ID (If USA incorporated, please upload proof of EIN.)",
        "DocumentType": "BusinessTaxIdProof",
        "DocumentLabel": "Upload proof of Business Tax ID"
      },
      {
        "State": "missing",
        "RecordType": "documents",
        "Title": "Upload a proof of address for the principal place of business",
        "DocumentType": "Business_Proof_Address",
        "DocumentLabel": "Upload a proof of address for the principal place of business"
      },
      {
        "State": "missing",
        "RecordType": "documents",
        "Title": "Upload a source of funds for the business",
        "DocumentType": "SourceOfBusFundsProof",
        "DocumentLabel": "Upload a source of funds for the business"
      },
      {
        "State": "missing",
        "RecordType": "documents",
        "Individual_id": "6a4763a25f39cb7aee21f0e9",
        "Title": "Upload a proof of address for John Smith",
        "DocumentType": "ProofOfAddress",
        "DocumentLabel": "Upload a proof of address for John Smith"
      },
      {
        "State": "rejected",
        "RecordType": "documents",
        "RecordId": "6a478fe57267551942867f7d",
        "Title": "Upload proof of source of funds for this individual.",
        "DocumentType": "SourceOfFunds",
        "DocumentLabel": "Upload proof of source of funds for this individual."
      },
      {
        "State": "submitted",
        "RecordType": "documents",
        "RecordId": "6a47694f5f39cb7aee21f10e",
        "Individual_id": "6a4763a25f39cb7aee21f0e9",
        "Title": "Upload proof of source of funds for this individual.",
        "DocumentType": "SourceOfFunds",
        "DocumentLabel": "Upload proof of source of funds for this individual."
      }
    ],
    "GeneratedAt": 1783336020
  }
}

If the application ID does not exist or does not belong to the authenticated broker, a 400 response is returned with code `record_not_found`.

Requires `session-token: {SessionToken}` from Create GMA Session. Use the same client IP as authentication.

Search guide books, endpoints, paths, or parameters

↑↓navigateopenEscclose