GuidesAPI ReferenceDiscussions
Log In
API Reference

Submit a draw request for a loan application

Submit a draw request for a loan application. This endpoint handles both regular draw requests
and final draw requests with completion certificate upload (files and/or JSON metadata).

The system automatically determines if this is a final draw based on the loan's disbursement state.
For final draws, completion certificate documentation is required.

Gated funding loans

For loans configured with gated funding (disbursement check type Gated - Thrive Approval
or Gated - Borrower Approval), draw requests create a funding request instead of
immediately creating a merchant disbursement. Calculated draw amounts are returned in the
response, but funding is processed only after the request is approved.

  • merchantDisbursementId is null — no disbursement record is created until the funding
    request is approved and the draw is executed.
  • gatedFundingRequestUid — identifier for the pending funding request.
  • gatedFundingStatus — current review state (INTERNAL_REVIEW when Thrive admin approval
    is required, BORROWER_REVIEW when borrower approval is required).
  • gatedFundingMessage — human-readable status message for the funding request.

Use gatedFundingRequestUid (not merchantDisbursementId) to track pending draws on gated
loans. Submitting another draw while a funding request is under review returns HTTP 400.

For additional information, see the Draw Requests Guide in the Guides section.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required

Unique identifier of the loan application

Body Params
files
array of files

Project completion documentation files. Required only for final draw.

completionPictures
array of files

Project completion pictures. Required only if specified by merchant or project type. Must be geotagged unless the merchant is configured to skip geolocation validation.

string

JSON string containing completion certificate metadata. Required only for final draw.

boolean

Indicates if project was completed early.

string

Revised total loan amount (up to 2 decimal places). This value cannot exceed the original loan amount. Use this field to reduce the loan amount if the project is completed under budget.

string

Revised disbursement amount for this draw (up to 2 decimal places). Enter a specific amount less than the calculated draw amount to reduce the disbursement. This field cannot be used together with projectCompletedEarly.

Headers
string
required

Client ID for authentication

string
required

Client secret for authentication

string

Unique identifier for the merchant, used when your credentials are scoped to a merchant group. Required on every non-GET request for group-scoped credentials; omitting it returns "Must provide merchant-uid header for Merchant Group". On GET requests it is optional and the request stays scoped to the whole group.

Responses

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json