---
title: "Immovlan API: Agency Listings | Perceptlayer"
description: "Agency Listings from Immovlan as JSON. 1 credit per successful call."
url: https://perceptlayer.com/apis/immovlan/agency-listings
---

[APIs](https://perceptlayer.com/apis) / [Immovlan](https://perceptlayer.com/apis/immovlan) / Agency Listings

# Immovlan: Agency Listings

Agency Listings from Immovlan as JSON. 1 credit per successful call.

GET `/v1/immovlan/agency-listings`

## Parameters

Send parameters in the query string.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `transaction` | string | Optional | for-sale, for-rent, in-public-sale |
| `agency_id` | integer | Required | Any |
| `sort` | string | Optional | price, bedrooms, area, zip |
| `order` | string | Optional | asc, desc |
| `page` | integer | Optional | Any |
| `property_type[]` | list of string | Optional | house, apartment, land, garage, student-housing, business, investment-property, miscellaneous |
| `property_subtype[]` | list of string | Optional | residence, villa, bungalow, chalet, cottage, master-house, mansion, mixed-building, land, development-site, to-parcel-out-site, farmland, other, green-zone, wood, recreational-land, industrial-ground, apartment, ground-floor, penthouse, duplex, triplex, studio, loft, garage, parking, student-flat, commercial-building, industrial-building, office-space, farming-site, business-surface, business-activity, investment-property, undetermined-property |
| `epc_rating[]` | list of string | Optional | excellent, good, poor, bad, unknown |
| `tag[]` | list of string | Optional | hasgarden, hasterrace, hasbalcony, hasswimmingpool, hasheatpump, hassolarpanels, hassolarthermicpanels, hasfloorheating, islowenergybuilding, hassauna, hashammam, hasgym, isfurnished, hasinternetconnection, hasfiberconnection, hascabletvconnection, hasdigitaltv, hasentryphone, hasoutsidesecuritygate, hasreinforcedgate, hasdisabledaccess, hasgarage, hascellar, isnew, isimportantupdate, hasvideo, hasvirtualvisit, arepetsallowed, isserviceappartement |
| `facade[]` | list of string | Optional | 2, 3, 4 |
| `state[]` | list of string | Optional | new, normal, excellent, to-be-renovated, fully-renovated |
| `seller_type[]` | list of string | Optional | privateuser, prouser |
| `municipal[]` | list of string | Optional | Any |
| `town[]` | list of string | Optional | Any |
| `province[]` | list of string | Optional | Any |
| `region[]` | list of string | Optional | Any |
| `price_min` | integer | Optional | Any |
| `price_max` | integer | Optional | Any |
| `bedrooms_min` | integer | Optional | Any |
| `bedrooms_max` | integer | Optional | Any |
| `bathrooms_min` | integer | Optional | Any |
| `bathrooms_max` | integer | Optional | Any |
| `area_min` | integer | Optional | Any |
| `area_max` | integer | Optional | Any |
| `plot_area_min` | integer | Optional | Any |
| `plot_area_max` | integer | Optional | Any |

## Example request

cURL shell 

```
curl "https://api.perceptlayer.com/v1/immovlan/agency-listings?transaction=for-sale&agency_id=48956" \
  -H "X-API-Key: $API_KEY"
```

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