MediaWiki API help

This is an auto-generated MediaWiki API documentation page.

Documentation and examples: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

meta=notifications (not)

(main | query | notifications)

This module requires read rights.
Source: Echo
License: MIT

Get notifications waiting for the current user.

https://www.mediawiki.org/wiki/Special:MyLanguage/Echo_(Notifications)/API

Specific parameters:

Other general parameters are available.

notwikis

List of wikis to fetch notifications from (defaults to only current wiki).

Values (separate with | or alternative): *, aawiki, aawikibooks, aawiktionary, abwiki, abwiktionary, acewiki, advisorswiki, advisorywiki, adywiki, aewikimedia, afwiki, afwikibooks, afwikiquote, afwiktionary, akwiki, akwikibooks, akwiktionary, alswiki, altwiki, amiwiki, amwiki, amwikimedia, amwikiquote, amwiktionary, angwiki, angwikibooks, angwikiquote, angwikisource, angwiktionary, annwiki, anpwiki, anwiki, anwiktionary, apiportalwiki, arbcom_cswiki, arbcom_dewiki, arbcom_enwiki, arbcom_fiwiki, arbcom_itwiki, arbcom_nlwiki, arbcom_ruwiki, arcwiki, arwiki, arwikibooks, arwikimedia, arwikinews, arwikiquote, arwikisource, arwikiversity, arwiktionary, arywiki, arzwiki, astwiki, astwikibooks, astwikiquote, astwiktionary, aswiki, aswikibooks, aswikiquote, aswikisource, aswiktionary, atjwiki, auditcomwiki, avkwiki, avwiki, avwiktionary, awawiki, aywiki, aywikibooks, aywiktionary, azbwiki, azwiki, azwikibooks, azwikimedia, azwikiquote, azwikisource, azwiktionary, banwiki, banwikisource, barwiki, bat_smgwiki, bawiki, bawikibooks, bbcwiki, bclwiki, bclwikiquote, bclwikisource, bclwiktionary, bdrwiki, bdwikimedia, be_x_oldwiki, betawikiversity, bewiki, bewikibooks, bewikimedia, bewikiquote, bewikisource, bewiktionary, bewwiki, bgwiki, bgwikibooks, bgwikinews, bgwikiquote, bgwikisource, bgwiktionary, bhwiki, bhwiktionary, biwiki, biwikibooks, biwiktionary, bjnwiki, bjnwikiquote, bjnwiktionary, blkwiki, blkwiktionary, bmwiki, bmwikibooks, bmwikiquote, bmwiktionary, bnwiki, bnwikibooks, bnwikiquote, bnwikisource, bnwikivoyage, bnwiktionary, boardgovcomwiki, boardwiki, bowiki, bowikibooks, bowiktionary, bpywiki, brwiki, brwikimedia, brwikiquote, brwikisource, brwiktionary, bswiki, bswikibooks, bswikinews, bswikiquote, bswikisource, bswiktionary, btmwiki, btmwiktionary, bugwiki, bxrwiki, cawiki, cawikibooks, cawikimedia, cawikinews, cawikiquote, cawikisource, cawiktionary, cbk_zamwiki, cdowiki, cebwiki, cewiki, chairwiki, chapcomwiki, checkuserwiki, chowiki, chrwiki, chrwiktionary, chwiki, chwikibooks, chwiktionary, chywiki, ckbwiki, ckbwiktionary, cnwikimedia, collabwiki, commonswiki, cowiki, cowikibooks, cowikimedia, cowikiquote, cowiktionary, crhwiki, crwiki, crwikiquote, crwiktionary, csbwiki, csbwiktionary, cswiki, cswikibooks, cswikinews, cswikiquote, cswikisource, cswikiversity, cswikivoyage, cswiktionary, cuwiki, cvwiki, cvwikibooks, cywiki, cywikibooks, cywikiquote, cywikisource, cywiktionary, dagwiki, dawiki, dawikibooks, dawikiquote, dawikisource, dawiktionary, dewiki, dewikibooks, dewikinews, dewikiquote, dewikisource, dewikiversity, dewikivoyage, dewiktionary, dgawiki, dinwiki, diqwiki, diqwiktionary, dkwikimedia, donatewiki, dsbwiki, dtpwiki, dtywiki, dvwiki, dvwiktionary, dzwiki, dzwiktionary, ecwikimedia, eewiki, electcomwiki, elwiki, elwikibooks, elwikinews, elwikiquote, elwikisource, elwikiversity, elwikivoyage, elwiktionary, emlwiki, enwiki, enwikibooks, enwikinews, enwikiquote, enwikisource, enwikiversity, enwikivoyage, enwiktionary, eowiki, eowikibooks, eowikinews, eowikiquote, eowikisource, eowikivoyage, eowiktionary, eswiki, eswikibooks, eswikinews, eswikiquote, eswikisource, eswikiversity, eswikivoyage, eswiktionary, etwiki, etwikibooks, etwikimedia, etwikiquote, etwikisource, etwiktionary, euwiki, euwikibooks, euwikiquote, euwikisource, euwiktionary, execwiki, extwiki, fatwiki, fawiki, fawikibooks, fawikinews, fawikiquote, fawikisource, fawikivoyage, fawiktionary, fdcwiki, ffwiki, fiu_vrowiki, fiwiki, fiwikibooks, fiwikimedia, fiwikinews, fiwikiquote, fiwikisource, fiwikiversity, fiwikivoyage, fiwiktionary, fjwiki, fjwiktionary, fonwiki, foundationwiki, fowiki, fowikisource, fowiktionary, frpwiki, frrwiki, frwiki, frwikibooks, frwikinews, frwikiquote, frwikisource, frwikiversity, frwikivoyage, frwiktionary, furwiki, fywiki, fywikibooks, fywiktionary, gagwiki, ganwiki, gawiki, gawikibooks, gawikiquote, gawiktionary, gcrwiki, gdwiki, gdwiktionary, gewikimedia, glkwiki, glwiki, glwikibooks, glwikiquote, glwikisource, glwiktionary, gnwiki, gnwikibooks, gnwiktionary, gomwiki, gomwiktionary, gorwiki, gorwikiquote, gorwiktionary, gotwiki, gotwikibooks, gpewiki, grantswiki, grwikimedia, gucwiki, gurwiki, guwiki, guwikibooks, guwikiquote, guwikisource, guwiktionary, guwwiki, guwwikinews, guwwikiquote, guwwiktionary, gvwiki, gvwiktionary, hakwiki, hawiki, hawiktionary, hawwiki, hewiki, hewikibooks, hewikinews, hewikiquote, hewikisource, hewikivoyage, hewiktionary, hifwiki, hifwiktionary, hiwiki, hiwikibooks, hiwikimedia, hiwikiquote, hiwikisource, hiwikiversity, hiwikivoyage, hiwiktionary, howiki, hrwiki, hrwikibooks, hrwikiquote, hrwikisource, hrwiktionary, hsbwiki, hsbwiktionary, htwiki, htwikisource, huwiki, huwikibooks, huwikinews, huwikiquote, huwikisource, huwiktionary, hywiki, hywikibooks, hywikiquote, hywikisource, hywiktionary, hywwiki, hzwiki, iawiki, iawikibooks, iawiktionary, ibawiki, id_internalwikimedia, idwiki, idwikibooks, idwikimedia, idwikiquote, idwikisource, idwiktionary, iegcomwiki, iewiki, iewikibooks, iewiktionary, iglwiki, igwiki, igwikiquote, igwiktionary, iiwiki, ikwiki, ikwiktionary, ilowiki, ilwikimedia, incubatorwiki, inhwiki, internalwiki, iowiki, iowiktionary, iswiki, iswikibooks, iswikiquote, iswikisource, iswiktionary, itwiki, itwikibooks, itwikinews, itwikiquote, itwikisource, itwikiversity, itwikivoyage, itwiktionary, iuwiki, iuwiktionary, jamwiki, jawiki, jawikibooks, jawikinews, jawikiquote, jawikisource, jawikiversity, jawikivoyage, jawiktionary, jbowiki, jbowiktionary, jvwiki, jvwikisource, jvwiktionary, kaawiki, kaawiktionary, kabwiki, kawiki, kawikibooks, kawikiquote, kawikisource, kawiktionary, kbdwiki, kbdwiktionary, kbpwiki, kcgwiki, kcgwiktionary, kgewiki, kgwiki, kiwiki, kjwiki, kkwiki, kkwikibooks, kkwikiquote, kkwiktionary, klwiki, klwiktionary, kmwiki, kmwikibooks, kmwiktionary, knwiki, knwikibooks, knwikiquote, knwikisource, knwiktionary, koiwiki, kowiki, kowikibooks, kowikinews, kowikiquote, kowikisource, kowikiversity, kowiktionary, krcwiki, krwiki, krwikiquote, kshwiki, kswiki, kswikibooks, kswikiquote, kswiktionary, kuswiki, kuwiki, kuwikibooks, kuwikiquote, kuwiktionary, kvwiki, kwwiki, kwwikiquote, kwwiktionary, kywiki, kywikibooks, kywikiquote, kywiktionary, labswiki, ladwiki, lawiki, lawikibooks, lawikiquote, lawikisource, lawiktionary, lbewiki, lbwiki, lbwikibooks, lbwikiquote, lbwiktionary, legalteamwiki, lezwiki, lfnwiki, lgwiki, lijwiki, lijwikisource, liwiki, liwikibooks, liwikinews, liwikiquote, liwikisource, liwiktionary, lldwiki, lmowiki, lmowiktionary, lnwiki, lnwikibooks, lnwiktionary, loginwiki, lowiki, lowiktionary, lrcwiki, ltgwiki, ltwiki, ltwikibooks, ltwikiquote, ltwikisource, ltwiktionary, lvwiki, lvwikibooks, lvwiktionary, madwiki, madwiktionary, maiwiki, maiwikimedia, map_bmswiki, mdfwiki, mediawikiwiki, metawiki, mgwiki, mgwikibooks, mgwiktionary, mhrwiki, mhwiki, mhwiktionary, minwiki, minwiktionary, miwiki, miwikibooks, miwiktionary, mkwiki, mkwikibooks, mkwikimedia, mkwikisource, mkwiktionary, mlwiki, mlwikibooks, mlwikiquote, mlwikisource, mlwiktionary, mniwiki, mniwiktionary, mnwiki, mnwikibooks, mnwiktionary, mnwwiki, mnwwiktionary, moswiki, movementroleswiki, mrjwiki, mrwiki, mrwikibooks, mrwikiquote, mrwikisource, mrwiktionary, mswiki, mswikibooks, mswikisource, mswiktionary, mtwiki, mtwiktionary, muswiki, mwlwiki, mxwikimedia, myvwiki, mywiki, mywikibooks, mywikisource, mywiktionary, mznwiki, nahwiki, nahwikibooks, nahwiktionary, napwiki, napwikisource, nawiki, nawikibooks, nawikiquote, nawiktionary, nds_nlwiki, ndswiki, ndswikibooks, ndswikiquote, ndswiktionary, newiki, newikibooks, newiktionary, newwiki, ngwiki, ngwikimedia, niawiki, niawiktionary, nlwiki, nlwikibooks, nlwikimedia, nlwikinews, nlwikiquote, nlwikisource, nlwikivoyage, nlwiktionary, nnwiki, nnwikiquote, nnwiktionary, noboard_chapterswikimedia, nostalgiawiki, novwiki, nowiki, nowikibooks, nowikimedia, nowikinews, nowikiquote, nowikisource, nowiktionary, nqowiki, nrmwiki, nrwiki, nsowiki, nvwiki, nycwikimedia, nywiki, nzwikimedia, ocwiki, ocwikibooks, ocwiktionary, officewiki, olowiki, ombudsmenwiki, omwiki, omwiktionary, orwiki, orwikisource, orwiktionary, oswiki, otrs_wikiwiki, outreachwiki, pa_uswikimedia, pagwiki, pamwiki, papwiki, pawiki, pawikibooks, pawikisource, pawiktionary, pcdwiki, pcmwiki, pdcwiki, pflwiki, pihwiki, piwiki, piwiktionary, plwiki, plwikibooks, plwikimedia, plwikinews, plwikiquote, plwikisource, plwikivoyage, plwiktionary, pmswiki, pmswikisource, pnbwiki, pnbwiktionary, pntwiki, projectcomwiki, pswiki, pswikibooks, pswikivoyage, pswiktionary, ptwiki, ptwikibooks, ptwikimedia, ptwikinews, ptwikiquote, ptwikisource, ptwikiversity, ptwikivoyage, ptwiktionary, punjabiwikimedia, pwnwiki, qualitywiki, quwiki, quwikibooks, quwikiquote, quwiktionary, rmwiki, rmwikibooks, rmwiktionary, rmywiki, rnwiki, rnwiktionary, roa_rupwiki, roa_rupwiktionary, roa_tarawiki, romdwikimedia, rowiki, rowikibooks, rowikinews, rowikiquote, rowikisource, rowikivoyage, rowiktionary, rskwiki, rswikimedia, ruewiki, ruwiki, ruwikibooks, ruwikimedia, ruwikinews, ruwikiquote, ruwikisource, ruwikiversity, ruwikivoyage, ruwiktionary, rwwiki, rwwiktionary, sahwiki, sahwikiquote, sahwikisource, satwiki, sawiki, sawikibooks, sawikiquote, sawikisource, sawiktionary, scnwiki, scnwiktionary, scowiki, scwiki, scwiktionary, sdwiki, sdwikinews, sdwiktionary, searchcomwiki, sewiki, sewikibooks, sewikimedia, sgwiki, sgwiktionary, shiwiki, shnwiki, shnwikibooks, shnwikinews, shnwikivoyage, shnwiktionary, shwiki, shwiktionary, shywiktionary, simplewiki, simplewikibooks, simplewikiquote, simplewiktionary, siwiki, siwikibooks, siwiktionary, skrwiki, skrwiktionary, skwiki, skwikibooks, skwikiquote, skwikisource, skwiktionary, slwiki, slwikibooks, slwikiquote, slwikisource, slwikiversity, slwiktionary, smnwiki, smwiki, smwiktionary, snwiki, snwiktionary, sourceswiki, sowiki, sowiktionary, spcomwiki, specieswiki, sqwiki, sqwikibooks, sqwikinews, sqwikiquote, sqwiktionary, srnwiki, srwiki, srwikibooks, srwikinews, srwikiquote, srwikisource, srwiktionary, sswiki, sswiktionary, stewardwiki, stqwiki, strategywiki, stwiki, stwiktionary, suwiki, suwikibooks, suwikiquote, suwikisource, suwiktionary, svwiki, svwikibooks, svwikinews, svwikiquote, svwikisource, svwikiversity, svwikivoyage, svwiktionary, swwiki, swwikibooks, swwiktionary, sysop_itwiki, sysop_plwiki, szlwiki, szywiki, tawiki, tawikibooks, tawikinews, tawikiquote, tawikisource, tawiktionary, taywiki, tcywiki, tcywikisource, tcywiktionary, tddwiki, techconductwiki, tenwiki, test2wiki, testcommonswiki, testwiki, testwikidatawiki, tetwiki, tewiki, tewikibooks, tewikiquote, tewikisource, tewiktionary, tgwiki, tgwikibooks, tgwiktionary, thankyouwiki, thwiki, thwikibooks, thwikinews, thwikiquote, thwikisource, thwiktionary, tiwiki, tiwiktionary, tkwiki, tkwikibooks, tkwikiquote, tkwiktionary, tlwiki, tlwikibooks, tlwikiquote, tlwiktionary, tlywiki, tnwiki, tnwiktionary, towiki, towiktionary, tpiwiki, tpiwiktionary, transitionteamwiki, trvwiki, trwiki, trwikibooks, trwikimedia, trwikinews, trwikiquote, trwikisource, trwikivoyage, trwiktionary, tswiki, tswiktionary, ttwiki, ttwikibooks, ttwikiquote, ttwiktionary, tumwiki, twwiki, twwiktionary, tyvwiki, tywiki, u4cwiki, uawikimedia, udmwiki, ugwiki, ugwikibooks, ugwikiquote, ugwiktionary, ukwiki, ukwikibooks, ukwikinews, ukwikiquote, ukwikisource, ukwikivoyage, ukwiktionary, urwiki, urwikibooks, urwikiquote, urwiktionary, usabilitywiki, uzwiki, uzwikibooks, uzwikiquote, uzwiktionary, vecwiki, vecwikisource, vecwiktionary, vepwiki, vewiki, vewikimedia, viwiki, viwikibooks, viwikiquote, viwikisource, viwikivoyage, viwiktionary, vlswiki, votewiki, vowiki, vowikibooks, vowikiquote, vowiktionary, warwiki, wawiki, wawikibooks, wawikisource, wawiktionary, wbwikimedia, wg_enwiki, wikidatawiki, wikifunctionswiki, wikimania2005wiki, wikimania2006wiki, wikimania2007wiki, wikimania2008wiki, wikimania2009wiki, wikimania2010wiki, wikimania2011wiki, wikimania2012wiki, wikimania2013wiki, wikimania2014wiki, wikimania2015wiki, wikimania2016wiki, wikimania2017wiki, wikimania2018wiki, wikimaniateamwiki, wikimaniawiki, wowiki, wowikiquote, wowiktionary, wuuwiki, xalwiki, xhwiki, xhwikibooks, xhwiktionary, xmfwiki, yiwiki, yiwikisource, yiwiktionary, yowiki, yowikibooks, yowiktionary, yuewiktionary, zawiki, zawikibooks, zawikiquote, zawiktionary, zeawiki, zghwiki, zh_classicalwiki, zh_min_nanwiki, zh_min_nanwikibooks, zh_min_nanwikiquote, zh_min_nanwikisource, zh_min_nanwiktionary, zh_yuewiki, zhwiki, zhwikibooks, zhwikinews, zhwikiquote, zhwikisource, zhwikiversity, zhwikivoyage, zhwiktionary, zuwiki, zuwikibooks, zuwiktionary

Maximum number of values is 50 (500 for clients that are allowed higher limits).

Default: angwiktionary

notfilter

Filter notifications returned.

Values (separate with | or alternative): !read, read

Default: read|!read

notprop

Details to request.

Values (separate with | or alternative): count, list, seenTime

Default: list

notsections

The notification sections to query (i.e. some combination of 'alert' and 'message').

Values (separate with | or alternative): alert, message

Default: alert|message

notgroupbysection

Whether to group the result by section. Each section is fetched separately if set.

Type: boolean (details)

notformat

If specified, notifications will be returned formatted this way.

model: Raw notification data
special: Formatted for Special:Notifications page (and only that!) Do not rely on the HTML as it may change at any given time.
flyout: Deprecated. Use notformat=model for raw data
html: Deprecated. Use notformat=model for raw data

One of the following values: flyout, html, model, special

notlimit

The maximum number of notifications to return.

Type: integer or max

The value must be between 1 and 50.

Default: 20

notcontinue

When more results are available, use this to continue. More detailed information on how to continue queries can be found on mediawiki.org.

notunreadfirst

Whether to show unread notifications first (only used if groupbysection is not set).

Type: boolean (details)

nottitles

Only return notifications for these pages. To get notifications not associated with any page, use [] as a title.

Separate values with | or alternative.

Maximum number of values is 50 (500 for clients that are allowed higher limits).

notbundle

Whether to show bundle compatible unread notifications according to notification types bundling rules.

Type: boolean (details)

notnotifiertypes

Notifier types for which to return notifications.

Values (separate with | or alternative): email, web

Default: web

notalertcontinue

When more alert results are available, use this to continue.

notalertunreadfirst

Whether to show unread message notifications first (only used if groupbysection is set).

Type: boolean (details)

notmessagecontinue

When more message results are available, use this to continue.

notmessageunreadfirst

Whether to show unread alert notifications first (only used if groupbysection is set).

Type: boolean (details)

notcrosswikisummary

True to opt in to a summary notification of notifications on foreign wikis.

Type: boolean (details)

Examples:

List web notifications: api.php?action=query&meta=notifications [open in sandbox]
List web notifications, grouped by section, with counts: api.php?action=query&meta=notifications&notprop=count&notsections=alert|message&notgroupbysection=1 [open in sandbox]
List email notifications: api.php?action=query&meta=notifications&notnotifiertypes=email [open in sandbox]