Obtener un remitente

GET/v1/senders/{id}

Descripción

Retorna el detalle de un remitente por su id. Este es el detalle de campos que comparte también GET /v1/senders (cada elemento de data) — el alta y la baja de un remitente son exclusivas del panel web.

Autenticación

Authorizationbearer tokenheaderobligatorio

API key con scope senders:read. Formato: Bearer FD.<key_id>.<token>.

X-Instance-Slugstringheaderobligatorio

Request

Path params:

idinteger

Identificador del remitente, devuelto por `GET /v1/senders`.

Response

200 OKDevuelve un objeto con los campos que siguen.

idintegerobligatorio

Identificador del remitente.

namestringobligatorio

Nombre visible del remitente.

email_addressstringobligatorio

Dirección de envío, username@<domain>.

domain_idintegerobligatorio

id del dominio asociado.

domain_is_verifiedbooleanobligatorio

Estado de verificación del dominio asociado. Se recalcula en cada consulta, así que refleja el estado del dominio al momento de leer, no el que tenía cuando se registró el remitente: si el dominio se degrada a failed, este campo pasa a false en la siguiente lectura.

is_consent_requiredbooleanobligatorio

true cuando el envío a este remitente exige verificar el consentimiento del destinatario contra sus finalidades declaradas. Gestionable solo desde el panel web.

created_atstring (date-time)obligatorio

—

updated_atstring (date-time)obligatorio

—

Errores

Código	Cuándo
404	No existe un remitente con ese id en la instancia (sender_not_found).

Detalle en Errores genéricos.

Request

curl -X GET "https://$API_HOST/v1/senders/42" \
-H "Authorization: Bearer $API_KEY" \
-H "X-Instance-Slug: $SLUG"

Response

{
"id": 42,
"name": "Atención al cliente",
"email_address": "contacto@correos.micomercio.cl",
"domain_id": 7,
"domain_is_verified": true,
"is_consent_required": false,
"created_at": "2026-05-08T14:24:10Z",
"updated_at": "2026-05-08T14:24:10Z"
}