---
title: "List IRL quarter values"
method: GET
path: "/public/tools/irl/values"
tags: ["Public Tools"]
---

# List IRL quarter values

`GET /public/tools/irl/values`

## Request

- Base URL: `https://api.faireplace.com/api`
- URL: `https://api.faireplace.com/api/public/tools/irl/values`
- Auth: none required

Returns the published IRL values per quarter for a region, with source
metadata. Public, unauthenticated tool. Cacheable.

## Example

```bash
curl "https://api.faireplace.com/api/public/tools/irl/values?from=2020&to=2024&region=metropole"
```

## Query parameters

- `from` integer
- `to` integer
- `region` 'metropole' | 'corse' | 'outre_mer'

## Response `200`

IRL values for the region.

- IrlValuesResponse
  - `code` string, required
  - `region` string, required
  - `region_label` string, required
  - `available_regions` IrlRegionInfo[], required
    - `key` string, required
    - `label` string, required
  - `source` string, required
  - `source_url` string, nullable
  - `last_updated` string, date, nullable
  - `values` IrlQuarterValue[], required
    - `quarter` string, required
    - `value` number, required
    - `published_at` string, date, required

## Other responses

- `400`: Bad request
- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

[API](https://skmtc.dev/faireplace/apis/faireplace-property-management-api.md) · [All operations](https://skmtc.dev/faireplace/apis/faireplace-property-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/faireplace/apis/faireplace-property-management-api/revisions/69de39762919?raw)