# Get property by listing IDs (v1)

> **Casafari is the AI agent-native real estate data intelligence platform.** The most complete property index in Europe: a deduplicated, cleaned property graph of residential and commercial property, for sale and for rent, in 16 countries. Every property is one record with its full price and market history. [How the property graph is built](/docs/property-graph).

`POST https://api.casafari.com/api/v1/properties/match-by-listings`

[Property Sourcing](/docs/property-sourcing) · [REST API](/docs/rest/property-sourcing). Send `Authorization: Bearer $CASAFARI_TOKEN`; see [how to get a token](/docs/rest#get-a-token).

Over MCP: no tool does this. See [MCP and REST compared](/docs/parity#property-sourcing).

## Description

Returns a mapping properties IDs to listing IDs.

## Request body

Content type `application/json`. Optional. Type: `object`.

- `listing_ids` (integer[], required): List of listing IDs. at most 100 items; ≥ 1.

## Example request

Placeholders only: replace the token and the values with your own. Tested against the API on 2026-10-12: Listing ids taken from the search above; the ids in the description's example do not exist.

```bash
curl -X POST "https://api.casafari.com/api/v1/properties/match-by-listings" \
  -H "Authorization: Bearer $CASAFARI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "listing_ids": [
    31134746659,
    17571832,
    162754117
  ]
}'
```

## Responses

### 200 OK

Type: `object`.

- `property_id` (integer, required): ID of the property.
- `listing_ids` (integer[], required): List of listing IDs. 1–2147483647.

Example from the API description (long arrays shortened):

```json
[
  {
    "property_id": 12,
    "listing_ids": [
      1,
      2
    ]
  },
  {
    "property_id": 34,
    "listing_ids": [
      3,
      4
    ]
  }
]
```

### 401 Unauthorized

Type: `object`.

- `detail` (string, optional): Description of the error encountered.

### 403 Forbidden

Type: `object`.

- `detail` (string, optional): Description of the error encountered.

## Questions about this

- [Can I search properties over Casafari MCP?](/docs/faq/properties-over-mcp)
- [How do I look up one property and its price history?](/docs/faq/example-property-lookup)

## Related pages

- [Search properties (POST /v1/property-sourcing/searches)](/docs/rest/property-sourcing/search-properties)
- [Search properties by description (POST /v1/property-sourcing/searches/describe)](/docs/rest/property-sourcing/search-properties-by-description)
- [Next page of a search (GET /v1/property-sourcing/searches/{cursor})](/docs/rest/property-sourcing/next-page-of-a-search)
- [Get a property (GET /v1/property-sourcing/properties/{property_id})](/docs/rest/property-sourcing/get-a-property)
- [Property Sourcing REST API: all operations](/docs/rest/property-sourcing)
- [How to get a bearer token for the Casafari REST API](/docs/rest)
- [MCP vs REST API compared](/docs/parity)