> This page is for Referencia de la API.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://signalcore.ai/docs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://signalcore.ai/docs/_mcp/server.

# List 

GET https://signalcore.ai/v1/inbox

Reference: https://signalcore.ai/docs/referencia/bandeja/list

## Authentication

- `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer <token>`, where token is your auth token.

## Response

### 200

Successful Response

- `list of ItemOut`

## Types

### ItemOut

- `id` (string, required)
- `kind` (enum, required)
  - Allowed values: `notice`, `handoff`, `failed`, `waiting`, `unanswered`
- `agent_id` (string, required)
- `agent_name` (string, required)
- `conversation_id` (string, required, nullable)
- `text` (string, required)
- `read` (boolean, required)
- `created_at` (datetime, required)
- `run_id` (string, optional, nullable)
- `title` (string, optional, nullable)

## Examples

**Response**

```json
[
  {
    "id": "id",
    "kind": "notice",
    "agent_id": "agent_id",
    "agent_name": "agent_name",
    "conversation_id": "conversation_id",
    "text": "text",
    "read": true,
    "created_at": "2024-01-15T09:30:00Z",
    "run_id": "run_id",
    "title": "title"
  }
]
```

**SDK Code**

```python
import requests

url = "https://signalcore.ai/v1/inbox"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.json())
```