API docs by Redocly

Pinokeyio API (1.0.0)

Download OpenAPI specification:Download

Serverless booking platform API documentation

Accounts

Verify phone number with OTP

Verifies the user's phone number using the OTP code sent via SMS

Authorizations:
bearerAuth
Request Body schema: application/json
phone
required
string

Phone number (without country code)

otpCode
required
string

4-digit OTP code

Responses

Request samples

Content type
application/json
{
  • "phone": "555123456",
  • "otpCode": "4444"
}

Resend OTP code

Resends the OTP verification code to the user's phone number

Authorizations:
bearerAuth

Responses

Update phone number

Updates the user's phone number and sends a new OTP for verification

Authorizations:
bearerAuth
Request Body schema: application/json
phoneNumber
required
string

New phone number (without country code)

countryCode
required
string

Country code with +

Responses

Request samples

Content type
application/json
{
  • "phoneNumber": "555987654",
  • "countryCode": "+995"
}

Bookings

Block property for 10 minutes

Creates a temporary booking lock to prevent double bookings. Automatically deleted after 10 minutes.

path Parameters
propertyId
required
string

Property ID

Request Body schema: application/json
rentalType
required
string
Enum: "DAILY" "HOURLY"
checkIn
required
string

For DAILY - date only (2025-06-01), For HOURLY - full datetime (2025-06-01T14:00:00Z)

checkOut
required
string

For DAILY - date only (2025-06-03), For HOURLY - full datetime (2025-06-01T17:00:00Z)

guests
required
number

Responses

Request samples

Content type
application/json
{
  • "rentalType": "DAILY",
  • "checkIn": "2025-06-01",
  • "checkOut": "2025-06-03",
  • "guests": 2
}