Skip to main content
GET
/
notifications
List notifications
curl --request GET \
  --url https://api.quivo.co/notifications
[
  {
    "severityLevel": "INFO",
    "id": 123,
    "hash": "<string>",
    "message": "<string>",
    "lastOccurrence": "2023-11-07T05:31:56Z",
    "sort": {
      "short": true,
      "nodeType": "ARRAY",
      "float": true,
      "binary": true,
      "number": true,
      "integralNumber": true,
      "boolean": true,
      "double": true,
      "long": true,
      "int": true,
      "valueNode": true,
      "containerNode": true,
      "missingNode": true,
      "object": true,
      "pojo": true,
      "floatingPointNumber": true,
      "bigDecimal": true,
      "bigInteger": true,
      "textual": true,
      "array": true,
      "null": true
    },
    "notificationType": "UNKNOWN_SKU_IN_ORDER",
    "contents": [
      {
        "language": "DE",
        "title": "<string>"
      }
    ]
  }
]

Query Parameters

​
query
string

Search query string used to filter results. This field supports specific syntax for filtering across multiple fields.

​
sort
string

Optional sorting criteria for the results. Format is typically 'field:direction' (e.g., 'created:desc').

​
page
integer<int64>

The page number to retrieve when using offset-based pagination. Ignored if 'searchAfter' is provided.

​
searchAfter
string

Used for cursor-based pagination. Pass the 'sort' key value from the last item of the previous page to retrieve the next set of results efficiently. Overrides 'page'.

​
pageSize
integer<int64>

The maximum number of items to return per page. Used for both offset and cursor-based pagination.

Response

Returns an array of notifications for the authenticated user with read status and details.

​
severityLevel
enum<string>
required

The severity level. Possible values: INFO, WARNING, ERROR, URGENT, UPDATES

Available options:
INFO,
WARNING,
ERROR,
URGENT,
UPDATES
​
id
integer<int64>

The unique identifier for the id

​
hash
string

The hash value

​
message
string

Message content

​
lastOccurrence
string<date-time>

The last occurrence timestamp

​
sort
object

The

​
notificationType
enum<string>

The type or category of the notification

Available options:
UNKNOWN_SKU_IN_ORDER,
ORDER_CANCELLATION_FAILED,
AMAZON_PARTNERED_CARRIER,
INVALID_ORDER_IDENTIFIER,
MISSING_ORDER_INFORMATION,
COMPLETING_ORDER_FORCEFULLY,
ADDRESS_VERIFICATION_FAILED,
ORDERS_OUT_OF_STOCK,
RESTRICTIVE_SHIPMENT,
NEW_RETURN,
STOCK_BELOW_THRESHOLD,
MULTIPLE_STOCK_QUANT_IDS,
ITEM_NOT_STOCKED_AT_SHOP,
INBOUND_COMPLETED,
INBOUND_SHIPMENT_ARRIVED,
INBOUND_STATUS_CHANGE,
INBOUND_UNKNOWN_SKU,
INBOUND_INFORMATION_MISSING,
CUSTOMER_INQUIRY_UPDATE,
CUSTOMER_INQUIRY_RESOLVED,
INQUIRY_REMINDER,
CUSTOMER_INQUIRY_NEW_QUIVO,
CUSTOMER_INQUIRY_NEW,
SHOP_ERROR,
ITEM_NOT_FOUND,
SHOP_DEACTIVATED,
NOT_ENOUGH_ACCESS,
LOCATION_NOT_FOUND,
MULTIPLE_LOCATION_IDS,
NO_LOCATION_CONFIGURED,
IMPORTING_ORDERS_FAILED,
EXPORTING_INVENTORY_FAILED,
SHOP_NOT_CONFIGURED_PROPERLy,
SHOP_AVAILABLE,
NEW_RETURN_LINK_LABEL,
ITEM_EXPIRATION,
APPROVED_API_KEY_REQUEST,
EXPIRED_API_KEY,
DECLINED_API_KEY_REQUEST,
DELETED_API_KEY_REQUEST,
IMPORTANT_NOTIFICATION
​
contents
object[]

Array of content items