{ "item": [ { "id": "07dab6b8-9cad-452f-aecb-4f1cd9cc16f3", "name": "Lookup", "description": { "content": "Identity lookups across 800+ platforms", "type": "text/plain" }, "item": [ { "id": "575c61e4-065a-4004-9cf9-8e7bc36498e9", "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": false, "key": "wait", "value": "string", "description": "Set to `true` to wait for the full result." } ], "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}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "a4c5db2b-ca7d-4e43-a7b0-194a68a95165", "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": "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": "POST", "body": { "mode": "raw", "raw": "{\n \"query\": \"someone@example.com\",\n \"email\": \"someone@example.com\",\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\": \"someone@example.com\",\n \"platformsChecked\": 844,\n \"matches\": 3,\n \"socialMatches\": 2,\n \"servedFromCache\": false,\n \"results\": [\n {\n \"platform\": \"github\",\n \"registered\": true,\n \"method\": \"public_api\",\n \"icon\": \"https://cdn.jsdelivr.net/npm/simple-icons@latest/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://cdn.jsdelivr.net/npm/simple-icons@latest/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\": \"AT&T\",\n \"lineType\": \"mobile\",\n \"countryCode\": \"US\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "11d39418-0450-4f0d-a6b4-e0cb4920eaa5", "name": "Free trial used up, or monthly plan limit reached.", "originalRequest": { "url": { "path": [ "v1", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "wait", "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": "POST", "body": { "mode": "raw", "raw": "{\n \"query\": \"someone@example.com\",\n \"email\": \"someone@example.com\",\n \"phone\": \"+14155552671\"\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": "3e927761-8cb0-4a9a-a0c5-14263e1433fd", "name": "No query, email, or phone was sent.", "originalRequest": { "url": { "path": [ "v1", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "wait", "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": "POST", "body": { "mode": "raw", "raw": "{\n \"query\": \"someone@example.com\",\n \"email\": \"someone@example.com\",\n \"phone\": \"+14155552671\"\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": "c0e8c0c5-8c86-44cb-b1e9-73c1f88684da", "name": "Rate limit exceeded.", "originalRequest": { "url": { "path": [ "v1", "lookup" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "wait", "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": "POST", "body": { "mode": "raw", "raw": "{\n \"query\": \"someone@example.com\",\n \"email\": \"someone@example.com\",\n \"phone\": \"+14155552671\"\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": "2c36d626-2798-47b0-93ae-50516385614e", "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": false, "key": "limit", "value": "string", "description": "Default 20, max 100." }, { "disabled": false, "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": "d1d10beb-7c68-4fa7-80f5-c6ed1a5d80e6", "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": "8cd4092d-8019-446e-835d-3563d6aeb6f9", "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": "6ea5a367-227c-49f5-8715-11476f850961", "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": false, "key": "query", "value": "string" }, { "disabled": false, "key": "email", "value": "string" }, { "disabled": false, "key": "phone", "value": "string" } ], "variable": [] }, "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "c4ccac4d-4084-4152-a07e-35c13a3b540b", "originalRequest": { "url": { "path": [ "v1", "lookup", "stream" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "query", "value": "string" }, { "key": "email", "value": "string" }, { "key": "phone", "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": "71b46145-25f6-49f6-abb7-e61131e70481", "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": "01756677-703e-4f78-be4a-2ba8157d70f3", "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 \"servedFromCache\": false,\n \"results\": [\n {\n \"platform\": \"github\",\n \"registered\": true,\n \"method\": \"public_api\",\n \"icon\": \"https://cdn.jsdelivr.net/npm/simple-icons@latest/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://cdn.jsdelivr.net/npm/simple-icons@latest/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\": \"AT&T\",\n \"lineType\": \"mobile\",\n \"countryCode\": \"US\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fe2301bc-5fac-45b0-a899-d82deea6611f", "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": [] } ], "event": [], "variable": [ { "type": "string", "value": "http://localhost:4000", "key": "baseUrl" } ], "info": { "_postman_id": "f788d970-22c1-4455-afed-4ea910fde054", "name": "Digital Footprint API", "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" } } }