Authentication
Apartment Owners
Apartments
STR Submitted Declarations
List reservations for apartment
Copy
curl --request GET \
--url https://str.keroshospitality.com/api/v1/apartments/{id}/reservations \
--header 'Authorization: Bearer <token>'Copy
{
"reservations": [
{
"reservationId": "HMXDBC4N22",
"apartmentId": 42,
"startDate": "01/02/2025",
"endDate": "05/02/2025",
"amountReceived": 309.83,
"platform": "Airbnb",
"paymentMethod": "Λογαριασμός Πληρωμών Αλλοδαπής",
"guestName": "John Doe",
"guestId": "AT1237212",
"guestTaxId": "137269544",
"isForeigner": true,
"isDraft": false,
"cancellationDate": "<string>",
"cancellationAmount": 123,
"dateUploaded": "2022-01-01T00:00:00Z",
"declarationServerId": "<string>",
"uploadStatus": "PENDING",
"details": "",
"errorValue": "duplicate_declaration"
}
],
"requestId": "a1b2c3d4-e5f6-7890-a1b2-c3d4e5f67890"
}Reservations
List reservations for apartment
Get reservations for a specific apartment.
Allowed Roles:
admin, str-uploader
GET
/
apartments
/
{id}
/
reservations
List reservations for apartment
Copy
curl --request GET \
--url https://str.keroshospitality.com/api/v1/apartments/{id}/reservations \
--header 'Authorization: Bearer <token>'Copy
{
"reservations": [
{
"reservationId": "HMXDBC4N22",
"apartmentId": 42,
"startDate": "01/02/2025",
"endDate": "05/02/2025",
"amountReceived": 309.83,
"platform": "Airbnb",
"paymentMethod": "Λογαριασμός Πληρωμών Αλλοδαπής",
"guestName": "John Doe",
"guestId": "AT1237212",
"guestTaxId": "137269544",
"isForeigner": true,
"isDraft": false,
"cancellationDate": "<string>",
"cancellationAmount": 123,
"dateUploaded": "2022-01-01T00:00:00Z",
"declarationServerId": "<string>",
"uploadStatus": "PENDING",
"details": "",
"errorValue": "duplicate_declaration"
}
],
"requestId": "a1b2c3d4-e5f6-7890-a1b2-c3d4e5f67890"
}Authorizations
JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"
Path Parameters
Apartment ID
Response
200 - application/json
Reservations retrieved successfully
Show child attributes
Show child attributes
Example:
"HMXDBC4N22"
Example:
42
Example:
"01/02/2025"
Example:
"05/02/2025"
Example:
309.83
Example:
"Airbnb"
Example:
"Λογαριασμός Πληρωμών Αλλοδαπής"
Example:
"John Doe"
Example:
"AT1237212"
Example:
"137269544"
Example:
true
Example:
false
Example:
"2022-01-01T00:00:00Z"
Upload status
Available options:
PENDING, SUCCESS, FAILED Additional details about the upload status
Example:
""
Error classification for failed uploads
Available options:
duplicate_declaration, tax_id_not_found, timed_out, failed_to_authenticate, failed_to_navigate, internal_error, unknown Example:
"a1b2c3d4-e5f6-7890-a1b2-c3d4e5f67890"
⌘I