Get your first underwriting decision

  1. Obtain a Vector key and an approved synthetic BVN for the test environment.

  2. Submit an individual application with one bank statement. Save the returned `application_id`.

  3. Fetch the application by ID until it reaches a final state. If your integration receives decision webhooks, use them to trigger the same status retrieval.

  4. Read the decision and store it against your application reference. Display the result appropriate for the applicant and your own lending process.

bash
curl --request POST "$VECTOR_BASE_URL/api/v1/applications" \
  --header "Authorization: Bearer $VECTOR_API_KEY" \
  --header 'Accept: application/json' \
  --form 'type=individual' \
  --form 'applicationReference=loan-demo-001' \
  --form '[email protected]' \
  --form "bvn=$VECTOR_TEST_BVN" \
  --form 'state=Lagos' \
  --form 'city=Lagos' \
  --form '[email protected]'
bash
curl "$VECTOR_BASE_URL/api/v1/applications/$APPLICATION_ID" \
  --header "Authorization: Bearer $VECTOR_API_KEY" \
  --header 'Accept: application/json'

Applications and decisions · Bank statements