HomeDocumentationCode SamplesAnnouncementsModelsRelease NotesFAQVideos
Developer HubAPI StatusSupport
Documentation
Developer HubAPI StatusSupport

Data Kiosk Query Processing Finished Notification

Detailed information on the Data Kiosk Query Processing Finished Notification.

DATA_KIOSK_QUERY_PROCESSING_FINISHED

Sellers and vendors can subscribe to this notification.

The DATA_KIOSK_QUERY_PROCESSING_FINISHED notification is sent when a Data Kiosk query finishes processing.

DATA_KIOSK_QUERY_PROCESSING_FINISHED Payload schema: Version 2023-11-15

A DATA_KIOSK_QUERY_PROCESSING_FINISHED notification with payloadVersion = 2023-11-15 includes the following properties in the payload object:

Name Description Required
accountId The merchant customer ID or vendor group ID of the selling partner account that the query was submitted on behalf of.

Type: string

Yes
queryId The query identifier. This identifier is unique only in combination with the accountId.

Type: string

Yes
query The submitted query.

Type: string

Yes
processingStatus The processing status of the query.

Type: string

Yes
dataDocumentId The data document identifier. This document identifier is only present when there is data available as a result of the query. This identifier is unique only in combination with the accountId. Pass this identifier into the getDocument operation to get the information required to retrieve the data document's contents.

Type: string

No
errorDocumentId The error document identifier. This document identifier is only present when an error occurs during query processing. This identifier is unique only in combination with the accountId. Pass this identifier into the getDocument operation to get the information required to retrieve the error document's contents.

Type: string

No
pagination When a query produces results that are not included in the data document, pagination occurs. This means all results are divided into individual pages. To retrieve the next page, you must pass a CreateQuerySpecification object with paginationToken set to this object's nextToken and with query set to this object's query in the subsequent createQuery request. When there are no more pages to fetch, the nextToken field will be absent.

Type: Pagination

No

Pagination

Name Description Type
nextToken A token that can be used to fetch the next page of results. string

Notification schema: DataKioskQueryProcessingFinishedNotification.json

Notification example:

{
  "notificationVersion": "2023-11-15",
  "notificationType": "DATA_KIOSK_QUERY_PROCESSING_FINISHED",
  "payloadVersion": "2023-11-15",
  "eventTime": "2023-12-23T21:30:13.713Z",
  "payload": {
    "accountId": "amzn1.merchant.o.ABCD0123456789",
    "queryId": "54517018502",
    "query": "query MyQuery{salesAndTrafficByDate(startDate:\"2023-05-01\" endDate:\"2023-06-01\" aggregateBy:DAY){marketplaceId startDate endDate sales{unitsOrdered}traffic{pageViews}}}",
    "processingStatus": "DONE",
    "dataDocumentId": "amzn1.tortuga.3.edbcd0d8-3434-8222-1234-52ad8ade1208.REP4567URI9BMZ",
    "pagination": {
      "nextToken": "AAMA-EFRSURBSGhKZlpVSWVwOW96aU1xa2p6amVJdGp1YlZxMndOelFXa2hydStrUjZvVmFRRWVINldMNnFUVz"
    }
  },
  "notificationMetadata": {
    "applicationId": "amzn1.sellerapps.app.aacccfff-4455-4b7c-4422-664ecacdd336",
    "subscriptionId": "subscription-id-d0e9e693-c3ad-4373-979f-ed4ec98dd746",
    "publishTime": "2023-12-23T21:30:16.903Z",
    "notificationId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746"
  }
}