Skip to content

POST /v1/validation/bulk ​

Mette in coda una lista di indirizzi per la validazione. Massimo 10.000 per richiesta.

È asincrono: la risposta non contiene risultati, solo uno uuid che usi per leggerli in seguito. Se gli indirizzi sono in un file esportato, usa invece POST /v1/validation/file.

Ogni indirizzo controllato usa un credito di validazione.

Endpoint ​

http
POST /v1/validation/bulk
bash
curl -X POST https://api.mailiqo.com/v1/validation/bulk \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"emails": ["[email protected]", "[email protected]"]}'

Corpo della richiesta ​

CampoTipoObbligatorioDescrizione
emailsarraySìLista di indirizzi. Massimo 10.000.

Risposta ​

Codice 201. Lo uuid identifica la validazione, così puoi consultarne lo stato e il risultato.

json
{
  "status": "success",
  "data": {
    "uuid": "6f1c0f3e-6d1a-4b7e-9d2c-xxxxxxxx"
  }
}
CampoTipoDescrizione
uuidstringIdentificatore della validazione creata.

Errori ​

CodiceHTTPQuando
1300400Più di 10.000 indirizzi nella richiesta.
1304400Crediti di validazione insufficienti.
1302500Registrazione della lista di indirizzi fallita.
1303500Creazione della richiesta di validazione fallita.

Il saldo viene controllato prima di accettare il lotto: se non copre tutti gli indirizzi, nulla viene messo in coda e la richiesta viene rifiutata con 1304.

Passo successivo ​

Con lo uuid, segui l'avanzamento in GET /v1/validation/status/{uuid} e scarica il risultato in GET /v1/validation/details/{uuid}/{page}.

Endpoint correlati ​

Built with VitePress