# Get appointment requests

Fetches Appointment Requests for a given Company and Location.  
Supports filtering by status, date ranges, and pagination.

Endpoint: GET /appointmentRequests
Security: BearerAuth

## Query parameters:

  - `companyId` (string, required)
    Identifier for the company.

  - `locationId` (string)
    Identifier for the location.

  - `status` (string)
    Filter by appointment status.
    Enum: "requested", "confirmed", "declined"

  - `appointmentStartDate` (string)
    Filter by appointment start date (inclusive).  
Supports ISO 8601 (e.g., YYYY-MM-DDThh:mm:ssZ) to filter with time precision or date-only (YYYY-MM-DD).

  - `appointmentEndDate` (string)
    Filter by appointment end date (inclusive). Supports ISO 8601 (e.g., YYYY-MM-DDThh:mm:ssZ) to filter with time precision or date-only (YYYY-MM-DD).

  - `updatedDateStart` (string)
    Filter by updated date range start. Supports ISO 8601 (e.g., YYYY-MM-DDThh:mm:ssZ) to filter with time precision or date-only (YYYY-MM-DD).

  - `updatedDateEnd` (string)
    Filter by updated date range end.Supports ISO 8601 (e.g., YYYY-MM-DDThh:mm:ssZ) to filter with time precision or date-only (YYYY-MM-DD)

  - `createdDateStart` (string)
    Filter by created date range start. Supports ISO 8601 (e.g., YYYY-MM-DDThh:mm:ssZ) to filter with time precision or date-only (YYYY-MM-DD)

  - `createdDateEnd` (string)
    Filter by created date range end. Supports ISO 8601 (e.g., YYYY-MM-DDThh:mm:ssZ) to filter with time precision or date-only (YYYY-MM-DD)

  - `sort` (string)
    Property to sort by.
    Enum: "startDate", "endDate"

  - `sortDirection` (string)
    Sort direction.
    Enum: "ASC", "DESC"

  - `size` (integer)
    Number of records per page (max 100).

  - `page` (integer)
    Page number (1-based).

## Response 200 fields (application/json):

  - `content` (array)
    Example: [{"appointmentId":"24f6c184","companyId":"222221","locationId":"LOC11","code":"10120","status":"requested","type":"customer","description":"","declineReason":"","dropOffOption":"waitForIt","isVehicleDropOff":false,"startDateTime":"2024-02-04T15:00:00.000Z","customer":{"firstName":"John ","lastName":"Doe","phone":"6093851044","email":"john.doe@mail.com","zipCode":"10001"},"vehicle":{"name":"2012 Fiat 500 Abarth"},"serviceCategories":[{"name":"Brakes","services":[{"name":"Brake check"},{"details":"Want to get the brakes checked"}]}],"createdAt":"2024-02-01T08:55:21.804Z","updatedAt":"2025-07-18T03:42:58.800Z"}]

  - `content.appointmentId` (string, required)

  - `content.companyId` (string, required)

  - `content.locationId` (string, required)

  - `content.code` (string)

  - `content.status` (string, required)
    Enum: "requested", "confirmed", "declined"

  - `content.type` (string)

  - `content.description` (string)

  - `content.declineReason` (string)

  - `content.dropOffOption` (string)
    Enum: "dropOff", "waitForIt", "pickUp", "requestCourtesy"

  - `content.isVehicleDropOff` (boolean)

  - `content.startDateTime` (string, required)

  - `content.endDateTime` (string,null)

  - `content.customer` (object)

  - `content.customer.firstName` (string)

  - `content.customer.lastName` (string)

  - `content.customer.phone` (string)

  - `content.customer.email` (string)

  - `content.customer.zipCode` (string)

  - `content.vehicle` (object)

  - `content.vehicle.name` (string)

  - `content.vehicle.year` (integer,null)

  - `content.vehicle.make` (string,null)

  - `content.vehicle.model` (string,null)

  - `content.serviceCategories` (array)

  - `content.serviceCategories.services` (array)

  - `content.serviceCategories.services.details` (string)

  - `content.createdAt` (string)

  - `content.updatedAt` (string)

  - `pageable` (object)

  - `pageable.sort` (object)

  - `pageable.sort.unsorted` (boolean)

  - `pageable.sort.sorted` (boolean)

  - `pageable.sort.empty` (boolean)

  - `pageable.offset` (integer)

  - `pageable.pageSize` (integer)

  - `pageable.pageNumber` (integer)

  - `pageable.paged` (boolean)

  - `pageable.unpaged` (boolean)

  - `totalPages` (integer)
    Example: 1

  - `totalElements` (integer)
    Example: 3

  - `last` (boolean)
    Example: true

  - `size` (integer)
    Example: 10

  - `number` (integer)

  - `first` (boolean)
    Example: true