Platinux API

POST/score/email

Score from an email

Score the company behind any email: company or work email 10 credits, generic email 20.

View as Markdown

Send an email address; we find the company and score it in one call.

EmailExampleHow we find the companyCredits
Companyinfo@acme.comThe email's own domain10
Workjane@mail.acme.comThe email's own domain → acme.com10
Generic (Gmail, Outlook, etc.)jane.doe@gmail.comThe person's professional profile → their current employer → its website20
Temporaryx@mailinator.comNone: there is no company0

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

bash
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 fieldTypeRequired
emailstringYes
template_idstring (UUID)Yes

Company found, scoring started: 202

json
{ "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

json
{ "status": "not_found", "input": "someone@gmail.com", "input_type": "personal_email", "domain": null, "score": null, "credits_charged": 0 }
json
{ "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

bash
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.

json
{ "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

HTTPerrorWhen
400invalid_emailNot a valid email address
400invalid_domainThe company's website was rejected (Domain checks). Free
401unauthorizedMissing, wrong or revoked key
402insufficient_creditsBalance below the price (10, or 20 for a generic email)
403 / 409 / 422template_not_allowed / template_not_live / template_emptyTemplate problems
502provider_unavailableA data source didn't answer while finding the company. Free; try again