{ "item": [ { "id": "c94b1207-9d86-48c6-ade2-a19f307f7dcc", "name": "Lookup", "description": { "content": "Identity lookups across 800+ platforms", "type": "text/plain" }, "item": [ { "id": "019e2b20-7ee9-495d-b7d6-cad8beba7c1a", "name": "List every platform that can be named in a lookup", "request": { "name": "List every platform that can be named in a lookup", "description": { "content": "Every slug accepted by the `platforms` parameter, with the query types that can reach it and whether it answers on the instant path. A platform whose `supports` does not include the input you send is skipped rather than rejected.", "type": "text/plain" }, "url": { "path": [ "v1", "platforms" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "8bf9cc24-dd1e-470e-bd7a-db6847a8148d", "originalRequest": { "url": { "path": [ "v1", "platforms" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"total\": 1243,\n \"platforms\": [\n {\n \"platform\": \"github\",\n \"supports\": [\n \"email\",\n \"username\"\n ],\n \"instant\": [\n \"email\"\n ]\n },\n {\n \"platform\": \"github\",\n \"supports\": [\n \"email\",\n \"username\"\n ],\n \"instant\": [\n \"email\"\n ]\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f2a2dbfe-db0a-4d16-a2ec-7f4969ea3c89", "name": "Run a lookup", "request": { "name": "Run a lookup", "description": { "content": "Send one of `query` (auto-detected), `email`, or `phone`. Returns immediately with a `lookupId` to poll, or pass `?wait=true` to block until the full result is ready.", "type": "text/plain" }, "url": { "path": [ "v1", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": true, "key": "wait", "value": "true", "description": "Set to `true` to wait for the full result." }, { "disabled": true, "key": "instant", "value": "true", "description": "Set to `true` for a latency-bounded answer (default ceiling 900ms). Runs a high-signal subset of platforms and returns whatever answered in time; anything still in flight is omitted, and `platformsPending` says how much. Always synchronous - `wait` is not needed. Use it when you are fanning out to several APIs per transaction and cannot absorb a slow one." }, { "disabled": true, "key": "deep", "value": "true", "description": "Set to `true` to check the full platform set rather than the default band. Slower and unbounded - use it when coverage matters more than latency. The async path (POST without `wait`) already runs at this depth." } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"query\": \"someone@example.com\",\n \"email\": \"someone@example.com\",\n \"phone\": \"+14155552671\",\n \"platforms\": [\n \"google\",\n \"github\"\n ],\n \"ip\": \"8.8.8.8\",\n \"checks\": {\n \"email\": true,\n \"ip\": true\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "cb3d3ccd-5321-44d9-902e-1afb857bfe68", "name": "With `?wait=true`, the full result. Without it, a job handle to poll.", "originalRequest": { "url": { "path": [ "v1", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "wait", "value": "true" }, { "key": "instant", "value": "true" }, { "key": "deep", "value": "true" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"query\": \"someone@example.com\",\n \"email\": \"someone@example.com\",\n \"phone\": \"+14155552671\",\n \"platforms\": [\n \"google\",\n \"github\"\n ],\n \"ip\": \"8.8.8.8\",\n \"checks\": {\n \"email\": true,\n \"ip\": true\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"lookupId\": \"8f2c1d3e-4a5b-6c7d-8e9f-0a1b2c3d4e5f\",\n \"query\": \"someone@example.com\",\n \"platformsChecked\": 844,\n \"matches\": 3,\n \"socialMatches\": 2,\n \"hits\": [\n \"google\",\n \"github\",\n \"spotify\"\n ],\n \"servedFromCache\": false,\n \"results\": [\n {\n \"platform\": \"github\",\n \"registered\": true,\n \"method\": \"public_api\",\n \"icon\": \"https://digifootprint.dev/icons/github.svg\",\n \"checkedAt\": \"2026-08-26T11:40:55.902Z\",\n \"mailboxProvider\": true\n },\n {\n \"platform\": \"github\",\n \"registered\": true,\n \"method\": \"public_api\",\n \"icon\": \"https://digifootprint.dev/icons/github.svg\",\n \"checkedAt\": \"2026-08-26T11:40:55.902Z\",\n \"mailboxProvider\": true\n }\n ],\n \"breaches\": [\n {\n \"name\": \"Adobe\",\n \"date\": \"2013-10-04\"\n },\n {\n \"name\": \"Adobe\",\n \"date\": \"2013-10-04\"\n }\n ],\n \"webMentions\": [\n {\n \"title\": \"Someone (@someone) on a public profile\",\n \"url\": \"https://example.com/profile\",\n \"snippet\": \"Public page referencing the query.\",\n \"matchConfidence\": \"confirmed\"\n },\n {\n \"title\": \"Someone (@someone) on a public profile\",\n \"url\": \"https://example.com/profile\",\n \"snippet\": \"Public page referencing the query.\",\n \"matchConfidence\": \"confirmed\"\n }\n ],\n \"phoneDetails\": {\n \"valid\": true,\n \"carrier\": \"T-Mobile USA\",\n \"lineType\": \"mobile\",\n \"countryCode\": \"US\",\n \"voipClass\": \"nonFixed\",\n \"isVoip\": true\n },\n \"emailDetails\": {\n \"deliverable\": true,\n \"disposable\": false,\n \"freeProvider\": true,\n \"acceptAll\": false,\n \"domainAgeDays\": null,\n \"domainRegisteredAt\": null\n },\n \"ipDetails\": {\n \"ip\": \"8.8.8.8\",\n \"riskScore\": 0,\n \"confidence\": 100,\n \"isProxy\": false,\n \"isVpn\": false,\n \"isTor\": false,\n \"isHosting\": true,\n \"isScraper\": false,\n \"isCompromised\": false,\n \"operator\": null,\n \"asn\": \"AS15169\",\n \"isp\": \"Google LLC\",\n \"connectionType\": \"Hosting\",\n \"countryCode\": \"US\",\n \"regionName\": \"California\",\n \"cityName\": \"Mountain View\",\n \"latitude\": 37.4056,\n \"longitude\": -122.0775,\n \"timezone\": \"America/Los_Angeles\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "809ebf8f-512f-48c8-930b-a29e5e831441", "name": "Free trial used up, or monthly plan limit reached.", "originalRequest": { "url": { "path": [ "v1", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "wait", "value": "true" }, { "key": "instant", "value": "true" }, { "key": "deep", "value": "true" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"query\": \"someone@example.com\",\n \"email\": \"someone@example.com\",\n \"phone\": \"+14155552671\",\n \"platforms\": [\n \"google\",\n \"github\"\n ],\n \"ip\": \"8.8.8.8\",\n \"checks\": {\n \"email\": true,\n \"ip\": true\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Payment Required", "code": 402, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"quota_exceeded\",\n \"message\": \"You have used all 15 free lookups.\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "33bee2ed-41b9-4d48-bf36-2baa529e9c63", "name": "No query, email, or phone was sent.", "originalRequest": { "url": { "path": [ "v1", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "wait", "value": "true" }, { "key": "instant", "value": "true" }, { "key": "deep", "value": "true" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"query\": \"someone@example.com\",\n \"email\": \"someone@example.com\",\n \"phone\": \"+14155552671\",\n \"platforms\": [\n \"google\",\n \"github\"\n ],\n \"ip\": \"8.8.8.8\",\n \"checks\": {\n \"email\": true,\n \"ip\": true\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"quota_exceeded\",\n \"message\": \"You have used all 15 free lookups.\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dc1cf625-50fb-41d1-b271-3c8dd6a41304", "name": "Rate limit exceeded.", "originalRequest": { "url": { "path": [ "v1", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "wait", "value": "true" }, { "key": "instant", "value": "true" }, { "key": "deep", "value": "true" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"query\": \"someone@example.com\",\n \"email\": \"someone@example.com\",\n \"phone\": \"+14155552671\",\n \"platforms\": [\n \"google\",\n \"github\"\n ],\n \"ip\": \"8.8.8.8\",\n \"checks\": {\n \"email\": true,\n \"ip\": true\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"quota_exceeded\",\n \"message\": \"You have used all 15 free lookups.\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f9ce06d3-756c-4109-9fbe-70e3ee824fbb", "name": "List your lookups", "request": { "name": "List your lookups", "description": { "content": "Most recent first. Scoped to the account the API key belongs to.", "type": "text/plain" }, "url": { "path": [ "v1", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": true, "key": "limit", "value": "string", "description": "Default 20, max 100." }, { "disabled": true, "key": "offset", "value": "string", "description": "Default 0." } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "1feaa139-87b4-404e-8eb4-447fd9d919b3", "name": "The lookups this account has run.", "originalRequest": { "url": { "path": [ "v1", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "string" }, { "key": "offset", "value": "string" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "[\n {\n \"id\": \"8f2c1d3e-4a5b-6c7d-8e9f-0a1b2c3d4e5f\",\n \"query\": \"someone@example.com\",\n \"queryType\": \"email\",\n \"platformsChecked\": 844,\n \"matches\": 3,\n \"socialMatches\": 2,\n \"createdAt\": \"2026-08-26T11:40:55.902Z\"\n },\n {\n \"id\": \"8f2c1d3e-4a5b-6c7d-8e9f-0a1b2c3d4e5f\",\n \"query\": \"someone@example.com\",\n \"queryType\": \"email\",\n \"platformsChecked\": 844,\n \"matches\": 3,\n \"socialMatches\": 2,\n \"createdAt\": \"2026-08-26T11:40:55.902Z\"\n }\n]", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a57e40c3-c96e-4bf6-ad56-fcd712a3fd1a", "name": "Read rate limit exceeded (20/min).", "originalRequest": { "url": { "path": [ "v1", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "string" }, { "key": "offset", "value": "string" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"quota_exceeded\",\n \"message\": \"You have used all 15 free lookups.\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ca71c519-3ac6-4f8f-b534-31df337c34a3", "name": "Queue up to 50 lookups", "request": { "name": "Queue up to 50 lookups", "description": { "content": "Each item is billed and queued as its own lookup and gets its own lookupId. Results are read back one at a time with GET /v1/lookup/{id}. A malformed item is rejected up front and nothing is billed. Once accepted, items are billed and queued independently, so one item running out of credit never voids the rest.", "type": "text/plain" }, "url": { "path": [ "v1", "lookup", "batch" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"items\": [\n {\n \"email\": \"someone@example.com\",\n \"phone\": \"+14155552671\",\n \"ip\": \"8.8.8.8\",\n \"query\": \"someone\",\n \"checks\": {\n \"email\": true\n }\n },\n {\n \"email\": \"someone@example.com\",\n \"phone\": \"+14155552671\",\n \"ip\": \"8.8.8.8\",\n \"query\": \"someone\",\n \"checks\": {\n \"email\": true\n }\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "ba024295-3800-415c-9d13-55a15728b9b3", "originalRequest": { "url": { "path": [ "v1", "lookup", "batch" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"items\": [\n {\n \"email\": \"someone@example.com\",\n \"phone\": \"+14155552671\",\n \"ip\": \"8.8.8.8\",\n \"query\": \"someone\",\n \"checks\": {\n \"email\": true\n }\n },\n {\n \"email\": \"someone@example.com\",\n \"phone\": \"+14155552671\",\n \"ip\": \"8.8.8.8\",\n \"query\": \"someone\",\n \"checks\": {\n \"email\": true\n }\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"results\": [\n {\n \"index\": 0,\n \"status\": \"queued\",\n \"lookupId\": \"8f2c1d3e-4a5b-6c7d-8e9f-0a1b2c3d4e5f\",\n \"error\": {\n \"code\": \"insufficient_credits\",\n \"message\": \"Top up to continue.\"\n }\n },\n {\n \"index\": 0,\n \"status\": \"queued\",\n \"lookupId\": \"8f2c1d3e-4a5b-6c7d-8e9f-0a1b2c3d4e5f\",\n \"error\": {\n \"code\": \"insufficient_credits\",\n \"message\": \"Top up to continue.\"\n }\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2631a026-16b4-4f5d-a84a-87a89aa5ae16", "name": "Empty batch, more than 50 items, or a malformed item.", "originalRequest": { "url": { "path": [ "v1", "lookup", "batch" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"items\": [\n {\n \"email\": \"someone@example.com\",\n \"phone\": \"+14155552671\",\n \"ip\": \"8.8.8.8\",\n \"query\": \"someone\",\n \"checks\": {\n \"email\": true\n }\n },\n {\n \"email\": \"someone@example.com\",\n \"phone\": \"+14155552671\",\n \"ip\": \"8.8.8.8\",\n \"query\": \"someone\",\n \"checks\": {\n \"email\": true\n }\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "21f8bcf4-c545-47ee-872a-2c296112d215", "name": "Batch rate limit exceeded.", "originalRequest": { "url": { "path": [ "v1", "lookup", "batch" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"items\": [\n {\n \"email\": \"someone@example.com\",\n \"phone\": \"+14155552671\",\n \"ip\": \"8.8.8.8\",\n \"query\": \"someone\",\n \"checks\": {\n \"email\": true\n }\n },\n {\n \"email\": \"someone@example.com\",\n \"phone\": \"+14155552671\",\n \"ip\": \"8.8.8.8\",\n \"query\": \"someone\",\n \"checks\": {\n \"email\": true\n }\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8b95be44-8b5a-40f9-8f4e-99fbac966f4b", "name": "Stream a lookup", "request": { "name": "Stream a lookup", "description": { "content": "Server-sent events. Each platform result is pushed as it resolves, so the first results arrive in well under a second rather than after the full run. Event types: `platform_result`, `breach_result`, `web_mentions_result`, `phone_details_result`, `done`.", "type": "text/plain" }, "url": { "path": [ "v1", "lookup", "stream" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": true, "key": "query", "value": "string" }, { "disabled": true, "key": "email", "value": "string" }, { "disabled": true, "key": "phone", "value": "string" }, { "disabled": true, "key": "ip", "value": "string" }, { "disabled": false, "key": "deep", "value": "string", "description": "(Required) " }, { "disabled": true, "key": "instant", "value": "true", "description": "Set to `true` for a latency-bounded stream. Runs the same high-signal subset as the batch instant path and closes at the ceiling, emitting `done` with `instant`, `deadlineMs` and `platformsPending`. Results still arrive as each check resolves - the ceiling only decides when the stream ends." }, { "disabled": false, "key": "platforms", "value": "string", "description": "(Required) " } ], "variable": [] }, "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "3c041f65-bc8a-40ba-bc13-da206e78c87b", "originalRequest": { "url": { "path": [ "v1", "lookup", "stream" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "query", "value": "string" }, { "key": "email", "value": "string" }, { "key": "phone", "value": "string" }, { "key": "ip", "value": "string" }, { "key": "deep", "value": "string" }, { "key": "instant", "value": "true" }, { "key": "platforms", "value": "string" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9b95e6a0-8ca2-4038-a8c7-9073de2b7e41", "name": "Get one lookup", "request": { "name": "Get one lookup", "description": { "content": "Returns the full result, or `status: \"processing\"` if the job has not finished yet. A lookup belonging to another account returns 404, identically to an id that does not exist.", "type": "text/plain" }, "url": { "path": [ "v1", "lookup", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "id", "description": "(Required) " } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "39a2c4de-2b4e-4254-8b73-0dbe9012220f", "originalRequest": { "url": { "path": [ "v1", "lookup", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"lookupId\": \"8f2c1d3e-4a5b-6c7d-8e9f-0a1b2c3d4e5f\",\n \"query\": \"someone@example.com\",\n \"platformsChecked\": 844,\n \"matches\": 3,\n \"socialMatches\": 2,\n \"hits\": [\n \"google\",\n \"github\",\n \"spotify\"\n ],\n \"servedFromCache\": false,\n \"results\": [\n {\n \"platform\": \"github\",\n \"registered\": true,\n \"method\": \"public_api\",\n \"icon\": \"https://digifootprint.dev/icons/github.svg\",\n \"checkedAt\": \"2026-08-26T11:40:55.902Z\",\n \"mailboxProvider\": true\n },\n {\n \"platform\": \"github\",\n \"registered\": true,\n \"method\": \"public_api\",\n \"icon\": \"https://digifootprint.dev/icons/github.svg\",\n \"checkedAt\": \"2026-08-26T11:40:55.902Z\",\n \"mailboxProvider\": true\n }\n ],\n \"breaches\": [\n {\n \"name\": \"Adobe\",\n \"date\": \"2013-10-04\"\n },\n {\n \"name\": \"Adobe\",\n \"date\": \"2013-10-04\"\n }\n ],\n \"webMentions\": [\n {\n \"title\": \"Someone (@someone) on a public profile\",\n \"url\": \"https://example.com/profile\",\n \"snippet\": \"Public page referencing the query.\",\n \"matchConfidence\": \"confirmed\"\n },\n {\n \"title\": \"Someone (@someone) on a public profile\",\n \"url\": \"https://example.com/profile\",\n \"snippet\": \"Public page referencing the query.\",\n \"matchConfidence\": \"confirmed\"\n }\n ],\n \"phoneDetails\": {\n \"valid\": true,\n \"carrier\": \"T-Mobile USA\",\n \"lineType\": \"mobile\",\n \"countryCode\": \"US\",\n \"voipClass\": \"nonFixed\",\n \"isVoip\": true\n },\n \"emailDetails\": {\n \"deliverable\": true,\n \"disposable\": false,\n \"freeProvider\": true,\n \"acceptAll\": false,\n \"domainAgeDays\": null,\n \"domainRegisteredAt\": null\n },\n \"ipDetails\": {\n \"ip\": \"8.8.8.8\",\n \"riskScore\": 0,\n \"confidence\": 100,\n \"isProxy\": false,\n \"isVpn\": false,\n \"isTor\": false,\n \"isHosting\": true,\n \"isScraper\": false,\n \"isCompromised\": false,\n \"operator\": null,\n \"asn\": \"AS15169\",\n \"isp\": \"Google LLC\",\n \"connectionType\": \"Hosting\",\n \"countryCode\": \"US\",\n \"regionName\": \"California\",\n \"cityName\": \"Mountain View\",\n \"latitude\": 37.4056,\n \"longitude\": -122.0775,\n \"timezone\": \"America/Los_Angeles\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a2191bc1-b8e9-4bdb-8cb0-426d8dbb1237", "name": "No lookup with that id on your account.", "originalRequest": { "url": { "path": [ "v1", "lookup", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"quota_exceeded\",\n \"message\": \"You have used all 15 free lookups.\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "4a325f4f-ad51-4781-af82-2f68309189e8", "name": "Checks", "description": { "content": "", "type": "text/plain" }, "item": [ { "id": "274632bf-2e5e-4ff2-b571-3d99a03d4ce6", "name": "Check one email address", "request": { "name": "Check one email address", "description": { "content": "Mailbox-level facts about an address: whether it is deliverable, disposable, consumer webmail, on a catch-all domain, and how old its domain is. Skips the platform sweep, so it answers in about a second. Billed as one lookup.", "type": "text/plain" }, "url": { "path": [ "v1", "email" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"email\": \"someone@example.com\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "5dedb78b-1033-42ab-af4f-96ab5fb81a98", "originalRequest": { "url": { "path": [ "v1", "email" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"email\": \"someone@example.com\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"lookupId\": \"8f2c1d3e-4a5b-6c7d-8e9f-0a1b2c3d4e5f\",\n \"query\": \"someone@example.com\",\n \"emailDetails\": {\n \"deliverable\": true,\n \"disposable\": false,\n \"freeProvider\": true,\n \"acceptAll\": false,\n \"domainAgeDays\": null,\n \"domainRegisteredAt\": null\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a612194d-c8eb-453b-85fe-8a30fc7e03a6", "name": "Out of credits.", "originalRequest": { "url": { "path": [ "v1", "email" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"email\": \"someone@example.com\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Payment Required", "code": 402, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "e127ad91-e321-49f3-b095-4ad3f16fe1b6", "name": "Invalid email address.", "originalRequest": { "url": { "path": [ "v1", "email" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"email\": \"someone@example.com\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "274b15ab-409a-4902-b0ba-0bbebb1ae2f6", "name": "Check one phone number", "request": { "name": "Check one phone number", "description": { "content": "Line-level facts about a number: validity, carrier, line type, and whether it is VOIP - including whether that VOIP line is fixed (a business line) or non-fixed (a number minted in an app). Skips the platform sweep. Billed as one lookup.", "type": "text/plain" }, "url": { "path": [ "v1", "phone" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"phone\": \"+14155552671\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "b904cc3c-671c-4a68-a89a-6fb8bc128161", "originalRequest": { "url": { "path": [ "v1", "phone" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"phone\": \"+14155552671\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"lookupId\": \"8f2c1d3e-4a5b-6c7d-8e9f-0a1b2c3d4e5f\",\n \"query\": \"+14155552671\",\n \"phoneDetails\": {\n \"valid\": true,\n \"carrier\": \"T-Mobile USA\",\n \"lineType\": \"mobile\",\n \"countryCode\": \"US\",\n \"voipClass\": \"nonFixed\",\n \"isVoip\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b712ee48-8c6d-4e75-b3cc-401450bbad6d", "name": "Out of credits.", "originalRequest": { "url": { "path": [ "v1", "phone" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"phone\": \"+14155552671\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Payment Required", "code": 402, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "6876eca3-21a6-4f4b-a6e2-4bb0d08bcd3c", "name": "Invalid phone number.", "originalRequest": { "url": { "path": [ "v1", "phone" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"phone\": \"+14155552671\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d7ebdcd9-4a0b-46a5-85ca-81aeda9e86c4", "name": "Check one IP address", "request": { "name": "Check one IP address", "description": { "content": "Risk and network facts about an address: a 0-100 risk score, VPN/proxy/Tor/datacenter flags, the VPN operator where known, plus geolocation and network owner. The fastest endpoint here - one call and a local database read. Billed as one lookup.", "type": "text/plain" }, "url": { "path": [ "v1", "ip" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"ip\": \"8.8.8.8\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "65fb0b23-df49-4f56-a90c-1fff4f785b77", "originalRequest": { "url": { "path": [ "v1", "ip" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"ip\": \"8.8.8.8\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"lookupId\": \"8f2c1d3e-4a5b-6c7d-8e9f-0a1b2c3d4e5f\",\n \"query\": \"8.8.8.8\",\n \"ipDetails\": {\n \"ip\": \"8.8.8.8\",\n \"riskScore\": 0,\n \"confidence\": 100,\n \"isProxy\": false,\n \"isVpn\": false,\n \"isTor\": false,\n \"isHosting\": true,\n \"isScraper\": false,\n \"isCompromised\": false,\n \"operator\": null,\n \"asn\": \"AS15169\",\n \"isp\": \"Google LLC\",\n \"connectionType\": \"Hosting\",\n \"countryCode\": \"US\",\n \"regionName\": \"California\",\n \"cityName\": \"Mountain View\",\n \"latitude\": 37.4056,\n \"longitude\": -122.0775,\n \"timezone\": \"America/Los_Angeles\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d081f9e1-3fb0-4cf2-a26c-baff9539d566", "name": "Out of credits.", "originalRequest": { "url": { "path": [ "v1", "ip" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"ip\": \"8.8.8.8\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Payment Required", "code": 402, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "effe1b16-2566-49af-87b8-fa65f4d68c5f", "name": "Invalid IP address.", "originalRequest": { "url": { "path": [ "v1", "ip" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"ip\": \"8.8.8.8\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] } ], "event": [], "variable": [ { "type": "string", "value": "https://api.digifootprint.dev", "key": "baseUrl" } ], "info": { "_postman_id": "3d56ddc2-efd3-49f1-a47c-253202e501e6", "name": "Digital Footprint API (v1)", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "description": { "content": "Given an email address, phone number, or username, find where that identity is registered across the internet, plus breach history and public web associations.\n\nEvery platform result is one of three states: registered, not registered, or omitted. A platform we could not get a confident answer for is left out of the response entirely - it is never reported as \"not registered\". Likewise `breaches` and `webMentions` are null when a source is not configured, which is different from an empty array meaning we checked and found nothing.", "type": "text/plain" } } }