# List Repair Orders

Retrieves a paginated list of Repair orders for the specified company and optional filters.
If repairOrderNumber is provided as a query param, returns that specific RO (but use /orders/{roNumber} for clarity).

Endpoint: GET /orders
Security: BearerAuth

## Query parameters:

  - `companyId` (string, required)
    The company identifier used to scope the query.

  - `locationId` (string)
    The location identifier used to scope the query.

  - `search` (string)
    Search by RO No., customer name, or vehicle info

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

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

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

  - `finalizeStartDate` (string)
    Filter by RO's finalization date range. Supports ISO 8601 (e.g., YYYY-MM-DDThh:mm:ssZ) to filter with time precision or date-only (YYYY-MM-DD).

  - `finalizeEndDate` (string)
    Filter by RO's finalization date range. Supports ISO 8601 (e.g., YYYY-MM-DDThh:mm:ssZ) to filter with time precision or date-only (YYYY-MM-DD).

  - `repairOrderNumber` (string)
    Filter by Repair Order's Number

  - `repairOrderStatusId` (integer)
    1=Estimate, 2=WIP, 3=Complete, 4=Saved, 5=Posted, 6=AR, 7=Deleted
    Enum: 1, 2, 3, 4, 5, 6, 7

  - `isFinalized` (boolean)
    Filters results based on whether a repair order has been finalized.  
  • true — Returns only finalized repair orders.  
  • false — Returns only estimates or non-finalized orders.  
  • Omit this parameter to return all orders.

  - `sort` (string)
    Specify the property you'd like to sort on
Permitted Values are "createdDate" and "repairOrderNumber"
    Enum: "createdDate", "repairOrderNumber"

  - `sortDirection` (string)
    Defines the sort order of results.  
 • ASC — Sorts in ascending order (default).  
 • DESC — Sorts in descending order.
    Enum: "ASC", "DESC"

  - `size` (integer)
    Number of records to be displayed. For values greater than 100, the API overrides and returns 100 records. Pagination can be used to access the next records.

  - `page` (integer)
    Page number of the returned data.

## Response 200 fields (application/json):

  - `content` (array)

  - `content.repairOrderNumber` (integer)

  - `content.companyId` (string)

  - `content.locationId` (string)

  - `content.repairOrderStatus` (string)

  - `content.workflowStatus` (string)

  - `content.paymentStatus` (string)

  - `content.customer` (object)

  - `content.customer.id` (string)

  - `content.customer.firstName` (string)

  - `content.customer.lastName` (string)

  - `content.customer.customerType` (string)

  - `content.serviceWriter` (object)

  - `content.serviceWriter.name` (string)

  - `content.serviceWriter.payrollId` (string)

  - `content.shopNotes` (string)

  - `content.recommendationsForCustomer` (string)

  - `content.vehicleId` (string)

  - `content.milesIn` (number)

  - `content.milesOut` (number)

  - `content.estimateDate` (string)

  - `content.approveDate` (string)

  - `content.invoiceDate` (string)

  - `content.invoicedBy` (string)

  - `content.finalizeDate` (string)

  - `content.finalizeType` (string)

  - `content.finalizeBy` (string)

  - `content.laborSales` (number)

  - `content.laborCost` (number)

  - `content.partsSales` (number)

  - `content.partsCost` (number)

  - `content.tiresSales` (number)

  - `content.tiresCost` (number)

  - `content.subletSales` (number)

  - `content.subletCost` (number)

  - `content.otherSales` (number)

  - `content.otherCost` (number)

  - `content.tireStorageTotal` (number)

  - `content.tireStorageCost` (number)

  - `content.serviceFeesTotal` (number)

  - `content.serviceFeesCost` (number)

  - `content.serviceDiscountsTotal` (number)

  - `content.orderLevelDiscounts` (object)

  - `content.orderLevelDiscounts.total` (number)

  - `content.orderLevelFees` (object)

  - `content.taxes` (number)

  - `content.taxableAmount` (number)

  - `content.nonTaxableAmount` (number)

  - `content.amountPaid` (number)

  - `content.totalSales` (number)

  - `content.totalCost` (number)

  - `content.passthroughTax` (number)

  - `content.taxRate` (number)

  - `content.taxCode` (string)

  - `content.invoiceNumber` (string)

  - `content.services` (array)

  - `content.services.title` (string)

  - `content.services.authorized` (boolean)

  - `content.services.serviceStatus` (string)

  - `content.services.authorizedDate` (string)

  - `content.services.technician` (array)

  - `content.services.technician.isPrimaryTech` (string)

  - `content.services.note` (string)

  - `content.services.partsTotal` (number)

  - `content.services.laborTotal` (number)

  - `content.services.tiresTotal` (number)

  - `content.services.otherTotal` (number)

  - `content.services.subletTotal` (number)

  - `content.services.tiresStorageCost` (number)

  - `content.services.feeCost` (number)

  - `content.services.itemLevelDiscountTotal` (number)

  - `content.services.serviceLeveldiscountTotal` (number)

  - `content.services.feeTotal` (number)

  - `content.services.passthroughTaxTotal` (number)

  - `content.services.subtotal` (number)

  - `content.services.laborLineLevelDiscountTotal` (number)

  - `content.services.partsLineLevelDiscountTotal` (number)

  - `content.services.tiresLineLevelDiscountTotal` (number)

  - `content.services.tireStorageLineLevelDiscountTotal` (number)

  - `content.services.subletLineLevelDiscountTotal` (number)

  - `content.services.otherLineLevelDiscountTotal` (number)

  - `content.services.createdDate` (string)

  - `content.services.updatedDate` (string)

  - `content.services.labor` (array)

  - `content.services.labor.description` (string)

  - `content.services.labor.ratePerHour` (number)

  - `content.services.labor.costRatePerHour` (number)

  - `content.services.labor.billableHours` (number)

  - `content.services.labor.estimatedHours` (number)

  - `content.services.labor.cost` (number)

  - `content.services.labor.price` (number)

  - `content.services.labor.taxable` (boolean)

  - `content.services.labor.laborDiscount` (number)

  - `content.services.labor.netPrice` (number)

  - `content.services.labor.complete` (boolean)

  - `content.services.labor.category` (object)

  - `content.services.labor.category.categoryId` (string)

  - `content.services.labor.category.categoryName` (string)

  - `content.services.labor.category.subCategoryId` (string)

  - `content.services.labor.category.subCategoryName` (string)

  - `content.services.labor.category.subSubCategoryId` (string)

  - `content.services.labor.category.subSubCategoryName` (string)

  - `content.services.labor.salesCode` (object)

  - `content.services.labor.salesCode.code` (string)

  - `content.services.labor.salesCode.salesGroup` (object)

  - `content.services.parts` (array)

  - `content.services.parts.partNumber` (string)

  - `content.services.parts.quantity` (number)

  - `content.services.parts.brand` (string)

  - `content.services.parts.costPerUnit` (number)

  - `content.services.parts.pricePerUnit` (number)

  - `content.services.parts.totalPrice` (number)

  - `content.services.parts.partDiscount` (number)

  - `content.services.tires` (array)

  - `content.services.tires.discount` (number)

  - `content.services.tires.model` (string)

  - `content.services.tires.width` (integer)

  - `content.services.tires.ratio` (integer)

  - `content.services.tires.diameter` (integer)

  - `content.services.tires.tireType` (string)

  - `content.services.tires.loadIndex` (integer)

  - `content.services.tires.speedRating` (string)

  - `content.services.fees` (array)

  - `content.services.fees.feeType` (string)

  - `content.services.fees.feeDiscount` (number)

  - `content.services.discounts` (array)

  - `content.services.sublets` (array)

  - `content.services.sublets.vendor` (object)

  - `content.services.sublets.status` (string)

  - `content.services.sublets.PaymentStatus` (string)

  - `content.services.other` (array)

  - `content.services.other.otherDiscount` (number)

  - `content.customerConcerns` (array)

  - `content.customerConcerns.concern` (string)

  - `content.customerConcerns.serviceID` (string)

  - `content.archivedDate` (string,null)

  - `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)

  - `totalElements` (integer)

  - `last` (boolean)

  - `size` (integer)

  - `number` (integer)

  - `first` (boolean)

  - `numberOfElements` (integer)