Retrive all reservations by a filter

POST

/v2/reservations/query

curl --request POST \
  --url https://api-crm-staging.divinea.com/api/v2/reservations/query \
  --header 'APIKey: <APIKey>' \
  --header 'Content-Type: application/json' \
  --data '{ "endTime": "2026-04-15", "ids": [ "example" ], "lang": "example", "startTime": "2026-04-15", "states": [ "draft" ], "wineryId": "example" }'

Authorizations

• ApiKey

Parameters

Query Parameters

lang

string

Lang

Request Body

Filter

Media typeapplication/json

Filter

object

endTime

string format: date

ids

Array<string>

lang

string

startTime

string format: date

states

Array<string>

Allowed values: draft waiting confirmed revoked rejected completed deleted canceled hold_seat

wineryId

string

Responses

200

OK

Media type*/*

Array<object>

ReservationDTO

object

additionalQuestionAnswers

Additional booking question answers

Array<object>

AnswerInput

object

answerType

string

freeText

string

questionId

string format: uuid

selectedOptionIds

Array<integer>

contactId

Contact ID - only if already associeted with reservation

integer format: int64

Example

12312

createdAt

required

Created at

string format: date-time

Example

2021-01-01T12:00:00

date

required

Reservation date

string format: date

Example

2021-01-01

discountTotalCents

Discount total cents

integer format: int64

Example

0

dueTotalCents

Due total cents

integer format: int64

Example

0

experienceId

required

Experience ID

string format: uuid

Example

123e4567-e89b-12d3-a456-426614174000

experiencePriceExtras

required

Experience price extras

Array<object>

ExperiencePriceExtra

object

created_at

string format: date

experience_id

string format: uuid

id

integer format: int64

position

integer format: int32

price_cents

number format: double

price_currency

string

quantity

integer format: int32

title_translations

Translatable

object

de

string

en

string

it

string

updated_at

string format: date

experiencePriceLabels

required

Experience price labels

Array<object>

ExperiencePriceLabel

object

created_at

string format: date

experience_id

string format: uuid

id

integer format: int64

islabel1

boolean

position

integer format: int32

price_cents

number format: double

price_currency

string

quantity

integer format: int32

title_translations

Translatable

object

de

string

en

string

it

string

updated_at

string format: date

experienceTitleTranslations

LabelTranslations

object

labelKey

string

languagesPresent

Array<string>

Allowed values: SPANISH FRENCH BULGARIAN ARABIC DANISH CHINESE RUSSIAN ENGLISH PORTUGUESE ITALIAN GERMAN ROMANIAN POLISH CROATIAN

translations

Array<object>

LabelTranslation

object

label

string

language

string

Allowed values: SPANISH FRENCH BULGARIAN ARABIC DANISH CHINESE RUSSIAN ENGLISH PORTUGUESE ITALIAN GERMAN ROMANIAN POLISH CROATIAN

languageISO

string

giftId

Id of the gift related

string format: uuid

Example

123e4567-e89b-12d3-a456-426614174000

grossTotalCents

Gross total cents

integer format: int64

Example

1000

guestCount01

required

Guest count 01

integer format: int32

Example

1

guestCountTotal

required

Total guest count

integer format: int32

Example

2

id

Reservation ID

string format: uuid

Example

123a4567-e89b-12d3-a456-426614174000

languageIso

required

Language ISO

string

Example

en

manualDiscountTotalCents

Manual discount total cents

integer format: int64

Example

0

message

Message from final user

string

netTotalCents

required

Net total cents

integer format: int64

Example

1000

optionalData

Optional data - Legacy additional data

object

origin

required

Origin

string

Example

https://www.divinea.com/

otherData

Other data to save as JSON

object

Example

{
  "key": "value",
  "key2": "value2"
}

paid

required

Paid

boolean

Example

true

paidAt

UTC instant of first captured/charged payment (derived). WS-2190.

string format: date-time

paidTotalCents

Paid total cents

integer format: int64

Example

1000

paymentCurrency

required

Payment currency

string

Example

EUR

refundedAt

UTC instant of refund activity (derived). WS-2190.

string format: date-time

refundedTotalCents

Refunded total cents (from payment intents)

integer format: int64

Example

1000

reservationContacts

required

Reservation contacts

Array<object>

ContactDTO

object

acceptedMarketing

Accepted Marketing

boolean

Example

true

acceptedPrivacyTerms

Accepted Privacy Terms

boolean

Example

true

acceptedProfiling

Accepted Profiling

boolean

Example

true

contactType

required

Contact Type - At least one contact and one MASTER. The other ones can be saved if SECONDARY

string

Example

MASTER

countryIso

required

Country ISO

string

Example

IT

email

required

Email

string

Example

john.doe@gmail.com

firstName

required

First Name

string

Example

John

lastName

required

Last Name

string

Example

Doe

manualMarketing

Privacy Manual flagged by winery (has a signed paper)

boolean

Example

false

otherData

Other data to be safe

object

Example

{}

phoneNumber

required

Phone Number

string

Example

+39 123456789

unsubscribed

Privacy Unsubscribed

boolean

Example

false

reservationMasterContact

ContactDTO

object

acceptedMarketing

Accepted Marketing

boolean

Example

true

acceptedPrivacyTerms

Accepted Privacy Terms

boolean

Example

true

acceptedProfiling

Accepted Profiling

boolean

Example

true

contactType

required

Contact Type - At least one contact and one MASTER. The other ones can be saved if SECONDARY

string

Example

MASTER

countryIso

required

Country ISO

string

Example

IT

email

required

Email

string

Example

john.doe@gmail.com

firstName

required

First Name

string

Example

John

lastName

required

Last Name

string

Example

Doe

manualMarketing

Privacy Manual flagged by winery (has a signed paper)

boolean

Example

false

otherData

Other data to be safe

object

Example

{}

phoneNumber

required

Phone Number

string

Example

+39 123456789

unsubscribed

Privacy Unsubscribed

boolean

Example

false

state

required

Reservation State

string

Allowed values: draft waiting confirmed revoked rejected completed deleted canceled hold_seat

Example

CONFIRMED

time

required

LocalTime

Reservation time

object

hour

integer format: int32

minute

integer format: int32

nano

integer format: int32

second

integer format: int32

Example

12:00:00

updatedAt

required

Updated at

string format: date-time

Example

2021-01-01T12:30:00

wineryId

required

Winery ID

string format: uuid

Example

123e4567-e89b-12d3-a456-426614174000