# Flatfox Listing Detail API Documentation

Fetch public Flatfox listings by id, up to 50 in one request, or one page of the listings of an agency. Each listing carries the price, rooms, living space, floor, year built, features, address with coordinates, images, documents, the agency, the moving date, publication dates, viewing and tour links and the public url. Ids that Flatfox does not know are listed in missing_pks; if none is found the request answers a non-billable 404.

- **Documentation:** [https://scrappa.co/docs/immoscout24-ch-api/immoscout24_ch_flatfox_listing](https://scrappa.co/docs/immoscout24-ch-api/immoscout24_ch_flatfox_listing)
- **API group:** ImmoScout24 CH API
- **Endpoint:** `GET https://scrappa.co/api/immoscout24-ch/flatfox/listing`

## 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 |
| --- | --- | --- | --- |
| `pk` | string | No | One listing id, a comma-separated list, or pk[]=1&pk[]=2 (up to 50). Example: 1234567. |
| `organization` | integer | No | Agency id. Returns a page of that agency's listings instead. |
| `limit` | integer | No | Page size for organization lookups, 1 to 50. Defaults to 20. |
| `offset` | integer | No | Offset for organization lookups. Defaults to 0. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/immoscout24-ch/flatfox/listing?pk=1234567"
```

## Example response

```json
{
    "success": true,
    "data": {
        "query": {
            "pk": [
                1234567
            ]
        },
        "results": [
            {
                "id": "1234567",
                "offer_type": "rent",
                "object_category": "APARTMENT",
                "title": "Helle 2.5-Zimmer-Wohnung in Z\u00fcrich",
                "price": {
                    "currency": "CHF",
                    "display": 2150,
                    "net": 1900,
                    "charges": 250,
                    "gross": 2150
                },
                "rooms": 2.5,
                "living_space": 62,
                "floor": 2,
                "features": {
                    "attributes": [
                        "balcony",
                        "lift"
                    ]
                },
                "address": {
                    "street": "Beispielstrasse 1",
                    "postal_code": "8004",
                    "locality": "Z\u00fcrich",
                    "latitude": 47.3769,
                    "longitude": 8.5417
                },
                "images": [
                    "https://flatfox.ch/media/example/1.jpg"
                ],
                "lister": {
                    "name": "Beispiel Verwaltung AG",
                    "locality": "Z\u00fcrich",
                    "country": "CH"
                },
                "moving_date": "2026-12-01",
                "created_at": "2026-10-01T08:00:00Z",
                "url": "https://flatfox.ch/en/flat/example/1234567/"
            }
        ]
    },
    "meta": {
        "endpoint_family": "flatfox-listing",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. This response is not billable. |
| 404 | Listing Not Found | The source has no matching resource. This response is not billable. |
| 503 | Source Unavailable | The source is temporarily unreachable or blocked the request. Retry later; this response is not billable. |

## 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)