--- title: "getServiceJobs" method: GET path: "/service/v1/serviceJobs" tags: ["Services v1"] --- # getServiceJobs `GET /service/v1/serviceJobs` Gets service job details for the specified filter query. **Usage Plan:** | Rate (requests per second) | Burst | | ---- | ---- | | 10 | 40 | The `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api). ## Query parameters - `serviceOrderIds` string[] - `productOrderIds` string[] - `trackingIds` string[] - `serviceJobStatus` string[] - `pageToken` string - `pageSize` integer - `sortField` 'JOB_DATE' | 'JOB_STATUS' - `sortOrder` 'ASC' | 'DESC' - `createdAfter` string - `createdBefore` string - `lastUpdatedAfter` string - `lastUpdatedBefore` string - `scheduleStartDate` string - `scheduleEndDate` string - `marketplaceIds` string[], required - `asins` string[] - `requiredSkills` string[] - `storeIds` string[] ## Response `200` Success response. - GetServiceJobsResponse — Response schema for the `getServiceJobs` operation. - `payload` JobListing — The payload for the `getServiceJobs` operation. - `totalResultSize` integer — Total result size of the query result. - `nextPageToken` string — A generated string used to pass information to your next request. If `nextPageToken` is returned, pass the value of `nextPageToken` to the `pageToken` to get next results. - `previousPageToken` string — A generated string used to pass information to your next request. If `previousPageToken` is returned, pass the value of `previousPageToken` to the `pageToken` to get previous page results. - `jobs` ServiceJob[] — List of job details for the given input. - `createTime` string, date-time — The date and time of the creation of the job in ISO 8601 format. - `serviceJobId` string — Amazon identifier for the service job. - `serviceJobStatus` 'NOT_SERVICED' | 'CANCELLED' | 'COMPLETED' | 'PENDING_SCHEDULE' | 'NOT_FULFILLABLE' | 'HOLD' | 'PAYMENT_DECLINED' — The status of the service job. - `scopeOfWork` ScopeOfWork — The scope of work for the order. - `asin` string — The Amazon Standard Identification Number (ASIN) of the service job. - `title` string — The title of the service job. - `quantity` integer — The number of service jobs. - `requiredSkills` string[] — A list of skills required to perform the job. - `seller` Seller — Information about the seller of the service job. - `sellerId` string — The identifier of the seller of the service job. - `serviceJobProvider` ServiceJobProvider — Information about the service job provider. - `serviceJobProviderId` string — The identifier of the service job provider. - `preferredAppointmentTimes` AppointmentTime[] — A list of appointment windows preferred by the buyer. Included only if the buyer selected appointment windows when creating the order. - `startTime` string, date-time, required — The date and time of the start of the appointment window in ISO 8601 format. - `durationInMinutes` integer, required — The duration of the appointment window, in minutes. - `appointments` Appointment[] — A list of appointments. - `appointmentId` string — The appointment identifier. - `appointmentStatus` 'ACTIVE' | 'CANCELLED' | 'COMPLETED' — The status of the appointment. - `appointmentTime` AppointmentTime — The time of the appointment window. - `startTime` string, date-time, required — The date and time of the start of the appointment window in ISO 8601 format. - `durationInMinutes` integer, required — The duration of the appointment window, in minutes. - `assignedTechnicians` Technician[] — A list of technicians assigned to the service job. - `technicianId` string — The technician identifier. - `name` string — The name of the technician. - `rescheduledAppointmentId` string — The appointment identifier. - `poa` Poa — Proof of Appointment (POA) details. - `appointmentTime` AppointmentTime — The time of the appointment window. - `startTime` string, date-time, required — The date and time of the start of the appointment window in ISO 8601 format. - `durationInMinutes` integer, required — The duration of the appointment window, in minutes. - `technicians` Technician[] — A list of technicians. - `technicianId` string — The technician identifier. - `name` string — The name of the technician. - `uploadingTechnician` string — The identifier of the technician who uploaded the POA. - `uploadTime` string, date-time — The date and time when the POA was uploaded in ISO 8601 format. - `poaType` 'NO_SIGNATURE_DUMMY_POS' | 'CUSTOMER_SIGNATURE' | 'DUMMY_RECEIPT' | 'POA_RECEIPT' — The type of POA uploaded. - `serviceOrderId` string — The Amazon-defined identifier for an order placed by the buyer, in 3-7-7 format. - `productOrderIds` string[] — A list of associated product order IDs for the service job. - `trackingIds` string[] — A list of associated product tracking IDs for the service job. - `marketplaceId` string — The marketplace identifier. - `storeId` string — The Amazon-defined identifier for the region scope. - `buyer` Buyer — Information about the buyer. - `buyerId` string — The identifier of the buyer. - `name` string — The name of the buyer. - `phone` string — The phone number of the buyer. - `isPrimeMember` boolean — When true, the service is for an Amazon Prime buyer. - `associatedItems` AssociatedItem[] — A list of items associated with the service job. - `asin` string — The Amazon Standard Identification Number (ASIN) of the item. - `title` string — The title of the item. - `quantity` integer — The total number of items included in the order. - `orderId` string — The Amazon-defined identifier for an order placed by the buyer, in 3-7-7 format. - `itemStatus` 'ACTIVE' | 'CANCELLED' | 'SHIPPED' | 'DELIVERED' — The status of the item. - `brandName` string — The brand name of the item. - `itemDelivery` ItemDelivery — Delivery information for the item. - `estimatedDeliveryDate` string, date-time — The date and time of the latest Estimated Delivery Date (EDD) of all the items with an EDD. In ISO 8601 format. - `itemDeliveryPromise` ItemDeliveryPromise — Promised delivery information for the item. - `startTime` string, date-time — The date and time of the start of the promised delivery window in ISO 8601 format. - `endTime` string, date-time — The date and time of the end of the promised delivery window in ISO 8601 format. - `linkedAssets` LinkedAsset[] — A list of customer-owned assets on which the service must be performed. - `assetType` string — The type of the linked asset. For example: `VEHICLE`. - `assetName` string — The name of the linked asset. For example: `2024 Polaris Slingshot SLR AutoDrive`. - `additionalAttributes` object — Additional attributes of the linked asset, such as vehicle make, model, year, and engine details. - `serviceLocation` ServiceLocation — Information about the location of the service job. - `serviceLocationType` 'IN_HOME' | 'IN_STORE' | 'ONLINE' — The location of the service job. - `address` Address — Address of the party. - `name` string, required — The name of the person, business or institution at that address. - `addressLine1` string, required — First line of the address. - `addressLine2` string — Additional street address information, if required. - `addressLine3` string — Additional street address information, if required. - `city` string — The city where the person, business or institution is located. - `county` string — The county where person, business or institution is located. - `district` string — The district where person, business or institution is located. - `stateOrRegion` string — The state or region where person, business or institution is located. - `postalCode` string — The postal code of that address. It contains a series of letters or digits or both, sometimes including spaces or punctuation. - `countryCode` string, required — The two digit country code in ISO 3166-1 alpha-2 format. - `phone` string — The phone number of the person, business or institution located at that address. - `payments` Payment[] — A list that contains payment information for the service job. - `amount` MoneyAmount — The monetary amount and type of currency. - `value` number, required — The monetary value. - `currency` string, required — The currency code in ISO 4217 format. - `instrument` string — The payment instrument used for the transaction. - `errors` Error[] — A list of error responses returned when a request is unsuccessful. - `code` string, required — An error code that identifies the type of error that occurred. - `message` string, required — A message that describes the error condition. - `details` string — Additional details that can help the caller understand or fix the issue. ## Other responses - `400` — Request has missing or invalid parameters and cannot be parsed. - `403` — Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature. - `404` — The resource specified does not exist. - `413` — The request size exceeded the maximum accepted size. - `415` — The request payload is in an unsupported format. - `429` — The frequency of requests was greater than allowed. - `500` — An unexpected condition occurred that prevented the server from fulfilling the request. - `503` — Temporary overloading or maintenance of the server. --- [API](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01.md) · [All operations](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws-samples/a-content-management-v2020-11-01/revisions/815a5b6dbaa6/schema)