Freddie Mac Resolve Valuation & Pricing
Request Minimum Net Proceeds (MNP) value via the API to Resolve, the integrated default management platform. Directly connect while maintaining your user experience and receive MNP values for short sales.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/resolve-valuation-pricing"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
{
"openapi": "3.0.1",
"info": {
"title": "Resolve Valuation & Pricing",
"version": "2.0.0"
},
"servers": [
{
"url": "https://api-test.freddiemac.com/singlefamily/servicing/v2/rvp-service/rvpInfo"
}
],
"tags": [
{
"name": "Resolve Valuation & Pricing API",
"description": "When you connect through the Resolve Valuation & Pricing API, you’ll receive minimum net proceed values for short sales. The API is a new and faster way of receiving an MNP as well as ordering a value if one is not already available in the Real Estate Valuation and Pricing tool. Through seamless B2B integration, you’ll increase productivity and speed up mortgage resolution."
}
],
"security": [
{
"bearerAuth": []
}
],
"paths": {
"/rvpService": {
"post": {
"tags": [
"Resolve Valuation & Pricing API"
],
"summary": "Delivers real-time minimum net proceed values and data for single or bulk real estate value submissions.",
"description": "",
"operationId": "ShortSaleMNPUsingPOST",
"requestBody": {
"description": "Short Sale MNP Service Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ShortSaleMNPServiceRequest"
},
"examples": {
"RequestCompletedMNPWithFutureGTD": {
"$ref": "#/components/examples/RequestCompletedMNPWithFutureGTD"
},
"RequestOrderMNP": {
"$ref": "#/components/examples/RequestOrderMNP"
}
}
}
},
"required": true
},
"responses": {
"200": {
"description": "<b>OK</b> Request succeeded.\r\n\n <b>Sample Response Messages</b> <br/> <ul> <li><strong>RVP00005 </strong>Duplicate Freddie Mac Loan Number.\r\n </li> <li><strong>RVP00006 </strong>Seller Servicer Number is invalid.\r\n </li> <li><strong>RVP00007 </strong>Seller Servicer Number is required.\r\n </li> <li><strong>RVP00008 </strong>The Freddie Mac Loan Number is invalid. Please enter a Valid Freddie Mac Loan Number.\r\n </li> <li><strong>RVP00009 </strong>You are not authorized to submit a request for the loan number entered.\r\n </li> <li><strong>RVP00010 </strong>Serivce Loan Number is invalid.\r\n </li> <li><strong>RVP00011 </strong>MNP Status is Pending, check back again on the next business day.\r\n </li> <li><strong>RVP00012 </strong>BPO is on hold, please fix the issue listed in the Hold Reasons/Comments, or contact your Loss Mitigation Analyst for additional information.\r\n </li> <li><strong>RVP00013 </strong>Property Type is invalid.\r\n </li> <li><strong>RVP00014 </strong>Servicer Contact First Name is missing.\r\n </li> <li><strong>RVP00015 </strong>Servicer Contact Last Name is missing.\r\n </li> <li><strong>RVP00016 </strong>Servicer Contact Phone is missing.\r\n </li> <li><strong>RVP00017 </strong>Servicer Contact Email is missing.\r\n </li> <li><strong>RVP00018 </strong>Property Type is missing.\r\n </li> <li><strong>RVP00019 </strong>Property Contact Day Phone is missing.\r\n </li> <li><strong>RVP00020 </strong>Special Interior Access is missing.\r\n </li> <li><strong>RVP00021</strong>Property Contact First Name is missing.\r\n </li> <li><strong>RVP00022 </strong>Property Contact Last Name is missing.\r\n </li> <li><strong>RVP00023 </strong>The MNP has a pending dispute. Please come back on the next business day to check on the dispute status or contact your Loss Mitigation Analyst for additional information.\r\n </li> <li><strong>RVP00024 </strong>Servicer Contact Phone is invalid.\r\n </li> <li><strong>RVP00025 </strong>Property Contact Day Phone is invalid.\r\n </li> <li><strong>RVP00026 </strong>Servicer Contact Email is invalid.\r\n </li> <li><strong>RVP00027 </strong>No current MNP found for loan requested. MNP request has been filed. Please monitor MNP Request Status on a daily basis.\r\n </li> <li><strong>RVP00029 </strong>Request Type is Invalid.\r\n </li> <li><strong>RVP00030 </strong>Request Type is Required.\r\n </li> <li><strong>RVP00034 </strong>The request for Minimum Net proceeds cannot be completed as there is a workout associated to the loan in Approved, Settled or Closed status.\r\n </li> <li><strong>RVP00033 </strong>The Freddie Mac Loan Number you entered shows a status of REO in our system.\r\n </li> <li><strong>RVP00032 </strong>The Freddie Mac Loan Number you entered shows a status of CLOSED in our system. A closed loan is a loan that is Paid Off or Charged Off.\r\n </li> <li><strong>RVP00031 </strong>Unable to complete MNP request. Please refer to Cancel Reasons/Comments for further directions, or contact your Loss Mitigation Analyst for additional information.\r\n </li> <li><strong>RVP00035 </strong>No current MNP found for loan requested. Please provide all required and valid data, so that a new MNP can be ordered.\r\n </li> </ul>",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ShortSaleMNPServiceResponse"
},
"examples": {
"ResponseCompletedMNPWithFutureGTD": {
"$ref": "#/components/examples/ResponseCompletedMNPWithFutureGTD"
},
"ResponseOrderMNP": {
"$ref": "#/components/examples/ResponseOrderMNP"
}
}
}
}
},
"400": {
"description": "<b>Bad Request</b> \r\n\n <font size='1' color='black'><b>Error codes & details</b></font> \r\n\n <ul> <li><B>400.001</B> Malformed content from the client \r\n\n </li><li><B>400.002</B> Request data does not match the application schema, please validate the request data. \r\n\n</li><li><B>400.005</B> Empty request body \r\n\n </li><li><B>400.006</B> Content-type must be application/json \r\n\n </li></ul>",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
},
"example": {
"code": "400.006",
"message": "Missing header Content-type",
"details": [
{
"error": "Content-type must be application/json"
}
]
}
}
}
},
"401": {
"description": "<b>Unauthorized</b> \r\n\n <font size='1' color='black'><b>Error codes & details </b></font> \r\n\n <ul><li><B>401.001</B> Invalid Access Token, please validate the token, if error persists please renew your token. \r\n\n </li><li><b>401.002</b> Access Token Expired, please renew your access token. \r\n\n </li><li><b>401.003</b> API Product mismatch for token. Your token does not have access to the requested API \r\n\n </li><li><b>401.004</b> Invalid API Key, please validate the Client ID \r\n\n </li><li><b>401.005</b> Invalid API Key for given resource \r\n\n </li><li><b>401.006</b> Insufficient scope for Application \r\n\n </li><li><b>401.007</b> Invalid Username/Password combination, the provided combination of username and password is incorrect, please verify your credentials. \r\n\n </li><li><b>401.008</b> Invalid Refresh Token. \r\n\n </li><li><b>401.009</b> Invalid client secret \r\n\n </li><li><b>401.010</b> Refresh Token expired.</li></ul>",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
},
"example": {
"code": "401.002",
"message": "Access Token Expired",
"details": {
"error": "Access Token Expired, please renew your access token."
}
}
}
}
},
"404": {
"description": "<b>Not Found</b> \r\n\n <font size='1' color='black'><b>Error codes & details </b></font> \r\n\n <b>404.001</b> No resource for POST <b>/path</b>",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
},
"example": {
"code": "404.001",
"message": "No resource for POST /path",
"details": {
"error": "No resource for POST /path"
}
}
}
}
},
"429": {
"description": "<b>Too Many Requests</b> \r\n\n <font size='1' color='black'><b>Error codes & details </b></font> \r\n\n <b>429.001</b> Rate limit exceeded, too many requests have been sent per second. \r\n\n <b>429.002</b> Quota limit exceeded, too many requests have been sent per minute.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
},
"example": {
"code": 429.001,
"message": "Rate limit exceeded",
"details": {
"error": "Rate limit exceeded, too many requests have been sent per second."
}
}
}
}
},
"500": {
"description": "<b>Internal server error.</b> \r\n\n <font size='1' color='black'><b>Error codes & details </b></font> \r\n\n <b>500</b> Internal server error.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
},
"example": {
"code": "500",
"message": "Internal server error",
"details": [
{
"error": "Liquidation API is unable to retrieve data for the submitted request at this time. Please resubmit or contact Customer Support at (800-FREDDIE) for assistance."
}
]
}
}
}
}
},
"x-codegen-request-body-name": "shortSaleMNPServiceRequest"
}
}
},
"components": {
"schemas": {
"Error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"details": {
"type": "array",
"items": {
"title": "The Items Schema",
"type": "object",
"properties": {
"error": {
"description": "error messages",
"type": "string"
}
}
}
}
}
},
"ShortSaleMNPServiceRequest": {
"title": "ShortSaleMNPServiceRequest",
"description": "The root schema comprises the entire JSON document.",
"type": "object",
"properties": {
"message": {
"title": "The Message Schema",
"type": "object",
"properties": {
"aboutVersions": {
"title": "The Aboutversions Schema",
"description": "Dataset to capture the header information",
"type": "object",
"properties": {
"aboutVersion": {
"title": "The Aboutversion Schema",
"description": "Dataset to capture the header information",
"type": "object",
"properties": {
"aboutVersionIdentifier": {
"title": "The Aboutversionidentifier Schema",
"description": "This is the version number of the schema in use",
"type": "string",
"example": "S1.0.01"
},
"createdDatetime": {
"title": "The Createddatetime Schema",
"description": "The date and time stamp of response schema creation",
"type": "string",
"example": "2019-09-19T09:29:11Z"
}
},
"required": [
"aboutVersionIdentifier",
"createdDatetime"
],
"default": {}
}
},
"required": [
"aboutVersion"
],
"default": {}
},
"requestData": {
"title": "The Requestdata Schema",
"description": "An explanation about the purpose of this instance.",
"type": "object",
"properties": {
"workoutList": {
"title": "The Workoutlist Schema",
"description": "An explanation about the purpose of this instance.",
"type": "array",
"items": {
"title": "The Items Schema",
"description": "An explanation about the purpose of this instance.",
"type": "object",
"properties": {
"externalData": {
"title": "The Externaldata Schema",
"description": "An explanation about the purpose of this instance.",
"type": "object",
"properties": {
"servicerAccountIdentifier": {
"title": "The Sellerservicernumber Schema",
"description": "Unique identifier, issued by Freddie Mac, for the individual Seller or Servicer. ",
"type": "string"
},
"loanIdentifier": {
"title": "The Loanidentifier Schema",
"description": "Unique Freddie Mac identifier assigned to a financial instrument within the system.",
"type": "string"
},
"servicerLoanIdentifier": {
"title": "The Servicer Loan Identifier Schema",
"description": "A unique identifier assigned by the servicer to identify the loan.",
"type": "string"
},
"requestType": {
"type": "string"
},
"rEVP": {
"type": "object",
"properties": {
"valuationData": {
"type": "array",
"items": {
"type": "object",
"properties": {
"category": {
"type": "string",
"enum": [
"PropertyType",
"ServicerContactFirstName",
"ServicerContactLastName",
"ServicerContactPhone",
"ServicerContactEmail",
"PropertyContactFirstName",
"PropertyContactLastName",
"PropertyContactPhone",
"SpecialInteriorAccess",
"ServicerContactPhoneExtension",
"PropertyContactPhoneExtension"
]
},
"value": {
"type": "string"
}
},
"required": [
"category",
"value"
]
}
}
},
"required": [
"valuationData"
]
}
},
"required": [
"servicerAccountIdentifier",
"loanIdentifier",
"servicerLoanIdentifier",
"requestType",
"rEVP"
],
"default": {}
}
},
"required": [
"externalData"
],
"default": {}
},
"default": []
}
},
"required": [
"workoutList"
],
"default": {}
}
},
"required": [
"aboutVersions",
"requestData"
],
"default": {}
}
},
"required": [
"message"
],
"default": {}
},
"ShortSaleMNPServiceResponse": {
"title": "ShortSaleMNPServiceResponse",
"description": "The root schema comprises the entire JSON document.",
"type": "object",
"properties": {
"message": {
"title": "The Message Schema",
"type": "object",
"properties": {
"aboutVersions": {
"title": "The Aboutversions Schema",
"description": "Dataset to capture the header information",
"type": "object",
"properties": {
"aboutVersion": {
"title": "The Aboutversion Schema",
"description": "Data set to capture the header information",
"type": "object",
"properties": {
"aboutVersionIdentifier": {
"title": "The Aboutversionidentifier Schema",
"description": "This is the version number of the schema in use",
"type": "string",
"example": "S1.0.01"
},
"createdDatetime": {
"title": "The Createddatetime Schema",
"description": "The date and time stamp of response schema creation",
"type": "string",
"example": "2019-09-19T09:29:11Z"
}
},
"required": [
"aboutVersionIdentifier",
"createdDatetime"
],
"default": {},
"example": {}
}
},
"required": [
"aboutVersion"
],
"default": {}
},
"responseData": {
"title": "The Responsedata Schema",
"description": "Collection of the data attributes that depicts the response to a workout request.",
"type": "object",
"properties": {
"isRVPRequestValid": {
"title": "The isRequest valid Schema",
"description": "Indicates any request level error occured",
"type": "boolean"
},
"requestResponseRVPIdentifier": {
"title": "The requestResponseIdentifier valid Schema",
"description": " unique identifier that associates the response back to the original request",
"type": "integer"
},
"errorList": {
"title": "The Errorlist Schema",
"description": "Request level eligilbity messages",
"type": "array",
"items": {
"title": "The Items Schema",
"type": "object",
"properties": {
"errorCode": {
"title": "The ErrorCode Schema",
"description": "unique code representing schema validation error encountered during the validation process",
"type": "string"
},
"errorText": {
"title": "The ErrorDescription Schema",
"description": "Error description for the Schema validation error during the validation process.",
"type": "string",
"example": "Invalid Schema"
}
}
}
},
"responseRVPList": {
"title": "The ResponseRVPlist Schema",
"description": "Collection of the data attributes that depicts the response to a RVP request.",
"type": "array",
"items": {
"title": "The Items Schema",
"type": "object",
"properties": {
"loanIdentifier": {
"title": "The Loanidentifier Schema",
"description": "Unique Freddie Mac identifier assigned to a financial instrument within the system.",
"type": "string"
},
"servicerLoanIdentifier": {
"description": "A unique identifier assigned by the servicer to identify the loan.",
"type": "string"
},
"servicerAccountIdentifier": {
"title": "The Servicer Account Identifier Schema",
"description": "Unique identifier, issued by Freddie Mac, for the individual Seller or Servicer. ",
"type": "string"
},
"requestType": {
"title": "The Workout Reporting Status Type Schema",
"description": "Type of Real Estate valuation data being requested to indicate if a request is for Minimum Net Proceeds, Credit Bid Valuation or Dispute data.",
"type": "string"
},
"serviceType": {
"description": "A discrete set of values that describes the types of inspection that were performed in order to obtain the information needed for a property appraisal or broker price opinion.",
"type": "string"
},
"orderSource": {
"description": "Captures the source of the request. ",
"type": "string"
},
"isValid": {
"title": "The Isvalid Schema",
"description": "Indicates when the processing encountered any format validation or loan validation errors",
# --- truncated at 32 KB (56 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/freddie-mac/refs/heads/main/openapi/freddie-mac-resolve-valuation-pricing-openapi.json