/v2/application/business/detail/{id}Get Business Plus Application
Returns the full Business Plus application, including anything still required to complete it.
Path variables
| Field | Type | Required | Possible values | Description |
|---|---|---|---|---|
id | string | Required | — | Application ID returned by Create Business Plus Application. |
Headers
| Field | Type | Required | Possible values | Description |
|---|---|---|---|---|
session-token | string | Required | — | SessionToken obtained from the Create GMA Session endpoint. All secured endpoints require this header. |
Response
| Field | Type | Possible values | Description |
|---|---|---|---|
ResponseCode | integer | 200 | 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). |
ResponseMessage | string | Success | 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. |
ResponseData | object | Please refer to below example for response body | Full application detail. `ApplicationType` is `BUSINESS`. `Business` and `Individuals` are present. `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[].IndividualId` is present only for individual-level documents; pass as `individualId` 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 Upload Document. |
ApplicationState.State | string (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,
"EntityType": "Limited_Liability_Company",
"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,
"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"
}
],
"PrimaryBusinessActivities": "Software development",
"CustomerDescription": "Small businesses",
"BusSourceOfFunds": [
"revenue_from_business_operations"
],
"IllegalImmoralDisclosure": [
"none_of_the_above"
],
"DepositLocations": [
"usa"
],
"PaymentLocations": [
"usa"
],
"HasEntity": false,
"Entities": [],
"MobilePhone": "5551112222",
"LandlinePhone": "1134960000",
"Website": true,
"Url": "https://example.com",
"BusinessRegistrationState": "NY",
"IsFinancialInstitution": false,
"CountriesOfOperations": [
"US"
],
"BusSourceOfWealth": [
"retained_earnings"
],
"BusPurposeOfAccount": "operational",
"AnnualRevenue": "tier2",
"ExpectedDepositVolumeTier": "low",
"ExpectedPaymentVolumeTier": "low",
"CustomersInSanctionedCountries": false,
"HasSanctionedCountryExposure": 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",
"IndividualId": "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",
"IndividualId": "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.