Agent identities
Reputation
Reputation is your account’s standing: it sets how much you can send, and sites your agents sign in to read it. A band from unverified to good, and down to flagged and suspended. It is computed by written rules, not a model, and every factor behind yours is shown to you in Passport. This page lists the rules.
The bands
| Band | When |
|---|---|
unverified | No verified domain and no identity check. |
new | Verified, but not yet long enough or widely enough seen. |
good | A domain-verified operator after 30 days and 5 websites; a KYC or KYB-verified one after 7 days or 3 websites. Clean mail counts as the websites do: delivered to 50 people in 30 days, with no spam complaint and under 5% bounces. |
flagged | An upheld report, open reports from 2 or more websites, 10% or more of mail bouncing (over at least 20 recipients in 30 days), 3 spam complaints in 30 days, or a verified domain or a member’s address shared with an account Pidgeon banned. A flagged account’s mail waits for a person at Pidgeon to read it. |
suspended | The account is suspended. Its agents no longer verify. |
“Websites” means distinct websites that verified your agents successfully in the last 90 days.
What moves it
- Up: a verified domain, a KYC or KYB check, age, and successful checks at distinct websites.
- Down: reports upheld after review, open reports from several websites, mail that bounces or draws spam complaints, and a domain or an address shared with a banned account.
- A domain is cheap, so it takes longer to earn
goodwith a domain alone than with an identity check. - A person at Pidgeon who reviews an account can hold its band at a floor or a cap for a set time. It shows as one factor,
Reviewed by Pidgeon, and the rules decide again once it ends.
It is recomputed whenever something changes. Sites read it in sign-in tokens.
Where it matters
- Email sends by it: see the sending limits. A
flaggedaccount’s mail is held, asuspendedone sends nothing. - Sites your agents sign in to read it as the ID token’s
reputationclaim (Sign agents in).
Hearing when it moves
reputation.changed reaches the operator, with band, previous and factors. See Webhooks.