Notifications

List user notifications

Changed on

Delegated Aura access tokens require notifications:read; missing scope returns 403 FORBIDDEN. Retrieves the authenticated user’s canonical notifications in newest-first order. Watchlist price-change notifications preserve each event’s immutable source currency; no FX conversion is applied from the user’s preferences. Product image URLs are presented according to the authenticated user’s showUnassessedOrSensitiveContent preference.

get/api/v1/me/notifications

Request

  • Base URL: https://api.stage.aura-historia.com
  • URL: https://api.stage.aura-historia.com/api/v1/me/notifications
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Query parameters

language'de' | 'en' | 'fr' | 'es' | 'it' | 'zh' | 'pt' | 'pl' | 'tr' | 'nl' | 'cs' | 'ja' | 'ru' | 'ar'

Supported language codes (ISO 639-1 canonical values):

  • de: German (includes de-DE, de-AT, de-CH, de-LU, de-LI)
  • en: English (includes en-US, en-GB, en-AU, en-CA, en-NZ, and backend-specific accepted alias en_IE)
  • fr: French (includes fr-FR, fr-CA, fr-BE, fr-CH, fr-LU)
  • es: Spanish (includes es-ES, es-MX, es-AR, es-CO, es-CL, es-PE, es-VE)
  • it: Italian (includes it-IT, it-CH)
  • zh: Chinese (Simplified) (includes zh-CN, zh-Hans)
  • pt: Portuguese (includes pt-PT, pt-BR)
  • pl: Polish (includes pl-PL)
  • tr: Turkish (includes tr-TR)
  • nl: Dutch (includes nl-NL, nl-BE)
  • cs: Czech (includes cs-CZ)
  • ja: Japanese (includes ja-JP)
  • ru: Russian (includes ru-RU)
  • ar: Arabic (includes ar-SA, ar-EG, ar-AE)

de, en, fr, es, and it are fully supported localization/translation-target languages. zh, pt, pl, tr, nl, cs, ja, ru, and ar are ingestion-only languages: they can appear in stored/native content and are accepted anywhere LanguageData is used, but backend-generated translations and fallback localized strings are not produced in these languages.

Example:de
sizeinteger
searchAfterstring

Opaque JSON [created RFC3339 timestamp, Notification ID] cursor returned by the prior page.

Response

Notifications retrieved successfully.

sizeinteger required

Number of items returned in the current page.

searchAfterstring[] nullable

Opaque [created RFC3339 timestamp, Notification ID] cursor for the next page; omitted when no further page exists.

Changes

    • breaking

      the response property's min was decreased from 1.00 to 0.00 for the response status

    • warning

      added the new DKK enum value to the ////////////////// response property for the response status

    • warning

      added the new DKK enum value to the ////////////////// response property for the response status

    • warning

      added the new HUF enum value to the ////////////////// response property for the response status

    • warning

      added the new HUF enum value to the ////////////////// response property for the response status

    • warning

      added the new INR enum value to the ////////////////// response property for the response status

    • warning

      added the new INR enum value to the ////////////////// response property for the response status

    • warning

      added the new KRW enum value to the ////////////////// response property for the response status

    • warning

      added the new KRW enum value to the ////////////////// response property for the response status

    • warning

      added the new MXN enum value to the ////////////////// response property for the response status

    • warning

      added the new MXN enum value to the ////////////////// response property for the response status

    • warning

      added the new NOK enum value to the ////////////////// response property for the response status

    • warning

      added the new NOK enum value to the ////////////////// response property for the response status

    • warning

      added the new RON enum value to the ////////////////// response property for the response status

    • warning

      added the new RON enum value to the ////////////////// response property for the response status

    • warning

      added the new SEK enum value to the ////////////////// response property for the response status

    • warning

      added the new SEK enum value to the ////////////////// response property for the response status

    • warning

      added the new THB enum value to the ////////////////// response property for the response status

    • warning

      added the new THB enum value to the ////////////////// response property for the response status

    • warning

      added the new TWD enum value to the ////////////////// response property for the response status

    • warning

      added the new TWD enum value to the ////////////////// response property for the response status

    • warning

      added the new ZAR enum value to the ////////////////// response property for the response status

    • warning

      added the new ZAR enum value to the ////////////////// response property for the response status

    • info

      added the non-success response with the status

    • breaking

      the response property's min was decreased from 1.00 to 0.00 for the response status