Get Experience Booking History

GET

/management/:experienceId/bookings

GET

/experience/booking/management/:experienceId/bookings

const url = 'https://api.etera.dev/experience/booking/management/experienceId/bookings';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

200Retrieved

{
  "success": true,
  "experienceId": "exp_abc123",
  "bookings": [
    {
      "id": "bk_001",
      "guestName": "John Doe",
      "email": "john@example.com",
      "phone": "+1234567890",
      "partySize": 4,
      "date": "2024-01-15",
      "time": "19:00",
      "status": "confirmed",
      "provider": "opentable",
      "createdAt": "2024-01-15T09:30:00Z",
      "updatedAt": "2024-01-15T09:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 245,
    "totalPages": 13
  }
}

Retrieve paginated booking history for experience management.

Features:

📋 Complete Booking Details - Guest info, status, timestamps
🔍 Advanced Filtering - By status, date range, provider
📄 Pagination Support - Handle large booking volumes
📊 Export Ready - Data formatted for reports

Filtering Options:

Status - Filter by booking status
Date Range - Custom date filters
Provider - Filter by booking source
Search - Find specific bookings

Use Cases:

Daily operations management
Customer service lookup
Financial reconciliation
Performance analysis

Authentication

AuthorizationBearer

JWT token from @etera-ai/auth package (auth.etera.dev) - Format: Bearer <token>

Path parameters

experienceIdstringRequired

Experience identifier

Query parameters

pagedoubleOptional>=1

Page number

limitdoubleOptional1-100

Items per page

statusenumOptional

Filter by status

Allowed values:

dateFromstringOptionalformat: "^\d{4}-\d{2}-\d{2}$"

Start date filter

dateTostringOptionalformat: "^\d{4}-\d{2}-\d{2}$"

End date filter

providerenumOptional

Filter by provider

Allowed values:

Response

Booking history retrieved successfully

successbooleanOptional

experienceIdstringOptional

bookingslist of objectsOptional

paginationobjectOptional