MyBeezBox API (v2)
Download OpenAPI specification:Download
Welcome to MyBeezBox API v2. The interface and the logic were rebuilt from scratch to provide better, more RESTful experience.
Useful links
- Authentication – learn how to access this API.
- General documentation of MyBeezBox service
contact_requests_create
A viewset for the use_funnel.ContactRequest model.
Note: for the moment, the mixins used only allow the creation of a ContactRequest object with a POST request. Add more mixins to enable GET requests on list and detail views.
Authorizations:
header Parameters
| X-Partner-Domain | string Examples:
Partner's site domain (optional) |
Request Body schema: required
| gift_code required | string |
| full_name required | string |
| email required | string <email> |
| phone_number | string or null |
| message required | string |
| partner required | string <uuid> |
Responses
Request samples
- Payload
This is an example of a contact request's information.
partneris the UUID of the partner selling the gift product for which we create a contact request.
{- "id": 1,
- "gift_code": "voucher_code",
- "full_name": "Jane Doe",
- "email": "janedoe@mybeezbox.com",
- "phone_number": "+33 123 456 780",
- "message": "I would like to use this gift code.",
- "related_product_details": {
- "id": 1,
- "type": "Voucher",
- "state": "paid"
}, - "partner": "ab803b77-c6db-4884-b5ac-9f77de035f63"
}Response samples
- 201
This is an example of a contact request's information.
partneris the UUID of the partner selling the gift product for which we create a contact request.
{- "id": 1,
- "gift_code": "voucher_code",
- "full_name": "Jane Doe",
- "email": "janedoe@mybeezbox.com",
- "phone_number": "+33 123 456 780",
- "message": "I would like to use this gift code.",
- "related_product_details": {
- "id": 1,
- "type": "Voucher",
- "state": "paid"
}, - "partner": "ab803b77-c6db-4884-b5ac-9f77de035f63"
}destinations_list
Authorizations:
header Parameters
| X-Partner-Domain | string Examples:
Partner's site domain (optional) |
Responses
Response samples
- 200
This is an example of region, department and a city of a partner.
[- {
- "city": "Porto-Vecchio",
- "department": "Corse",
- "region": "Corse-du-Sud"
}
]event_prototypes_retrieve
A view set to retrieve detailed data for an event:
- Event's details
- Event's available slots.
- Event's formula
Authorizations:
path Parameters
| id required | integer A unique integer value identifying this event. |
header Parameters
| X-Partner-Domain | string Examples:
Partner's site domain (optional) |
Responses
Response samples
- 200
{- "id": 0,
- "name": {
- "fr": "string",
- "en": "string",
- "es": "string",
- "it": "string",
- "de": "string",
- "nl": "string",
- "ca": "string",
- "pt": "string"
}, - "short_description": {
- "fr": "string",
- "en": "string",
- "es": "string",
- "it": "string",
- "de": "string",
- "nl": "string",
- "ca": "string",
- "pt": "string"
}, - "long_description": {
- "fr": "string",
- "en": "string",
- "es": "string",
- "it": "string",
- "de": "string",
- "nl": "string",
- "ca": "string",
- "pt": "string"
}, - "booking": {
- "fr": "string",
- "en": "string",
- "es": "string",
- "it": "string",
- "de": "string",
- "nl": "string",
- "ca": "string",
- "pt": "string"
}, - "cover_image": "string",
- "images": [
- "string"
], - "slots": [
- {
- "starting_datetime": "2019-08-24T14:15:22Z",
- "starting_datetime_formatted": {
- "en": "Friday December, 12th 2025",
- "fr": "vendredi 12 Décembre 2025",
- "es": "viernes 12 diciembre 2025",
- "it": "Venerdì 12 Dicembre 2025",
- "nl": "vrijdag 12 december 2025",
- "de": "Freitag 12 Dezember 2025",
- "ca": "Divendres 12 desembre 2025",
- "pt": "Sexta-feira 12 Dezembro 2025"
}, - "ending_datetime": "2019-08-24T14:15:22Z",
- "ending_datetime_formatted": {
- "en": "Friday December, 12th 2025",
- "fr": "vendredi 12 Décembre 2025",
- "es": "viernes 12 diciembre 2025",
- "it": "Venerdì 12 Dicembre 2025",
- "nl": "vrijdag 12 december 2025",
- "de": "Freitag 12 Dezember 2025",
- "ca": "Divendres 12 desembre 2025",
- "pt": "Sexta-feira 12 Dezembro 2025"
}, - "duration_formatted": {
- "pt": "De 21h00 para 23h03",
- "en": "From 21:00 to 23:03",
- "es": "De 21:00 a 23:03",
- "it": "Dalle 21h00 alle 23h03",
- "fr": "De 21h00 à 23h03",
- "nl": "Van 21h00 naar 23h03",
- "de": "Von 21h00 bis 23h03",
- "ca": "Des de 21:00 a 23:03"
}, - "funnel_link": "string",
- "available_places": 0
}
], - "formulas": "string",
- "lowest_price": "string",
- "lowest_price_formatted": {
- "pt": "410,00 €",
- "fr": "410,00 €",
- "it": "410,00 €",
- "es": "410,00 €",
- "de": "410,00 €",
- "en": "€410.00",
- "ca": "410,00 €",
- "nl": "€ 410,00"
}, - "currency_code": "string",
- "delivery_options": {
- "activated_email_to_buyer": true,
- "activated_email_to_beneficiary_delivery": true,
- "activated_postal_mail_to_buyer": true,
- "activated_postal_mail_to_beneficiary_delivery": true,
- "postal_mail_shipping_cost": "string",
- "postal_mail_duration": 0,
- "activated_pickup_on_site_delivery": true,
- "pickup_on_site_duration": 0,
- "pickup_on_site_cost": "string",
- "activated_3MA_to_buyer": true,
- "activated_3MA_to_beneficiary": true,
- "threema_delivery_cost": "string"
}
}event_slots_list
ViewSet for listing Events' slots.
Refs: https://app.clickup.com/t/86c6n9b6x
Each Event is presented by their first available slot. If the partner's ticket settings checks "Display event per slots", all available slots are displayed.
This view uses querysets of Slot objects.
For a detail endpoint of an Event, another view with a queryset of Event objects is needed.
Authorizations:
query Parameters
| page | integer A page number within the paginated result set. |
| page_size | integer Number of results to return per page. |
header Parameters
| X-Partner-Domain | string Examples:
Partner's site domain (optional) |
Responses
Response samples
- 200
{- "count": 123,
- "results": [
- {
- "id": 0,
- "event_id": 0,
- "name": {
- "fr": "string",
- "en": "string",
- "es": "string",
- "it": "string",
- "de": "string",
- "nl": "string",
- "ca": "string",
- "pt": "string"
}, - "description": {
- "fr": "string",
- "en": "string",
- "es": "string",
- "it": "string",
- "de": "string",
- "nl": "string",
- "ca": "string",
- "pt": "string"
}, - "starting_datetime": "2019-08-24T14:15:22Z",
- "starting_datetime_formatted": {
- "en": "Friday December, 12th 2025",
- "fr": "vendredi 12 Décembre 2025",
- "es": "viernes 12 diciembre 2025",
- "it": "Venerdì 12 Dicembre 2025",
- "nl": "vrijdag 12 december 2025",
- "de": "Freitag 12 Dezember 2025",
- "ca": "Divendres 12 desembre 2025",
- "pt": "Sexta-feira 12 Dezembro 2025"
}, - "ending_datetime": "2019-08-24T14:15:22Z",
- "ending_datetime_formatted": {
- "en": "Friday December, 12th 2025",
- "fr": "vendredi 12 Décembre 2025",
- "es": "viernes 12 diciembre 2025",
- "it": "Venerdì 12 Dicembre 2025",
- "nl": "vrijdag 12 december 2025",
- "de": "Freitag 12 Dezember 2025",
- "ca": "Divendres 12 desembre 2025",
- "pt": "Sexta-feira 12 Dezembro 2025"
}, - "duration_formatted": {
- "pt": "De 21h00 para 23h03",
- "en": "From 21:00 to 23:03",
- "es": "De 21:00 a 23:03",
- "it": "Dalle 21h00 alle 23h03",
- "fr": "De 21h00 à 23h03",
- "nl": "Van 21h00 naar 23h03",
- "de": "Von 21h00 bis 23h03",
- "ca": "Des de 21:00 a 23:03"
}, - "price": "string",
- "price_formatted": {
- "pt": "410,00 €",
- "fr": "410,00 €",
- "it": "410,00 €",
- "es": "410,00 €",
- "de": "410,00 €",
- "en": "€410.00",
- "ca": "410,00 €",
- "nl": "€ 410,00"
}, - "formulas_count": 0,
- "currency_code": "string",
- "available_places": 0,
- "slots_count": 0
}
]
}gift_linked_partners_retrieve
Return the partners linked to this gift code.
Rules (mirrors legacy):
- Voucher → one partner: selling_partner
- Giftcard → one partner: selling_partner
- NetworkGiftcard → network_giftcards_settings.allowed_partners
- NetworkVoucher → DISTINCT partners behind box.get_validated_offers()
Authorizations:
path Parameters
| code required | string |
header Parameters
| X-Partner-Domain | string Examples:
Partner's site domain (optional) |
Responses
giftcard_prototypes_list
Get "Giftcard Prototypes" – i.e Giftcard Settings for partner(s) .
Authorizations:
query Parameters
| page | integer A page number within the paginated result set. |
| page_size | integer Number of results to return per page. |
| partner | integer |
header Parameters
| X-Partner-Domain | string Examples:
Partner's site domain (optional) |
Responses
Response samples
- 200
This is an example of Giftcard Prototype object (giftcard settings).
{- "count": 123,
- "results": [
- {
- "customized_amount": true,
- "description": {
- "fr": "Choisissez un chèque cadeau du montant de votre choix puis laissez le bénéficiaire en profiter en fonction de ses envies !",
- "it": "Scegli una gift card dell'importo che preferisci e lascia che il beneficiario la utilizzi come meglio desidera!",
- "de": "Wählen Sie einen Geschenkgutschein in der von Ihnen gewünschten Höhe und lassen Sie den Beschenkten ihn nach Belieben verwenden!",
- "ca": "Tria una targeta regal de l'import que prefereixis i deixa que el beneficiari la faci servir com vulgui!",
- "es": "Elija una cantidad personalizada para regalar. El beneficiario podrá gastar su tarjeta regalo como quiera en nuestro establecimiento.",
- "en": "Choose a gift card with the amount of your choice and let the beneficiary take advantage of it as she/he wants.",
- "pt": "Escolha um cartão-presente no valor que preferir e deixe que o destinatário o utilize como quiser!",
- "nl": "Kies een cadeaubon in het bedrag dat jij wilt en laat de ontvanger deze gebruiken zoals hij of zij wil!"
}, - "id": 1,
- "minimum_amount": "50.00",
- "money_pot": {
- "activated": true,
- "logo": "/static/dist/images/default/present.png"
}, - "partner_id": 1,
- "partner_name": "Nom commercial",
- "predefined_amounts": [
- "10.00",
- "25.00",
- "50.00"
], - "terms_of_use": {
- "fr": "Terms of Use FR",
- "it": "Terms of Use IT",
- "de": null,
- "ca": null,
- "es": "Terms of Use ES",
- "en": "Terms of Use EN",
- "pt": null,
- "nl": null
}, - "title": {
- "fr": "Découvrez nos chèques cadeaux et cagnottes",
- "it": "Scopri di più sulle nostre gift card e casse comuni",
- "de": "Entdecken Sie unsere Geschenkgutscheine und Geldtöpfe",
- "ca": "Descobreix les nostres Targetes Regal i Pots de diners",
- "es": "¿No encuentra el regalo ideal entre todo lo que ofrecemos?",
- "en": "Discover our Giftcards and Money pots",
- "pt": "Descubra os nossos Giftcards e Money pots",
- "nl": "Ontdek onze cadeaubonnen en geldpotten"
}, - "validity_period": 365,
- "validity_unit": "days",
- "minimum_amount_formatted": {
- "fr": "50,00 €",
- "it": "50,00 €",
- "de": "50,00 €",
- "ca": "50,00 €",
- "es": "50,00 €",
- "en": "€50.00",
- "pt": "50,00 €",
- "nl": "€ 50,00"
}, - "predefined_amounts_formatted": [
- {
- "fr": "10,00 €",
- "it": "10,00 €",
- "de": "10,00 €",
- "ca": "10,00 €",
- "es": "10,00 €",
- "en": "€10.00",
- "pt": "10,00 €",
- "nl": "€ 10,00"
}, - {
- "fr": "25,00 €",
- "it": "25,00 €",
- "de": "25,00 €",
- "ca": "25,00 €",
- "es": "25,00 €",
- "en": "€25.00",
- "pt": "25,00 €",
- "nl": "€ 25,00"
}, - {
- "fr": "50,00 €",
- "it": "50,00 €",
- "de": "50,00 €",
- "ca": "50,00 €",
- "es": "50,00 €",
- "en": "€50.00",
- "pt": "50,00 €",
- "nl": "€ 50,00"
}
]
}
]
}giftcard_prototypes_retrieve
Get "Giftcard Prototypes" – i.e Giftcard Settings for partner(s) .
Authorizations:
path Parameters
| id required | integer A unique integer value identifying this Giftcard settings. |
header Parameters
| X-Partner-Domain | string Examples:
Partner's site domain (optional) |
Responses
Response samples
- 200
This is an example of Giftcard Prototype object (giftcard settings).
{- "customized_amount": true,
- "description": {
- "fr": "Choisissez un chèque cadeau du montant de votre choix puis laissez le bénéficiaire en profiter en fonction de ses envies !",
- "it": "Scegli una gift card dell'importo che preferisci e lascia che il beneficiario la utilizzi come meglio desidera!",
- "de": "Wählen Sie einen Geschenkgutschein in der von Ihnen gewünschten Höhe und lassen Sie den Beschenkten ihn nach Belieben verwenden!",
- "ca": "Tria una targeta regal de l'import que prefereixis i deixa que el beneficiari la faci servir com vulgui!",
- "es": "Elija una cantidad personalizada para regalar. El beneficiario podrá gastar su tarjeta regalo como quiera en nuestro establecimiento.",
- "en": "Choose a gift card with the amount of your choice and let the beneficiary take advantage of it as she/he wants.",
- "pt": "Escolha um cartão-presente no valor que preferir e deixe que o destinatário o utilize como quiser!",
- "nl": "Kies een cadeaubon in het bedrag dat jij wilt en laat de ontvanger deze gebruiken zoals hij of zij wil!"
}, - "id": 1,
- "minimum_amount": "50.00",
- "money_pot": {
- "activated": true,
- "logo": "/static/dist/images/default/present.png"
}, - "partner_id": 1,
- "partner_name": "Nom commercial",
- "predefined_amounts": [
- "10.00",
- "25.00",
- "50.00"
], - "terms_of_use": {
- "fr": "Terms of Use FR",
- "it": "Terms of Use IT",
- "de": null,
- "ca": null,
- "es": "Terms of Use ES",
- "en": "Terms of Use EN",
- "pt": null,
- "nl": null
}, - "title": {
- "fr": "Découvrez nos chèques cadeaux et cagnottes",
- "it": "Scopri di più sulle nostre gift card e casse comuni",
- "de": "Entdecken Sie unsere Geschenkgutscheine und Geldtöpfe",
- "ca": "Descobreix les nostres Targetes Regal i Pots de diners",
- "es": "¿No encuentra el regalo ideal entre todo lo que ofrecemos?",
- "en": "Discover our Giftcards and Money pots",
- "pt": "Descubra os nossos Giftcards e Money pots",
- "nl": "Ontdek onze cadeaubonnen en geldpotten"
}, - "validity_period": 365,
- "validity_unit": "days",
- "minimum_amount_formatted": {
- "fr": "50,00 €",
- "it": "50,00 €",
- "de": "50,00 €",
- "ca": "50,00 €",
- "es": "50,00 €",
- "en": "€50.00",
- "pt": "50,00 €",
- "nl": "€ 50,00"
}, - "predefined_amounts_formatted": [
- {
- "fr": "10,00 €",
- "it": "10,00 €",
- "de": "10,00 €",
- "ca": "10,00 €",
- "es": "10,00 €",
- "en": "€10.00",
- "pt": "10,00 €",
- "nl": "€ 10,00"
}, - {
- "fr": "25,00 €",
- "it": "25,00 €",
- "de": "25,00 €",
- "ca": "25,00 €",
- "es": "25,00 €",
- "en": "€25.00",
- "pt": "25,00 €",
- "nl": "€ 25,00"
}, - {
- "fr": "50,00 €",
- "it": "50,00 €",
- "de": "50,00 €",
- "ca": "50,00 €",
- "es": "50,00 €",
- "en": "€50.00",
- "pt": "50,00 €",
- "nl": "€ 50,00"
}
]
}Get partner legal information
Authorizations:
header Parameters
| X-Partner-Domain | string Examples:
Partner's site domain (optional) |
Responses
Response samples
- 200
Legal information of the current partner
[- {
- "agency_name": "Agency Name",
- "name": "Partner's Name",
- "address_line_1": "Address line 1",
- "address_line_2": "Address line 2",
- "address_line_3": "Address line 3",
- "postal_code": "75000",
- "city": "City",
- "country": "Country",
- "company_type": "bus",
- "creation_date": "2026-03-12T13:12:10.344823+01:00",
- "hq_phone_number": "+33 123 456 789",
- "agency_phone": "+33 123 456 780",
- "agency_website": "www.website.com",
- "legal_notice_email": "agency @ email.com",
- "legal_form": "SARL (France)",
- "capital_stock": "10000.00",
- "currency_symbol": "€",
- "legal_first_name": "John",
- "legal_last_name": "Doe",
- "siret_number": "SIRET1234",
- "vat_id": "VAT1234",
- "rcs": "RCS1234"
}
]Get refund and withdrawal terms in all languages
Authorizations:
header Parameters
| X-Partner-Domain | string Examples:
Partner's site domain (optional) |
Responses
Response samples
- 200
Translated Refund & Withdrawal terms for the current partner, to be displayed in its purchase website.
[- {
- "refund_withdrawal_terms": {
- "fr": "Conformément à l’article L 221-18 à 28 du Code de la Consommation, l’acheteur d’un cadeau est informé qu’il bénéficie d’un délai de rétractation de 14 jours francs pour exercer son droit de rétractation. Aucun motif ne devra être apporté et aucune pénalité ne sera appliquée, à l'exception d’éventuels frais de retour qui restent à la charge de l’acheteur. Si l’acheteur a choisi une carte cadeau physique, le remboursement ne pourra être effectué que si la carte cadeau est renvoyée dans un parfait état.\n\nPour pouvoir être traité, le retour devra faire l’objet d’une demande préalable de la part du bénéficiaire.\n\nLe remboursement sera effectué dans un délai de 14 jours à compter de la réception de la carte cadeau en parfait état.\n\nLes bons cadeaux et chèques cadeaux sont non-remboursables. Ils ne peuvent pas être échangés contre de l’argent liquide.",
- "it": "Il diritto di recesso è disciplinato dal Codice del Consumo, all’articolo 52 e segg. del D. Lsg. 206 del 2005. L'acquirente di un regalo è informato che dispone di un periodo di riflessione di 14 giorni liberi per esercitare il suo diritto di recesso. Non è necessario fornire alcuna motivazione e non verrà applicata alcuna penale, ad eccezione delle spese di restituzione, che restano a carico dell'acquirente. Se l'acquirente ha scelto una carta regalo fisica, il rimborso sarà effettuato solo se la carta regalo viene restituita in perfette condizioni.\n\nPer poter gestire la richiesta di recesso, questa deve essere oggetto di una richiesta preventiva ed esplicita da parte del beneficiario.\n\nIl rimborso verrà effettuato entro 14 giorni dalla ricezione del buono regalo in perfette condizioni.\n\nI buoni regalo e le gift card non sono rimborsabili e non possono essere scambiati contro denaro liquido.",
- "de": "-",
- "ca": "-",
- "es": "De acuerdo con el artículo L 221-18 a 28 del Código de Consumo francés, se informa al comprador de un regalo de que dispone de un plazo de reflexión de 14 días para ejercer su derecho de desistimiento. No se debe dar ninguna razón y no se aplicará ninguna penalización, a excepción de los gastos de devolución que siguen siendo responsabilidad del comprador. Si el comprador ha elegido una tarjeta regalo o un bono regalo físico, el reembolso sólo se realizará si el bono regalo se devuelve en perfecto estado.\n\nPara que se pueda tramitar, la devolución debe ser solicitada previamente por el destinatario.\n\nEl reembolso se realizará en un plazo de 14 días a partir de la recepción del bono regalo o tarjeta regalo en perfecto estado.\n\nLos bonos regalo y las tarjetas regalo no son reembolsables. No se pueden cambiar por dinero en efectivo.",
- "en": "In conformity with article L 221-18 of the French Consumer Code, the purchaser of a gift is informed that he/she benefits from a 14-day retraction period to exercise his/her right of retraction. No reason must be given and no penalty will be applied, with the exception of any return costs which remain the responsibility of the buyer. If the buyer has chosen a physical gift card, the refund will only be made if the gift card is returned in perfect condition.\n\nIn order to be processed, the return must be requested in advance by the beneficiary.\n\nThe refund will be made within 14 days of receipt of the gift card in perfect condition.\n\nGift vouchers are non-refundable. They cannot be exchanged for cash.",
- "pt": "-",
- "nl": "-"
}
}
]network_vouchers_universes_list
Get all the universes from all the network voucher boxes for a marketplace.
Authorizations:
header Parameters
| X-Partner-Domain | string Examples:
Partner's site domain (optional) |
Responses
Response samples
- 200
This is an example of Universe which has a sub-universe and a sub-sub-universe
[- {
- "id": 1,
- "name": {
- "fr": "Séjour",
- "it": null,
- "de": null,
- "ca": null,
- "es": null,
- "en": "Stay",
- "pt": null,
- "nl": null
}, - "order": 1,
- "sub_universes": [
- {
- "id": 2,
- "name": {
- "fr": "Insolite",
- "it": null,
- "de": null,
- "ca": null,
- "es": null,
- "en": "Glamping",
- "pt": null,
- "nl": null
}, - "order": null,
- "sub_universes": [
- {
- "id": 3,
- "name": {
- "fr": "Bateau",
- "it": null,
- "de": null,
- "ca": null,
- "es": null,
- "en": "Boat",
- "pt": null,
- "nl": null
}, - "order": null,
- "sub_universes": [ ]
}
]
}
]
}
]partners_list
Authorizations:
query Parameters
| department | string |
| id | Array of integers Multiple values may be separated by commas. |
| page | integer A page number within the paginated result set. |
| page_size | integer Number of results to return per page. |
| region | string |
header Parameters
| X-Partner-Domain | string Examples:
Partner's site domain (optional) |
Responses
Response samples
- 200
This is an example of a partner's detailed information.
{- "count": 123,
- "results": [
- {
- "id": 999,
- "name": "Agency Name",
- "description": {
- "fr": "Établissement design au cœur de Bastia",
- "it": "Hotel di design nel cuore di Bastia",
- "de": null,
- "ca": null,
- "es": "Hotel de diseño en el corazón de Bastia",
- "en": "Design hotel in the heart of Bastia",
- "pt": null,
- "nl": null
}, - "logo": null,
- "region": "Corse",
- "department": "Haute-Corse",
- "latitude": 42.5,
- "longitude": 8.8,
- "commercial_description": {
- "fr": "Laissez-vous tenter par un séjour en bord de mer, perché sur un site exceptionnel au coeur de la baie de Douarnenez à l'hôtel Ty Mad.",
- "it": null,
- "de": null,
- "ca": null,
- "es": "",
- "en": "",
- "pt": null,
- "nl": null
}
}
]
}partners_retrieve
Authorizations:
path Parameters
| id required | integer A unique integer value identifying this partner. |
header Parameters
| X-Partner-Domain | string Examples:
Partner's site domain (optional) |
Responses
Response samples
- 200
This is an example of a partner's detailed information.
label_and_networkis a list of objects with the following keys:namethe name of the label (e.g."1 Michelin 2025")logothe absolute url of the logo a the label (e.g."https://www.label/example.png")
{- "id": 999,
- "name": "Agency Name",
- "description": {
- "fr": "Établissement design au cœur de Bastia",
- "it": "Hotel di design nel cuore di Bastia",
- "de": null,
- "ca": null,
- "es": "Hotel de diseño en el corazón de Bastia",
- "en": "Design hotel in the heart of Bastia",
- "pt": null,
- "nl": null
}, - "logo": null,
- "region": "Corse",
- "department": "Haute-Corse",
- "latitude": 42.5,
- "longitude": 8.8,
- "commercial_description": {
- "fr": "Laissez-vous tenter par un séjour en bord de mer, perché sur un site exceptionnel au coeur de la baie de Douarnenez à l'hôtel Ty Mad.",
- "it": null,
- "de": null,
- "ca": null,
- "es": "",
- "en": "",
- "pt": null,
- "nl": null
}, - "managers": {
- "fr": "Présentation des responsables(...)",
- "it": "Presentazione dei manager(...)",
- "de": null,
- "ca": null,
- "es": "Presentación de los directores(...)",
- "en": "Presentation of the managers(...)",
- "pt": null,
- "nl": null
}, - "nearby": {
- "fr": "Citadelle de Bastia",
- "it": "Cittadella di Bastia",
- "de": null,
- "ca": null,
- "es": "Ciudadela de Bastia",
- "en": "Bastia Citadel",
- "pt": null,
- "nl": null
}, - "practical_information": {
- "fr": "Ouvert tous les jours de 20h00 à 02h00(...)",
- "it": "Aperto tutti i giorni dalle 20.00 alle 2.00(...)",
- "de": null,
- "ca": null,
- "es": "Abierto todos los días de 20:00 a 2:00(...)",
- "en": "Open daily from 8:00 pm to 2:00 am(...)",
- "pt": null,
- "nl": null
}, - "access": {
- "fr": "Accès à l'établissement(...)",
- "it": "Informazioni di accesso(...)",
- "de": null,
- "ca": null,
- "es": "Información de acceso(...)",
- "en": "Access information(...)",
- "pt": null,
- "nl": null
}, - "facilities": {
- "disabled_access": true,
- "air_conditioning": false,
- "private_parking": true,
- "wifi": true,
- "smoking_area": false,
- "pets_allowed": true,
- "family_friendly": true
}, - "social_links": {
}, - "label_and_network": [
- {
- "name": "Charme&Caractère",
}, - {
- "name": "Hôtel 3 étoiles",
- "logo": null
}
]
}partners_me_retrieve
Get basic information about the current partner.
Authorizations:
header Parameters
| X-Partner-Domain | string Examples:
Partner's site domain (optional) |
Responses
Response samples
- 200
This is an example of a partner's detailed information.
label_and_networkis a list of objects with the following keys:namethe name of the label (e.g."1 Michelin 2025")logothe absolute url of the logo a the label (e.g."https://www.label/example.png")
{- "id": 999,
- "name": "Agency Name",
- "description": {
- "fr": "Établissement design au cœur de Bastia",
- "it": "Hotel di design nel cuore di Bastia",
- "de": null,
- "ca": null,
- "es": "Hotel de diseño en el corazón de Bastia",
- "en": "Design hotel in the heart of Bastia",
- "pt": null,
- "nl": null
}, - "logo": null,
- "region": "Corse",
- "department": "Haute-Corse",
- "latitude": 42.5,
- "longitude": 8.8,
- "commercial_description": {
- "fr": "Laissez-vous tenter par un séjour en bord de mer, perché sur un site exceptionnel au coeur de la baie de Douarnenez à l'hôtel Ty Mad.",
- "it": null,
- "de": null,
- "ca": null,
- "es": "",
- "en": "",
- "pt": null,
- "nl": null
}, - "managers": {
- "fr": "Présentation des responsables(...)",
- "it": "Presentazione dei manager(...)",
- "de": null,
- "ca": null,
- "es": "Presentación de los directores(...)",
- "en": "Presentation of the managers(...)",
- "pt": null,
- "nl": null
}, - "nearby": {
- "fr": "Citadelle de Bastia",
- "it": "Cittadella di Bastia",
- "de": null,
- "ca": null,
- "es": "Ciudadela de Bastia",
- "en": "Bastia Citadel",
- "pt": null,
- "nl": null
}, - "practical_information": {
- "fr": "Ouvert tous les jours de 20h00 à 02h00(...)",
- "it": "Aperto tutti i giorni dalle 20.00 alle 2.00(...)",
- "de": null,
- "ca": null,
- "es": "Abierto todos los días de 20:00 a 2:00(...)",
- "en": "Open daily from 8:00 pm to 2:00 am(...)",
- "pt": null,
- "nl": null
}, - "access": {
- "fr": "Accès à l'établissement(...)",
- "it": "Informazioni di accesso(...)",
- "de": null,
- "ca": null,
- "es": "Información de acceso(...)",
- "en": "Access information(...)",
- "pt": null,
- "nl": null
}, - "facilities": {
- "disabled_access": true,
- "air_conditioning": false,
- "private_parking": true,
- "wifi": true,
- "smoking_area": false,
- "pets_allowed": true,
- "family_friendly": true
}, - "social_links": {
}, - "label_and_network": [
- {
- "name": "Charme&Caractère",
}, - {
- "name": "Hôtel 3 étoiles",
- "logo": null
}
]
}product_information_events_list
Override list to a singleton result
Authorizations:
header Parameters
| X-Partner-Domain | string Examples:
Partner's site domain (optional) |
Responses
Response samples
- 200
This is an example of a Partner's Events product information
{- "title": {
- "fr": "Événements",
- "it": "Eventi",
- "de": "Veranstaltungen",
- "ca": "Esdeveniments",
- "es": "Eventos",
- "en": "Events",
- "pt": "Eventos",
- "nl": "Evenementen"
}, - "description": {
- "fr": "Description de la page 'Évènements'",
- "it": null,
- "de": null,
- "ca": null,
- "es": null,
- "en": "Description of 'Tickets' page",
- "pt": null,
- "nl": null
}, - "tos_url": {
- "it": "",
- "de": "",
- "ca": "",
- "es": "",
- "pt": "",
- "nl": ""
}, - "display_fully_booked_events": false,
- "display_events_per_slots": true
}product_information_giftcards_list
Get Giftcards product configuration.
Authorizations:
header Parameters
| X-Partner-Domain | string Examples:
Partner's site domain (optional) |
Responses
Response samples
- 200
[- {
- "title": {
- "fr": "string",
- "en": "string",
- "es": "string",
- "it": "string",
- "de": "string",
- "nl": "string",
- "ca": "string",
- "pt": "string"
}, - "description": {
- "fr": "string",
- "en": "string",
- "es": "string",
- "it": "string",
- "de": "string",
- "nl": "string",
- "ca": "string",
- "pt": "string"
}, - "partners": [
- {
- "id": 0,
- "agency_name": "string"
}
]
}
]product_information_network_giftcards_list
Get Network Giftcards product configuration.
Authorizations:
header Parameters
| X-Partner-Domain | string Examples:
Partner's site domain (optional) |
Responses
Response samples
- 200
This example of Marketplace's Network Giftcards configuration
- Money Pot is activated
- Giftcard has custom logo file
- MoneyPot uses default logo image
{- "title": {
- "fr": "Découvrez nos chèques cadeaux",
- "it": "Scopri le nostre gift card",
- "de": "Entdecken Sie unsere Geschenkkarten",
- "ca": "Descobreix les nostres targetes de regal",
- "es": "Descubre nuestras tarjetas regalo",
- "en": "Discover our giftcards",
- "pt": "Descubra os nossos cartões de oferta",
- "nl": "Ontdek onze cadeaubonnen"
}, - "description": {
- "fr": "Nos chèques cadeaux sont disponibles dans tous nos établissements",
- "it": "Le nostre gift card sono disponibili in tutte le nostre strutture",
- "de": "Unsere Geschenkkarten sind in allen unseren Einrichtungen erhältlich",
- "ca": "Les nostres targetes de regal estan disponibles a totes les nostres estructures",
- "es": "Nuestras tarjetas regalo están disponibles en todos nuestros establecimientos",
- "en": "Our giftcards are available in all our establishments",
- "pt": "Os nossos cartões de oferta estão disponíveis em todas as nossas instalações",
- "nl": "Onze cadeaubonnen zijn verkrijgbaar in al onze vestigingen"
}, - "giftcard": {
- "customized_amount": true,
- "description": {
- "fr": "Nos chèques cadeaux réseaux permettent à leur bénéficiaire de choisir la prestation de leur rêve dans l'un de nos nombreux établissements. ",
- "it": "Le nostre gift card del gruppo permettono al destinatario di scegliere il servizio dei suoi sogni in una delle numerose strutture del gruppo.",
- "de": "Mit unseren Gruppen-Geschenkgutscheinen kann der Beschenkte den Service seiner Träume in einer der vielen Einrichtungen der Gruppe wählen.",
- "ca": "Les nostres targetes de regal de grup permeten al destinatari triar el servei dels seus somnis en una de les nombroses estructures del grup.",
- "es": "Nuestros tarjeta regalo de la red permiten al destinatario elegir el servicio de sus sueños en uno de nuestros numerosos establecimientos.",
- "en": "Our network gift cards allow the recipient to choose the service of their dreams in one of our many establishments.",
- "pt": "Os nossos cartões-presente de grupo permitem que o destinatário escolha o serviço dos seus sonhos numa das muitas instalações do grupo.",
- "nl": "Met onze groepscadeaubonnen kan de ontvanger de service van zijn of haar dromen kiezen in een van de vele faciliteiten van de groep."
}, - "minimum_amount": "10.00",
- "predefined_amounts": [
- "5.00",
- "15.00",
- "25.00"
], - "terms_of_use": {
- "fr": "Afin d'utiliser cette carte cadeau, merci de contacter l'établissement qui vous intéresse et de réserver.",
- "it": "Per utilizzare questa gift card, ti invitiamo a contattare il locale di interesse e a effettuare una prenotazione.",
- "de": "Um diesen Geschenkgutschein einzulösen, setzen Sie sich bitte mit dem gewünschten Veranstaltungsort in Verbindung und nehmen Sie eine Reservierung vor.",
- "ca": "Per utilitzar aquesta targeta de regal, us convidem a contactar amb el lloc per interès i fer una reserva.",
- "es": "Para utilizar este tarjeta regalo, póngase en contacto con el establecimiento que le interesa y haga una reserva.",
- "en": "In order to use this gift card, please contact the establishment you are interested in and make a reservation.",
- "pt": "Para utilizar este cartão-presente, contacte o local de interesse e faça uma reserva.",
- "nl": "Om deze cadeaubon te gebruiken, neem je contact op met de locatie die je interesseert en maak je een reservering."
}, - "title": {
- "fr": "Offrez un chèque cadeau",
- "it": "Offri una gift card",
- "de": "Bieten Sie eine Geschenkkarte an",
- "ca": "Oferiu una targeta de regal",
- "es": "Ofrezca una tarjeta regalo",
- "en": "Offer a gift card",
- "pt": "Oferecer um cartão de oferta",
- "nl": "Een cadeaubon aanbieden"
}, - "validity_period": 365,
- "validity_unit": "days",
- "minimum_amount_formatted": {
- "fr": "10,00 €",
- "it": "10,00 €",
- "de": "10,00 €",
- "ca": "10,00 €",
- "es": "10,00 €",
- "en": "€10.00",
- "pt": "10,00 €",
- "nl": "€ 10,00"
}, - "predefined_amounts_formatted": [
- {
- "fr": "5,00 €",
- "it": "5,00 €",
- "de": "5,00 €",
- "ca": "5,00 €",
- "es": "5,00 €",
- "en": "€5.00",
- "pt": "5,00 €",
- "nl": "€ 5,00"
}, - {
- "fr": "15,00 €",
- "it": "15,00 €",
- "de": "15,00 €",
- "ca": "15,00 €",
- "es": "15,00 €",
- "en": "€15.00",
- "pt": "15,00 €",
- "nl": "€ 15,00"
}, - {
- "fr": "25,00 €",
- "it": "25,00 €",
- "de": "25,00 €",
- "ca": "25,00 €",
- "es": "25,00 €",
- "en": "€25.00",
- "pt": "25,00 €",
- "nl": "€ 25,00"
}
]
}, - "money_pot": {
- "activated": true,
- "description": {
- "fr": "Invitez vos amis à participer à un pot commun ! Le montant total saisi sera ensuite transformé en bon cadeau, utilisable librement au sein de notre établissement !",
- "it": "Invita i tuoi amici a partecipare a una cassa comune! L'importo totale inserito sarà poi convertito in una gift card. Questa potrà essere utilizzata liberamente presso la nostra struttura!",
- "de": "Laden Sie Ihre Freunde ein, an einer gemeinsamen Kasse teilzunehmen! Der eingegebene Gesamtbetrag wird dann in eine Geschenkkarte umgewandelt. Dieser kann in unserer Einrichtung frei verwendet werden!",
- "ca": "Convida els teus amics a participar en un cas comú.La quantitat total inserida es convertirà en una targeta de regal.Això es pot utilitzar lliurement a la nostra estructura.",
- "es": "¡Invita a tus amigos a participar en una olla común! ¡El importe total ingresado se convertirá en un cheque regalo, que se puede utilizar libremente dentro de nuestro establecimiento!",
- "en": "Invite your friends to participate in a common pot! The total amount entered will then be turned into a gift voucher, which can be used freely within our establishment!",
- "pt": "Convide os seus amigos para participarem num checkout conjunto! O montante total introduzido será então convertido num cartão-presente. Este pode ser utilizado livremente nas nossas instalações!",
- "nl": "Nodig je vrienden uit om samen af te rekenen! Het totaal ingevoerde bedrag wordt dan omgezet in een cadeaubon. Deze kan vrij gebruikt worden in onze vestiging!"
}, - "logo": "/static/dist/images/default/giftcard-default-logo.jpg",
- "title": {
- "fr": "Créez une cagnotte",
- "it": "Crea una cassa comune",
- "de": "Schaffung eines gemeinsamen Fonds",
- "ca": "Creeu un cas comú",
- "es": "Crear un bote",
- "en": "Create a money pot",
- "pt": "Criar um fundo comum",
- "nl": "Creëer een gemeenschappelijk fonds"
}
}
}product_information_network_vouchers_list
The Network vouchers product information view.
Authorizations:
header Parameters
| X-Partner-Domain | string Examples:
Partner's site domain (optional) |
Responses
Response samples
- 200
This is an example of a Marketplace's Network Vouchers product information
{- "title": {
- "fr": "Découvrez nos coffrets cadeaux",
- "it": "Scopri i nostri pacchetti regalo",
- "de": "Entdecken Sie unsere Geschenkpakete",
- "ca": "Descobreix els nostres paquets de regals",
- "es": "Descubre nuestras cajas regalo",
- "en": "Discover our gift boxes",
- "pt": "Descubra os nossos pacotes de oferta",
- "nl": "Ontdek onze geschenkpakketten"
}, - "description": {
- "fr": "Nos coffrets cadeaux vous permettent de choisir parmi différentes expériences dans nos établissements",
- "it": "I nostri pacchetti regalo ti permettono di scegliere tra diverse esperienze presso le nostre strutture",
- "de": "Mit unseren Geschenkpaketen können Sie zwischen verschiedenen Erlebnissen in unseren Einrichtungen wählen",
- "ca": "Els nostres paquets de regals us permeten triar entre diferents experiències a les nostres estructures",
- "es": "Nuestras cajas regalo te permiten elegir entre diferentes experiencias en nuestros establecimientos",
- "en": "Our gift boxes allow you to choose from different experiences in our establishments",
- "pt": "Os nossos pacotes de oferta permitem-lhe escolher entre diferentes experiências nas nossas instalações",
- "nl": "Met onze cadeaupakketten kun je kiezen uit verschillende ervaringen in onze faciliteiten"
}, - "terms_of_use": {
- "fr": "Afin d'utiliser ce coffret cadeaux, merci de contacter l'établissement qui vous intéresse et de réserver.",
- "it": "Per utilizzare questo pacchetto regalo, si prega di contattare la struttura di interesse e di effettuare una prenotazione.",
- "de": "Um dieses Geschenkpaket in Anspruch zu nehmen, wenden Sie sich bitte an die Einrichtung, die Sie interessiert, und reservieren Sie einen Termin.",
- "ca": "Per utilitzar aquest paquet de regals, poseu -vos en contacte amb l'estructura d'interès i feu una reserva.",
- "es": "Para utilizar este caja regalo, póngase en contacto con el establecimiento que le interesa y haga una reserva.",
- "en": "In order to use this gift box, please contact the establishment you are interested in and make a reservation.",
- "pt": "Para utilizar este pacote de oferta, é necessário contactar o estabelecimento de interesse e efetuar uma reserva.",
- "nl": "Om gebruik te maken van dit cadeaupakket moet je contact opnemen met het etablissement waarin je geïnteresseerd bent en een reservering maken."
}, - "display_by_universe": true,
- "validity_period": 365,
- "validity_period_unit": 1,
- "activated_product_feature": false,
- "activated_group_payment": true,
- "display_offers_map": false,
- "activated_offer_country_filter": false,
- "activated_offer_department_filter": false,
- "activated_offer_region_filter": false,
}product_information_vouchers_list
Get Vouchers product configuration.
Authorizations:
header Parameters
| X-Partner-Domain | string Examples:
Partner's site domain (optional) |
Responses
Response samples
- 200
This example of Partner's Voucher product configuration
- All delivery modes are activated, except for 'On site pickup'.
- 'destination' and 'universe' filters are deactivated.
- There's no hero image for vouchers.
{- "title": {
- "fr": "Bons cadeaux",
- "it": "Buono regalo",
- "de": "Geschenkgutschein",
- "ca": "Val de regal",
- "es": "Bonos regalo",
- "en": "Vouchers",
- "pt": "Vale de oferta",
- "nl": "Cadeaubon"
}, - "subtitle": {
- "fr": "test",
- "it": null,
- "de": null,
- "ca": null,
- "es": null,
- "en": null,
- "pt": null,
- "nl": null
}, - "short_description": {
- "fr": "Brève description",
- "it": "I nostri buoni regalo - 01mptest",
- "de": "Unsere Gutscheine - 01mptest",
- "ca": "Els nostres vals regal - 01mptest",
- "es": "Descripción corta",
- "en": "Short description",
- "pt": "Our vouchers - 01mptest",
- "nl": "Onze vouchers - 01mptest"
}, - "hero_image": null,
- "activated_destination_filter": false,
- "activated_universe_filter": false,
- "activated_price_filter": true,
- "activated_target_filter": true,
- "activated_theme_filter": true,
- "activated_environment_filter": true,
- "activated_offer_ordering_by_ranking": true,
- "validity_period": 365,
- "validity_period_unit": 1,
- "method_of_display": 1,
- "default_prototype_image": null,
- "activated_group_payment": false
}product_information_workshops_list
Override the list endpoint to a singleton result
Authorizations:
header Parameters
| X-Partner-Domain | string Examples:
Partner's site domain (optional) |
Responses
Response samples
- 200
This is an example of a Partner's Workshops product information
{- "title": {
- "fr": "Réserver un atelier",
- "it": "I nostri workshop",
- "de": "Unsere Workshops",
- "ca": "Els nostres tallers",
- "es": "Nuestros talleres",
- "en": "Our workshops",
- "pt": "As nossas oficinas",
- "nl": "Onze workshops"
}, - "description": {
- "fr": "Description de la page 'Réservations'",
- "it": null,
- "de": null,
- "ca": null,
- "es": null,
- "en": "Description of 'Bookings' page",
- "pt": null,
- "nl": null
}, - "tos_url": {
- "it": "",
- "de": "",
- "ca": "",
- "es": "",
- "pt": "",
- "nl": ""
}, - "display_workshops_by_month": false,
- "display_workshops_per_session": true,
- "display_fully_booked_sessions": false,
- "activated_month_filter": true,
- "activated_day_filter": true,
- "activated_time_filter": true,
- "activated_price_filter": false,
- "activated_category_filter": false,
- "activated_duration_filter": false,
- "activated_target_filter": false,
- "activated_level_filter": false,
- "activated_theme_filter": false,
- "min_nb_free_places_for_label_shown": 3,
- "display_phone_number": true,
- "phone_number": "",
- "default_workshop_image": "https://mybb-storage-prod.s3.fr-par.scw.cloud/default_workshop_image.png",
- "validity_period": 365,
- "validity_period_unit": 1
}themes_list
Get all themes from all voucher prototypes of a partner.
Authorizations:
header Parameters
| X-Partner-Domain | string Examples:
Partner's site domain (optional) |
Responses
Response samples
- 200
[- {
- "id": 0,
- "name": {
- "fr": "string",
- "en": "string",
- "es": "string",
- "it": "string",
- "de": "string",
- "nl": "string",
- "ca": "string",
- "pt": "string"
}
}
]universes_list
Get all universes from all voucher prototypes of a partner.
Authorizations:
header Parameters
| X-Partner-Domain | string Examples:
Partner's site domain (optional) |
Responses
Response samples
- 200
This is an example of Universe which has a sub-universe and a sub-sub-universe
[- {
- "id": 1,
- "name": {
- "fr": "Séjour",
- "it": null,
- "de": null,
- "ca": null,
- "es": null,
- "en": "Stay",
- "pt": null,
- "nl": null
}, - "order": 1,
- "sub_universes": [
- {
- "id": 2,
- "name": {
- "fr": "Insolite",
- "it": null,
- "de": null,
- "ca": null,
- "es": null,
- "en": "Glamping",
- "pt": null,
- "nl": null
}, - "order": null,
- "sub_universes": [
- {
- "id": 3,
- "name": {
- "fr": "Bateau",
- "it": null,
- "de": null,
- "ca": null,
- "es": null,
- "en": "Boat",
- "pt": null,
- "nl": null
}, - "order": null,
- "sub_universes": [ ]
}
]
}
]
}
]voucher_categories_list
Get all categories from all voucher prototypes of a partner.
Authorizations:
header Parameters
| X-Partner-Domain | string Examples:
Partner's site domain (optional) |
Responses
Response samples
- 200
This is an example of Voucher Prototype's Category object.
[- {
- "id": 1,
- "name": {
- "fr": "Séjour et Gastronomie",
- "it": "Soggiorno e gastronomia",
- "de": "Aufenthalt und Gastronomie",
- "ca": "Allotjament i Gastronomia",
- "es": "Estancia y gastronomía",
- "en": "Accommodation and Gastronomy",
- "pt": "Estadia e Gastronomia",
- "nl": "Verblijf en gastronomie"
}, - "description": {
- "fr": "Les idées cadeaux préférées de nos clients",
- "it": "Le idee regalo preferite dai nostri clienti",
- "de": "Die beliebtesten Geschenkideen unserer Kunden",
- "ca": "Idees de regal preferides dels nostres clients",
- "es": "Las ideas de regalo favoritas de nuestros clientes",
- "en": "Our customers' favourite gift ideas",
- "pt": "As ideias de presentes favoritas dos nossos clientes",
- "nl": "De favoriete cadeau-ideeën van onze klanten"
}, - "photo": null
}
]voucher_prototypes_list
Returns a paginated list of voucher prototypes for the authenticated partner or marketplace.
Filters and ordering parameters are applied to the queryset. If the request comes from a
marketplace client, an additional field partners_count is included in the response. This
field indicates the number of distinct affiliate partners associated with the full filtered
result set, before pagination is applied.
Authorizations:
query Parameters
| active | boolean |
| category | integer |
| destination | string |
| ordering | string Which field to use when ordering the results. |
| page | integer A page number within the paginated result set. |
| page_size | integer Number of results to return per page. |
| partner | integer |
| price_max | string or null <decimal> (Base price) ^-?\d{0,6}(?:\.\d{0,4})?$ Price per night or single usage/entry |
| price_min | string or null <decimal> (Base price) ^-?\d{0,6}(?:\.\d{0,4})?$ Price per night or single usage/entry |
| theme | Array of integers |
| universe | Array of integers |
| with_sub_universes | boolean If true, results will include voucher prototypes from selected universes and all their descendants. |
header Parameters
| X-Partner-Domain | string Examples:
Partner's site domain (optional) |
Responses
Response samples
- 200
This is an example of Voucher Prototype object.
- Texts are in EN, FR and ES languages only.
- Prototype has no themes
- It's a prototype for Partner(id=1)
{- "count": 123,
- "results": [
- {
- "currency_code": "EUR",
- "description": {
- "fr": "Restez pour 2 dans une cabine flottante avec une bouteille de champagne",
- "it": null,
- "de": null,
- "ca": null,
- "es": "Quédate por 2 en una cabaña flotante con una botella de champán",
- "en": "Stay for 2 in a floating cabin with a bottle of champagne",
- "pt": "Fique por 2 em uma cabine flutuante com uma garrafa de champanhe",
- "nl": null
}, - "display_max_capacity": true,
- "display_x_person": true,
- "price_formatted": {
- "fr": "420,00 €",
- "it": "420,00 €",
- "de": "420,00 €",
- "ca": "420,00 €",
- "es": "420,00 €",
- "en": "€420.00",
- "pt": "420,00 €",
- "nl": "€ 420,00"
}, - "price_scope": 6,
- "id": 1000,
- "is_active": false,
- "is_highlight": false,
- "max_capacity": 10,
- "min_capacity": 1,
- "name": {
- "fr": "Nuitée en cabane flottante et champagne",
- "it": null,
- "de": null,
- "ca": null,
- "es": "Pasar la noche en una cabaña flotante",
- "en": "Overnight stay in a floating cabin",
- "pt": "Pernoite a noite em uma cabine flutuante",
- "nl": null
}, - "partner_city": "Bordeaux",
- "partner_department": "Gironde",
- "partner_id": 1,
- "partner_name": "Nom commercial",
- "partner_region": "Nouvelle-Aquitaine",
- "price": "420.00",
- "ranking": 1,
- "themes": [
- 8,
- 7
], - "universe": 42
}
], - "partners_count": 12
}voucher_prototypes_retrieve
Authorizations:
path Parameters
| id required | integer A unique integer value identifying this voucher's prototype. |
header Parameters
| X-Partner-Domain | string Examples:
Partner's site domain (optional) |
Responses
Response samples
- 200
This is an example of Voucher Prototype object.
- Texts are in EN, FR and ES languages only.
- It's a prototype for Partner(id=1)
{- "booking_condition": {
- "fr": "Réservation obligatoire. Merci de vous munir de votre bon cadeau lors de votre venue.\nLe bon cadeau est utilisable 48h après achat.",
- "it": "Prenotazione obbligatoria. Si prega di portare con sé il buono regalo al momento della prenotazione.\nIl buono regalo può essere utilizzato 48 ore dopo l'acquisto.",
- "de": "Reservierung erforderlich. Bitte bringen Sie Ihren Geschenkgutschein zur Reservierung mit.\nDer Geschenkgutschein kann 48 Stunden nach dem Kauf eingelöst werden.",
- "ca": "Cal reserva. Si us plau, porteu el vostre xec regal quan feu la reserva.\nEl xec regal es pot utilitzar 48 hores després de la compra.",
- "es": "Reserva obligatoria. Por favor traiga su bono regalo cuando venga.\nEl bono regalo se puede utilizar 48 horas después de la compra.",
- "en": "Booking required. Please bring your voucher PDF with you when you come.\nThe voucher can be used 48 hours after purchase.",
- "pt": "É necessário efetuar uma reserva. Por favor, traga o seu vale de oferta aquando da reserva.\nO vale de oferta pode ser trocado 48 horas após a compra.",
- "nl": "Reserveren verplicht. Neem je cadeaubon mee als je reserveert.\nDe cadeaubon kan 48 uur na aankoop worden ingewisseld."
}, - "category": null,
- "currency_code": "EUR",
- "delivery_options": {
- "activated_email_to_buyer": true,
- "activated_email_to_beneficiary_delivery": true,
- "activated_postal_mail_to_buyer": false,
- "activated_postal_mail_to_beneficiary_delivery": false,
- "postal_mail_shipping_cost": "0.00",
- "postal_mail_duration": 5,
- "activated_pickup_on_site_delivery": false,
- "pickup_on_site_duration": 24,
- "pickup_on_site_cost": null,
- "activated_3MA_to_buyer": false,
- "activated_3MA_to_beneficiary": false,
- "threema_delivery_cost": "7.50"
}, - "description": {
- "fr": "Restez pour 2 dans une cabine flottante avec une bouteille de champagne",
- "it": null,
- "de": null,
- "ca": null,
- "es": "Quédate por 2 en una cabaña flotante con una botella de champán",
- "en": "Stay for 2 in a floating cabin with a bottle of champagne",
- "pt": "Fique por 2 em uma cabine flutuante com uma garrafa de champanhe",
- "nl": null
}, - "display_max_capacity": true,
- "display_validity_period": true,
- "display_x_person": true,
- "price_formatted": {
- "fr": "420,00 €",
- "it": "420,00 €",
- "de": "420,00 €",
- "ca": "420,00 €",
- "es": "420,00 €",
- "en": "€420.00",
- "pt": "420,00 €",
- "nl": "€ 420,00"
}, - "id": 1000,
- "images": [
], - "is_active": false,
- "is_highlight": false,
- "last_active_day": null,
- "long_description": {
- "fr": null,
- "it": null,
- "de": null,
- "ca": null,
- "es": null,
- "en": null,
- "pt": null,
- "nl": null
}, - "long_description_admin": {
- "fr": null,
- "it": null,
- "de": null,
- "ca": null,
- "es": null,
- "en": null,
- "pt": null,
- "nl": null
}, - "max_capacity": 10,
- "min_capacity": 1,
- "name": {
- "fr": "Nuitée en cabane flottante et champagne",
- "it": null,
- "de": null,
- "ca": null,
- "es": "Pasar la noche en una cabaña flotante",
- "en": "Overnight stay in a floating cabin",
- "pt": "Pernoite a noite em uma cabine flutuante",
- "nl": null
}, - "partner_city": "Bordeaux",
- "partner_department": "Gironde",
- "partner_id": 1,
- "partner_name": "Nom commercial",
- "partner_region": "Nouvelle-Aquitaine",
- "price": "420.00",
- "price_scope": 6,
- "ranking": 1,
- "rent_conditions": {
- "fr": null,
- "it": null,
- "de": null,
- "ca": null,
- "es": null,
- "en": null,
- "pt": null,
- "nl": null
}, - "specific_validity_period": null,
- "fixed_expiration_date": null,
- "type": "Standard",
- "themes": [
- 8,
- 7
], - "universe": 42
}Voucher prototype options
Returns a paginated list of available options for a given voucher prototype. Includes a boolean field is_included indicating whether each option is included in the prototype.
Authorizations:
path Parameters
| id required | integer A unique integer value identifying this voucher's prototype. |
query Parameters
| active | boolean If true, returns active options only. |
header Parameters
| X-Partner-Domain | string Examples:
Partner's site domain (optional) |
Responses
Response samples
- 200
This is an example of Voucher Prototype Option object.
{- "count": 123,
- "results": [
- {
- "category": 10,
- "description": {
- "fr": "Description FR",
- "it": null,
- "de": null,
- "ca": null,
- "es": null,
- "en": "Description EN",
- "pt": null,
- "nl": null
}, - "id": 100,
- "is_active": true,
- "name": {
- "fr": "Name FR",
- "it": null,
- "de": null,
- "ca": null,
- "es": null,
- "en": "Name EN",
- "pt": null,
- "nl": null
}, - "price": 20.5,
- "ranking": 100,
- "is_included": false,
- "price_formatted": {
- "fr": "20,50 €",
- "it": "20,50 €",
- "de": "20,50 €",
- "ca": "20,50 €",
- "es": "20,50 €",
- "en": "€20.50",
- "pt": "20,50 €",
- "nl": "€ 20,50"
}
}
], - "partners_count": 12
}website_configuration_list
Get Partner's website configuration.
Authorizations:
query Parameters
| fields | string Examples:
Fields to include in the response (comma-separated). When missing, all fields are included. |
header Parameters
| X-Partner-Domain | string Examples:
Partner's site domain (optional) |
Responses
Response samples
- 200
This is an example of Partner configuration, but only contact and images fields are selected.
{- "contact": {
- "name": "Nom commercial",
- "address": "1200 Test Address",
- "phone_number": "123 456 897",
- "agency_website": ""
}, - "images": {
- "hero_image": null,
- "logo_mm": null
}
}workshop_categories_list
Authorizations:
query Parameters
| page | integer A page number within the paginated result set. |
| page_size | integer Number of results to return per page. |
header Parameters
| X-Partner-Domain | string Examples:
Partner's site domain (optional) |
Responses
Response samples
- 200
{- "count": 123,
- "results": [
- {
- "id": 0,
- "name": {
- "fr": "string",
- "en": "string",
- "es": "string",
- "it": "string",
- "de": "string",
- "nl": "string",
- "ca": "string",
- "pt": "string"
}
}
]
}workshop_levels_list
Authorizations:
query Parameters
| page | integer A page number within the paginated result set. |
| page_size | integer Number of results to return per page. |
header Parameters
| X-Partner-Domain | string Examples:
Partner's site domain (optional) |
Responses
Response samples
- 200
{- "count": 123,
- "results": [
- {
- "id": 0,
- "name": {
- "fr": "string",
- "en": "string",
- "es": "string",
- "it": "string",
- "de": "string",
- "nl": "string",
- "ca": "string",
- "pt": "string"
}
}
]
}workshop_sessions_list
ViewSet for listing Workshops' sessions.
Similar to tickets' slots, each workshop is presented by their first available session.
- If the partner's workshop settings checks "Display workshops per session", all available sessions are displayed.
- If the partner's workshop settings checks "Display workshops by month", the nearest session for a month is displayed within sections, on the front part, for each month.
- If the partner's workshop settings checks both "Display workshops per session" and "Display workshops by month", all the sessions are displayed within sections, on the front part, for each month.
This view uses querysets of Session objects.
For a detail endpoint of a Workshop, another view with a queryset of Workshop objects is needed.
Authorizations:
query Parameters
| category | integer |
| duration | integer |
| level | integer |
| month | integer Enum: 1 10 11 12 2 3 4 5 6 7 8 9
|
| page | integer A page number within the paginated result set. |
| page_size | integer Number of results to return per page. |
| price_max | string <decimal> (Selling price) ^-?\d{0,6}(?:\.\d{0,2})?$ |
| price_min | string <decimal> (Selling price) ^-?\d{0,6}(?:\.\d{0,2})?$ |
| recipe | Array of integers |
| skill | Array of integers |
| target | Array of integers |
| theme | Array of integers |
| time | Array of strings Items Enum: "afternoon" "evening" "midday" "morning" "night" "night"
|
| week_day | integer Enum: 1 2 3 4 5 6 7
|
header Parameters
| X-Partner-Domain | string Examples:
Partner's site domain (optional) |
Responses
Response samples
- 200
This is an example of a workshop's session.
{- "count": 123,
- "results": [
- {
- "id": 1,
- "starting_datetime_formatted": {
- "fr": "jeudi 12 Mars 2026",
- "it": "Giovedì 12 Marzo 2026",
- "de": "Donnerstag 12 März 2026",
- "ca": "Dijous 12 març 2026",
- "es": "jueves 12 marzo 2026",
- "en": "Thursday March, 12th 2026",
- "pt": "Quinta-feira 12 Março 2026",
- "nl": "donderdag 12 maart 2026"
}, - "starting_datetime": "2026-03-12T13:12:10.546651+01:00",
- "ending_datetime_formatted": {
- "fr": "vendredi 12 Mars 2027",
- "it": "Venerdì 12 Marzo 2027",
- "de": "Freitag 12 März 2027",
- "ca": "Divendres 12 març 2027",
- "es": "viernes 12 marzo 2027",
- "en": "Friday March, 12th 2027",
- "pt": "Sexta-feira 12 Março 2027",
- "nl": "vrijdag 12 maart 2027"
}, - "ending_datetime": "2027-03-12T13:12:10.546656+01:00",
- "min_capacity": 1,
- "max_capacity": 10,
- "duration_formatted": {
- "fr": "De jeudi 12 Mars 2026 13h12 à vendredi 12 Mars 2027 13h12",
- "it": "Da Giovedì 12 Marzo 2026 13:12 a Venerdì 12 Marzo 2027 13:12",
- "de": "Von Donnerstag 12 März 2026 13h12 bis Freitag 12 März 2027 13h12",
- "ca": "De Dijous 12 de març 2026 01:12 a Divendres 12 de març 2027 01:12",
- "es": "Desde jueves 12 de marzo 2026 01:12 hasta viernes 12 de marzo 2027 01:12",
- "en": "From Thursday 12th March 2026 01:12 to Friday 12th March 2027 01:12",
- "pt": "De Quinta-feira 12 Março 2026 13h12 para Sexta-feira 12 Março 2027 13h12",
- "nl": "Van donderdag 12 maart 2026 13h12 naar vrijdag 12 maart 2027 13h12"
}, - "duration_value_formatted": {
- "fr": "2h",
- "it": "2h",
- "de": "2h",
- "ca": "2h",
- "es": "2h",
- "en": "2h",
- "pt": "2h",
- "nl": "2h"
}, - "available_places": 8,
- "funnel_link": ""
}
]
}workshops_retrieve
ViewSet for Workshop details.
Authorizations:
path Parameters
| id required | integer A unique integer value identifying this workshop. |
header Parameters
| X-Partner-Domain | string Examples:
Partner's site domain (optional) |
Responses
Response samples
- 200
{- "id": 0,
- "name": {
- "fr": "string",
- "en": "string",
- "es": "string",
- "it": "string",
- "de": "string",
- "nl": "string",
- "ca": "string",
- "pt": "string"
}, - "images": [
- "string"
], - "short_description": {
- "fr": "string",
- "en": "string",
- "es": "string",
- "it": "string",
- "de": "string",
- "nl": "string",
- "ca": "string",
- "pt": "string"
}, - "long_description": {
- "fr": "string",
- "en": "string",
- "es": "string",
- "it": "string",
- "de": "string",
- "nl": "string",
- "ca": "string",
- "pt": "string"
}, - "booking_conditions": {
- "fr": "string",
- "en": "string",
- "es": "string",
- "it": "string",
- "de": "string",
- "nl": "string",
- "ca": "string",
- "pt": "string"
}, - "can_be_privatized": true,
- "display_calendar": true,
- "address": "string",
- "category": {
- "id": 0,
- "name": {
- "fr": "string",
- "en": "string",
- "es": "string",
- "it": "string",
- "de": "string",
- "nl": "string",
- "ca": "string",
- "pt": "string"
}, - "price": "string",
- "price_formatted": {
- "pt": "410,00 €",
- "fr": "410,00 €",
- "it": "410,00 €",
- "es": "410,00 €",
- "de": "410,00 €",
- "en": "€410.00",
- "ca": "410,00 €",
- "nl": "€ 410,00"
}, - "currency_code": "string",
- "specific_validity_period": 32767
}, - "level": {
- "id": 0,
- "name": {
- "fr": "string",
- "en": "string",
- "es": "string",
- "it": "string",
- "de": "string",
- "nl": "string",
- "ca": "string",
- "pt": "string"
}
}, - "themes": [
- {
- "id": 0,
- "name": {
- "fr": "string",
- "en": "string",
- "es": "string",
- "it": "string",
- "de": "string",
- "nl": "string",
- "ca": "string",
- "pt": "string"
}
}
], - "targets": [
- {
- "id": 0,
- "name": {
- "fr": "string",
- "en": "string",
- "es": "string",
- "it": "string",
- "de": "string",
- "nl": "string",
- "ca": "string",
- "pt": "string"
}
}
], - "skills": [
- {
- "id": 0,
- "name": {
- "fr": "string",
- "en": "string",
- "es": "string",
- "it": "string",
- "de": "string",
- "nl": "string",
- "ca": "string",
- "pt": "string"
}
}
], - "recipes": [
- {
- "id": 0,
- "name": {
- "fr": "string",
- "en": "string",
- "es": "string",
- "it": "string",
- "de": "string",
- "nl": "string",
- "ca": "string",
- "pt": "string"
}
}
], - "sessions": [
- {
- "id": 0,
- "starting_datetime_formatted": {
- "en": "Friday December, 12th 2025",
- "fr": "vendredi 12 Décembre 2025",
- "es": "viernes 12 diciembre 2025",
- "it": "Venerdì 12 Dicembre 2025",
- "nl": "vrijdag 12 december 2025",
- "de": "Freitag 12 Dezember 2025",
- "ca": "Divendres 12 desembre 2025",
- "pt": "Sexta-feira 12 Dezembro 2025"
}, - "starting_datetime": "2019-08-24T14:15:22Z",
- "ending_datetime_formatted": {
- "en": "Friday December, 12th 2025",
- "fr": "vendredi 12 Décembre 2025",
- "es": "viernes 12 diciembre 2025",
- "it": "Venerdì 12 Dicembre 2025",
- "nl": "vrijdag 12 december 2025",
- "de": "Freitag 12 Dezember 2025",
- "ca": "Divendres 12 desembre 2025",
- "pt": "Sexta-feira 12 Dezembro 2025"
}, - "ending_datetime": "2019-08-24T14:15:22Z",
- "min_capacity": 32767,
- "max_capacity": 32767,
- "duration_formatted": {
- "pt": "De 21h00 para 23h03",
- "en": "From 21:00 to 23:03",
- "es": "De 21:00 a 23:03",
- "it": "Dalle 21h00 alle 23h03",
- "fr": "De 21h00 à 23h03",
- "nl": "Van 21h00 naar 23h03",
- "de": "Von 21h00 bis 23h03",
- "ca": "Des de 21:00 a 23:03"
}, - "duration_value_formatted": {
- "pt": "De 21h00 para 23h03",
- "en": "From 21:00 to 23:03",
- "es": "De 21:00 a 23:03",
- "it": "Dalle 21h00 alle 23h03",
- "fr": "De 21h00 à 23h03",
- "nl": "Van 21h00 naar 23h03",
- "de": "Von 21h00 bis 23h03",
- "ca": "Des de 21:00 a 23:03"
}, - "available_places": 0,
}
], - "activate_workshops_group_payment": true
}workshops_options_retrieve
Handler method for HTTP 'OPTIONS' request.
Authorizations:
path Parameters
| id required | integer A unique integer value identifying this workshop. |
header Parameters
| X-Partner-Domain | string Examples:
Partner's site domain (optional) |
Responses
Response samples
- 200
{- "id": 0,
- "name": {
- "fr": "string",
- "en": "string",
- "es": "string",
- "it": "string",
- "de": "string",
- "nl": "string",
- "ca": "string",
- "pt": "string"
}, - "images": [
- "string"
], - "short_description": {
- "fr": "string",
- "en": "string",
- "es": "string",
- "it": "string",
- "de": "string",
- "nl": "string",
- "ca": "string",
- "pt": "string"
}, - "long_description": {
- "fr": "string",
- "en": "string",
- "es": "string",
- "it": "string",
- "de": "string",
- "nl": "string",
- "ca": "string",
- "pt": "string"
}, - "booking_conditions": {
- "fr": "string",
- "en": "string",
- "es": "string",
- "it": "string",
- "de": "string",
- "nl": "string",
- "ca": "string",
- "pt": "string"
}, - "can_be_privatized": true,
- "display_calendar": true,
- "address": "string",
- "category": {
- "id": 0,
- "name": {
- "fr": "string",
- "en": "string",
- "es": "string",
- "it": "string",
- "de": "string",
- "nl": "string",
- "ca": "string",
- "pt": "string"
}, - "price": "string",
- "price_formatted": {
- "pt": "410,00 €",
- "fr": "410,00 €",
- "it": "410,00 €",
- "es": "410,00 €",
- "de": "410,00 €",
- "en": "€410.00",
- "ca": "410,00 €",
- "nl": "€ 410,00"
}, - "currency_code": "string",
- "specific_validity_period": 32767
}, - "level": {
- "id": 0,
- "name": {
- "fr": "string",
- "en": "string",
- "es": "string",
- "it": "string",
- "de": "string",
- "nl": "string",
- "ca": "string",
- "pt": "string"
}
}, - "themes": [
- {
- "id": 0,
- "name": {
- "fr": "string",
- "en": "string",
- "es": "string",
- "it": "string",
- "de": "string",
- "nl": "string",
- "ca": "string",
- "pt": "string"
}
}
], - "targets": [
- {
- "id": 0,
- "name": {
- "fr": "string",
- "en": "string",
- "es": "string",
- "it": "string",
- "de": "string",
- "nl": "string",
- "ca": "string",
- "pt": "string"
}
}
], - "skills": [
- {
- "id": 0,
- "name": {
- "fr": "string",
- "en": "string",
- "es": "string",
- "it": "string",
- "de": "string",
- "nl": "string",
- "ca": "string",
- "pt": "string"
}
}
], - "recipes": [
- {
- "id": 0,
- "name": {
- "fr": "string",
- "en": "string",
- "es": "string",
- "it": "string",
- "de": "string",
- "nl": "string",
- "ca": "string",
- "pt": "string"
}
}
], - "sessions": [
- {
- "id": 0,
- "starting_datetime_formatted": {
- "en": "Friday December, 12th 2025",
- "fr": "vendredi 12 Décembre 2025",
- "es": "viernes 12 diciembre 2025",
- "it": "Venerdì 12 Dicembre 2025",
- "nl": "vrijdag 12 december 2025",
- "de": "Freitag 12 Dezember 2025",
- "ca": "Divendres 12 desembre 2025",
- "pt": "Sexta-feira 12 Dezembro 2025"
}, - "starting_datetime": "2019-08-24T14:15:22Z",
- "ending_datetime_formatted": {
- "en": "Friday December, 12th 2025",
- "fr": "vendredi 12 Décembre 2025",
- "es": "viernes 12 diciembre 2025",
- "it": "Venerdì 12 Dicembre 2025",
- "nl": "vrijdag 12 december 2025",
- "de": "Freitag 12 Dezember 2025",
- "ca": "Divendres 12 desembre 2025",
- "pt": "Sexta-feira 12 Dezembro 2025"
}, - "ending_datetime": "2019-08-24T14:15:22Z",
- "min_capacity": 32767,
- "max_capacity": 32767,
- "duration_formatted": {
- "pt": "De 21h00 para 23h03",
- "en": "From 21:00 to 23:03",
- "es": "De 21:00 a 23:03",
- "it": "Dalle 21h00 alle 23h03",
- "fr": "De 21h00 à 23h03",
- "nl": "Van 21h00 naar 23h03",
- "de": "Von 21h00 bis 23h03",
- "ca": "Des de 21:00 a 23:03"
}, - "duration_value_formatted": {
- "pt": "De 21h00 para 23h03",
- "en": "From 21:00 to 23:03",
- "es": "De 21:00 a 23:03",
- "it": "Dalle 21h00 alle 23h03",
- "fr": "De 21h00 à 23h03",
- "nl": "Van 21h00 naar 23h03",
- "de": "Von 21h00 bis 23h03",
- "ca": "Des de 21:00 a 23:03"
}, - "available_places": 0,
}
], - "activate_workshops_group_payment": true
}