ZVG-Portal: Search

Search from ZVG-Portal as JSON. 1 credit per successful call.

GET /v1/zvg-portal/search

Parameters

Send parameters in the query string.

Parameter	Type	Required	Allowed values
`land`	string	Required	bw, by, be, br, hb, hh, he, mv, ni, nw, rp, sl, sn, st, sh, th
`court`	string	Optional	Any
`object_type[]`	list of integer	Optional	1, 2, 3, 19, 4, 5, 6, 7, 8, 13, 9, 10, 11, 12, 14, 15, 16, 17, 18
`procedure_type`	integer	Optional	-1, 0, 1, 2, 3, 6, 4, 5, 7, 8
`plz`	string	Optional	Any
`city`	string	Optional	Up to 100 characters
`district`	string	Optional	Up to 100 characters
`street`	string	Optional	Up to 100 characters
`house_number`	string	Optional	Up to 10 characters
`case_number`	string	Optional	Any
`date_from`	string	Optional	Any
`date_to`	string	Optional	Any
`min_price`	integer	Optional	Any
`max_price`	integer	Optional	Any
`sort`	string	Optional	updated, auction_date, case_number, price_asc, price_desc
`page`	integer	Optional	Any
`per_page`	integer	Optional	Any

Example request

ZVG-Portal

GET/v1/zvg-portal/search?land=hb&sort=price_asc&per_page=2

{
  "success": true,
  "data": {
    "search_parameters": {
      "land": "hb",
      "sort": "price_asc",
      "page": 1,
      "per_page": 2
    },
    "search_metadata": {
      "total_results": 17,
      "page": 1,
      "per_page": 2,
      "total_pages": 9,
      "has_next_page": true,
      "upstream_total": 17,
      "filtered_out": 0,
      "dropped_invalid": 0
    },
    "listings": [
      {
        "zvg_id": 4829,
        "land": "hb",
        "case_number": "0011 b K 0031/2025",
        "updated_at": "2026-11-03T10:52:00+01:00",
        "court": "Bremen",
        "object_type": "Einfamilienhaus",
        "address": {
          "text": "Batteriestraße 79, 27568 Bremerhaven, Lehe",
          "street": "Batteriestraße 79",
          "postal_code": "27568",
          "city": "Bremerhaven",
          "district": "Lehe"
        },
        "verkehrswert": {
          "raw": "Verkehrswert gemäß §§ 74 a Abs. 5, 85 a Abs. 2 ZVG: 15.000,00 € (11b K 31,32/25). Wert des jeweiligen ½ Miteigentumsanteils: 7.500,00 € (11b K 31/25 bzw. 11 b K 32/25).",
          "amount": 15000,
          "currency": "EUR",
          "amounts": [
            15000,
            31.32,
            7500
          ]
        },
        "auction_date": "2026-12-16T09:30:00+01:00",
        "auction_date_text": "Mittwoch, 16. Dezember 2026, 09:30 Uhr",
        "cancelled": false,
        "attachments": [
          {
            "file_id": 8365,
            "name": "Amtliche Bekanntmachung",
            "size_kb": 62.75,
            "size_text": "62.75 kB",
            "url": "https://www.zvg-portal.de/index.php?button=showAnhang&land_abk=hb&file_id=8365&zvg_id=4829"
          }
        ],
        "url": "https://www.zvg-portal.de/index.php?button=showZvg&zvg_id=4829&land_abk=hb"
      },
      {
        "zvg_id": 4830,
        "land": "hb",
        "case_number": "0011 a K 0172/2011",
        "updated_at": "2026-11-02T15:48:00+01:00",
        "court": "Bremen",
        "object_type": "Eigentumswohnung (1 bis 2 Zimmer), 2-Zimmer Wohnung",
        "address": {
          "text": "Georgstraße 108, 27570 Bremerhaven, Geestemünde",
          "street": "Georgstraße 108",
          "postal_code": "27570",
          "city": "Bremerhaven",
          "district": "Geestemünde"
        },
        "verkehrswert": {
          "raw": "53.000,00 €.",
          "amount": 53000,
          "currency": "EUR",
          "amounts": [
            53000
          ]
        },
        "auction_date": "2026-12-16T10:30:00+01:00",
        "auction_date_text": "Mittwoch, 16. Dezember 2026, 10:30 Uhr",
        "cancelled": false,
        "attachments": [
          {
            "file_id": 8367,
            "name": "Amtliche Bekanntmachung",
            "size_kb": 62.13,
            "size_text": "62.13 kB",
            "url": "https://www.zvg-portal.de/index.php?button=showAnhang&land_abk=hb&file_id=8367&zvg_id=4830"
          }
        ],
        "url": "https://www.zvg-portal.de/index.php?button=showZvg&zvg_id=4830&land_abk=hb"
      }
    ]
  },
  "meta": {
    "endpoint_family": "search",
    "request_id": "req_b8dc1423eba74ba8a19b1237a36f4ab0",
    "credits_charged": 1,
    "credits_remaining": 1801
  }
}

200 OKJSONX-Credits-Used: 1

Recorded from our API and shortened.

Run this endpoint in the playground with your own parameters. 1 credit per successful call; failed calls are free.