Create Guest Booking

curl --request POST \
  --url http://localhost:3000/api/bookings/create-booking-guest \
  --header 'Content-Type: application/json' \
  --data '
{
  "artistUserId": "<string>",
  "guestEmail": "[email protected]",
  "guestFirstName": "<string>",
  "guestSessionId": "<string>",
  "bookingData": {
    "requestType": "Flash",
    "preferredLocationIds": [
      "<string>"
    ],
    "isCoverUp": true,
    "tattooPlacement": [
      "<string>"
    ],
    "selectedDates": [
      "2023-12-25"
    ],
    "desiredTimeOfDay": "Morning",
    "isOver18": true,
    "isPolicyAccepted": true,
    "flashIds": [
      "<string>"
    ],
    "description": "<string>",
    "color": "<string>",
    "length": "<string>",
    "width": "<string>",
    "otherTattooPlacement": "<string>",
    "tattooStyle": [
      "<string>"
    ],
    "images": [
      "<string>"
    ],
    "links": [
      "<string>"
    ],
    "additionalDateComments": "<string>",
    "medicalConditions": "<string>"
  },
  "guestLastName": "<string>"
}
'

{
  "success": true,
  "bookingId": "<string>",
  "clientCreated": true
}

Body

application/json

artistUserId

string

required

ID of the artist to book with

Minimum string length: 1

guestEmail

string<email>

required

Email address of the guest user

guestFirstName

string

required

First name of the guest user

Minimum string length: 1

guestSessionId

string

required

Unique session ID for the guest (used for temporary image storage)

Minimum string length: 1

bookingData

object

required

Booking request details including tattoo info, dates, and images. Can be either Flash or Custom booking type.

Show child attributes

bookingData.requestType

enum<string>

required

Type of booking request. Flash requires flashIds array. Custom requires description (min 30 chars), color field.

Available options:

Flash,

Custom

bookingData.preferredLocationIds

string[]

required

IDs of preferred locations for the booking

Minimum array length: 1

bookingData.isCoverUp

boolean

required

Whether this is a cover-up tattoo

bookingData.tattooPlacement

string[]

required

Selected placement areas for the tattoo

bookingData.selectedDates

(string<date> | string<date-time>)[]

required

Preferred dates for the tattoo session (can be date strings or timestamps)

bookingData.desiredTimeOfDay

enum<string>

required

Preferred time of day for the session

Available options:

Morning,

Afternoon,

Either

bookingData.isOver18

boolean

required

Confirmation that the client is over 18 (must be true)

bookingData.isPolicyAccepted

boolean

required

Confirmation that the client accepts the policy (must be true)

bookingData.flashIds

string[]

Array of flash listing IDs (for Flash bookings, can be empty array)

bookingData.description

string

Description of the tattoo request. Optional for Flash (max 1000 chars), required for Custom (min 30 chars).

Maximum string length: 1000

bookingData.color

string

Color preference (required for Custom bookings)

bookingData.length

string

Length of the tattoo (optional for Custom, must be positive number if provided)

bookingData.width

string

Width of the tattoo (optional for Custom, must be positive number if provided)

bookingData.otherTattooPlacement

string

Custom placement description if not in standard options

bookingData.tattooStyle

string[]

Selected tattoo styles (optional, for Custom bookings)

bookingData.images

string[]

Array of image URLs (optional)

bookingData.links

string<uri>[]

Reference links for tattoo design (optional)

bookingData.additionalDateComments

string

Additional comments about date preferences

bookingData.medicalConditions

string

Any relevant medical conditions

guestLastName

string

Last name of the guest user (optional)

Response

Guest booking created successfully

success

boolean

required

Whether the guest booking was created successfully

bookingId

string

required

ID of the created booking

clientCreated

boolean

required

Whether a new user account was created for the guest

Edit BookingModifies an existing booking

⌘I

Create Guest Booking

curl --request POST \
  --url http://localhost:3000/api/bookings/create-booking-guest \
  --header 'Content-Type: application/json' \
  --data '
{
  "artistUserId": "<string>",
  "guestEmail": "[email protected]",
  "guestFirstName": "<string>",
  "guestSessionId": "<string>",
  "bookingData": {
    "requestType": "Flash",
    "preferredLocationIds": [
      "<string>"
    ],
    "isCoverUp": true,
    "tattooPlacement": [
      "<string>"
    ],
    "selectedDates": [
      "2023-12-25"
    ],
    "desiredTimeOfDay": "Morning",
    "isOver18": true,
    "isPolicyAccepted": true,
    "flashIds": [
      "<string>"
    ],
    "description": "<string>",
    "color": "<string>",
    "length": "<string>",
    "width": "<string>",
    "otherTattooPlacement": "<string>",
    "tattooStyle": [
      "<string>"
    ],
    "images": [
      "<string>"
    ],
    "links": [
      "<string>"
    ],
    "additionalDateComments": "<string>",
    "medicalConditions": "<string>"
  },
  "guestLastName": "<string>"
}
'

{
  "success": true,
  "bookingId": "<string>",
  "clientCreated": true
}

Endpoints

Body

Response