# Ver un aviso del buzón tributario

`GET https://api.fiscalisto.com/v1/sat_mailbox_messages/{id}`

Un aviso del buzón, con su urgencia y si pide hacer algo.

## Parámetros

| Nombre | Dónde | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `id` | ruta | sí | El id del objeto. |

## Con el SDK de TypeScript

```ts
import { Fiscalisto } from "fiscalisto";

// La llave viene de FISCALISTO_API_KEY.
const fiscalisto = new Fiscalisto();

const satMailboxMessage = await fiscalisto.satMailboxMessages.get("sbm_OufpKqnrvx9p1");
```

## Con el SDK de Python

```python
from fiscalisto import Fiscalisto

# La llave viene de FISCALISTO_API_KEY.
fiscalisto = Fiscalisto()

sat_mailbox_message = fiscalisto.sat_mailbox_messages.get("sbm_OufpKqnrvx9p1")
```

## Con el SDK de PHP

```php
<?php

use Fiscalisto\Fiscalisto;

// La llave viene de FISCALISTO_API_KEY.
$fiscalisto = new Fiscalisto();

$satMailboxMessage = $fiscalisto->satMailboxMessages->get('sbm_OufpKqnrvx9p1');
```

## Con el SDK de .NET

```csharp
using Fiscalisto;

// La llave viene de FISCALISTO_API_KEY.
var fiscalisto = new FiscalistoClient();

var satMailboxMessage = await fiscalisto.SatMailboxMessages.GetAsync("sbm_OufpKqnrvx9p1");
```

## Con el SDK de Go

```go
package main

import (
	"context"
	"fmt"
	"log"

	fiscalisto "fiscalisto.com/go"
)

func main() {
	// La llave viene de FISCALISTO_API_KEY.
	client, err := fiscalisto.NewClient("")
	if err != nil {
		log.Fatal(err)
	}
	ctx := context.Background()

	satMailboxMessage, err := client.SatMailboxMessages.Get(ctx, "sbm_OufpKqnrvx9p1")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(satMailboxMessage.ID)
}
```

## Con el SDK de Java

```java
import com.fiscalisto.FiscalistoClient;

// La llave viene de FISCALISTO_API_KEY.
var fiscalisto = new FiscalistoClient();

var satMailboxMessage = fiscalisto.satMailboxMessages().get("sbm_OufpKqnrvx9p1");
System.out.println(satMailboxMessage.getId());
```

## Respuesta 200

Correcto.

Un objeto `SatMailboxMessage`:

| Campo | Tipo | Siempre viene | Descripción |
| --- | --- | --- | --- |
| `id` | string | sí | Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). |
| `livemode` | boolean | sí | true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. |
| `object` | `"sat_mailbox_message"` | sí | Qué tipo de objeto es («invoice», «customer»…). |
| `issuer` | string | sí | El emisor. |
| `subject` | string | sí | Su asunto. |
| `summary` | string o null | sí | Su texto, resumido, o null. |
| `source` | `mailbox`, `email` | sí | mailbox (el buzón del portal) o email (un aviso que el SAT mandó por correo). |
| `unread` | boolean | sí | true si no se ha leído en el SAT. |
| `urgency` | `urgent`, `attention`, `informational` | sí | urgent (un requerimiento, un plazo), attention o informational. |
| `kind` | string | sí | Qué es: requerimiento, carta invitación, informativo… |
| `action_required` | boolean | sí | true si pide hacer algo. |
| `received_at` | string o null | sí | Cuándo llegó, como lo dice el SAT. |
| `created_at` | string (date-time) o null | sí | Cuándo lo trajo Fiscalisto. |

```json
{
  "id": "sbm_OufpKqnrvx9p1",
  "object": "sat_mailbox_message",
  "livemode": false,
  "issuer": "iss_OufpKqnrvx9p",
  "subject": "Requerimiento de información",
  "summary": "Se le requiere la documentación que acredite…",
  "source": "mailbox",
  "unread": true,
  "urgency": "urgent",
  "kind": "Requerimiento",
  "action_required": true,
  "received_at": "2026-10-27",
  "created_at": "2026-10-27T09:12:00-06:00"
}
```

## Errores

Puede responder 400, 401, 403, 404, 429, 500 con el cuerpo de error de siempre; cada código está en https://fiscalisto.com/docs/api/errores.md.