# List inbox notifications (threaded)

`GET /api/inbox`

URL: https://repsona.com/api/get-inbox

Groups notifications by their Task/Note and returns the latest per thread with subIds (legacy-compatible).

## Parameters

| name | in | type | required | description |
| --- | --- | --- | --- | --- |
| `status` | query | unread \| archived |  | Which notifications to list: `unread` or `archived`. Defaults to `unread`. |
| `page` | query | integer |  | Page number, starting at 1. Each page has 10 threads. Defaults to 1. |
| `until_id` | query | integer |  | Return only notifications with an ID lower than this value. Use it to keep paging stable while new notifications arrive. |
| `mention_only` | query | boolean |  | Set to `true` to list only notifications that mention you. Defaults to `false`. |

## Request

```sh
curl -X GET "https://<space>.repsona.com/api/inbox" \
  -H "Authorization: Bearer $REPSONA_API_KEY"
```

## Responses

- 200: Threaded inbox notifications
- 401: Authentication is required

## Example response

```json
{
  "inboxNotifications": [
    {
      "id": 55,
      "status": "unread",
      "createdAt": 1793662651149,
      "activity": {
        "id": 22405,
        "createdAt": 1793662651133,
        "model": "TaskComment",
        "modelId": 74,
        "property": "comment",
        "isMultiple": false,
        "action": "create",
        "message": "コメントを作成しました",
        "user": {
          "id": 1128,
          "name": "mia",
          "fullName": "Mia Chen",
          "avatarUrl": null,
          "state": "active",
          "extra": {
            "color": null
          }
        },
        "project": {
          "id": 297,
          "name": "beta-launch",
          "fullName": "Beta Launch"
        },
        "ref": {
          "link": {
            "text": "Fix login redirect",
            "path": "/p/297/task/100443#comment-74"
          },
          "fromContent": null,
          "toContent": "Looks good to me. Shipping on Friday.",
          "content": "Looks good to me. Shipping on Friday."
        }
      },
      "reaction": {
        "targetType": "taskComment",
        "targetId": 74,
        "reactions": []
      },
      "subIds": []
    },
    {
      "id": 54,
      "status": "unread",
      "createdAt": 1793662651128,
      "activity": {
        "id": 22403,
        "createdAt": 1793662651116,
        "model": "TaskComment",
        "modelId": 73,
        "property": "comment",
        "isMultiple": false,
        "action": "create",
        "message": "コメントを作成しました",
        "user": {
          "id": 1128,
          "name": "mia",
          "fullName": "Mia Chen",
          "avatarUrl": null,
          "state": "active",
          "extra": {
            "color": null
          }
        },
        "project": {
          "id": 297,
          "name": "beta-launch",
          "fullName": "Beta Launch"
        },
        "ref": {
          "link": {
            "text": "Write release notes",
            "path": "/p/297/task/100441#comment-73"
          },
          "fromContent": null,
          "toContent": "Looks good to me. Shipping on Friday.",
          "content": "Looks good to me. Shipping on Friday."
        }
      },
      "reaction": {
        "targetType": "taskComment",
        "targetId": 73,
        "reactions": []
      },
      "subIds": []
    }
  ]
}
```