Search, price and book rental cars across Poland; the customer confirms on beep.rent.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Use when the user asks to cancel: after verify_reservation_management, with its management_id (and the reservation_number when the code was sent for the user's e-mail), or with the reservation_number when the user's BEEP.rent account is connected. First call without confirm: it returns the refund and a confirmation_token and cancels nothing. Show the refund, get the user's explicit yes, then call again with confirm=true and that token. Cancellation is irreversible. Example: {"management_id":"from_verify","confirm":true,"confirmation_token":"from_preview"}.
false previews; true executes the previewed operation.
From verify_reservation_management.
The number of one of the user's own reservations.
The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.
Use when the user asks to cancel: after verify_reservation_management, with its management_id (and the reservation_number when the code was sent for the user's e-mail), or with the reservation_number when the user's BEEP.rent account is connected. First call without confirm: it returns the refund and a confirmation_token and cancels nothing. Show the refund, get the user's explicit yes, then call again with confirm=true and that token. Cancellation is irreversible. Example: {"management_id":"from_verify","confirm":true,"confirmation_token":"from_preview"}.
| Argument | Type | Description |
|---|---|---|
| market | any | |
| confirm | boolean | false previews; true executes the previewed operation. |
| management_id | any | From verify_reservation_management. |
| confirmation_token | any | |
| reservation_number | any | The number of one of the user's own reservations. |
{
"type": "object",
"title": "CancelInput",
"properties": {
"market": {
"anyOf": [
{
"enum": [
"pl-pl",
"en-pl"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Market",
"default": null
},
"confirm": {
"type": "boolean",
"title": "Confirm",
"default": false,
"description": "false previews; true executes the previewed operation."
},
"management_id": {
"anyOf": [
{
"type": "string",
"maxLength": 512,
"minLength": 16
},
{
"type": "null"
}
],
"title": "Management Id",
"default": null,
"description": "From verify_reservation_management."
},
"confirmation_token": {
"anyOf": [
{
"type": "string",
"maxLength": 128,
"minLength": 16
},
{
"type": "null"
}
],
"title": "Confirmation Token",
"default": null
},
"reservation_number": {
"anyOf": [
{
"type": "string",
"pattern": "^\\s*[A-Za-z0-9]+\\s*$",
"maxLength": 16,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Reservation Number",
"default": null,
"description": "The number of one of the user's own reservations."
}
},
"additionalProperties": false
}Use when the user gives you the 6-digit code they received for a new reservation. Never guess or invent a code. Returns the reservation status: the rental company may still have to accept it. Example: {"reservation_number":"AB12CD34","status_token":"from_reservation","code":"123456"}.
| Argument | Type | Description |
|---|---|---|
| code* | string | The 6-digit code the user received. |
| market | any | |
| status_token* | string | |
| reservation_number* | string |
{
"type": "object",
"title": "ConfirmCodeInput",
"required": [
"reservation_number",
"status_token",
"code"
],
"properties": {
"code": {
"type": "string",
"title": "Code",
"pattern": "^\\d{6}$",
"description": "The 6-digit code the user received."
},
"market": {
"anyOf": [
{
"enum": [
"pl-pl",
"en-pl"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Market",
"default": null
},
"status_token": {
"type": "string",
"title": "Status Token",
"maxLength": 512,
"minLength": 16
},
"reservation_number": {
"type": "string",
"title": "Reservation Number",
"pattern": "^\\s*[A-Za-z0-9]+\\s*$",
"maxLength": 16,
"minLength": 1
}
},
"additionalProperties": false
}Use after get_offer when the user chose an offer: freezes the final price, deposit, options and policies and returns checkout_id and a beep.rent link (continue_url) where the user can finish. Resend every option you applied in get_offer. Does not book anything. Show the user the price, the deposit and the cancellation policy before calling this tool. Example: {"search_id":"from_search","offer_ref":"from_offer","options":{"damage_waiver":true}}.
| Argument | Type | Description |
|---|---|---|
| market | any | |
| options | any | |
| offer_ref* | string | |
| search_id* | string |
{
"type": "object",
"title": "CheckoutInput",
"required": [
"search_id",
"offer_ref"
],
"properties": {
"market": {
"anyOf": [
{
"enum": [
"pl-pl",
"en-pl"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Market",
"default": null
},
"options": {
"anyOf": [
{
"type": "object",
"title": "OfferOptions",
"properties": {
"extras": {
"type": "array",
"items": {
"type": "string"
},
"title": "Extras",
"maxItems": 30
},
"cleaning": {
"type": "boolean",
"title": "Cleaning",
"default": false
},
"card_type": {
"anyOf": [
{
"enum": [
"credit",
"debit"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Card Type",
"default": null
},
"driver_age": {
"anyOf": [
{
"type": "integer",
"maximum": 99,
"minimum": 18
},
{
"type": "null"
}
],
"title": "Driver Age",
"default": null
},
"child_seats": {
"type": "array",
"items": {
"type": "object",
"title": "ChildSeat",
"required": [
"weight_kg"
],
"properties": {
"quantity": {
"type": "integer",
"title": "Quantity",
"default": 1,
"maximum": 3,
"minimum": 1
},
"weight_kg": {
"type": "integer",
"title": "Weight Kg",
"maximum": 36,
"minimum": 1
}
},
"additionalProperties": false
},
"title": "Child Seats",
"maxItems": 3
},
"coupon_code": {
"anyOf": [
{
"type": "string",
"maxLength": 32
},
{
"type": "null"
}
],
"title": "Coupon Code",
"default": null
},
"fuel_prepaid": {
"type": "boolean",
"title": "Fuel Prepaid",
"default": false
},
"zero_deposit": {
"type": "boolean",
"title": "Zero Deposit",
"default": false
},
"damage_waiver": {
"type": "boolean",
"title": "Damage Waiver",
"default": false
},
"foreign_countries": {
"type": "array",
"items": {
"type": "string"
},
"title": "Foreign Countries",
"maxItems": 10,
"description": "ISO 3166-1 alpha-2 country codes, e.g. DE for Germany or CZ for Czechia."
},
"additional_drivers": {
"type": "integer",
"title": "Additional Drivers",
"default": 0,
"maximum": 3,
"minimum": 0
},
"license_tenure_months": {
"anyOf": [
{
"type": "integer",
"maximum": 1200,
"minimum": 0
},
{
"type": "null"
}
],
"title": "License Tenure Months",
"default": null
},
"pickup_service_address": {
"anyOf": [
{
"type": "string",
"maxLength": 160,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Pickup Service Address",
"default": null,
"description": "A street address in Poland, e.g. Woronicza 17, Warszawa."
},
"return_service_address": {
"anyOf": [
{
"type": "string",
"maxLength": 160,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Return Service Address",
"default": null,
"description": "A street address in Poland, e.g. Woronicza 17, Warszawa."
},
"pickup_service_location": {
"anyOf": [
{
"type": "object",
"title": "ServiceLocation",
"required": [
"latitude",
"longitude",
"address"
],
"properties": {
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "City",
"default": null
},
"address": {
"type": "string",
"title": "Address",
"maxLength": 500,
"minLength": 1
},
"latitude": {
"type": "number",
"title": "Latitude",
"maximum": 90,
"minimum": -90
},
"place_id": {
"anyOf": [
{
"type": "string",
"maxLength": 512
},
{
"type": "null"
}
],
"title": "Place Id",
"default": null
},
"longitude": {
"type": "number",
"title": "Longitude",
"maximum": 180,
"minimum": -180
},
"address_precise": {
"type": "boolean",
"title": "Address Precise",
"default": false
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"default": null
},
"pickup_service_place_id": {
"anyOf": [
{
"type": "string",
"maxLength": 512,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Pickup Service Place Id",
"default": null,
"description": "A place_id from earlier candidates."
},
"return_service_location": {
"anyOf": [
{
"type": "object",
"title": "ServiceLocation",
"required": [
"latitude",
"longitude",
"address"
],
"properties": {
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "City",
"default": null
},
"address": {
"type": "string",
"title": "Address",
"maxLength": 500,
"minLength": 1
},
"latitude": {
"type": "number",
"title": "Latitude",
"maximum": 90,
"minimum": -90
},
"place_id": {
"anyOf": [
{
"type": "string",
"maxLength": 512
},
{
"type": "null"
}
],
"title": "Place Id",
"default": null
},
"longitude": {
"type": "number",
"title": "Longitude",
"maximum": 180,
"minimum": -180
},
"address_precise": {
"type": "boolean",
"title": "Address Precise",
"default": false
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"default": null
},
"return_service_place_id": {
"anyOf": [
{
"type": "string",
"maxLength": 512,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Return Service Place Id",
"default": null,
"description": "A place_id from earlier candidates."
},
"pickup_service_requested": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Pickup Service Requested",
"default": null
},
"return_service_requested": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Return Service Requested",
"default": null
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"default": null
},
"offer_ref": {
"type": "string",
"title": "Offer Ref",
"maxLength": 128,
"minLength": 1
},
"search_id": {
"type": "string",
"title": "Search Id",
"maxLength": 64,
"minLength": 1
}
},
"additionalProperties": false
}Use only after the user explicitly asked to book and, asked in one question of its own, accepted the terms and the privacy policy and answered about marketing messages (a yes to the booking is not a yes to the terms): creates the reservation from checkout_id with the driver's details. The booking is not confirmed until the user enters the code sent to them (confirm_reservation_code) or pays on beep.rent. Calling again with the same checkout returns the same reservation. Show the user the price, the deposit and the cancellation policy before calling this tool. Example: {"checkout_id":"from_checkout","customer":{"first_name":"Anna","last_name":"Nowak","email":"[email protected]","phone":"+48500600700"},"consents":{"terms":true,"rental_terms":true,"marketing":false}}.
| Argument | Type | Description |
|---|---|---|
| market | any | |
| comment | any | |
| invoice | any | |
| consents* | object | |
| customer* | object | |
| checkout_id* | string | |
| accept_changes | boolean | Set only after the user accepted the changed terms returned with status requires_review. |
Use to find physical pickup desks near a city or location. Reads the shared public snapshot. Do not treat a pickup point as a guarantee of car availability. Examples: {"city":"krakow","radius_m":10000}; {"near":{"lat":50.06,"lng":19.94},"limit":5}.
| Argument | Type | Description |
|---|---|---|
| city | any | |
| near | any | |
| limit | integer | |
| market | any | |
| radius_m | integer |
{
"type": "object",
"title": "PickupPointsInput",
"properties": {
"city": {
"anyOf": [
{
"type": "string",
"maxLength": 160,
"minLength": 1
},
{
"type": "null"
}
],
"title": "City",
"default": null
},
"near": {
"anyOf": [
{
"type": "object",
"title": "LocationInput",
"properties": {
"lat": {
"anyOf": [
{
"type": "number",
"maximum": 90,
"minimum": -90
},
{
"type": "null"
}
],
"title": "Lat",
"default": null
},
"lng": {
"anyOf": [
{
"type": "number",
"maximum": 180,
"minimum": -180
},
{
"type": "null"
}
],
"title": "Lng",
"default": null
},
"query": {
"anyOf": [
{
"type": "string",
"maxLength": 160,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Query",
"default": null,
"description": "A place name or address, e.g. Kraków or Warsaw Chopin Airport."
},
"city_id": {
"anyOf": [
{
"type": "string",
"maxLength": 128,
"minLength": 1
},
{
"type": "null"
}
],
"title": "City Id",
"default": null,
"description": "A city_id returned by get_city_prices or a clarification; for a city name use query."
},
"place_id": {
"anyOf": [
{
"type": "string",
"maxLength": 512,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Place Id",
"default": null,
"description": "A place_id from earlier candidates."
},
"pickup_point_id": {
"anyOf": [
{
"type": "string",
"maxLength": 64,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Pickup Point Id",
"default": null,
"description": "An id from find_pickup_points."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"default": null
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 10,
"maximum": 20,
"minimum": 1
},
"market": {
"anyOf": [
{
"enum": [
"pl-pl",
"en-pl"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Market",
"default": null
},
"radius_m": {
"type": "integer",
"title": "Radius M",
"default": 30000,
"maximum": 100000,
"minimum": 1
}
},
"additionalProperties": false
}Use for cached price examples before travel dates are chosen. These are dated examples, not live availability. Do not use for a binding quote. Examples: {"city":"Kraków"}; {"city":"wroclaw-krzyki","market":"en-pl"}.
| Argument | Type | Description |
|---|---|---|
| city* | string | |
| market | any |
{
"type": "object",
"title": "CityInput",
"required": [
"city"
],
"properties": {
"city": {
"type": "string",
"title": "City",
"maxLength": 160,
"minLength": 1
},
"market": {
"anyOf": [
{
"enum": [
"pl-pl",
"en-pl"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Market",
"default": null
}
},
"additionalProperties": false
}Use after search_offers to read current pricing, deposit, extras and rental policies. Supplied options are applied on top of the search selections; omitted options keep the search values. Options from earlier get_offer calls are not remembered: resend every option you changed. detail "full" adds every photo; "policies" keeps the policies in a concise response. Do not use to book or confirm a reservation. Example: {"search_id":"from_search","offer_ref":"from_offer"}.
| Argument | Type | Description |
|---|---|---|
| detail | string | |
| market | any | |
| options | any | |
| offer_ref* | string | |
| search_id* | string | |
| response_format | string |
{
"type": "object",
"title": "OfferInput",
"required": [
"search_id",
"offer_ref"
],
"properties": {
"detail": {
"enum": [
"summary",
"policies",
"full"
],
"type": "string",
"title": "Detail",
"default": "summary"
},
"market": {
"anyOf": [
{
"enum": [
"pl-pl",
"en-pl"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Market",
"default": null
},
"options": {
"anyOf": [
{
"type": "object",
"title": "OfferOptions",
"properties": {
"extras": {
"type": "array",
"items": {
"type": "string"
},
"title": "Extras",
"maxItems": 30
},
"cleaning": {
"type": "boolean",
"title": "Cleaning",
"default": false
},
"card_type": {
"anyOf": [
{
"enum": [
"credit",
"debit"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Card Type",
"default": null
},
"driver_age": {
"anyOf": [
{
"type": "integer",
"maximum": 99,
"minimum": 18
},
{
"type": "null"
}
],
"title": "Driver Age",
"default": null
},
"child_seats": {
"type": "array",
"items": {
"type": "object",
"title": "ChildSeat",
"required": [
"weight_kg"
],
"properties": {
"quantity": {
"type": "integer",
"title": "Quantity",
"default": 1,
"maximum": 3,
"minimum": 1
},
"weight_kg": {
"type": "integer",
"title": "Weight Kg",
"maximum": 36,
"minimum": 1
}
},
"additionalProperties": false
},
"title": "Child Seats",
"maxItems": 3
},
"coupon_code": {
"anyOf": [
{
"type": "string",
"maxLength": 32
},
{
"type": "null"
}
],
"title": "Coupon Code",
"default": null
},
"fuel_prepaid": {
"type": "boolean",
"title": "Fuel Prepaid",
"default": false
},
"zero_deposit": {
"type": "boolean",
"title": "Zero Deposit",
"default": false
},
"damage_waiver": {
"type": "boolean",
"title": "Damage Waiver",
"default": false
},
"foreign_countries": {
"type": "array",
"items": {
"type": "string"
},
"title": "Foreign Countries",
"maxItems": 10,
"description": "ISO 3166-1 alpha-2 country codes, e.g. DE for Germany or CZ for Czechia."
},
"additional_drivers": {
"type": "integer",
"title": "Additional Drivers",
"default": 0,
"maximum": 3,
"minimum": 0
},
"license_tenure_months": {
"anyOf": [
{
"type": "integer",
"maximum": 1200,
"minimum": 0
},
{
"type": "null"
}
],
"title": "License Tenure Months",
"default": null
},
"pickup_service_address": {
"anyOf": [
{
"type": "string",
"maxLength": 160,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Pickup Service Address",
"default": null,
"description": "A street address in Poland, e.g. Woronicza 17, Warszawa."
},
"return_service_address": {
"anyOf": [
{
"type": "string",
"maxLength": 160,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Return Service Address",
"default": null,
"description": "A street address in Poland, e.g. Woronicza 17, Warszawa."
},
"pickup_service_location": {
"anyOf": [
{
"type": "object",
"title": "ServiceLocation",
"required": [
"latitude",
"longitude",
"address"
],
"properties": {
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "City",
"default": null
},
"address": {
"type": "string",
"title": "Address",
"maxLength": 500,
"minLength": 1
},
"latitude": {
"type": "number",
"title": "Latitude",
"maximum": 90,
"minimum": -90
},
"place_id": {
"anyOf": [
{
"type": "string",
"maxLength": 512
},
{
"type": "null"
}
],
"title": "Place Id",
"default": null
},
"longitude": {
"type": "number",
"title": "Longitude",
"maximum": 180,
"minimum": -180
},
"address_precise": {
"type": "boolean",
"title": "Address Precise",
"default": false
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"default": null
},
"pickup_service_place_id": {
"anyOf": [
{
"type": "string",
"maxLength": 512,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Pickup Service Place Id",
"default": null,
"description": "A place_id from earlier candidates."
},
"return_service_location": {
"anyOf": [
{
"type": "object",
"title": "ServiceLocation",
"required": [
"latitude",
"longitude",
"address"
],
"properties": {
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "City",
"default": null
},
"address": {
"type": "string",
"title": "Address",
"maxLength": 500,
"minLength": 1
},
"latitude": {
"type": "number",
"title": "Latitude",
"maximum": 90,
"minimum": -90
},
"place_id": {
"anyOf": [
{
"type": "string",
"maxLength": 512
},
{
"type": "null"
}
],
"title": "Place Id",
"default": null
},
"longitude": {
"type": "number",
"title": "Longitude",
"maximum": 180,
"minimum": -180
},
"address_precise": {
"type": "boolean",
"title": "Address Precise",
"default": false
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"default": null
},
"return_service_place_id": {
"anyOf": [
{
"type": "string",
"maxLength": 512,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Return Service Place Id",
"default": null,
"description": "A place_id from earlier candidates."
},
"pickup_service_requested": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Pickup Service Requested",
"default": null
},
"return_service_requested": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Return Service Requested",
"default": null
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"default": null
},
"offer_ref": {
"type": "string",
"title": "Offer Ref",
"maxLength": 128,
"minLength": 1
},
"search_id": {
"type": "string",
"title": "Search Id",
"maxLength": 64,
"minLength": 1
},
"response_format": {
"enum": [
"concise",
"detailed"
],
"type": "string",
"title": "Response Format",
"default": "detailed"
}
},
"additionalProperties": false
}Use to check whether a reservation is confirmed, awaits the user's code or payment, or awaits the rental company. Identify it with status_token from create_reservation, with the e-mail used for booking, with the management_id of the user's e-mail, or by its number alone when the user's BEEP.rent account is connected. Never say a reservation is confirmed unless this returns status confirmed. Examples: {"reservation_number":"AB12CD34","status_token":"from_reservation"}; {"reservation_number":"AB12CD34","email":"[email protected]"}.
| Argument | Type | Description |
|---|---|---|
| any | ||
| market | any | |
| status_token | any | |
| management_id | any | From verify_reservation_management for the user's e-mail. |
| reservation_number* | string |
{
"type": "object",
"title": "StatusInput",
"required": [
"reservation_number"
],
"properties": {
"email": {
"anyOf": [
{
"type": "string",
"maxLength": 254,
"minLength": 3
},
{
"type": "null"
}
],
"title": "Email",
"default": null
},
"market": {
"anyOf": [
{
"enum": [
"pl-pl",
"en-pl"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Market",
"default": null
},
"status_token": {
"anyOf": [
{
"type": "string",
"maxLength": 512,
"minLength": 16
},
{
"type": "null"
}
],
"title": "Status Token",
"default": null
},
"management_id": {
"anyOf": [
{
"type": "string",
"maxLength": 512,
"minLength": 16
},
{
"type": "null"
}
],
"title": "Management Id",
"default": null,
"description": "From verify_reservation_management for the user's e-mail."
},
"reservation_number": {
"type": "string",
"title": "Reservation Number",
"pattern": "^\\s*[A-Za-z0-9]+\\s*$",
"maxLength": 16,
"minLength": 1
}
},
"additionalProperties": false
}Use when the user asks about their own BEEP.rent bookings. Lists the reservations of the e-mail the user verified with start_reservation_management (pass its management_id) or of the BEEP.rent account they connected: upcoming ones with the next pickup first, or with include_past the last 365 days, newest first. Each has its number, status, dates, pickup place, car and total. Example: {"management_id": "from_verify", "limit": 5}.
| Argument | Type | Description |
|---|---|---|
| limit | integer | How many reservations to return. |
| offset | integer | |
| include_past | boolean | Also list rentals that ended or were cancelled in the last 365 days. |
| management_id | any | From verify_reservation_management for the user's e-mail. |
{
"type": "object",
"title": "MyReservationsInput",
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 10,
"maximum": 20,
"minimum": 1,
"description": "How many reservations to return."
},
"offset": {
"type": "integer",
"title": "Offset",
"default": 0,
"maximum": 1000,
"minimum": 0
},
"include_past": {
"type": "boolean",
"title": "Include Past",
"default": false,
"description": "Also list rentals that ended or were cancelled in the last 365 days."
},
"management_id": {
"anyOf": [
{
"type": "string",
"maxLength": 512,
"minLength": 16
},
{
"type": "null"
}
],
"title": "Management Id",
"default": null,
"description": "From verify_reservation_management for the user's e-mail."
}
},
"additionalProperties": false
}Use when the user wants to return the car later, after verify_reservation_management, with its management_id (and the reservation_number when the code was sent for the user's e-mail), or with the reservation_number when the user's BEEP.rent account is connected: prices the extra days. Only a rental in progress can be extended. Changes nothing. Example: {"management_id":"from_verify","new_return_at":"2026-12-10T10:00:00+01:00"}.
| Argument | Type | Description |
|---|---|---|
| market | any | |
| management_id | any | From verify_reservation_management. |
| new_return_at* | string | |
| reservation_number | any | The number of one of the user's own reservations. |
{
"type": "object",
"title": "ExtensionQuoteInput",
"required": [
"new_return_at"
],
"properties": {
"market": {
"anyOf": [
{
"enum": [
"pl-pl",
"en-pl"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Market",
"default": null
},
"management_id": {
"anyOf": [
{
"type": "string",
"maxLength": 512,
"minLength": 16
},
{
"type": "null"
}
],
"title": "Management Id",
"default": null,
"description": "From verify_reservation_management."
},
"new_return_at": {
"type": "string",
"title": "New Return At"
},
"reservation_number": {
"anyOf": [
{
"type": "string",
"pattern": "^\\s*[A-Za-z0-9]+\\s*$",
"maxLength": 16,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Reservation Number",
"default": null,
"description": "The number of one of the user's own reservations."
}
},
"additionalProperties": false
}Use when the user did not receive the 6-digit code for a new reservation or it expired. Sends a new code to the contact given at booking; do not call it unprompted. Example: {"reservation_number":"AB12CD34","status_token":"from_reservation"}.
| Argument | Type | Description |
|---|---|---|
| market | any | |
| status_token* | string | |
| reservation_number* | string |
{
"type": "object",
"title": "ReservationTokenInput",
"required": [
"reservation_number",
"status_token"
],
"properties": {
"market": {
"anyOf": [
{
"enum": [
"pl-pl",
"en-pl"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Market",
"default": null
},
"status_token": {
"type": "string",
"title": "Status Token",
"maxLength": 512,
"minLength": 16
},
"reservation_number": {
"type": "string",
"title": "Reservation Number",
"pattern": "^\\s*[A-Za-z0-9]+\\s*$",
"maxLength": 16,
"minLength": 1
}
},
"additionalProperties": false
}Use after quote_extension when the user asked to extend. First call without confirm previews the request and returns confirmation_token; after the user's explicit yes call again with confirm=true, the token and the same new_return_at. The rental company decides; decision says how the user hears back. Example: {"management_id":"from_verify","new_return_at":"2026-12-10T10:00:00+01:00","confirm":true,"confirmation_token":"from_preview"}.
| Argument | Type | Description |
|---|---|---|
| market | any | |
| confirm | boolean | false previews; true executes the previewed operation. |
| management_id | any | From verify_reservation_management. |
| new_return_at* | string | |
| confirmation_token | any | |
| reservation_number | any | The number of one of the user's own reservations. |
{
"type": "object",
"title": "ExtensionRequestInput",
"required": [
"new_return_at"
],
"properties": {
"market": {
"anyOf": [
{
"enum": [
"pl-pl",
"en-pl"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Market",
"default": null
},
"confirm": {
"type": "boolean",
"title": "Confirm",
"default": false,
"description": "false previews; true executes the previewed operation."
},
"management_id": {
"anyOf": [
{
"type": "string",
"maxLength": 512,
"minLength": 16
},
{
"type": "null"
}
],
"title": "Management Id",
"default": null,
"description": "From verify_reservation_management."
},
"new_return_at": {
"type": "string",
"title": "New Return At"
},
"confirmation_token": {
"anyOf": [
{
"type": "string",
"maxLength": 128,
"minLength": 16
},
{
"type": "null"
}
],
"title": "Confirmation Token",
"default": null
},
"reservation_number": {
"anyOf": [
{
"type": "string",
"pattern": "^\\s*[A-Za-z0-9]+\\s*$",
"maxLength": 16,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Reservation Number",
"default": null,
"description": "The number of one of the user's own reservations."
}
},
"additionalProperties": false
}Use when the user pastes a beep.rent link to one offer (from an e-mail, a campaign or a short beep.rent/r/ link). Returns search_id and offer_ref for get_offer, priced with the options the link advertised. Example: {"url": "https://beep.rent/pl-pl/wynajem-samochodu/?offer_car=...&pickup_parking=...&pickup_at=..."}.
| Argument | Type | Description |
|---|---|---|
| url* | string | The beep.rent link to one offer exactly as the user received it. |
{
"type": "object",
"title": "BookingLinkInput",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "Url",
"maxLength": 2048,
"minLength": 10,
"description": "The beep.rent link to one offer exactly as the user received it."
}
},
"additionalProperties": false
}Use when looking for available cars and full prices in Poland. Supply the whole trip when changing criteria; omitted options reset. Filters and sort are not remembered: repeat them on every page. Do not use for an existing reservation. Examples: {"pickup":{"query":"Kraków"},"pickup_at":"2026-12-01T10:00:00+01:00","return_at":"2026-12-08T10:00:00+01:00","sort":"price"}; {"search_id":"from_previous_result","offset":8,"sort":"price"}.
| Argument | Type | Description |
|---|---|---|
| sort | string | |
| limit | integer | |
| market | any | |
| offset | integer | |
| pickup | any | |
| filters | object | |
| options | object | |
| card_type | string | |
| pickup_at | any | |
| return_at | any |
Use when the user wants to see, cancel or extend their reservations: e-mails a 6-digit code to the booking's e-mail address and returns management_id. With the reservation number the code unlocks that reservation; without it, every reservation of that e-mail. Examples: {"reservation_number":"AB12CD34","email":"[email protected]"}; {"email":"[email protected]"}.
| Argument | Type | Description |
|---|---|---|
| email* | string | |
| market | any | |
| reservation_number | any |
{
"type": "object",
"title": "ManagementStartInput",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"title": "Email",
"maxLength": 254,
"minLength": 3
},
"market": {
"anyOf": [
{
"enum": [
"pl-pl",
"en-pl"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Market",
"default": null
},
"reservation_number": {
"anyOf": [
{
"type": "string",
"pattern": "^\\s*[A-Za-z0-9]+\\s*$",
"maxLength": 16,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Reservation Number",
"default": null
}
},
"additionalProperties": false
}Use with the 6-digit code from the management e-mail: unlocks the reservation's summary and its cancellation and extension options or, for a code sent for an e-mail alone, that e-mail's reservations, for this conversation (2 hours). Go on with the management_id it returns. Never guess a code. Example: {"management_id":"from_start","code":"123456"}.
| Argument | Type | Description |
|---|---|---|
| code* | string | The 6-digit code the user received. |
| market | any | |
| management_id* | string |
{
"type": "object",
"title": "ManagementVerifyInput",
"required": [
"management_id",
"code"
],
"properties": {
"code": {
"type": "string",
"title": "Code",
"pattern": "^\\d{6}$",
"description": "The 6-digit code the user received."
},
"market": {
"anyOf": [
{
"enum": [
"pl-pl",
"en-pl"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Market",
"default": null
},
"management_id": {
"type": "string",
"title": "Management Id",
"maxLength": 512,
"minLength": 16
}
},
"additionalProperties": false
}{
"type": "object",
"title": "ReservationInput",
"required": [
"checkout_id",
"customer",
"consents"
],
"properties": {
"market": {
"anyOf": [
{
"enum": [
"pl-pl",
"en-pl"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Market",
"default": null
},
"comment": {
"anyOf": [
{
"type": "string",
"maxLength": 2000
},
{
"type": "null"
}
],
"title": "Comment",
"default": null
},
"invoice": {
"anyOf": [
{
"type": "object",
"title": "Invoice",
"required": [
"buyer_name",
"buyer_tax_id",
"buyer_street",
"buyer_city",
"buyer_zip_code"
],
"properties": {
"buyer_city": {
"type": "string",
"title": "Buyer City",
"maxLength": 64,
"minLength": 1
},
"buyer_name": {
"type": "string",
"title": "Buyer Name",
"maxLength": 128,
"minLength": 1
},
"buyer_street": {
"type": "string",
"title": "Buyer Street",
"maxLength": 128,
"minLength": 1
},
"buyer_tax_id": {
"type": "string",
"title": "Buyer Tax Id",
"maxLength": 16,
"minLength": 10,
"description": "Polish NIP of the buyer."
},
"buyer_zip_code": {
"type": "string",
"title": "Buyer Zip Code",
"pattern": "^\\d{2}-\\d{3}$"
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"default": null
},
"consents": {
"type": "object",
"title": "Consents",
"required": [
"terms",
"rental_terms",
"marketing"
],
"properties": {
"terms": {
"type": "boolean",
"title": "Terms",
"description": "The user accepted the BEEP.rent terms of service and privacy policy."
},
"marketing": {
"type": "boolean",
"title": "Marketing",
"description": "True only after an explicit yes to marketing messages (promotions and discount codes)."
},
"rental_terms": {
"type": "boolean",
"title": "Rental Terms",
"description": "The user accepted the rental company's general terms of rental."
}
},
"additionalProperties": false
},
"customer": {
"type": "object",
"title": "Customer",
"required": [
"first_name",
"last_name",
"email",
"phone"
],
"properties": {
"email": {
"type": "string",
"title": "Email",
"maxLength": 254,
"minLength": 3
},
"phone": {
"type": "string",
"title": "Phone",
"maxLength": 20,
"minLength": 7,
"description": "E.164 with the country code, for example +48500600700."
},
"last_name": {
"type": "string",
"title": "Last Name",
"maxLength": 64,
"minLength": 1
},
"first_name": {
"type": "string",
"title": "First Name",
"maxLength": 64,
"minLength": 1
}
},
"additionalProperties": false
},
"checkout_id": {
"type": "string",
"title": "Checkout Id",
"maxLength": 64,
"minLength": 1
},
"accept_changes": {
"type": "boolean",
"title": "Accept Changes",
"default": false,
"description": "Set only after the user accepted the changed terms returned with status requires_review."
}
},
"additionalProperties": false
}| search_id | any |
| driver_age | integer |
| response_format | string |
| return_location | any |
| license_tenure_months | integer |
{
"type": "object",
"title": "SearchInput",
"properties": {
"sort": {
"enum": [
"instant",
"no_advance_payment",
"distance",
"price"
],
"type": "string",
"title": "Sort",
"default": "instant"
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 8,
"maximum": 20,
"minimum": 1
},
"market": {
"anyOf": [
{
"enum": [
"pl-pl",
"en-pl"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Market",
"default": null
},
"offset": {
"type": "integer",
"title": "Offset",
"default": 0,
"maximum": 10000,
"minimum": 0
},
"pickup": {
"anyOf": [
{
"type": "object",
"title": "LocationInput",
"properties": {
"lat": {
"anyOf": [
{
"type": "number",
"maximum": 90,
"minimum": -90
},
{
"type": "null"
}
],
"title": "Lat",
"default": null
},
"lng": {
"anyOf": [
{
"type": "number",
"maximum": 180,
"minimum": -180
},
{
"type": "null"
}
],
"title": "Lng",
"default": null
},
"query": {
"anyOf": [
{
"type": "string",
"maxLength": 160,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Query",
"default": null,
"description": "A place name or address, e.g. Kraków or Warsaw Chopin Airport."
},
"city_id": {
"anyOf": [
{
"type": "string",
"maxLength": 128,
"minLength": 1
},
{
"type": "null"
}
],
"title": "City Id",
"default": null,
"description": "A city_id returned by get_city_prices or a clarification; for a city name use query."
},
"place_id": {
"anyOf": [
{
"type": "string",
"maxLength": 512,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Place Id",
"default": null,
"description": "A place_id from earlier candidates."
},
"pickup_point_id": {
"anyOf": [
{
"type": "string",
"maxLength": 64,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Pickup Point Id",
"default": null,
"description": "An id from find_pickup_points."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"default": null
},
"filters": {
"type": "object",
"title": "Filters",
"properties": {
"is_suv": {
"type": "boolean",
"title": "Is Suv",
"default": false
},
"gearbox": {
"anyOf": [
{
"enum": [
"manual",
"automatic"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Gearbox",
"default": null
},
"segment": {
"type": "array",
"items": {
"type": "string"
},
"title": "Segment",
"maxItems": 30
},
"is_premium": {
"type": "boolean",
"title": "Is Premium",
"default": false
},
"low_deposit": {
"type": "boolean",
"title": "Low Deposit",
"default": false
},
"vehicle_size": {
"type": "array",
"items": {
"enum": [
"small",
"medium",
"large",
"xlarge"
],
"type": "string"
},
"title": "Vehicle Size",
"maxItems": 4
},
"zero_deposit": {
"type": "boolean",
"title": "Zero Deposit",
"default": false
},
"no_credit_card": {
"type": "boolean",
"title": "No Credit Card",
"default": false
},
"pay_at_pickup_only": {
"type": "boolean",
"title": "Pay At Pickup Only",
"default": false
}
},
"additionalProperties": false
},
"options": {
"type": "object",
"title": "Options",
"properties": {
"extras": {
"type": "array",
"items": {
"type": "string"
},
"title": "Extras",
"maxItems": 30
},
"cleaning": {
"type": "boolean",
"title": "Cleaning",
"default": false
},
"child_seats": {
"type": "array",
"items": {
"type": "object",
"title": "ChildSeat",
"required": [
"weight_kg"
],
"properties": {
"quantity": {
"type": "integer",
"title": "Quantity",
"default": 1,
"maximum": 3,
"minimum": 1
},
"weight_kg": {
"type": "integer",
"title": "Weight Kg",
"maximum": 36,
"minimum": 1
}
},
"additionalProperties": false
},
"title": "Child Seats",
"maxItems": 3
},
"coupon_code": {
"anyOf": [
{
"type": "string",
"maxLength": 32
},
{
"type": "null"
}
],
"title": "Coupon Code",
"default": null
},
"fuel_prepaid": {
"type": "boolean",
"title": "Fuel Prepaid",
"default": false
},
"zero_deposit": {
"type": "boolean",
"title": "Zero Deposit",
"default": false
},
"damage_waiver": {
"type": "boolean",
"title": "Damage Waiver",
"default": false
},
"foreign_countries": {
"type": "array",
"items": {
"type": "string"
},
"title": "Foreign Countries",
"maxItems": 10,
"description": "ISO 3166-1 alpha-2 country codes, e.g. DE for Germany or CZ for Czechia."
},
"additional_drivers": {
"type": "integer",
"title": "Additional Drivers",
"default": 0,
"maximum": 3,
"minimum": 0
},
"pickup_service_address": {
"anyOf": [
{
"type": "string",
"maxLength": 160,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Pickup Service Address",
"default": null,
"description": "A street address in Poland, e.g. Woronicza 17, Warszawa."
},
"return_service_address": {
"anyOf": [
{
"type": "string",
"maxLength": 160,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Return Service Address",
"default": null,
"description": "A street address in Poland, e.g. Woronicza 17, Warszawa."
},
"pickup_service_place_id": {
"anyOf": [
{
"type": "string",
"maxLength": 512,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Pickup Service Place Id",
"default": null,
"description": "A place_id from earlier candidates."
},
"return_service_place_id": {
"anyOf": [
{
"type": "string",
"maxLength": 512,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Return Service Place Id",
"default": null,
"description": "A place_id from earlier candidates."
}
},
"additionalProperties": false
},
"card_type": {
"enum": [
"credit",
"debit",
"none"
],
"type": "string",
"title": "Card Type",
"default": "credit"
},
"pickup_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Pickup At",
"default": null
},
"return_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Return At",
"default": null
},
"search_id": {
"anyOf": [
{
"type": "string",
"maxLength": 64,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Search Id",
"default": null
},
"driver_age": {
"type": "integer",
"title": "Driver Age",
"default": 31,
"maximum": 99,
"minimum": 18
},
"response_format": {
"enum": [
"concise",
"detailed"
],
"type": "string",
"title": "Response Format",
"default": "concise"
},
"return_location": {
"anyOf": [
{
"type": "object",
"title": "LocationInput",
"properties": {
"lat": {
"anyOf": [
{
"type": "number",
"maximum": 90,
"minimum": -90
},
{
"type": "null"
}
],
"title": "Lat",
"default": null
},
"lng": {
"anyOf": [
{
"type": "number",
"maximum": 180,
"minimum": -180
},
{
"type": "null"
}
],
"title": "Lng",
"default": null
},
"query": {
"anyOf": [
{
"type": "string",
"maxLength": 160,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Query",
"default": null,
"description": "A place name or address, e.g. Kraków or Warsaw Chopin Airport."
},
"city_id": {
"anyOf": [
{
"type": "string",
"maxLength": 128,
"minLength": 1
},
{
"type": "null"
}
],
"title": "City Id",
"default": null,
"description": "A city_id returned by get_city_prices or a clarification; for a city name use query."
},
"place_id": {
"anyOf": [
{
"type": "string",
"maxLength": 512,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Place Id",
"default": null,
"description": "A place_id from earlier candidates."
},
"pickup_point_id": {
"anyOf": [
{
"type": "string",
"maxLength": 64,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Pickup Point Id",
"default": null,
"description": "An id from find_pickup_points."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"default": null
},
"license_tenure_months": {
"type": "integer",
"title": "License Tenure Months",
"default": 60,
"maximum": 1200,
"minimum": 0
}
},
"additionalProperties": false
}