# Pull your UCDP appraisal results into your own systems

> Read a Doc File ID's Fannie Mae and Freddie Mac status, or every finding in its Submission Summary Report, from UCDP with one API call. Or have a workflow check yesterday's submissions each morning and email you every Not Successful appraisal before delivery.

Page: https://fous.com/automate/uniform-collateral-data-portal
Updated: 2026-11-12

Works with your own Uniform Collateral Data Portal account. Fous is an independent product.

## What you can build on UCDP

### Get a submission's status

Opens the Appraisal: View/Edit page for one Doc File ID or Lender Loan Number and reads the Submission Details and each GSE's status.

- Takes: Doc File ID or Lender Loan Number
- Returns: Doc File ID, Lender Loan Number, lender name, business unit, submitted at, last update, Fannie Mae status, Freddie Mac status, appraised value, effective date

### Search submitted appraisals

Runs a search on the Search Appraisal page by submission date and Investor Status, and reads the Search Results list.

- Takes: Date or date range, Investor Status (optional)
- Returns: Submission date, Doc File ID, Lender Loan Number, lender name, address, zip, username, FNM status, FRE status

### Read the findings in a Submission Summary Report

Downloads the FNM or FRE SSR for one Doc File ID and reads its Document Level Results and Submission Findings Results.

- Takes: Doc File ID, GSE
- Returns: Document File Status, document status, risk score, rep and warrant relief, finding category, severity, message ID, message, property affected, report section

### Resubmit a corrected appraisal report file

Opens a Doc File ID on Appraisal: View/Edit and uploads a corrected appraisal file in its place.

- Takes: Doc File ID, corrected appraisal file (UAD 3.6 ZIP or UAD 2.6 XML)
- Returns: Doc File ID, last update, Fannie Mae status, Freddie Mac status

## Automate UCDP with a workflow

A [workflow](/product/workflows) runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

### Yesterday's Not Successful appraisals, with their fatal findings

Starts: Every weekday at 7:00

1. Search submitted appraisals for Yesterday with Investor Status Not Successful.
2. For each Doc File ID, read the findings in the SSR of each GSE whose status is Not Successful.
3. Keep the findings with Fatal severity.
4. Email you the list by Lender Loan Number, with each message ID and message.

### Delivery check for the loans you are about to sell

Starts: When your system calls the workflow's webhook with a list of Lender Loan Numbers

1. For each Lender Loan Number, get the submission's status on Appraisal: View/Edit.
2. Mark the loans whose Fannie Mae or Freddie Mac status is not Successful.
3. Post the Doc File ID and both GSE statuses for every loan to your delivery system's webhook.

### Weekly risk score report for the previous week

Starts: Every Monday at 8:00

1. Search submitted appraisals for the Previous Week.
2. For each Doc File ID, read the CU or LCA risk score and rep and warrant relief from its FNM and FRE SSRs.
3. Keep the appraisals without rep and warrant relief.
4. Email you the list with Lender Loan Number, address and risk score.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

## Once built, one call from your code

Once you have built a [method](/product/methods), it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get a submission's status” would look like.

Example request:

```
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "www.uniformdataportal.com/get_submission_status",
    "input": {
      "lender_loan_number": "NW-2026-08817"
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "doc_file_id": "2004187263",
    "lender_loan_number": "NW-2026-08817",
    "lender_name": "Northwind Mortgage",
    "business_unit": "Northwind Retail",
    "submitted_at": "2026-11-10T14:22:05-05:00",
    "last_update": "2026-11-11T09:41:37-05:00",
    "fannie_mae_status": "Successful",
    "freddie_mac_status": "Not Successful",
    "appraised_value": 412000,
    "effective_date": "2026-11-06"
  }
}
```

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

## UCDP’s own options

Besides the web interface, lenders can reach UCDP through an integrated B2B solution: a vendor's system with an integrated UCDP interface, or direct integration (DI). The UAD 3.6 SSR is a PDF in the web interface and JSON only through DI. The GSEs charge no fees for using UCDP.

| Option | What it covers | What it takes |
| --- | --- | --- |
| Integrated B2B solution | Using UCDP from a vendor's system or by direct integration (DI). The UAD 3.6 SSR comes as JSON only through DI. | A vendor on Fannie Mae's Integrated Vendor List or Freddie Mac's Software Partners list, or your own direct integration. No GSE fees. |
| SSR JSON schema and data dictionary | The published field definitions of the UAD 3.6 SSR in JSON, the format DI returns. | Free to download from Freddie Mac's UCDP page. Useful once you receive SSRs through DI. |
| UCDP by hand | Submit Appraisal, Search Appraisal with results downloadable to Excel, and each UAD 3.6 SSR as a PDF. | A UCDP account that your lender admin creates or invites you to. No GSE fees. |

Read on November 12, 2026: [UCDP Overview (Fannie Mae and Freddie Mac)](https://sf.freddiemac.com/docs/pdf/fact-sheet/uniform_collateral_data_portal_885_final.pdf), [UCDP FAQs (Freddie Mac)](https://sf.freddiemac.com/faqs/ucdp-faq), [UCDP page (Freddie Mac)](https://sf.freddiemac.com/tools-learning/uniform-mortgage-data-program/ucdp).

## Signing in to UCDP

UCDP signs you in with a username and password, on an account your lender admin creates. Passwords for the web interface expire every 90 days, and a session ends after 10 minutes of inactivity. With Fous you sign in once through UCDP's own sign-in with your own account: the login is sealed with AES-256, and an expired session is signed back in.

## Worth knowing

- **Only a resubmission clears a fatal finding**: In UAD 3.6, a Fatal finding makes the Document File Status Not Successful and is cleared only by resubmitting a corrected file. Overrides can be requested for some UAD 2.6 submissions.
- **One session per login**: UCDP does not allow two active sessions with the same credentials: the second shows Additional Login Denied. After closing without logging out, you may wait up to 10 minutes to log back in.
- **Revisions keep the Doc File ID**: Each submission on Submit Appraisal creates a new Doc File ID, and one Doc File ID per loan goes to each GSE's loan delivery system. Send corrected files through Appraisal: View/Edit.
- **Doc File IDs tell you the standard**: A Doc File ID starting with 1 is a UAD 2.6 XML submission and one starting with 2 is a UAD 3.6 ZIP. The SSR button does not appear while a submission is In Progress.

## More in Finance: mortgage and title

- [AppraisalPort](https://fous.com/automate/appraisalport.md)
- [Mercury Network](https://fous.com/automate/mercury-network.md)
- [Desktop Underwriter](https://fous.com/automate/desktop-underwriter.md)
- [Loan Product Advisor](https://fous.com/automate/loan-product-advisor.md)
- [PEXA](https://fous.com/automate/pexa.md)
- [Simplifile](https://fous.com/automate/simplifile.md)
- [ApplyOnline](https://fous.com/automate/applyonline.md)
- [HM Land Registry portal](https://fous.com/automate/hm-land-registry-portal.md)
- [CommBroker](https://fous.com/automate/commbroker.md)
- [LMS Conveyancer Zone](https://fous.com/automate/lms-conveyancer-zone.md)
- [Barclays Mortgage Hub](https://fous.com/automate/barclays-mortgage-hub.md)
- [Halifax Intermediaries Online](https://fous.com/automate/halifax-intermediaries-online.md)
- [HSBC UK for Intermediaries](https://fous.com/automate/hsbc-uk-for-intermediaries.md)
- [NatWest Intermediary Solutions](https://fous.com/automate/natwest-intermediary-solutions.md)
- [NFI Online](https://fous.com/automate/nfi-online.md)
- [Santander for Intermediaries](https://fous.com/automate/santander-for-intermediaries.md)
- [Filogix Expert](https://fous.com/automate/filogix-expert.md)
- [NMLS](https://fous.com/automate/nmls.md)
- [MERS Online](https://fous.com/automate/mers-online.md)
- [Teraview](https://fous.com/automate/teraview.md)
- [RP Data Professional](https://fous.com/automate/rp-data-professional.md)
- [AgentTRAX](https://fous.com/automate/agenttrax.md)
- [VA LGY Hub](https://fous.com/automate/va-lgy-hub.md)
- [UWM EASE](https://fous.com/automate/uwm-ease.md)
- [Encompass TPO Connect](https://fous.com/automate/encompass-tpo-connect.md)

Other industries: [PostalOne](/automate/postalone), [BidNet Direct](/automate/bidnet-direct), [CDTFA Online Services](/automate/cdtfa-online-services), [Sunbiz](/automate/sunbiz), [Rexel France](/automate/rexel-france), [ShiftWise Flex](/automate/shiftwise-flex).

## Frequently asked questions

### Does the Uniform Collateral Data Portal have an API?

Yes, for system-to-system use: lenders can reach UCDP through a vendor's system with an integrated UCDP interface, from the lists each GSE publishes, or by direct integration (DI). The UAD 3.6 SSR comes as JSON only through DI. Otherwise you use the UCDP web interface.

### Why is my UCDP submission Not Successful?

At least one Fatal finding fired in the Submission Summary Report. In UAD 3.6, Severe, Warning, Informational and Notification findings do not change the status. A Fatal finding is cleared only by resubmitting a corrected appraisal file.

### Can I export my UCDP submissions to a spreadsheet?

Yes, the Search Results on the Search Appraisal page download to Excel, and the Submission History downloads to Excel too. The UAD 3.6 SSR is a PDF in the web interface. With Fous, a method you build can read the same results and return them as JSON.

### How long do appraisals stay in UCDP?

An appraisal report that receives a Doc File ID can be viewed in UCDP for up to three years from the initial submission.

### Is Fous affiliated with Fannie Mae or Freddie Mac?

No. Fous is an independent product. You use it with your own UCDP account, and a method reads and does only what that account can.

Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of Uniform Collateral Data Portal (Fannie Mae and Freddie Mac). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.