Today

Get Today's counts

GET/today

How many tasks are open today, due soon and in the Inbox, and how many key dates, deadlines and notes, with today in the owner's time zone; the fortnight is today to day 14. Each task count matches its GET /tasks view. Expired tasks are archived first. Not a record: there's nothing to page or sync, so ask again when things change. Unknown parameters are ignored.

curl "$NIFTY_URL/api/v1/today" \
  -H "Authorization: Bearer $NIFTY_TOKEN"

Response

200 OK Errors: 401 429

{
  "data": {
    "date": "2026-10-10",
    "tasks_today": 1,
    "tasks_due_not_today": 1,
    "tasks_inbox": 1,
    "key_dates_in_fortnight": 1,
    "deadlines_in_fortnight": 1,
    "overdue_deadlines": 1,
    "notes_this_week": 1,
    "pinned_notes": 1
  }
}

Get what's been started

GET/getting_started

Which areas have anything in them yet, and which getting-started tips the owner has hidden. The app shows each empty area's introduction, Today's welcome until it's hidden or every area has started, and Calendar's until it's hidden or Calendar has started. Not a record: there's nothing to page or sync.

curl "$NIFTY_URL/api/v1/getting_started" \
  -H "Authorization: Bearer $NIFTY_TOKEN"

Response

200 OK Errors: 401 429

{
  "data": {
    "started": {
      "people": true,
      "notes": true,
      "tasks": true,
      "projects": true,
      "documents": true,
      "calendar": true
    },
    "hidden": [
      "today"
    ]
  }
}

Hide a tip

PUT/getting_started/hidden/{tip}

Hides the tip on every device, for good. Hiding it again changes nothing; an unknown tip is a 404. Allowed while read-only.

curl -X PUT "$NIFTY_URL/api/v1/getting_started/hidden/today" \
  -H "Authorization: Bearer $NIFTY_TOKEN"

Path parameters

Response

200 Hidden. Errors: 401 403 404 429

{
  "data": {
    "started": {
      "people": true,
      "notes": true,
      "tasks": true,
      "projects": true,
      "documents": true,
      "calendar": true
    },
    "hidden": [
      "today"
    ]
  }
}

Show a tip again

DELETE/getting_started/hidden/{tip}

Shows a hidden tip again (the hide's Undo). Showing one that isn't hidden changes nothing. Allowed while read-only.

curl -X DELETE "$NIFTY_URL/api/v1/getting_started/hidden/today" \
  -H "Authorization: Bearer $NIFTY_TOKEN"

Path parameters

Response

200 Shown. Errors: 401 403 404 429

{
  "data": {
    "started": {
      "people": true,
      "notes": true,
      "tasks": true,
      "projects": true,
      "documents": true,
      "calendar": true
    },
    "hidden": [
      "today"
    ]
  }
}