Create Parking Spot

Register a new parking spot

POST https://harbor-parking.vercel.app/api/parking-spots

Create Parking Spot

cURL

curl --request POST \
  --url https://harbor-parking.vercel.app/api/parking-spots \
  --header 'Content-Type: application/json' \
  --data '
{
  "spot_number": "<string>",
  "building_section": "<string>"
}
'

Success Response

{
  "spot": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "spot_number": "A-15",
    "owner_id": "456e7890-e89b-12d3-a456-426614174001",
    "building_section": "Level 2 Parking Garage",
    "is_verified": false,
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-15T10:30:00Z"
  }
}

Overview

This endpoint allows users to register a new parking spot in the system.

Authentication

Request Body

spot_number · string · required

Unique spot number or identifier

building_section · string · required

Building section or location description

Response

spot · object · required

Created parking spot object

Show Spot Object

id · string · required

Unique spot identifier (UUID)

spot_number · string · required

Spot number or identifier

owner_id · string · required

ID of the spot owner (authenticated user)

building_section · string · required

Building section or location

is_verified · boolean · required

Whether the spot has been verified by admin (always false on creation)

created_at · string · required

Spot creation timestamp (ISO 8601)

updated_at · string · required

Spot last update timestamp (ISO 8601)

Example Request

cURL

curl -X POST "https://harbor-parking.vercel.app/api/parking-spots" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "spot_number": "A-15",
    "building_section": "Level 2 Parking Garage"
  }'

Example Response

Success Response

{
  "spot": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "spot_number": "A-15",
    "owner_id": "456e7890-e89b-12d3-a456-426614174001",
    "building_section": "Level 2 Parking Garage",
    "is_verified": false,
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-15T10:30:00Z"
  }
}