# Get property by listing IDs

> **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/v1/properties/match-by-listings`

[Existing Casafari API](/docs/existing-api-customers) · [API v1](/docs/existing-api-customers/v1) · Properties. Send `Authorization: Token $CASAFARI_TOKEN` with your existing API token; see [where to get it](/docs/existing-api-customers#where-to-get-your-existing-token).

The same path under `/api`, signed in with a bearer token, is in the REST API reference: [`POST /api/v1/properties/match-by-listings`](/docs/rest/properties/get-property-by-listing-ids-v1).

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

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

## Responses

### 200

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.

## Related pages

- [Search properties (POST /v1/properties/search)](/docs/existing-api-customers/v1/search-properties)
- [Get property by ID (GET /v1/properties/search/{property_id})](/docs/existing-api-customers/v1/get-property-by-id)
- [Create a smart link (BETA) (POST /v1/properties/smart-links)](/docs/existing-api-customers/v1/create-a-smart-link-beta)
- [The same path in the REST API reference (POST /api/v1/properties/match-by-listings)](/docs/rest/properties/get-property-by-listing-ids-v1)
- [Existing Casafari API v1: all operations](/docs/existing-api-customers/v1)
- [Existing API customers: token and documentation](/docs/existing-api-customers)