Recibir correos: Lectura
Buscar
Busca en el buzón por remitente, dominio, asunto, cuerpo o etiqueta, con los mismos operadores que el cuadro de búsqueda del webmail.
https://g.sendcorex.com/v1command: searchSin field, la búsqueda es automática: una dirección de correo completa busca por remitente exacto, domain.com busca por dominio y cualquier otra cosa busca en el asunto, el cuerpo y el nombre del remitente.
Con operadores (from:, is:unread…) los resultados se agrupan por conversación: una fila por hilo, con el mensaje más reciente que coincidió. Sin in:, Spam y Papelera quedan fuera.
Argumentos
querystringobligatorioQué buscar, hasta 256 caracteres. Con varias palabras, la primera sale del índice y las demás filtran por asunto y vista previa.
fieldstringopcionalLimita una búsqueda simple a
from,to,subject,body,senderolabel. Se ignora cuando la consulta tiene operadores.limitnumberopcionalTamaño de página, de 1 a 100. Por defecto 25.
cursorstringopcionalEl
next_cursorde la página anterior.
Inicio rápido
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "search",
args: {
query: "ana@client.com",
field: "from",
limit: 5
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_TOKEN } },
);
const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);Respuesta
{
"type": "SUCCESS",
"results": [
{
"command": "search",
"id": "0",
"type": "SUCCESS",
"data": {
"messages": [
{
"message_uid": "Vj0xQUJDMTIz",
"thread_id": "thr_9a1c4e72",
"subject": "Invoice for September",
"preview": "Hi, attached is the invoice for September…",
"from_name": "Ana Costa",
"from_email": "ana@client.com",
"folders": [
"INBOX"
],
"is_read": false,
"is_starred": false,
"is_important": false,
"received_at": "2026-10-09T14:21:07Z"
}
],
"has_more": false,
"next_cursor": null
}
}
]
}Campos de la respuesta
messages[]Mensajes que coinciden, del más reciente al más antiguo. Cada uno tiene
message_uid,thread_id,subject,preview,from_name,from_email,folders, los flags de leído/destacado/importante yreceived_at.has_more / next_cursorPaginación.
Operadores
Combínalos con palabras simples. Un valor con espacios va entre comillas: subject:"new proposal". Pon - delante para excluir: -from:noreply, -newsletter.
Body de la solicitud
{
"commands": [
{
"command": "search",
"args": {
"query": "from:ana@client.com has:attachment newer_than:30d invoice"
}
}
]
}from: / to:Remitente / destinatario (to o cc), parte del nombre o de la dirección.
subject: / label:Texto del asunto / una etiqueta.
in:inbox,sent,archive,trash,spam,drafts,promotions,snoozed,scheduled,agents,not-subscribingo el id de una carpeta personalizada.has:attachmentSolo mensajes con adjuntos.
is:unread / is:read / is:starred / is:importantEstado del mensaje.
after: / before:Una fecha
YYYY/MM/DD(oYYYY-MM-DD), UTC.newer_than: / older_than:7d,2w,3m(30 días) o1y.
Solo filtros, sin palabra que buscar (is:unread in:archive), devuelven threads (la lista de conversaciones de esa carpeta) en lugar de messages.
Ejemplos de búsqueda
Bodies de la solicitud
// subject + body + sender name
{
"commands": [
{
"command": "search",
"args": {
"query": "invoice september"
}
}
]
}
// exact sender
{
"commands": [
{
"command": "search",
"args": {
"query": "ana@client.com",
"field": "from"
}
}
]
}
// everyone from a domain
{
"commands": [
{
"command": "search",
"args": {
"query": "client.com"
}
}
]
}
// messages with a label
{
"commands": [
{
"command": "search",
"args": {
"query": "cliente-vip",
"field": "label"
}
}
]
}Errores
Los errores a nivel HTTP devuelven type, code y message. Los errores marcados con CMD vuelven dentro del resultado del comando, con HTTP 200.
- 401
TOKEN_EXPIREDEl access token expiró. Llama a Refresh Token y repite la solicitud.
- 401
INVALID_TOKENEl token está mal formado, es desconocido o fue revocado.
- 429
RATE_LIMITEDMás de 15 solicitudes/s o 15 en curso para la misma IP + buzón. Espera la cantidad de segundos indicada en Retry-After.
- CMD
INVALID_ARGSFalta un argumento obligatorio o no es válido.
- CMD
INVALID_CURSOREl cursor está mal formado o pertenece a otra cuenta o carpeta.
- CMD
INTERNALError del servidor. El detalle solo se escribe en el log del servidor.