# Score from an email

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

`POST https://mmkuffhlzytnmgraagbp.supabase.co/functions/v1/score/email`

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

| Email | 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

```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 field | Type | Required |
|---|---|---|
| `email` | string | Yes |
| `template_id` | string (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

| HTTP | `error` | When |
|---|---|---|
| 400 | `invalid_email` | Not a valid email address |
| 400 | `invalid_domain` | The company's website was rejected ([Domain checks](/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 |
