Upload an STR task - STR Uploader API

POST

str

task

Upload an STR task

curl --request POST \
  --url https://str.keroshospitality.com/api/v1/str/task \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "draftUpload": true,
  "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
    }
  ]
}
'

{
  "taskId": 123,
  "requestId": "a1b2c3d4-e5f6-7890-a1b2-c3d4e5f67890",
  "createdAt": "2022-01-01T00:00:00Z"
}

Authorizations

Authorization

string

header

required

JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"

Body

application/json

draftUpload

boolean

default:false

Example:

true

reservations

object[]

Show child attributes

Response

Task created successfully

taskId

integer

Example:

123

requestId

string

Example:

"a1b2c3d4-e5f6-7890-a1b2-c3d4e5f67890"

createdAt

string<date-time>

Example:

"2022-01-01T00:00:00Z"

Get STR task statusGet the status of an STR upload task. ### Allowed Roles: `admin`, `str-uploader`

Upload an STR task

curl --request POST \
  --url https://str.keroshospitality.com/api/v1/str/task \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "draftUpload": true,
  "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
    }
  ]
}
'

{
  "taskId": 123,
  "requestId": "a1b2c3d4-e5f6-7890-a1b2-c3d4e5f67890",
  "createdAt": "2022-01-01T00:00:00Z"
}