POST/score/email
Score from an email
Score the company behind any email: company or work email 10 credits, generic email 20.
Send an email address; we find the company and score it in one call.
| Example | How we find the company | Credits | |
|---|---|---|---|
| Company | info@acme.com | The email's own domain | 10 |
| Work | jane@mail.acme.com | The email's own domain → acme.com | 10 |
| Generic (Gmail, Outlook, etc.) | jane.doe@gmail.com | The person's professional profile → their current employer → its website | 20 |
| Temporary | x@mailinator.com | None: there is no company | 0 |
You're only charged when scoring happens. No company found, a temporary email, or a rejected company website all cost 0. The score is for the person's company, not the person.
Start
curl -X POST "https://mmkuffhlzytnmgraagbp.supabase.co/functions/v1/score/email" \
-H "Authorization: Bearer $PLATINUX_API_KEY" -H "Content-Type: application/json" \
-d '{"email": "jane.doe@gmail.com", "template_id": "4d286e65-…"}'| Body field | Type | Required |
|---|---|---|
email | string | Yes |
template_id | string (UUID) | Yes |
Company found, scoring started: 202
{ "status": "processing", "job_id": "fba400cc-…", "domain": "acme.com", "template_id": "4d286e65-…",
"check_after_seconds": 30, "input": "jane.doe@gmail.com", "input_type": "personal_email", "credits_charged": 20 }No company: 200, 0 credits
{ "status": "not_found", "input": "someone@gmail.com", "input_type": "personal_email", "domain": null, "score": null, "credits_charged": 0 }{ "status": "temporary_email", "input": "x@mailinator.com", "input_type": "temporary_email", "domain": null, "score": null, "credits_charged": 0 }input_type: work_email (work and company emails), personal_email (a generic email such as Gmail or Outlook) or temporary_email.
Check the score
curl "https://mmkuffhlzytnmgraagbp.supabase.co/functions/v1/score/domain?job_id=8184a513-…" -H "Authorization: Bearer $PLATINUX_API_KEY"202 while processing; 200 when finished. Check every check_after_seconds (30). Any of the three paths works for GET.
{ "status": "complete", "job_id": "8184a513-…", "domain": "asana.com", "template_id": "4d286e65-…",
"score": 100, "scored_at": "2026-11-19T14:48:49Z", "credits_charged": 10 }status is complete, or partial when some data didn't arrive within 10 minutes (scored with what arrived).
Errors
| HTTP | error | When |
|---|---|---|
| 400 | invalid_email | Not a valid email address |
| 400 | invalid_domain | The company's website was rejected (Domain checks). Free |
| 401 | unauthorized | Missing, wrong or revoked key |
| 402 | insufficient_credits | Balance below the price (10, or 20 for a generic email) |
| 403 / 409 / 422 | template_not_allowed / template_not_live / template_empty | Template problems |
| 502 | provider_unavailable | A data source didn't answer while finding the company. Free; try again |