> ## Documentation Index > Fetch the complete documentation index at: https://docs.propertydata.dev/llms.txt > Use this file to discover all available pages before exploring further. # Get Mortgage Rates > Get Mortgage Rates ## OpenAPI ````yaml api-reference/zillow/openapi.json get /api/v1/mortgage/rates openapi: 3.1.0 info: title: US Property Data description: US Property Data Documentation version: 1.0.0 servers: - url: https://us-property-data.p.rapidapi.com description: RapiAPI security: [] paths: /api/v1/mortgage/rates: get: tags: - Mortgage summary: Get Mortgage Rates description: Get Mortgage Rates operationId: getApiV1MortgageRates parameters: - in: query name: loan_program schema: type: string enum: - ARM3 - ARM5 - ARM7 - Fixed10Year - Fixed15Year - Fixed20Year - Fixed30Year description: >- Type of loan program. ARM3/ARM5/ARM7 are adjustable-rate mortgages with initial fixed periods of 3, 5, or 7 years. Fixed10Year, Fixed15Year, Fixed20Year, and Fixed30Year are fixed-rate mortgages with the specified loan term. example: Fixed10Year required: true - in: query name: loan_purpose schema: type: string enum: - Purchase - Refinance description: >- Purpose of the loan. Use Purchase for buying a new property, or Refinance for replacing an existing mortgage with a new one. default: Purchase example: Purchase required: false - in: query name: credit_rating schema: type: string enum: - VeryHigh - High - Low description: >- Borrower credit rating category used to estimate mortgage rates. VeryHigh represents excellent credit, High represents good credit, and Low represents fair or poor credit. default: VeryHigh example: VeryHigh required: false - in: query name: percent_down schema: type: string enum: - VeryHigh - High - Normal description: >- Down payment percentage category. VeryHigh indicates a large down payment, High indicates a medium down payment, and Normal indicates a standard or minimum down payment. default: Normal example: Normal required: false - in: query name: location schema: type: string description: >- Property location used to determine regional mortgage rates (e.g., city, state, or ZIP code). required: false - in: query name: timespan schema: type: string enum: - '1' - '7' - '30' - '90' - '365' - '720' description: >- Time range (in days) for which mortgage rate data is requested. For example, 1 = today, 7 = last 7 days, 30 = last 30 days, 90 = last 90 days. default: '90' example: '90' required: false responses: '200': description: Success content: application/json: schema: type: object properties: success: type: boolean example: true cost: type: number description: Cost of the request example: 1 data: type: object properties: query: type: object properties: creditScoreBucket: type: string description: >- Credit score category used to determine mortgage eligibility and rates (e.g., VeryHigh, High, Medium). example: VeryHigh loanAmountBucket: type: string description: >- Loan size category based on conforming or non-conforming loan limits. example: Conforming loanToValueBucket: type: string description: >- Loan-to-value (LTV) ratio category representing the borrower’s equity level. example: Normal loanType: type: string description: >- Type of mortgage loan selected by the borrower (e.g., Conventional, FHA, VA). example: Conventional program: type: string description: >- Mortgage program or term type, such as fixed-rate or adjustable-rate and loan duration. example: Fixed10Year description: >- Parameters describing the mortgage profile used to request rate samples. samples: type: array items: type: object properties: apr: type: number description: >- Annual Percentage Rate (APR) representing the total yearly cost of the loan including fees. example: 5.437 rate: type: number description: >- Base interest rate offered for the mortgage at the given time. example: 5.42 time: type: string description: >- Timestamp indicating when the mortgage rate sample was recorded. example: '2025-10-24T00:00:00-07:00' volume: type: number description: >- Number of mortgage rate samples or transactions recorded for this time period. example: 0 description: >- List of historical or current mortgage rate samples matching the query criteria. '400': description: Bad Request content: application/json: schema: type: object properties: message: type: string example: Bad request '401': description: Unauthorized content: application/json: schema: type: object properties: message: type: string example: >- Invalid API key. Go to https://docs.rapidapi.com/docs/keys for more info. '403': description: Not Found content: application/json: schema: type: object properties: message: type: string example: You are not subscribed to this API. '500': description: Internal Server Error content: application/json: schema: type: object properties: success: type: boolean example: false message: type: string example: 'Request failed with status 500: Internal Server Error' status_code: type: number example: 500 cost: type: number example: 0 explain: type: string example: >- Oops, it looks like there was an issue processing your request. Don't worry, you won't be charged for this request security: - apiKeyAuth: [] components: securitySchemes: apiKeyAuth: type: apiKey in: header name: x-rapidapi-key description: Rapid API Key ````