---
title: "Find service orders associated with a given claim ID or Service Order Id. Must include claimId or serviceOrderId for searching. Cannot search by both claimId and serviceOrderId"
method: GET
path: "/service-orders/search"
tags: ["service-orders"]
---

# Find service orders associated with a given claim ID or Service Order Id. Must include claimId or serviceOrderId for searching. Cannot search by both claimId and serviceOrderId

`GET /service-orders/search`

## Query parameters

- `claimId` string, uuid
- `includeShippingLabels` 'true' | 'false'
- `serviceOrderId` string, uuid
- `limit` number
- `cursor` number

## Headers

- `Content-Type` string, required
- `X-Extend-Access-Token` string, required
- `Accept` string, required

## Response `200`

Returns an array of service orders associated with a given claim Id or service order Id

- object[]
  - `body` object, required
    - `id` string, required
    - `claimId` string, required
    - `contractId` string, required
    - `sellerId` string, required
    - `customerEmail` string
    - `assignedServicer` object
      - `servicerId` string, required
      - `authOrganizationId` string, required
      - `businessName` string, required
      - `contact` object
        - `email` string
        - `phone` string
        - `name` string
      - `servicingLocation` object, required
        - `id` string, required
        - `businessName` string, required
        - `contact` object, required
          - `email` string, required
          - `phone` string, required
          - `name` string, required
        - `address` object, required
          - `address1` string, required
          - `address2` string
          - `city` string, required
          - `countryCode` string, required
          - `postalCode` string, required
          - `provinceCode` string, required
        - `createdAt` number, required
        - `updatedAt` number, required
      - `servicerType` 'third-party' | 'merchant' | 'extend', required
    - `attachments` object
      - `packingSlip` object
        - `instructions` string
        - `packingSlipUrl` string
    - `status` 'created' | 'accepted' | 'assigned' | 'fulfilled' | 'payment_approved' | 'payment_requested', required
    - `serviceType` 'product_replacement' | 'gift_card' | 'virtual_card' | 'direct_payment' | 'carry_in' | 'cleaning_kit' | 'self_repair' | 'replace' | 'repair' | 'repair_depot' | 'repair_onsite' | 'repair_irobot' | 'automated_replacement', required
    - `product` object, required
      - `id` string
      - `value` object, required
        - `amount` number, required — Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
        - `currencyCode` 'AUD' | 'CAD' | 'EUR' | 'GBP' | 'NZD' | 'USD'
        - `formattedAmount` string
      - `title` string, required
    - `overrides` object
      - `shipping` object
        - `labelUrl` string, required
        - `trackingNumber` string, required
        - `carrier` string, required
    - `fulfillmentMetaData` union
      - object
        - `method` 'product_replacement', required
        - `productReferenceId` string, required
        - `productName` string, required
        - `productValue` object, required
          - `amount` number, required — Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
          - `currencyCode` 'AUD' | 'CAD' | 'EUR' | 'GBP' | 'NZD' | 'USD'
          - `formattedAmount` string
        - `productReimbursementAmount` object
          - `amount` number, required — Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
          - `currencyCode` 'AUD' | 'CAD' | 'EUR' | 'GBP' | 'NZD' | 'USD'
          - `formattedAmount` string
        - `trackingNumber` string
        - `carrier` 'usps' | 'ups' | 'fedex_ground' | 'dhl_express' | 'ontrac' | 'newgistics'
        - `expenseDescription` string
        - `orderNumber` string
      - object
        - `method` 'repair_depot', required
    - `createdAt` number, required
    - `updatedAt` number, required
    - `repairMetaData` object
      - `acceptedAt` number
      - `assignedAt` number
      - `diagnosticExplanation` string
      - `diagnosticCompletedAt` number
      - `estimatedRepairCompletionAt` number
      - `repairStartedAt` number
      - `repairCompletedAt` number
      - `repairShippedAt` number
    - `paymentMetaData` object
      - `paymentRequestedAt` number
      - `paymentApprovedAt` number
      - `paidAt` number
      - `paymentId` string
    - `errorCode` union
      - 'missing_tracking_info'
      - unknown
    - `configurations` object
      - `productReturnRequired` boolean, required
      - `isPartialReplacement` boolean
      - `hasCustomReturnLabel` boolean
      - `hasCustomDefectiveLabel` boolean
      - `rmaNumberRequired` boolean
      - `packingSlipRequired` boolean
      - `useTotalValueForAutomatedPayout` boolean
      - `isPaymentAutoApprovalEnabled` boolean
      - `autoAccept` boolean
      - `packingSlipConfiguration` object
        - `contractId` boolean, required
        - `claimId` boolean, required
        - `serviceOrderId` boolean, required
        - `orderNumber` boolean, required
        - `customerName` boolean, required
        - `productName` boolean, required
        - `productReferenceId` boolean, required
        - `productListPrice` boolean, required — Unit list price of the product, expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
        - `productPurchasePrice` boolean, required — Unit purchase price of the product, expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul> <p> Please note that the purchase price should not reflect the quantity as total price
        - `failureType` boolean, required
        - `failureDescription` boolean, required
      - `replacementFulfillmentMethod` 'manual' | 'virtual_card' | 'direct_payment' | 'automated_replacement'
      - `fulfillmentMethod` 'product_replacement' | 'gift_card' | 'virtual_card' | 'direct_payment' | 'carry_in' | 'cleaning_kit' | 'self_repair' | 'replace' | 'repair' | 'repair_depot' | 'repair_onsite' | 'repair_irobot' | 'automated_replacement' | 'store_credit' | 'original_tender'
      - `shippingAccountOverride` object
        - `accountId` string, required
        - `postalCode` string, required
        - `carrier` 'fedex_ground' | 'ups_ground', required
    - `rmaNumber` string
    - `claimType` 'shipping_protection' | 'extended_warranty'
    - `totalItemsValue` object, required
      - `amount` number, required — Expressed in terms of the smallest currency unit.<p> <ul><li>$19.99 would be 1999</li><li>1.234,56 € would be 123456</li><li>£ 1,999.99 would be 199999</li></ul>
      - `currencyCode` 'AUD' | 'CAD' | 'EUR' | 'GBP' | 'NZD' | 'USD'
      - `formattedAmount` string
    - `costDetails` object
      - `currencyCode` 'AUD' | 'CAD' | 'EUR' | 'GBP' | 'NZD' | 'USD', required
      - `productCosts` object[], required
        - `productId` string, required
        - `lineItemId` string
        - `lineItemTransactionId` string
        - `title` string, required
        - `itemValue` number, required
        - `contractValue` number
        - `quantity` number, required
        - `perUnitDiscountAmount` number
      - `tax` number
      - `returnCost` number
      - `shippingCost` number
    - `failureType` 'road_hazard' | 'electricalFailure' | 'mechanicalFailure' | 'waterDamage' | 'dropped' | 'unanswered' | 'aluminum_finish_scratch' | 'animal_damage' | 'ballpoint_ink_stain' | 'bleach_stain' | 'box_spring_handle_damage' | 'broken_zipper_button' | 'burn' | 'burn_heat_mark' | 'burning_mech_component_damage' | 'color_fade_loss' | 'color_fade_loss_change' | 'electrical_component_damage' | 'electrical_component_failure' | 'fabric_gazebo_cover_sling_frame_damage' | 'finish_check_crack_bubble_peel' | 'fire' | 'foam_loss' | 'food_beverage_stain' | 'frame_damage' | 'frame_spring_mech_motor_lever_damage' | 'human_pet_body_fluid_waste_stain' | 'incline_recline_heat_vibrate_mech_damage' | 'liquid_mark_ring' | 'loose_joint' | 'material_scuffing_scrapes_fraying_pilling' | 'mirror_glass_chip_scratch_break' | 'mirror_silvering_loss' | 'mold_mildew' | 'nail_polish_and_remover_stain_damage' | 'non_damage_breakage' | 'non_fire_burn' | 'odor' | 'other_puncture_tear_rip' | 'other_water_damage' | 'perspiration_hair_body_oils' | 'pet_damage' | 'puncture_cut_tear_rip' | 'rocker_swivel_glide_recline_mech_breakage' | 'rug_fringe' | 'rug_pilling_fraying' | 'scratch_gouge_chip' | 'seam_separation' | 'six_inch_border_tear' | 'spring_coil_puncture_tear_rip' | 'table_arc_umbrella_mech_damage' | 'table_top_breakage' | 'umbrella_rib_damage' | 'vermin' | 'weld_breakage'
    - `shippingLabels` object[]
      - `destinationType` string[], required
      - `imageData` string, required
      - `pdfDownloadUrl` string

## Other responses

- `403` — Forbidden
- `422` — Unprocessable entity
- `500` — Internal server error

---

[API](https://skmtc.dev/extend/apis/leads-api.md) · [All operations](https://skmtc.dev/extend/apis/leads-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/extend/leads-api/revisions/76403e33d7d6/schema)