HomeGuidesAPI ReferenceChangelogDiscussions
GuidesAPI ReferenceDiscussions

## Overview

The following sections will cover document retrieval from a loan in Blend through our Public API.

For instructions on loan data retrieval from Blend, please refer to the [Export a Home Loan](🔗) reference.

## Endpoints

Blend users access loan documents and application packages via the "Docs" tab of Blend's user interface. They can download individual documents or complete application packages. These `loans/id/documents` and `documents/documentId` endpoints allow your integration to perform the same actions programmatically.

`loans/id/documents` returns a list of available documents for a particular loan. `documents/documentsId` allow you to fetch an individual loan document.

  • `GET loans/id/documents` - Used to get a JSON object of all documents associated with a Blend loan

  • `GET documents/documentId` - Used to fetch a single document from a Blend loan by its ID


## 1. Get the list of documents associated with the loan

This request generates a list of documents associated with a Blend loan file. The action is similar to a user viewing the available documents in the "Docs" tab of the Blend user interface.

**Example request:**

**Example response:**

## Considerations for already downloaded documents:

In the GET loans/id/documents request, Blend will return a "losExportedAt" value. This "losExportedAt" value can be queried in your response since the endpoint will have one of the following values:

  • `null` - the document was never exported

  • `timestamp` - this will indicate when the document was last fetched

Example: `https://api.beta.blendlabs.com/loans/[LOANID]/documents?losExportedAt=null`

To further filter your results:

`losExportedAt=true`: only includes documents exported by any API user such as a Public API user or Encompass Partnership API user

`losExportedAt=false`: only includes documents exported by any basic auth user

## 2. Download a document file

This request will allow you to fetch a individual document by a single documentId value.

**Example request:**


The document file will be returned to your server.


## What types of documents are available in Blend?

[Download CSV of Doc Type Definitions](🔗)

## What formats of documents can I upload via the API?

The Blend user interface accepts many document file formats and will attempt to convert them to PDFs at the time of upload. Currently, The Blend API accepts documents in PDF format. Please convert all docs before programmatically sending them to Blend.