> For the complete documentation index, see [llms.txt](https://docs.tnid.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tnid.com/api-reference/002_company/012_notifications/001__list_notifications_as_company.md).

# List Notifications (Company)

GraphQL endpoint: `/company`

Lists the calling company's notifications, cursor-paginated. Optionally filter by status (UNREAD or READ); pass paginationInfo.nextCursor back as cursor for the next page.

## Query

```graphql
query (
  $limit: Int
  $cursor: String
  $status: NotificationStatus
) {
  notifications (
    limit: $limit
    cursor: $cursor
    status: $status
  ) {
    paginationInfo {
      limit
      nextCursor
    }
    records {
      id
      text
      kind
      subjectId
      subjectStatus
      context
      status
      insertedAt
      updatedAt
    }
  }
}

```

## Variables

```json
{}
```

## Response

```json
{
  "data": {
    "notifications": {
      "paginationInfo": {
        "limit": 20,
        "nextCursor": null
      },
      "records": [
        {
          "context": {},
          "id": "00000000-0000-4000-8000-000000000001",
          "insertedAt": "2026-01-15T09:00:00",
          "kind": null,
          "status": "UNREAD",
          "subjectId": null,
          "subjectStatus": null,
          "text": "test notification",
          "updatedAt": "2026-01-15T09:00:00"
        },
        {
          "context": {},
          "id": "00000000-0000-4000-8000-000000000002",
          "insertedAt": "2026-01-15T09:00:00",
          "kind": null,
          "status": "UNREAD",
          "subjectId": null,
          "subjectStatus": null,
          "text": "test notification",
          "updatedAt": "2026-01-15T09:00:00"
        },
        {
          "context": {},
          "id": "00000000-0000-4000-8000-000000000003",
          "insertedAt": "2026-01-15T09:00:00",
          "kind": null,
          "status": "UNREAD",
          "subjectId": null,
          "subjectStatus": null,
          "text": "test notification",
          "updatedAt": "2026-01-15T09:00:00"
        }
      ]
    }
  }
}
```