getServiceJobByServiceJobId

get https://sellingpartnerapi-na.amazon.com/service/v1/serviceJobs/{serviceJobId}

Gets details of service job indicated by the provided serviceJobID.

Usage Plan:

Rate (requests per second)	Burst
20	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.

Responses

Response body

object

payload

object

The job details of a service.

createTime

date-time

The date and time of the creation of the job in ISO 8601 format.

serviceJobId

string

length between 1 and 100

Amazon identifier for the service job.

serviceJobStatus

string

The status of the service job.

NOT_SERVICED CANCELLED COMPLETED PENDING_SCHEDULE NOT_FULFILLABLE HOLD PAYMENT_DECLINED

Show Details

NOT_SERVICED	Indicates that the service for the service job is not complete.
CANCELLED	Indicates that the service job is cancelled.
COMPLETED	Indicates that the service is performed and the service job is closed successfully.
PENDING_SCHEDULE	Indicates that an appointment for the service job has not been scheduled.
NOT_FULFILLABLE	Indicates that the service job is not actionable due to an unexpected exception.
HOLD	Indicates that the appointment time preference given by customer cannot be serviced by the service provider.
PAYMENT_DECLINED	Indicates that the customer payment has been declined.

scopeOfWork

object

The scope of work for the order.

seller

object

Information about the seller of the service job.

serviceJobProvider

object

Information about the service job provider.

preferredAppointmentTimes

array of objects

A list of appointment windows preferred by the buyer. Included only if the buyer selected appointment windows when creating the order.

preferredAppointmentTimes

object

startTime

date-time

required

The date and time of the start of the appointment window in ISO 8601 format.

durationInMinutes

integer

required

≥ 1

The duration of the appointment window, in minutes.

appointments

array of objects

A list of appointments.

appointments

object

appointmentId

string

length between 5 and 100

The appointment identifier.

appointmentStatus

string

The status of the appointment.

ACTIVE CANCELLED COMPLETED

Show Details

ACTIVE	Indicates that an appointment is scheduled.
CANCELLED	Indicates that the appointment is cancelled.
COMPLETED	Indicates that the appointment is completed.

appointmentTime

object

The time of the appointment window.

assignedTechnicians

array of objects

length ≥ 1

A list of technicians assigned to the service job.

assignedTechnicians

object

technicianId

string

length between 1 and 50

The technician identifier.

name

string

The name of the technician.

rescheduledAppointmentId

string

length between 5 and 100

The appointment identifier.

poa

object

Proof of Appointment (POA) details.

serviceOrderId

string

length between 5 and 20

The Amazon-defined identifier for an order placed by the buyer, in 3-7-7 format.

marketplaceId

string

The marketplace identifier.

storeId

string

length between 1 and 100

The Amazon-defined identifier for the region scope.

buyer

object

Information about the buyer.

associatedItems

array of objects

A list of items associated with the service job.

associatedItems

object

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

length between 5 and 20

The Amazon-defined identifier for an order placed by the buyer, in 3-7-7 format.

itemStatus

string

The status of the item.

ACTIVE CANCELLED SHIPPED DELIVERED

Show Details

ACTIVE	Indicates the item is yet to be shipped.
CANCELLED	Indicates the item has been cancelled.
SHIPPED	Indicates the item is shipped but not delivered.
DELIVERED	Indicates the item is delivered.

brandName

string

The brand name of the item.

itemDelivery

object

Delivery information for the item.

serviceLocation

object

Information about the location of the service job.

errors

array of objects

A list of error responses returned when a request is unsuccessful.

errors

object

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.

errorLevel

string

The type of error.

ERROR WARNING

Show Details

ERROR	Error
WARNING	Warning

Headers

object

x-amzn-RateLimit-Limit

string

Your rate limit (requests per second) for this operation.

x-amzn-RequestId

string

Unique request reference identifier.

Response body

object

payload

object

The job details of a service.

createTime

date-time

The date and time of the creation of the job in ISO 8601 format.

serviceJobId

string

length between 1 and 100

Amazon identifier for the service job.

serviceJobStatus

string

The status of the service job.

NOT_SERVICED CANCELLED COMPLETED PENDING_SCHEDULE NOT_FULFILLABLE HOLD PAYMENT_DECLINED

Show Details

NOT_SERVICED	Indicates that the service for the service job is not complete.
CANCELLED	Indicates that the service job is cancelled.
COMPLETED	Indicates that the service is performed and the service job is closed successfully.
PENDING_SCHEDULE	Indicates that an appointment for the service job has not been scheduled.
NOT_FULFILLABLE	Indicates that the service job is not actionable due to an unexpected exception.
HOLD	Indicates that the appointment time preference given by customer cannot be serviced by the service provider.
PAYMENT_DECLINED	Indicates that the customer payment has been declined.

scopeOfWork

object

The scope of work for the order.

seller

object

Information about the seller of the service job.

serviceJobProvider

object

Information about the service job provider.

preferredAppointmentTimes

array of objects

A list of appointment windows preferred by the buyer. Included only if the buyer selected appointment windows when creating the order.

preferredAppointmentTimes

object

startTime

date-time

required

The date and time of the start of the appointment window in ISO 8601 format.

durationInMinutes

integer

required

≥ 1

The duration of the appointment window, in minutes.

appointments

array of objects

A list of appointments.

appointments

object

appointmentId

string

length between 5 and 100

The appointment identifier.

appointmentStatus

string

The status of the appointment.

ACTIVE CANCELLED COMPLETED

Show Details

ACTIVE	Indicates that an appointment is scheduled.
CANCELLED	Indicates that the appointment is cancelled.
COMPLETED	Indicates that the appointment is completed.

appointmentTime

object

The time of the appointment window.

assignedTechnicians

array of objects

length ≥ 1

A list of technicians assigned to the service job.

assignedTechnicians

object

technicianId

string

length between 1 and 50

The technician identifier.

name

string

The name of the technician.

rescheduledAppointmentId

string

length between 5 and 100

The appointment identifier.

poa

object

Proof of Appointment (POA) details.

serviceOrderId

string

length between 5 and 20

The Amazon-defined identifier for an order placed by the buyer, in 3-7-7 format.

marketplaceId

string

The marketplace identifier.

storeId

string

length between 1 and 100

The Amazon-defined identifier for the region scope.

buyer

object

Information about the buyer.

associatedItems

array of objects

A list of items associated with the service job.

associatedItems

object

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

length between 5 and 20

The Amazon-defined identifier for an order placed by the buyer, in 3-7-7 format.

itemStatus

string

The status of the item.

ACTIVE CANCELLED SHIPPED DELIVERED

Show Details

ACTIVE	Indicates the item is yet to be shipped.
CANCELLED	Indicates the item has been cancelled.
SHIPPED	Indicates the item is shipped but not delivered.
DELIVERED	Indicates the item is delivered.

brandName

string

The brand name of the item.

itemDelivery

object

Delivery information for the item.

serviceLocation

object

Information about the location of the service job.

errors

array of objects

A list of error responses returned when a request is unsuccessful.

errors

object

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.

errorLevel

string

The type of error.

ERROR WARNING

Show Details

ERROR	Error
WARNING	Warning

Headers

object

x-amzn-RateLimit-Limit

string

Your rate limit (requests per second) for this operation.

x-amzn-RequestId

string

Unique request reference identifier.

Response body

object

payload

object

The job details of a service.

createTime

date-time

The date and time of the creation of the job in ISO 8601 format.

serviceJobId

string

length between 1 and 100

Amazon identifier for the service job.

serviceJobStatus

string

The status of the service job.

NOT_SERVICED CANCELLED COMPLETED PENDING_SCHEDULE NOT_FULFILLABLE HOLD PAYMENT_DECLINED

Show Details

NOT_SERVICED	Indicates that the service for the service job is not complete.
CANCELLED	Indicates that the service job is cancelled.
COMPLETED	Indicates that the service is performed and the service job is closed successfully.
PENDING_SCHEDULE	Indicates that an appointment for the service job has not been scheduled.
NOT_FULFILLABLE	Indicates that the service job is not actionable due to an unexpected exception.
HOLD	Indicates that the appointment time preference given by customer cannot be serviced by the service provider.
PAYMENT_DECLINED	Indicates that the customer payment has been declined.

scopeOfWork

object

The scope of work for the order.

seller

object

Information about the seller of the service job.

serviceJobProvider

object

Information about the service job provider.

preferredAppointmentTimes

array of objects

A list of appointment windows preferred by the buyer. Included only if the buyer selected appointment windows when creating the order.

preferredAppointmentTimes

object

startTime

date-time

required

The date and time of the start of the appointment window in ISO 8601 format.

durationInMinutes

integer

required

≥ 1

The duration of the appointment window, in minutes.

appointments

array of objects

A list of appointments.

appointments

object

appointmentId

string

length between 5 and 100

The appointment identifier.

appointmentStatus

string

The status of the appointment.

ACTIVE CANCELLED COMPLETED

Show Details

ACTIVE	Indicates that an appointment is scheduled.
CANCELLED	Indicates that the appointment is cancelled.
COMPLETED	Indicates that the appointment is completed.

appointmentTime

object

The time of the appointment window.

assignedTechnicians

array of objects

length ≥ 1

A list of technicians assigned to the service job.

assignedTechnicians

object

technicianId

string

length between 1 and 50

The technician identifier.

name

string

The name of the technician.

rescheduledAppointmentId

string

length between 5 and 100

The appointment identifier.

poa

object

Proof of Appointment (POA) details.

serviceOrderId

string

length between 5 and 20

The Amazon-defined identifier for an order placed by the buyer, in 3-7-7 format.

marketplaceId

string

The marketplace identifier.

storeId

string

length between 1 and 100

The Amazon-defined identifier for the region scope.

buyer

object

Information about the buyer.

associatedItems

array of objects

A list of items associated with the service job.

associatedItems

object

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

length between 5 and 20

The Amazon-defined identifier for an order placed by the buyer, in 3-7-7 format.

itemStatus

string

The status of the item.

ACTIVE CANCELLED SHIPPED DELIVERED

Show Details

ACTIVE	Indicates the item is yet to be shipped.
CANCELLED	Indicates the item has been cancelled.
SHIPPED	Indicates the item is shipped but not delivered.
DELIVERED	Indicates the item is delivered.

brandName

string

The brand name of the item.

itemDelivery

object

Delivery information for the item.

serviceLocation

object

Information about the location of the service job.

errors

array of objects

A list of error responses returned when a request is unsuccessful.

errors

object

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.

errorLevel

string

The type of error.

ERROR WARNING

Show Details

ERROR	Error
WARNING	Warning

Headers

object

x-amzn-RequestId

string

Unique request reference identifier.

Response body

object

payload

object

The job details of a service.

createTime

date-time

The date and time of the creation of the job in ISO 8601 format.

serviceJobId

string

length between 1 and 100

Amazon identifier for the service job.

serviceJobStatus

string

The status of the service job.

NOT_SERVICED CANCELLED COMPLETED PENDING_SCHEDULE NOT_FULFILLABLE HOLD PAYMENT_DECLINED

Show Details

NOT_SERVICED	Indicates that the service for the service job is not complete.
CANCELLED	Indicates that the service job is cancelled.
COMPLETED	Indicates that the service is performed and the service job is closed successfully.
PENDING_SCHEDULE	Indicates that an appointment for the service job has not been scheduled.
NOT_FULFILLABLE	Indicates that the service job is not actionable due to an unexpected exception.
HOLD	Indicates that the appointment time preference given by customer cannot be serviced by the service provider.
PAYMENT_DECLINED	Indicates that the customer payment has been declined.

scopeOfWork

object

The scope of work for the order.

seller

object

Information about the seller of the service job.

serviceJobProvider

object

Information about the service job provider.

preferredAppointmentTimes

array of objects

A list of appointment windows preferred by the buyer. Included only if the buyer selected appointment windows when creating the order.

preferredAppointmentTimes

object

startTime

date-time

required

The date and time of the start of the appointment window in ISO 8601 format.

durationInMinutes

integer

required

≥ 1

The duration of the appointment window, in minutes.

appointments

array of objects

A list of appointments.

appointments

object

appointmentId

string

length between 5 and 100

The appointment identifier.

appointmentStatus

string

The status of the appointment.

ACTIVE CANCELLED COMPLETED

Show Details

ACTIVE	Indicates that an appointment is scheduled.
CANCELLED	Indicates that the appointment is cancelled.
COMPLETED	Indicates that the appointment is completed.

appointmentTime

object

The time of the appointment window.

assignedTechnicians

array of objects

length ≥ 1

A list of technicians assigned to the service job.

assignedTechnicians

object

technicianId

string

length between 1 and 50

The technician identifier.

name

string

The name of the technician.

rescheduledAppointmentId

string

length between 5 and 100

The appointment identifier.

poa

object

Proof of Appointment (POA) details.

serviceOrderId

string

length between 5 and 20

The Amazon-defined identifier for an order placed by the buyer, in 3-7-7 format.

marketplaceId

string

The marketplace identifier.

storeId

string

length between 1 and 100

The Amazon-defined identifier for the region scope.

buyer

object

Information about the buyer.

associatedItems

array of objects

A list of items associated with the service job.

associatedItems

object

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

length between 5 and 20

The Amazon-defined identifier for an order placed by the buyer, in 3-7-7 format.

itemStatus

string

The status of the item.

ACTIVE CANCELLED SHIPPED DELIVERED

Show Details

ACTIVE	Indicates the item is yet to be shipped.
CANCELLED	Indicates the item has been cancelled.
SHIPPED	Indicates the item is shipped but not delivered.
DELIVERED	Indicates the item is delivered.

brandName

string

The brand name of the item.

itemDelivery

object

Delivery information for the item.

serviceLocation

object

Information about the location of the service job.

errors

array of objects

A list of error responses returned when a request is unsuccessful.

errors

object

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.

errorLevel

string

The type of error.

ERROR WARNING

Show Details

ERROR	Error
WARNING	Warning

Headers

object

x-amzn-RateLimit-Limit

string

Your rate limit (requests per second) for this operation.

x-amzn-RequestId

string

Unique request reference identifier.

Response body

object

payload

object

The job details of a service.

createTime

date-time

The date and time of the creation of the job in ISO 8601 format.

serviceJobId

string

length between 1 and 100

Amazon identifier for the service job.

serviceJobStatus

string

The status of the service job.

NOT_SERVICED CANCELLED COMPLETED PENDING_SCHEDULE NOT_FULFILLABLE HOLD PAYMENT_DECLINED

Show Details

NOT_SERVICED	Indicates that the service for the service job is not complete.
CANCELLED	Indicates that the service job is cancelled.
COMPLETED	Indicates that the service is performed and the service job is closed successfully.
PENDING_SCHEDULE	Indicates that an appointment for the service job has not been scheduled.
NOT_FULFILLABLE	Indicates that the service job is not actionable due to an unexpected exception.
HOLD	Indicates that the appointment time preference given by customer cannot be serviced by the service provider.
PAYMENT_DECLINED	Indicates that the customer payment has been declined.

scopeOfWork

object

The scope of work for the order.

seller

object

Information about the seller of the service job.

serviceJobProvider

object

Information about the service job provider.

preferredAppointmentTimes

array of objects

A list of appointment windows preferred by the buyer. Included only if the buyer selected appointment windows when creating the order.

preferredAppointmentTimes

object

startTime

date-time

required

The date and time of the start of the appointment window in ISO 8601 format.

durationInMinutes

integer

required

≥ 1

The duration of the appointment window, in minutes.

appointments

array of objects

A list of appointments.

appointments

object

appointmentId

string

length between 5 and 100

The appointment identifier.

appointmentStatus

string

The status of the appointment.

ACTIVE CANCELLED COMPLETED

Show Details

ACTIVE	Indicates that an appointment is scheduled.
CANCELLED	Indicates that the appointment is cancelled.
COMPLETED	Indicates that the appointment is completed.

appointmentTime

object

The time of the appointment window.

assignedTechnicians

array of objects

length ≥ 1

A list of technicians assigned to the service job.

assignedTechnicians

object

technicianId

string

length between 1 and 50

The technician identifier.

name

string

The name of the technician.

rescheduledAppointmentId

string

length between 5 and 100

The appointment identifier.

poa

object

Proof of Appointment (POA) details.

serviceOrderId

string

length between 5 and 20

The Amazon-defined identifier for an order placed by the buyer, in 3-7-7 format.

marketplaceId

string

The marketplace identifier.

storeId

string

length between 1 and 100

The Amazon-defined identifier for the region scope.

buyer

object

Information about the buyer.

associatedItems

array of objects

A list of items associated with the service job.

associatedItems

object

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

length between 5 and 20

The Amazon-defined identifier for an order placed by the buyer, in 3-7-7 format.

itemStatus

string

The status of the item.

ACTIVE CANCELLED SHIPPED DELIVERED

Show Details

ACTIVE	Indicates the item is yet to be shipped.
CANCELLED	Indicates the item has been cancelled.
SHIPPED	Indicates the item is shipped but not delivered.
DELIVERED	Indicates the item is delivered.

brandName

string

The brand name of the item.

itemDelivery

object

Delivery information for the item.

serviceLocation

object

Information about the location of the service job.

errors

array of objects

A list of error responses returned when a request is unsuccessful.

errors

object

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.

errorLevel

string

The type of error.

ERROR WARNING

Show Details

ERROR	Error
WARNING	Warning

Headers

object

x-amzn-RateLimit-Limit

string

Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.

x-amzn-RequestId

string

Unique request reference identifier.

Response body

object

payload

object

The job details of a service.

createTime

date-time

The date and time of the creation of the job in ISO 8601 format.

serviceJobId

string

length between 1 and 100

Amazon identifier for the service job.

serviceJobStatus

string

The status of the service job.

NOT_SERVICED CANCELLED COMPLETED PENDING_SCHEDULE NOT_FULFILLABLE HOLD PAYMENT_DECLINED

Show Details

NOT_SERVICED	Indicates that the service for the service job is not complete.
CANCELLED	Indicates that the service job is cancelled.
COMPLETED	Indicates that the service is performed and the service job is closed successfully.
PENDING_SCHEDULE	Indicates that an appointment for the service job has not been scheduled.
NOT_FULFILLABLE	Indicates that the service job is not actionable due to an unexpected exception.
HOLD	Indicates that the appointment time preference given by customer cannot be serviced by the service provider.
PAYMENT_DECLINED	Indicates that the customer payment has been declined.

scopeOfWork

object

The scope of work for the order.

seller

object

Information about the seller of the service job.

serviceJobProvider

object

Information about the service job provider.

preferredAppointmentTimes

array of objects

A list of appointment windows preferred by the buyer. Included only if the buyer selected appointment windows when creating the order.

preferredAppointmentTimes

object

startTime

date-time

required

The date and time of the start of the appointment window in ISO 8601 format.

durationInMinutes

integer

required

≥ 1

The duration of the appointment window, in minutes.

appointments

array of objects

A list of appointments.

appointments

object

appointmentId

string

length between 5 and 100

The appointment identifier.

appointmentStatus

string

The status of the appointment.

ACTIVE CANCELLED COMPLETED

Show Details

ACTIVE	Indicates that an appointment is scheduled.
CANCELLED	Indicates that the appointment is cancelled.
COMPLETED	Indicates that the appointment is completed.

appointmentTime

object

The time of the appointment window.

assignedTechnicians

array of objects

length ≥ 1

A list of technicians assigned to the service job.

assignedTechnicians

object

technicianId

string

length between 1 and 50

The technician identifier.

name

string

The name of the technician.

rescheduledAppointmentId

string

length between 5 and 100

The appointment identifier.

poa

object

Proof of Appointment (POA) details.

serviceOrderId

string

length between 5 and 20

The Amazon-defined identifier for an order placed by the buyer, in 3-7-7 format.

marketplaceId

string

The marketplace identifier.

storeId

string

length between 1 and 100

The Amazon-defined identifier for the region scope.

buyer

object

Information about the buyer.

associatedItems

array of objects

A list of items associated with the service job.

associatedItems

object

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

length between 5 and 20

The Amazon-defined identifier for an order placed by the buyer, in 3-7-7 format.

itemStatus

string

The status of the item.

ACTIVE CANCELLED SHIPPED DELIVERED

Show Details

ACTIVE	Indicates the item is yet to be shipped.
CANCELLED	Indicates the item has been cancelled.
SHIPPED	Indicates the item is shipped but not delivered.
DELIVERED	Indicates the item is delivered.

brandName

string

The brand name of the item.

itemDelivery

object

Delivery information for the item.

serviceLocation

object

Information about the location of the service job.

errors

array of objects

A list of error responses returned when a request is unsuccessful.

errors

object

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.

errorLevel

string

The type of error.

ERROR WARNING

Show Details

ERROR	Error
WARNING	Warning

Headers

object

x-amzn-RateLimit-Limit

string

Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.

x-amzn-RequestId

string

Unique request reference identifier.

Response body

object

payload

object

The job details of a service.

createTime

date-time

The date and time of the creation of the job in ISO 8601 format.

serviceJobId

string

length between 1 and 100

Amazon identifier for the service job.

serviceJobStatus

string

The status of the service job.

NOT_SERVICED CANCELLED COMPLETED PENDING_SCHEDULE NOT_FULFILLABLE HOLD PAYMENT_DECLINED

Show Details

NOT_SERVICED	Indicates that the service for the service job is not complete.
CANCELLED	Indicates that the service job is cancelled.
COMPLETED	Indicates that the service is performed and the service job is closed successfully.
PENDING_SCHEDULE	Indicates that an appointment for the service job has not been scheduled.
NOT_FULFILLABLE	Indicates that the service job is not actionable due to an unexpected exception.
HOLD	Indicates that the appointment time preference given by customer cannot be serviced by the service provider.
PAYMENT_DECLINED	Indicates that the customer payment has been declined.

scopeOfWork

object

The scope of work for the order.

seller

object

Information about the seller of the service job.

serviceJobProvider

object

Information about the service job provider.

preferredAppointmentTimes

array of objects

A list of appointment windows preferred by the buyer. Included only if the buyer selected appointment windows when creating the order.

preferredAppointmentTimes

object

startTime

date-time

required

The date and time of the start of the appointment window in ISO 8601 format.

durationInMinutes

integer

required

≥ 1

The duration of the appointment window, in minutes.

appointments

array of objects

A list of appointments.

appointments

object

appointmentId

string

length between 5 and 100

The appointment identifier.

appointmentStatus

string

The status of the appointment.

ACTIVE CANCELLED COMPLETED

Show Details

ACTIVE	Indicates that an appointment is scheduled.
CANCELLED	Indicates that the appointment is cancelled.
COMPLETED	Indicates that the appointment is completed.

appointmentTime

object

The time of the appointment window.

assignedTechnicians

array of objects

length ≥ 1

A list of technicians assigned to the service job.

assignedTechnicians

object

technicianId

string

length between 1 and 50

The technician identifier.

name

string

The name of the technician.

rescheduledAppointmentId

string

length between 5 and 100

The appointment identifier.

poa

object

Proof of Appointment (POA) details.

serviceOrderId

string

length between 5 and 20

The Amazon-defined identifier for an order placed by the buyer, in 3-7-7 format.

marketplaceId

string

The marketplace identifier.

storeId

string

length between 1 and 100

The Amazon-defined identifier for the region scope.

buyer

object

Information about the buyer.

associatedItems

array of objects

A list of items associated with the service job.

associatedItems

object

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

length between 5 and 20

The Amazon-defined identifier for an order placed by the buyer, in 3-7-7 format.

itemStatus

string

The status of the item.

ACTIVE CANCELLED SHIPPED DELIVERED

Show Details

ACTIVE	Indicates the item is yet to be shipped.
CANCELLED	Indicates the item has been cancelled.
SHIPPED	Indicates the item is shipped but not delivered.
DELIVERED	Indicates the item is delivered.

brandName

string

The brand name of the item.

itemDelivery

object

Delivery information for the item.

serviceLocation

object

Information about the location of the service job.

errors

array of objects

A list of error responses returned when a request is unsuccessful.

errors

object

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.

errorLevel

string

The type of error.

ERROR WARNING

Show Details

ERROR	Error
WARNING	Warning

Headers

object

x-amzn-RateLimit-Limit

string

Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.

x-amzn-RequestId

string

Unique request reference identifier.

Response body

object

payload

object

The job details of a service.

createTime

date-time

The date and time of the creation of the job in ISO 8601 format.

serviceJobId

string

length between 1 and 100

Amazon identifier for the service job.

serviceJobStatus

string

The status of the service job.

NOT_SERVICED CANCELLED COMPLETED PENDING_SCHEDULE NOT_FULFILLABLE HOLD PAYMENT_DECLINED

Show Details

NOT_SERVICED	Indicates that the service for the service job is not complete.
CANCELLED	Indicates that the service job is cancelled.
COMPLETED	Indicates that the service is performed and the service job is closed successfully.
PENDING_SCHEDULE	Indicates that an appointment for the service job has not been scheduled.
NOT_FULFILLABLE	Indicates that the service job is not actionable due to an unexpected exception.
HOLD	Indicates that the appointment time preference given by customer cannot be serviced by the service provider.
PAYMENT_DECLINED	Indicates that the customer payment has been declined.

scopeOfWork

object

The scope of work for the order.

seller

object

Information about the seller of the service job.

serviceJobProvider

object

Information about the service job provider.

preferredAppointmentTimes

array of objects

A list of appointment windows preferred by the buyer. Included only if the buyer selected appointment windows when creating the order.

preferredAppointmentTimes

object

startTime

date-time

required

The date and time of the start of the appointment window in ISO 8601 format.

durationInMinutes

integer

required

≥ 1

The duration of the appointment window, in minutes.

appointments

array of objects

A list of appointments.

appointments

object

appointmentId

string

length between 5 and 100

The appointment identifier.

appointmentStatus

string

The status of the appointment.

ACTIVE CANCELLED COMPLETED

Show Details

ACTIVE	Indicates that an appointment is scheduled.
CANCELLED	Indicates that the appointment is cancelled.
COMPLETED	Indicates that the appointment is completed.

appointmentTime

object

The time of the appointment window.

assignedTechnicians

array of objects

length ≥ 1

A list of technicians assigned to the service job.

assignedTechnicians

object

technicianId

string

length between 1 and 50

The technician identifier.

name

string

The name of the technician.

rescheduledAppointmentId

string

length between 5 and 100

The appointment identifier.

poa

object

Proof of Appointment (POA) details.

serviceOrderId

string

length between 5 and 20

The Amazon-defined identifier for an order placed by the buyer, in 3-7-7 format.

marketplaceId

string

The marketplace identifier.

storeId

string

length between 1 and 100

The Amazon-defined identifier for the region scope.

buyer

object

Information about the buyer.

associatedItems

array of objects

A list of items associated with the service job.

associatedItems

object

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

length between 5 and 20

The Amazon-defined identifier for an order placed by the buyer, in 3-7-7 format.

itemStatus

string

The status of the item.

ACTIVE CANCELLED SHIPPED DELIVERED

Show Details

ACTIVE	Indicates the item is yet to be shipped.
CANCELLED	Indicates the item has been cancelled.
SHIPPED	Indicates the item is shipped but not delivered.
DELIVERED	Indicates the item is delivered.

brandName

string

The brand name of the item.

itemDelivery

object

Delivery information for the item.

serviceLocation

object

Information about the location of the service job.

errors

array of objects

A list of error responses returned when a request is unsuccessful.

errors

object

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.

errorLevel

string

The type of error.

ERROR WARNING

Show Details

ERROR	Error
WARNING	Warning

Headers

object

x-amzn-RateLimit-Limit

string

Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.

x-amzn-RequestId

string

Unique request reference identifier.

Response body

object

payload

object

The job details of a service.

createTime

date-time

The date and time of the creation of the job in ISO 8601 format.

serviceJobId

string

length between 1 and 100

Amazon identifier for the service job.

serviceJobStatus

string

The status of the service job.

NOT_SERVICED CANCELLED COMPLETED PENDING_SCHEDULE NOT_FULFILLABLE HOLD PAYMENT_DECLINED

Show Details

NOT_SERVICED	Indicates that the service for the service job is not complete.
CANCELLED	Indicates that the service job is cancelled.
COMPLETED	Indicates that the service is performed and the service job is closed successfully.
PENDING_SCHEDULE	Indicates that an appointment for the service job has not been scheduled.
NOT_FULFILLABLE	Indicates that the service job is not actionable due to an unexpected exception.
HOLD	Indicates that the appointment time preference given by customer cannot be serviced by the service provider.
PAYMENT_DECLINED	Indicates that the customer payment has been declined.

scopeOfWork

object

The scope of work for the order.

seller

object

Information about the seller of the service job.

serviceJobProvider

object

Information about the service job provider.

preferredAppointmentTimes

array of objects

A list of appointment windows preferred by the buyer. Included only if the buyer selected appointment windows when creating the order.

preferredAppointmentTimes

object

startTime

date-time

required

The date and time of the start of the appointment window in ISO 8601 format.

durationInMinutes

integer

required

≥ 1

The duration of the appointment window, in minutes.

appointments

array of objects

A list of appointments.

appointments

object

appointmentId

string

length between 5 and 100

The appointment identifier.

appointmentStatus

string

The status of the appointment.

ACTIVE CANCELLED COMPLETED

Show Details

ACTIVE	Indicates that an appointment is scheduled.
CANCELLED	Indicates that the appointment is cancelled.
COMPLETED	Indicates that the appointment is completed.

appointmentTime

object

The time of the appointment window.

assignedTechnicians

array of objects

length ≥ 1

A list of technicians assigned to the service job.

assignedTechnicians

object

technicianId

string

length between 1 and 50

The technician identifier.

name

string

The name of the technician.

rescheduledAppointmentId

string

length between 5 and 100

The appointment identifier.

poa

object

Proof of Appointment (POA) details.

serviceOrderId

string

length between 5 and 20

The Amazon-defined identifier for an order placed by the buyer, in 3-7-7 format.

marketplaceId

string

The marketplace identifier.

storeId

string

length between 1 and 100

The Amazon-defined identifier for the region scope.

buyer

object

Information about the buyer.

associatedItems

array of objects

A list of items associated with the service job.

associatedItems

object

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

length between 5 and 20

The Amazon-defined identifier for an order placed by the buyer, in 3-7-7 format.

itemStatus

string

The status of the item.

ACTIVE CANCELLED SHIPPED DELIVERED

Show Details

ACTIVE	Indicates the item is yet to be shipped.
CANCELLED	Indicates the item has been cancelled.
SHIPPED	Indicates the item is shipped but not delivered.
DELIVERED	Indicates the item is delivered.

brandName

string

The brand name of the item.

itemDelivery

object

Delivery information for the item.

serviceLocation

object

Information about the location of the service job.

errors

array of objects

A list of error responses returned when a request is unsuccessful.

errors

object

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.

errorLevel

string

The type of error.

ERROR WARNING

Show Details

ERROR	Error
WARNING	Warning

Headers

object

x-amzn-RateLimit-Limit

string

Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.

x-amzn-RequestId

string

Unique request reference identifier.

Response body

object

payload

object

The job details of a service.

createTime

date-time

The date and time of the creation of the job in ISO 8601 format.

serviceJobId

string

length between 1 and 100

Amazon identifier for the service job.

serviceJobStatus

string

The status of the service job.

NOT_SERVICED CANCELLED COMPLETED PENDING_SCHEDULE NOT_FULFILLABLE HOLD PAYMENT_DECLINED

Show Details

NOT_SERVICED	Indicates that the service for the service job is not complete.
CANCELLED	Indicates that the service job is cancelled.
COMPLETED	Indicates that the service is performed and the service job is closed successfully.
PENDING_SCHEDULE	Indicates that an appointment for the service job has not been scheduled.
NOT_FULFILLABLE	Indicates that the service job is not actionable due to an unexpected exception.
HOLD	Indicates that the appointment time preference given by customer cannot be serviced by the service provider.
PAYMENT_DECLINED	Indicates that the customer payment has been declined.

scopeOfWork

object

The scope of work for the order.

seller

object

Information about the seller of the service job.

serviceJobProvider

object

Information about the service job provider.

preferredAppointmentTimes

array of objects

A list of appointment windows preferred by the buyer. Included only if the buyer selected appointment windows when creating the order.

preferredAppointmentTimes

object

startTime

date-time

required

The date and time of the start of the appointment window in ISO 8601 format.

durationInMinutes

integer

required

≥ 1

The duration of the appointment window, in minutes.

appointments

array of objects

A list of appointments.

appointments

object

appointmentId

string

length between 5 and 100

The appointment identifier.

appointmentStatus

string

The status of the appointment.

ACTIVE CANCELLED COMPLETED

Show Details

ACTIVE	Indicates that an appointment is scheduled.
CANCELLED	Indicates that the appointment is cancelled.
COMPLETED	Indicates that the appointment is completed.

appointmentTime

object

The time of the appointment window.

assignedTechnicians

array of objects

length ≥ 1

A list of technicians assigned to the service job.

assignedTechnicians

object

technicianId

string

length between 1 and 50

The technician identifier.

name

string

The name of the technician.

rescheduledAppointmentId

string

length between 5 and 100

The appointment identifier.

poa

object

Proof of Appointment (POA) details.

serviceOrderId

string

length between 5 and 20

The Amazon-defined identifier for an order placed by the buyer, in 3-7-7 format.

marketplaceId

string

The marketplace identifier.

storeId

string

length between 1 and 100

The Amazon-defined identifier for the region scope.

buyer

object

Information about the buyer.

associatedItems

array of objects

A list of items associated with the service job.

associatedItems

object

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

length between 5 and 20

The Amazon-defined identifier for an order placed by the buyer, in 3-7-7 format.

itemStatus

string

The status of the item.

ACTIVE CANCELLED SHIPPED DELIVERED

Show Details

ACTIVE	Indicates the item is yet to be shipped.
CANCELLED	Indicates the item has been cancelled.
SHIPPED	Indicates the item is shipped but not delivered.
DELIVERED	Indicates the item is delivered.

brandName

string

The brand name of the item.

itemDelivery

object

Delivery information for the item.

serviceLocation

object

Information about the location of the service job.

errors

array of objects

A list of error responses returned when a request is unsuccessful.

errors

object

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.

errorLevel

string

The type of error.

ERROR WARNING

Show Details

ERROR	Error
WARNING	Warning

Headers

object

x-amzn-RateLimit-Limit

string

Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.

x-amzn-RequestId

string

Unique request reference identifier.

Language


xxxxxxxxxx
1
curl --request GET \
2
     --url https://sellingpartnerapi-na.amazon.com/service/v1/serviceJobs/serviceJobId \
3
     --header 'accept: application/json'


xxxxxxxxxx
109
}
1
{
2
  "payload": {
3
    "createTime": "2025-04-01T21:58:13.430Z",
4
    "serviceJobId": "string",
5
    "serviceJobStatus": "NOT_SERVICED",
6
    "scopeOfWork": {
7
      "asin": "string",
8
      "title": "string",
9
      "quantity": 0,
10
      "requiredSkills": [
11
        "string"
12
      ]
13
    },
14
    "seller": {
15
      "sellerId": "string"
16
    },
17
    "serviceJobProvider": {
18
      "serviceJobProviderId": "string"
19
    },
20
    "preferredAppointmentTimes": [
21
      {
22
        "startTime": "2025-04-01T21:58:13.430Z",
23
        "durationInMinutes": 0
24
      }
25
    ],

200Success response.

400Request has missing or invalid parameters and cannot be parsed.

403Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.

404The resource specified does not exist.

413The request size exceeded the maximum accepted size.

415The request payload is in an unsupported format.

422Unprocessable Entity. Unable to process the contained instructions.

429The frequency of requests was greater than allowed.

500An unexpected condition occurred that prevented the server from fulfilling the request.

503Temporary overloading or maintenance of the server.