# MoneySuperMarket — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Browse and compare live mortgage rates across multiple lenders on MoneySuperMarket. Search for mortgage products by property value, deposit, term, region, and product type to find competitive rates and detailed cost breakdowns.

**Category:** Finance & Markets | **Website:** [moneysupermarket.com/](https://moneysupermarket.com/) | **Docs:** [parse.bot/marketplace/e5471f09-f4a1-40b9-91a3-a545c53e35c2/moneysupermarket-com-api](https://parse.bot/marketplace/e5471f09-f4a1-40b9-91a3-a545c53e35c2/moneysupermarket-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-moneysupermarket-com-api-e5471f09/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_lowest_rates

Get current lowest mortgage rates across product types for a given mortgage category. Returns rate data as a map keyed by product type (TwoYearFixed, ThreeYearFixed, FiveYearFixed, Variable) and loan-to-value bands (SixtyLoanToValue, SeventyFiveLoanToValue, etc.). Each entry contains the best product's initial rate, monthly payment, lender info, and a pre-built enquiry object for drilling into that segment. Not paginated — returns the full rate overview in one call.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Mortgage category. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-moneysupermarket-com-api-e5471f09/get_lowest_rates \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>"}'
```

### search_mortgages

Search for mortgage products based on property value, deposit, term, region, and optional filters. Returns paginated results (20 per page) with detailed product information including interest rates, fees, costs, lender details, and affordability. Each product includes initial and follow-on rate periods, monthly payments, APRC, total cost, and early repayment terms.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `deposit_amount` | integer | No | Deposit amount in GBP. |
| `fixed_term` | string | No | Optional term length filter. |
| `journey_type` | string | No | Journey type. |
| `page` | integer | No | Page number for pagination. 20 results per page. |
| `product_type` | string | No | Optional product type filter. |
| `property_value` | integer | No | Property value in GBP. |
| `region` | string | No | UK region. |
| `repayment_method` | string | No | Repayment method. |
| `required_term_years` | integer | No | Mortgage term in years. |
| `sort_by` | string | No | Sort order for results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-moneysupermarket-com-api-e5471f09/search_mortgages \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"deposit_amount":"<integer>","fixed_term":"<string>","journey_type":"<string>","page":"<integer>","product_type":"<string>","property_value":"<integer>","region":"<string>","repayment_method":"<string>","required_term_years":"<integer>","sort_by":"<string>"}'
```