---
title: "Seasons"
method: GET
path: "/fincaraiz/seasons"
tags: ["Fincaraiz"]
---

# Seasons

`GET /fincaraiz/seasons`

## Request

- Base URL: `https://scrappa.co/api`
- URL: `https://scrappa.co/api/fincaraiz/seasons`
- Auth: API key in header `X-API-KEY`

Seasonal rental periods available for one listing.

## Query parameters

- `property_id` integer, required

## Response `200`

- union
  - string
  - object
  - object
    - `success` boolean, required
    - `error` object, required
      - `code` 'parser_drift', required
      - `message` 'Fincaraiz returned an unreadable response. Please retry.', required
    - `meta` unknown[], required
      - unknown
  - object
    - `success` boolean, required
    - `error` object, required
      - `code` string, required
      - `message` 'Fincaraiz is temporarily unavailable. Please retry.' | 'Fincaraiz could not answer this query. Please retry.' | 'Fincaraiz returned an unreadable response. Please retry.' | 'Fincaraiz rejected the request from our egress pool. Please retry.', required
    - `meta` unknown[], required
      - unknown
  - object
    - `success` boolean, required
    - `error` object, required
      - `code` 'unknown_filter', required
      - `message` 'property_id must be a listing id.', required
    - `meta` unknown[], required
      - unknown

## Other responses

- `401`: Unauthorized - API key is missing or invalid
- `422`: The required `property_id` parameter is missing or invalid. Non-billable. property_id is missing or is not a numeric listing id. Non-billable.
- `503`: The platform answered successfully with a body this endpoint cannot read, so nothing is published and nothing is charged (`parser_drift`). Retryable. The upstream request failed after retries. Retryable and never billed.

---

[API](https://skmtc.dev/scrappa/apis/scrappa-api-documentation.md) · [All operations](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/revisions/2f4af6143d10?raw)