--- title: "Retrieve an Asset Report with Freddie Mac format. Only Freddie Mac can use this endpoint." method: POST path: "/credit/asset_report/freddie_mac/get" tags: ["plaid"] --- # Retrieve an Asset Report with Freddie Mac format. Only Freddie Mac can use this endpoint. `POST /credit/asset_report/freddie_mac/get` ## Request - Base URL: `https://production.plaid.com` - URL: `https://production.plaid.com/credit/asset_report/freddie_mac/get` - Auth: API key in header `PLAID-CLIENT-ID` and API key in header `PLAID-SECRET` and API key in header `Plaid-Version` The `/credit/asset_report/freddie_mac/get` endpoint retrieves the Asset Report in Freddie Mac's JSON format. ## Request body - AssetReportFreddieGetRequest: AssetReportFreddieGetRequest defines the request schema for `/credit/asset_report/freddie_mac/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 - AssetReportFreddieGetResponse: AssetReportFreddieGetResponse defines the response schema for `/credit/asset_report/freddie_mac/get` - `DEAL` AssetReportFreddie, required: An object representing an Asset Report with Freddie Mac schema. - `LOANS` Loans, required: A collection of loans that are part of a single deal. - `LOAN` Loan, required: Information specific to a mortgage loan agreement between one or more borrowers and a mortgage lender. - `LOAN_IDENTIFIERS` LoanIdentifiers, required: Collection of current and previous identifiers for this loan. - `LOAN_IDENTIFIER` LoanIdentifier, required: The information used to identify this loan by various parties to the transaction or other organizations. - `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. - `PARTIES` Parties, 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` Party[], required - `INDIVIDUAL` PartyIndividual, required: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. - `NAME` IndividualName, required: Parent container for name that allows for choice group between parsed and unparsed containers. - `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. - `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` Services, required: A collection of objects that describe requests and responses for services. - `SERVICE` Service, required: A collection of details related to a fulfillment service or product in terms of request, process and result. - `VERIFICATION_OF_ASSET` VerificationOfAsset, required: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. - `REPORTING_INFORMATION` ReportingInformation, required: Information about a report identifier and a report name. - `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` VerificationOfAssetResponse, required: Documentation not found in the MISMO model viewer and not provided by Freddie Mac. - `ASSETS` Assets, 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 (aka VOA or Freddie Mac Schema) schema version. ## Other responses - `default`: Error response ## Changes - **2026-10-15** `ea443cd78f6f`: 2 warning - added the new `CRA_PARTNER_INSIGHTS_ERROR` enum value to the `error_type` response property for the response status `default` - added the new `CRA_REPORT_ERROR` enum value to the `error_type` response property for the response status `default` - **2026-07-22** `94406d9a4d27`: 4 warning, 4 info - added the new `No` enum value to the `DEAL/SERVICES/SERVICE/VERIFICATION_OF_ASSET/VERIFICATION_OF_ASSET_RESPONSE/ASSETS/ASSET/items/ASSET_DETAIL/AssetEmployerSponsoredIndicator` response property for the response status `200` - added the new `No` enum value to the `DEAL/SERVICES/SERVICE/VERIFICATION_OF_ASSET/VERIFICATION_OF_ASSET_RESPONSE/ASSETS/ASSET/items/ASSET_DETAIL/AssetRetirementIndicator` response property for the response status `200` - added the new `Yes` enum value to the `DEAL/SERVICES/SERVICE/VERIFICATION_OF_ASSET/VERIFICATION_OF_ASSET_RESPONSE/ASSETS/ASSET/items/ASSET_DETAIL/AssetEmployerSponsoredIndicator` response property for the response status `200` - added the new `Yes` enum value to the `DEAL/SERVICES/SERVICE/VERIFICATION_OF_ASSET/VERIFICATION_OF_ASSET_RESPONSE/ASSETS/ASSET/items/ASSET_DETAIL/AssetRetirementIndicator` response property for the response status `200` - …4 more - …earlier changes not shown [Operation history](https://skmtc.dev/plaid/apis/the-plaid-api/changes/credit/asset_report/freddie_mac/get/post.md) --- [API](https://skmtc.dev/plaid/apis/the-plaid-api.md) - [All operations](https://skmtc.dev/plaid/apis/the-plaid-api/llms.txt) - [OpenAPI document](https://skmtc.dev/plaid/apis/the-plaid-api/revisions/ea443cd78f6f?raw)