# ZVG-Portal Court API Documentation

<p><strong>ZVG-Portal Court API</strong> returns the profile of one Amtsgericht, the agency of an auction, with all its current foreclosure auctions. The profile holds the court id, name, land and the number of auctions. The auctions use the same item shape, sort and paging as the search route. Get the <code>court_id</code> from the locations or reference route.</p>

- **Documentation:** [https://scrappa.co/docs/zvg-portal-api/zvg_portal_court](https://scrappa.co/docs/zvg-portal-api/zvg_portal_court)
- **API group:** ZVG-Portal API
- **Endpoint:** `GET https://scrappa.co/api/zvg-portal/v1/court`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `court` | string | Yes | court_id of the Amtsgericht. Example: H1101. |
| `sort` | string | No | auction_date (default), updated, case_number, price_asc or price_desc. |
| `page` | integer | No | One-based page number (default 1). |
| `per_page` | integer | No | Results per page, 1 to 100 (default 25). |

## Example response

```json
{
    "data": {
        "court": {
            "land": "hb",
            "name": "Amtsgericht Bremen",
            "court_id": "H1101",
            "land_name": "Bremen",
            "total_auctions": 15
        },
        "listings": [
            {
                "url": "https://www.zvg-portal.de/index.php?button=showZvg&zvg_id=4812&land_abk=hb",
                "land": "hb",
                "court": "Bremen",
                "zvg_id": 4812,
                "address": {
                    "city": "Bremerhaven",
                    "text": "Gnesener Stra\u00dfe 18, 27576 Bremerhaven",
                    "street": "Gnesener Stra\u00dfe 18",
                    "district": null,
                    "postal_code": "27576"
                },
                "cancelled": false,
                "updated_at": "2026-08-13T11:29:00+02:00",
                "attachments": [
                    {
                        "url": "https://www.zvg-portal.de/index.php?button=showAnhang&land_abk=hb&file_id=8320&zvg_id=4812",
                        "kind": null,
                        "name": "Amtliche Bekanntmachung",
                        "file_id": 8320,
                        "size_kb": 62.42,
                        "size_text": "62.42 kB"
                    }
                ],
                "case_number": "0011 b K 0078/2025",
                "object_type": "Eigentumswohnung (1 bis 2 Zimmer), 2-Zimmer-Wohnung",
                "auction_date": "2026-11-09T09:30:00+01:00",
                "verkehrswert": {
                    "raw": "6.000,00 \u20ac",
                    "amount": 6000,
                    "amounts": [
                        6000
                    ],
                    "currency": "EUR"
                },
                "auction_date_text": "Montag, 09. November 2026, 09:30 Uhr"
            },
            {
                "url": "https://www.zvg-portal.de/index.php?button=showZvg&zvg_id=4816&land_abk=hb",
                "land": "hb",
                "court": "Bremen",
                "zvg_id": 4816,
                "address": {
                    "city": "Bremen",
                    "text": "Gro\u00dfbeerenstra\u00dfe 23, 25, Loignystra\u00dfe, 28211 Bremen, Schwachhausen",
                    "street": "Gro\u00dfbeerenstra\u00dfe 23, 25, Loignystra\u00dfe",
                    "district": "Schwachhausen",
                    "postal_code": "28211"
                },
                "cancelled": false,
                "updated_at": "2026-09-01T09:25:00+02:00",
                "attachments": [
                    {
                        "url": "https://www.zvg-portal.de/index.php?button=showAnhang&land_abk=hb&file_id=8331&zvg_id=4816",
                        "kind": null,
                        "name": "Amtliche Bekanntmachung",
                        "file_id": 8331,
                        "size_kb": 101.85,
                        "size_text": "101.85 kB"
                    }
                ],
                "case_number": "0026 K 0059/2024",
                "object_type": "Sonstiges",
                "auction_date": "2026-11-11T09:30:00+01:00",
                "verkehrswert": {
                    "raw": "223.000,--",
                    "amount": 223000,
                    "amounts": [
                        223000
                    ],
                    "currency": "EUR"
                },
                "auction_date_text": "Mittwoch, 11. November 2026, 09:30 Uhr"
            }
        ],
        "search_metadata": {
            "page": 1,
            "per_page": 2,
            "total_pages": 8,
            "filtered_out": 0,
            "has_next_page": true,
            "total_results": 15,
            "upstream_total": 15,
            "dropped_invalid": 0
        },
        "search_parameters": {
            "plz": null,
            "city": null,
            "land": "hb",
            "page": 1,
            "sort": "auction_date",
            "court": null,
            "street": null,
            "date_to": null,
            "district": null,
            "per_page": 2,
            "date_from": null,
            "max_price": null,
            "min_price": null,
            "case_number": null,
            "object_type": null,
            "house_number": null,
            "procedure_type": null
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "court"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required parameter or a value is invalid. This response is not billable. |
| 503 | Upstream Unavailable | ZVG-Portal could not be reached. This response is not billable and is retryable. |
| 503 | Unexpected Upstream Data | ZVG-Portal returned data in an unexpected shape. This response is not billable and is retryable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)