---
title: "Find property flips"
method: GET
path: "/api/v1/deals/flips"
tags: ["Deals"]
---

# Find property flips

`GET /api/v1/deals/flips`

## Request

- Base URL: `https://propraven.com`
- URL: `https://propraven.com/api/v1/deals/flips`
- Auth: HTTP bearer

Retrieve recently flipped properties. Use ?view=flippers to get a ranked list of top flippers instead.

## Query parameters

- `county_fips` string
- `state_fips` string
- `flip_tier` 'QUICK_FLIP' | 'SHORT_HOLD' | 'MEDIUM_HOLD'
- `min_profit` number
- `view` 'flippers'
- `tax_delinquent` boolean
- `limit` integer
- `offset` integer

## Response `200`

Flips or flippers returned.

- object
  - `data` object[], required
    - `county_fips` string, required
    - `state_fips` string, required
    - `parcel_id` string, required
    - `address` string, nullable, required
    - `city` string, nullable, required
    - `state` string, nullable, required
    - `buy_date` string, date, nullable, required
    - `buy_price` number, nullable, required
    - `buyer_name` string, nullable, required
    - `sell_date` string, date, nullable, required
    - `sell_price` number, nullable, required
    - `seller_name` string, nullable, required
    - `hold_days` integer, nullable, required
    - `profit` number, nullable, required
    - `profit_pct` number, nullable, required
    - `flip_tier` 'QUICK_FLIP' | 'SHORT_HOLD' | 'MEDIUM_HOLD' | 'null', nullable, required
  - `total` integer, required
  - `limit` integer, required
  - `offset` integer, required
  - `tax_delinquency_filter` TaxDelinquencyFilter: Present when `tax_delinquent=true` was applied.
    - `applied` boolean, required
    - `statuses` string[], required
    - `note` string, required

## Other responses

- `400`: A query or body parameter is invalid. Nothing was read or charged.
- `401`: Missing, malformed or invalid credential.
- `402`: Monthly call cap reached (free tier, or a paid tier with the hard cap enabled).
- `405`: The endpoint exists but does not support this method. `Allow` lists the methods it does.
- `429`: Rate limit exceeded.
- `500`: Unexpected server error. The body never carries database or driver text.
- `503`: `tax_delinquent=true` before the tax delinquency layer's first load (`code: "tax_delinquency_unavailable"`).

---

[API](https://skmtc.dev/propraven/apis/propraven-api.md) · [All operations](https://skmtc.dev/propraven/apis/propraven-api/llms.txt) · [OpenAPI document](https://skmtc.dev/propraven/apis/propraven-api/revisions/37f8158c4eda?raw)