How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Beyond Customizations API

The Customizations API from Beyond — 6 operation(s) for customizations.

Beyond Customizations API is one of 7 APIs that Beyond publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Customizations. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, and authentication docs.

This API exposes 11 operations across 6 paths, and defines 59 schemas. It is described by OpenAPI 3.1.1, at version 2.0.0.

Requests are made against the base URL https://developers.beyondpricing.com/api/v1/.

11 operations 6 paths 59 schemas 6 GET5 PATCH

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.1
API Version
2.0.0
Base URL
https://developers.beyondpricing.com/api/v1/
Authentication
OAuth 2.0, HTTP Bearer
Resource Areas
1

Authentication & Security 2

Beyond Customizations API declares 2 security schemes for authenticating requests. It supports OAuth 2.0 (oauth2) using the clientCredentials flow, exposing 9 scopes. It accepts HTTP bearer tokens (PersonalAccessToken) (personalAccessToken).

  • oauth2 — Use OAuth2 client credentials to mint an application token, or add userid and optional credentialid in the Authorize dialog to request a user- or credential-sc…
  • personalAccessToken — Paste a bpat... personal access token. PATs use the same Bearer header as OAuth2 tokens and must still include the runtime-required scopes for each endpoint, e…

Paths & Operations 11

Across 6 paths, the API surfaces 11 operations — 6 GET, 5 PATCH. Each is listed below with its method, path, parameters, and response codes.

Customizations 11
GET
/api/v1/listings/{listing_id}/customizations/
Get all customizations for a listing
get_listing_all_customizations 2 params → 200401403404429500
GET
/api/v1/listings/{listing_id}/customizations/base-price/
Get base price customization for a listing
get_listing_base_price_customization 2 params → 200401403404429500
PATCH
/api/v1/listings/{listing_id}/customizations/base-price/
Update base price customization for a listing
patch_listing_base_price_customization 1 param body → 200400401403404422429500
GET
/api/v1/listings/{listing_id}/customizations/extra-guest-fees/
Get extra guest fee customization for a listing
get_listing_extra_guest_fee_customization 2 params → 200401403404429500
PATCH
/api/v1/listings/{listing_id}/customizations/extra-guest-fees/
Update extra guest fee customization for a listing
patch_listing_extra_guest_fee_customization 1 param body → 200400401403404422429500
GET
/api/v1/listings/{listing_id}/customizations/min-max-prices/
Get min/max prices customization for a listing
get_listing_min_max_prices_customization 2 params → 200401403404429500
PATCH
/api/v1/listings/{listing_id}/customizations/min-max-prices/
Update min/max prices customization for a listing
patch_listing_min_max_prices_customization 1 param body → 200400401403404422429500
GET
/api/v1/listings/{listing_id}/customizations/min-stays/
Get min-stays customization for a listing
get_listing_min_stays_customization 2 params → 200401403404429500
PATCH
/api/v1/listings/{listing_id}/customizations/min-stays/
Update min-stays customization for a listing
patch_listing_min_stays_customization 1 param body → 200400401403404422429500
GET
/api/v1/listings/{listing_id}/customizations/time-based-adjustments/
Get time-based adjustments customization for a listing
get_listing_time_based_adjustments_customization 2 params → 200401403404429500
PATCH
/api/v1/listings/{listing_id}/customizations/time-based-adjustments/
Update time-based adjustments customization for a listing
patch_listing_time_based_adjustments_customization 1 param body → 200400401403404422429500

Schemas 59

The contract defines 59 schemas that model the data the API accepts and returns. The most detailed are MinStaysCustomizationNested (8 properties), MinMaxPricesCustomizationNested (7 properties), SeasonalPrices (5 properties), SeasonalMinStay (5 properties). Each schema is shown below with its type and property counts.

ListingCustomizationResourceTypeEnum
string
MinStaysCustomizationResponse
object
1 property 1 required
MinMaxPricesCustomization
object
3 properties 2 required
TimeBasedAdjustmentsCustomization
object
3 properties 2 required
SeasonalMinStay
object
A date-scoped minimum-stay override.
5 properties 3 required
SeasonalDayOfWeekMinPrice
object
Weekday-specific nightly minimum prices limited to a date range.
3 properties 3 required
BasePriceCustomizationNested
object
Base price customization nested in the aggregate response.
1 property 1 required
SeasonalDayOfWeekMinStay
object
Weekday-specific minimum stays limited to a date range.
3 properties 3 required
MinMaxPricesCustomizationNested
object
Min/max prices customization nested in the aggregate response.
7 properties
ListingCustomizations
object
3 properties 2 required
BasePriceCustomization
object
3 properties 2 required
MinStayCustomizationResourceTypeEnum
string
ExtraGuestFeeCustomization
object
3 properties 2 required
PatchedExtraGuestFeeCustomizationRequest
object
1 property 1 required
DayOfWeekMinPriceRequest
object
A nightly minimum-price override for a specific weekday.
2 properties 1 required
SeasonalTimeBasedMinStayRequest
object
Lead-time min-stay rules limited to a seasonal date range.
4 properties 2 required
WeekdayEnum
string
monday - monday tuesday - tuesday wednesday - wednesday thursday - thursday friday - friday saturday - saturday sunday - sunday
BasePriceCustomizationResponse
object
1 property 1 required
MinMaxPricesCustomizationResponse
object
1 property 1 required
MinStaysCustomizationNested
object
Min-stays customization nested in the aggregate response.
8 properties
TimeBasedAdjustmentRequest
object
A lead-time-based price adjustment rule.
3 properties 3 required
SeasonalPricesRequest
object
A date-scoped nightly min/max price override.
5 properties 2 required
GapFillMinStayRequest
object
Gap-fill settings used to raise min stays around short orphan gaps.
3 properties
SeasonalMinStayRequest
object
A date-scoped minimum-stay override.
5 properties 3 required
ExtraGuestFeeCustomizationResponse
object
1 property 1 required
SeasonalMonthlyPrices
object
A date-scoped monthly min/max price override.
5 properties 2 required
DayOfWeekMinPrice
object
A nightly minimum-price override for a specific weekday.
2 properties 1 required
SeasonalTimeBasedMinStay
object
Lead-time min-stay rules limited to a seasonal date range.
4 properties 2 required
SeasonalGapFillMinStay
object
Gap-fill min-stay settings limited to a seasonal date range.
3 properties 3 required
TimeBasedMinStay
object
A lead-time-based minimum-stay rule.
3 properties 3 required
PatchedMinStaysCustomizationRequest
object
1 property 1 required
SeasonalDayOfWeekMinPriceRequest
object
Weekday-specific nightly minimum prices limited to a date range.
3 properties 3 required
TimeBasedAdjustmentCustomizationResourceTypeEnum
string
SeasonalPrices
object
A date-scoped nightly min/max price override.
5 properties 2 required
SeasonalTimeBasedAdjustmentRequest
object
Lead-time price adjustments limited to a seasonal date range.
5 properties 2 required
TimeBasedAdjustmentsCustomizationResponse
object
1 property 1 required
SeasonalMonthlyPricesRequest
object
A date-scoped monthly min/max price override.
5 properties 2 required
TierEnum
string
revenue - revenue occupancy - occupancy rate - rate
DayOfWeekMinStay
object
A minimum-stay override for a specific weekday.
2 properties 1 required
DirectionEnum
string
within - within after - after
SeasonalTimeBasedAdjustment
object
Lead-time price adjustments limited to a seasonal date range.
5 properties 2 required
DynamicTimeBasedAdjustmentsRequestRequest
object
Request payload for auto-generated time-based pricing recommendations.
2 properties
BasePriceCustomizationTypeEnum
string
SeasonalDayOfWeekMinStayRequest
object
Weekday-specific minimum stays limited to a date range.
3 properties 3 required
TimeBasedMinStayRequest
object
A lead-time-based minimum-stay rule.
3 properties 3 required
TimeBasedAdjustment
object
A lead-time-based price adjustment rule.
3 properties 3 required
DayOfWeekMinStayRequest
object
A minimum-stay override for a specific weekday.
2 properties 1 required
DynamicTimeBasedAdjustmentsRequest
object
Request payload for auto-generated time-based pricing recommendations.
2 properties
ExtraGuestFeeCustomizationNested
object
Extra guest fee customization nested in the aggregate response.
2 properties 2 required
PatchedTimeBasedAdjustmentsCustomizationRequest
object
1 property 1 required
PatchedMinMaxPricesCustomizationRequest
object
1 property 1 required
ListingCustomizationsResponse
object
1 property 1 required
PatchedBasePriceCustomizationRequest
object
1 property 1 required
GapFillMinStay
object
Gap-fill settings used to raise min stays around short orphan gaps.
3 properties
MinStaysCustomization
object
3 properties 2 required
MinMaxPriceCustomizationResourceTypeEnum
string
ExtraGuestFeeCustomizationResourceTypeEnum
string
SeasonalGapFillMinStayRequest
object
Gap-fill min-stay settings limited to a seasonal date range.
3 properties 3 required
TimeBasedAdjustmentsCustomizationNested
object
Time-based adjustments customization nested in the aggregate response.
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

beyond-customizations-api-openapi.yml Raw ↑

Other APIs Beyond publishes across the network.

Beyond Accounts API
Beyond Compsets API
Beyond Insights API
Beyond Listings API
Beyond OAuth2 API
Beyond Users API
Where this information came from

This is an independent, third-party profile of Beyond Customizations API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.