---
title: "Returns offers for one specific block."
method: GET
path: "/booking/v0-nsfw/blocks/{id}/offers"
tags: ["Block"]
---

# Returns offers for one specific block.

`GET /booking/v0-nsfw/blocks/{id}/offers`

## Request

- Base URL: `https://api.apaleo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.apaleo.com/booking/v0-nsfw/blocks/{id}/offers`
- Auth: OAuth 2
  - Implicit: `https://identity.apaleo.com/connect/authorize`
  - Scopes: `offers.read`, `blocks.manage`, `reservations.manage`, `admin`

Calculates and returns offers for amending a specific block.<br>You must have at least one of these scopes: 'offers.read, blocks.manage, reservations.manage'.<br>For fine-grained clients, you must have this permission: 'core.blocks.read'.

## Path parameters

- `id` string, required

## Query parameters

- `arrival` string, required
- `departure` string, required
- `includeUnavailable` boolean

## Response `200`

Success

- BlockOffersModel
  - `offers` BlockOfferModel[], required: List of block offers
    - `arrival` string, date-time, required: The earliest arrival date and time for this offer<br />A date and time in UTC or with UTC offset as defined in <a href="https://en.wikipedia.org/wiki/ISO_8601">ISO8601:2004</a>
    - `departure` string, date-time, required: The latest departure date and time for this offer<br />A date and time in UTC or with UTC offset as defined in <a href="https://en.wikipedia.org/wiki/ISO_8601">ISO8601:2004</a>
    - `timeSlices` BlockOfferTimeSliceModel[], required: The breakdown for each time slice for this offer
      - `from` string, date-time, required: The start date and time for this time slice<br />A date and time in UTC or with UTC offset as defined in <a href="https://en.wikipedia.org/wiki/ISO_8601">ISO8601:2004</a>
      - `to` string, date-time, required: The end date and time for this time slice<br />A date and time in UTC or with UTC offset as defined in <a href="https://en.wikipedia.org/wiki/ISO_8601">ISO8601:2004</a>
      - `availableUnits` integer, required: The number of available units for that time slice
      - `blockedUnits` integer, required: The number of blocked units for that time slice
      - `totalGrossAmount` MonetaryValueModel, required
        - `amount` number, double, required
        - `currency` string, required
      - `includedServicesAmount` MonetaryValueModel
        - `amount` number, double, required
        - `currency` string, required
    - `validationMessages` OfferValidationMessageModel[], nullable: Validation rules that were applied to the offer and show the reason why the offer is not bookable
      - `code` 'UnitGroupFullyBooked' | 'UnitGroupCapacityExceeded' | 'RatePlanRestrictionsViolated' | 'RatePlanSurchargesNotSet' | 'RateRestrictionsViolated' | 'RatePlanChannelNotSet' | 'RatesNotSet' | 'BlockFullyBooked' | 'IncludedServicesAmountExceededRateAmount' | 'ServiceFullyBooked' | 'RateDoesNotSatifyHurdles', required: The message Code
      - `message` string, required: The message description
    - `cityTaxes` OfferCityTaxModel[], nullable: Details of city taxes for this offer, if any
      - `id` string, required: The id of the city tax
      - `code` string, required: The code of the city tax
      - `name` string, required: The name for the city tax
      - `totalGrossAmount` MonetaryValueModel, required
        - `amount` number, double, required
        - `currency` string, required
      - `dates` OfferCityTaxItemModel[], required: Split per day for the city tax
        - `serviceDate` string, date, required: The date for this city tax
        - `amount` AmountModel, required
          - `grossAmount` number, double, required
          - `netAmount` number, double, required
          - `vatType` 'Null' | 'VeryReduced' | 'Reduced' | 'Normal' | 'Without' | 'Special' | 'Special1' | 'Special2' | 'ReducedCovid19' | 'NormalCovid19' | 'Mixed', required
          - `vatPercent` number, double, required
          - `currency` string, required

## Other responses

- `204`: There are no available offers for the specified parameters.
- `400`: Bad request.
- `401`: You are unauthorized.
- `403`: Forbidden.
- `404`: The Request-URI could not be found.
- `422`: Validation errors in the request body or query params.
- `499`: Client closed request.
- `500`: An unexpected error occurred.
- `503`: The server is currently unavailable. Please try later.

---

[API](https://skmtc.dev/apaleo/apis/apaleo-booking-api-not-safe-for-work.md) - [All operations](https://skmtc.dev/apaleo/apis/apaleo-booking-api-not-safe-for-work/llms.txt) - [OpenAPI document](https://skmtc.dev/apaleo/apis/apaleo-booking-api-not-safe-for-work/revisions/a1b6a2f6b879?raw)