---
title: "Retrieve an Asset Report with Freddie Mac format (aka VOA - Verification Of Assets), and a Verification Of Employment (VOE) report if this one is available. Only Freddie Mac can use this endpoint."
method: POST
path: "/credit/freddie_mac/reports/get"
tags: ["plaid"]
---

# Retrieve an Asset Report with Freddie Mac format (aka VOA - Verification Of Assets), and a Verification Of Employment (VOE) report if this one is available. Only Freddie Mac can use this endpoint.

`POST /credit/freddie_mac/reports/get`

The `/credit/freddie_mac/reports/get` endpoint retrieves the Verification of Assets and Verification of Employment reports.

## Request body

- CreditFreddieMacReportsGetRequest — CreditFreddieMacReportsGetRequest defines the request schema for `/credit/freddie_mac/reports/get`
  - `audit_copy_token` string, required — A token that can be shared with a third party auditor to allow them to obtain access to the Asset Report. This token should be stored securely.
  - `client_id` string — Your Plaid API `client_id`. The `client_id` is required and may be provided either in the `PLAID-CLIENT-ID` header or as part of a request body.
  - `secret` string — Your Plaid API `secret`. The `secret` is required and may be provided either in the `PLAID-SECRET` header or as part of a request body.

## Response `200`

OK

- CreditFreddieMacReportsGetResponse — CreditFreddieMacReportsGetResponse defines the response schema for `/credit/freddie_mac/reports/get`
  - `DEAL` CreditFreddieMacVerificationOfAssetsDeal, required — An object representing an Asset Report with Freddie Mac schema.
    - `LOANS` CreditFreddieMacLoans, required — A collection of loans that are part of a single deal.
      - `LOAN` CreditFreddieMacLoan, required — Information specific to a mortgage loan agreement between one or more borrowers and a mortgage lender.
        - `LOAN_IDENTIFIERS` CreditFreddieMacLoanIdentifiers, required — Collection of current and previous identifiers for this loan.
          - `LOAN_IDENTIFIER` LoanIdentifier[], required
            - `LoanIdentifier` string, nullable, required — The value of the identifier for the specified type.
            - `LoanIdentifierType` 'LenderLoan' | 'UniversalLoan', nullable, required — A value from a MISMO prescribed list that specifies the type of loan identifier.
        - `LoanRoleType` string, required — Type of loan. The value can only be "SubjectLoan".
    - `PARTIES` CreditFreddieMacParties, required — A collection of objects that define specific parties to a deal. This includes the direct participating parties, such as borrower and seller and the indirect parties such as the credit report provider.
      - `PARTY` CreditFreddieMacParty[], required
        - `INDIVIDUAL` CreditFreddieMacPartyIndividual, required — Documentation not found in the MISMO model viewer and not provided by Freddie Mac.
          - `NAME` CreditFreddieMacIndividualName, required — Documentation not found in the MISMO model viewer and not provided by Freddie Mac.
            - `FirstName` string, required — The first name of the individual represented by the parent object.
            - `LastName` string, required — The last name of the individual represented by the parent object.
            - `MiddleName` string, required — The middle name of the individual represented by the parent object.
        - `ROLES` Roles, required — Documentation not found in the MISMO model viewer and not provided by Freddie Mac.
          - `ROLE` Role, required — Documentation not found in the MISMO model viewer and not provided by Freddie Mac.
            - `ROLE_DETAIL` RoleDetail, required — Documentation not found in the MISMO model viewer and not provided by Freddie Mac.
              - …
        - `TAXPAYER_IDENTIFIERS` TaxpayerIdentifiers, required — The collection of `TAXPAYER_IDENTIFICATION` elements
          - `TAXPAYER_IDENTIFIER` TaxpayerIdentifier, required — Information about the Taxpayer identification values assigned to the individual or legal entity.
            - `TaxpayerIdentifierType` 'IndividualTaxpayerIdentificationNumber' | 'SocialSecurityNumber', nullable, required — A value from a MISMO prescribed list that classifies identification numbers used by the Internal Revenue Service (IRS) in the administration of tax laws. A Social Security number (SSN) is issued by the SSA; all other taxpayer identification numbers are issued by the IRS.
            - `TaxpayerIdentifierValue` string, nullable, required — The value of the taxpayer identifier as assigned by the IRS to the individual or legal entity.
    - `SERVICES` CreditFreddieMacServices, required — A collection of objects that describe requests and responses for services.
      - `SERVICE` CreditFreddieMacService, required — A collection of details related to a fulfillment service or product in terms of request, process and result.
        - `VERIFICATION_OF_ASSET` CreditFreddieMacVerificationOfAsset[], required
          - `REPORTING_INFORMATION` CreditFreddieMacReportingInformation, required — Information about a report identifier and a report name.
            - `ReportDateTime` string — Documentation not found in the MISMO model viewer and not provided by Freddie Mac.
            - `ReportIdentifierType` string — Documentation not found in the MISMO model viewer and not provided by Freddie Mac. The value can only be "ReportID".
            - `ReportingInformationParentIdentifier` string — Documentation not found in the MISMO model viewer and not provided by Freddie Mac.
            - `ReportingInformationIdentifier` string, required — Documentation not found in the MISMO model viewer and not provided by Freddie Mac.
          - `SERVICE_PRODUCT_FULFILLMENT` ServiceProductFulfillment, required — A collection of details related to a fulfillment service or product in terms of request, process and result.
            - `SERVICE_PRODUCT_FULFILLMENT_DETAIL` ServiceProductFulfillmentDetail, required — Documentation not found in the MISMO model viewer and not provided by Freddie Mac.
              - …
          - `VERIFICATION_OF_ASSET_RESPONSE` CreditFreddieMacVerificationOfAssetResponse, required — Documentation not found in the MISMO model viewer and not provided by Freddie Mac.
            - `ASSETS` CreditFreddieMacAssets, required — Documentation not found in the MISMO model viewer and not provided by Freddie Mac.
              - …
        - `STATUSES` Statuses, required — A collection of STATUS containers.
          - `STATUS` Status, required — Documentation not found in the MISMO model viewer and not provided by Freddie Mac.
            - `StatusCode` string, nullable, required — Status Code.
            - `StatusDescription` string, nullable, required — Status Description.
  - `request_id` string, required — A unique identifier for the request, which can be used for troubleshooting. This identifier, like all Plaid identifiers, is case sensitive.
  - `SchemaVersion` number, required — The Verification Of Assets (VOA) schema version.

## Other responses

- `default` — Error response

---

[API](https://skmtc.net/plaid/apis/the-plaid-api.md) · [All operations](https://skmtc.net/plaid/apis/the-plaid-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/plaid/the-plaid-api/versions/64c4514ea59b/schema)