API Reference — SignupDoggy · /v1/check, /v1/keys, /v1/blacklist, /v1/stats

Full SignupDoggy API reference. One endpoint — POST /v1/check — returns a 0–1 fraud risk score in under 50ms. Authentication, request/response schemas, error codes, and curl/Node/Python examples.

SignupDoggy API Reference

ONE ENDPOINT. ONE API KEY. ONE DECISION: ALLOW / REVIEW / BLOCK.

Base URL: https://signupdoggy-api.jeffrinjames99.workers.dev

Authentication: pass your API key in the X-API-KEY header. Keys are 52-character strings prefixed with SD_.

Endpoints:

POST /v1/check — Evaluate email, IP, and/or phone in one call. Pass at least one of email, ip, or phone. Returns per-input signals, an overall risk band, and a recommendation. Costs one credit.

POST /v1/keys — Mint a new API key. No auth header required. Returns 201.

POST /v1/blacklist — Add or remove an email / IP / phone on your account blacklist. Blacklisted values return recommendation: "block" whatever the other signals say.

GET /v1/stats — Requests, blocks (by reason), and estimated cost for today (UTC).

Response headers from /v1/check: X-Fraud-Blocked-Today, X-Fraud-Blocked-Reason, X-Estimated-Cost, X-Credit-Balance.

Errors: 400 (bad request, invalid JSON, no email/ip/phone supplied), 401 (unauthorized, missing or invalid API key), 402 (out of credits), 500 (internal error).

Pricing inline: $0.01 per request, deducted from your pre-paid credit balance. Credits never expire. No monthly fee. No sales call.

Languages: curl, Node.js, and Python examples are provided for every endpoint.