---
title: "ZVG-Portal API: Search | Perceptlayer"
description: "Search from ZVG-Portal as JSON. 1 credit per successful call."
url: https://perceptlayer.com/apis/zvg-portal/search
---

[APIs](https://perceptlayer.com/apis) / [ZVG-Portal](https://perceptlayer.com/apis/zvg-portal) / Search

# 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 OK JSON X-Credits-Used: 1

Recorded from our API and shortened.

[Run this endpoint in the playground](https://perceptlayer.com/apis/zvg-portal?try=search#playground) with your own parameters. 1 credit per successful call; failed calls are free.