Submit an application

Request
Response
Payload examples

Request

Endpoint

environment	HTTP method	endpoint
Sandbox testing	POST	https://api-sandbox.flexfactor.io/v1/onboarding/application/{id}/submit
Production environment	POST	https://api.flexfactor.io/v1/onboarding/application/{id}/submit

Required Keys

Parameter	Description
`{id}`	The unique application identifier returned during application creation or listing endpoints.
`bearer token`	The auth token returned by `/oauth2/token

❕
Prerequisite
Make sure the application is DRAFT mode before submission

Response

Field Definitions

Field Name	Type	Description
`status`	String	Status of the API request (`SUCCESS`, `FAILED`).
`success`	Boolean	Indicates if the API request was successful.
`result`	String	The result of the API request (e.g., "Application submitted successfully").
`statusCode`	String (Optional)	The HTTP status code of the API response.
`errors`	Array of Strings	Any errors encountered during the API request.
`customProperties`	Object (Optional)	Additional custom properties for the API response.

❗️
Notes

After a successful submission, the application status will change to SUBMITTED and cannot be edited further.

Notify relevant internal teams (e.g., Risk and Operations) of the submission for processing.

Payload Examples

Request

cURL Request Example

curl --request POST \
     --url https://api-sandbox.flexfactor.io/v1/application/{id}/submit \
     --header 'Authorization: bearer {the token returned by /oauth2}' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '

Response

JSON Example for a Successful Submission

{
   "status": "SUCCESS",
   "success": true,
   "result": "Application submitted successfully.",
   "statusCode": "200",
   "errors": [],
   "customProperties": {}
}

JSON Example for a Failed Submission

{
   "status": "FAILED",
   "success": false,
   "result": null,
   "statusCode": "400",
   "errors": [
       "Application is already submitted.",
       "Invalid application ID."
   ],
   "customProperties": {}
}

❕
Updating Application Status
After receiving a successful response, update the application status in your CRM or internal system to SUBMITTED for accurate tracking.

Updated about 2 months ago