{ "info": { "_postman_id": "5dbf78d0-510d-55da-bec8-53f428931c84", "name": "Enrich API", "description": { "content": "Every Enrich API v3 operation, assembled from the OpenAPI fragments Enrich publishes on each documentation page.", "type": "text/plain" }, "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "item": [ { "id": "19d286a0-6937-5c72-adf7-bff9e645a4e7", "name": "Wallets", "description": { "content": "", "type": "text/plain" }, "item": [ { "id": "485491a8-7fd2-54bd-8f77-6fdc6ac07541", "name": "Get your credit balance", "request": { "name": "Get your credit balance", "description": { "content": "Returns the current credit balance for your organization.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/wallets/balance", "host": [ "{{baseUrl}}" ], "path": [ "wallets", "balance" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "GET", "auth": null }, "response": [ { "id": "3cad579b-8ef2-514a-ac6d-e588155c1ba5", "name": "Current credit balance", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"organizationId\": \"665e0b2f4a6d8c001abc1234\",\n \"balance\": 25000,\n \"currency\": \"credits\",\n \"asOf\": \"2025-06-03T14:22:10.000Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b22c9dee-817b-5a19-92dd-9a16ac6502c4", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "581117ea-cfa7-5ee1-88d8-4a7c6e0cfee4", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "6672cbb9-a81f-50e2-860e-8672c0280bba", "name": "Get transaction history", "request": { "name": "Get transaction history", "description": { "content": "Browse your credit transactions \u2014 top-ups, deductions, refunds, and\nadjustments. Use the `type` parameter to filter by transaction type.\nResults are paginated.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/wallets/transactions", "host": [ "{{baseUrl}}" ], "path": [ "wallets", "transactions" ], "query": [ { "key": "page", "value": "1", "description": "Page number (default: 1)", "disabled": true }, { "key": "limit", "value": "50", "description": "Items per page (default: 50, max: 100)", "disabled": true }, { "key": "type", "value": "string", "description": "Filter by type: `deduction`, `topup`, `adjustment`, or `refund`", "disabled": true } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "GET", "auth": null }, "response": [ { "id": "d1012184-8f53-593e-aa27-3612eb4180b0", "name": "Paginated transaction list", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"transactions\": [\n {\n \"id\": \"665e10a14a6d8c001abc2001\",\n \"organizationId\": \"665e0b2f4a6d8c001abc1234\",\n \"type\": \"deduction\",\n \"amount\": -10,\n \"balanceAfter\": 24990,\n \"description\": \"Email finder: emily.zhang@figma.com\",\n \"createdAt\": \"2025-06-03T14:35:00.000Z\"\n },\n {\n \"id\": \"665e10a14a6d8c001abc2002\",\n \"organizationId\": \"665e0b2f4a6d8c001abc1234\",\n \"type\": \"refund\",\n \"amount\": 10,\n \"balanceAfter\": 25000,\n \"description\": \"Batch refund \\u2014 1 unfound lead in batch 665b12cf3e4c9200138eaf10\",\n \"createdAt\": \"2025-06-03T14:30:00.000Z\"\n },\n {\n \"id\": \"665e10a14a6d8c001abc2003\",\n \"organizationId\": \"665e0b2f4a6d8c001abc1234\",\n \"type\": \"topup\",\n \"amount\": 25000,\n \"balanceAfter\": 25000,\n \"description\": \"Credit purchase \\u2014 Pro plan (monthly)\",\n \"createdAt\": \"2025-06-01T00:00:00.000Z\"\n }\n ],\n \"pagination\": {\n \"page\": 1,\n \"limit\": 50,\n \"total\": 3,\n \"totalPages\": 1\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5aa61848-f7f0-5a2f-8141-d68d29efed29", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ebb96be9-ec22-529f-a58d-c5ecf930f84a", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] } ] }, { "id": "b5b94c84-7de6-5d52-bd35-223db7e4ac7c", "name": "Company Followers", "description": { "content": "", "type": "text/plain" }, "item": [ { "id": "73b2ad90-25b4-5794-948b-eefdf6545b30", "name": "Continue company follower scrape", "request": { "name": "Continue company follower scrape", "description": { "content": "> **Access required** \u2014 approved accounts only. [Contact us](https://enrich.so) to request access.\n\nContinue an under-delivered **partial** company-follower scrape to fill the gap. Re-runs **only** the filter combinations that under-delivered on the original run and appends the new profiles to the **same batch** (already-collected profiles are kept and de-duplicated within the batch).\n\n**How to call:** POST to this same `/company-follower` endpoint with the original batch id as the `batchId` query parameter and an **empty body**. The presence of `batchId` switches the endpoint from \u201cstart a new scrape\u201d to \u201ccontinue\u201d.\n\n**Eligibility:** only a batch whose status is `partial` and that is **less than 3 days old** can be continued (after 3 days the per-filter diagnostics used to target the gap have expired \u2192 `410 Gone`). A fully `completed` batch, or one already being continued, returns `409 Conflict`. If nothing is recoverable (every filter already delivered, or the remaining gap is unreachable) you get `422`.\n\n**Cost:** credits are reserved only for the recoverable **additional** profiles \u2014 not the whole batch again \u2014 under a separate reservation. On settle you are charged for the profiles the continue actually added and refunded the rest.\n\n**Polling & results:** keep using the **same** `batchId` with the progress and results endpoints; the continue tops up that same batch.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/company-follower", "host": [ "{{baseUrl}}" ], "path": [ "company-follower" ], "query": [ { "key": "batchId", "value": "string", "description": "The batch id of the PARTIAL scrape you want to continue. Its presence switches this endpoint from 'start a new scrape' to 'continue (fill the gap)'.", "disabled": false } ], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "60b6a7d7-b156-59e0-b0e5-d336b2634fc4", "name": "Continue accepted \u2014 the gap scrape has been queued.", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"batchId\": \"665a1f4e2c3b7800129dce01\",\n \"message\": \"Continuing scrape for the remaining 7076 profile(s).\",\n \"estimatedAdditional\": 7076\n },\n \"meta\": {\n \"requestId\": \"664f2b3c9a1e4d0012abcdef\",\n \"creditsReserved\": 707600,\n \"creditsPerItem\": 100\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f2f751e8-1607-5cfe-925f-eddd22466041", "name": "Missing batchId or team context.", "status": "400", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"error\": \"string\",\n \"message\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9791dc00-7b20-5467-889b-f22980f686e3", "name": "Your API key is missing or invalid.", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body/email Invalid email\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d4475b36-74a3-5d93-8991-6edd952cdd2e", "name": "Not enough credits to reserve the recoverable gap.", "status": "402", "code": 402, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"error\": \"Payment Required\",\n \"message\": \"Insufficient credits\",\n \"detail\": {\n \"required\": 707600,\n \"itemCount\": 7076\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1458683f-1765-5b70-be0c-e9c67fd9d620", "name": "No batch with that id belongs to your team.", "status": "404", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"error\": \"Not Found\",\n \"message\": \"Job not found\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f0833d04-ddd4-5603-bd77-bf8dac117d61", "name": "The batch is not partial (nothing to continue), a continue is already in progress, or the scrape is still running.", "status": "409", "code": 409, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"error\": \"Conflict\",\n \"message\": \"This scrape completed fully \\u2014 there is nothing to continue.\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4d0c0bd5-218f-5616-8f85-2483f3ae6628", "name": "The batch is older than 3 days \u2014 the diagnostics needed to target the gap have expired. Start a fresh scrape instead.", "status": "410", "code": 410, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"error\": \"Gone\",\n \"message\": \"Continue is only available within 3 days of the scrape. Start a fresh scrape instead.\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cec8a70c-e1a0-5b01-83fd-58d6d9aac5d4", "name": "Nothing is recoverable: every filter already delivered, or the remaining gap is unreachable.", "status": "422", "code": 422, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"error\": \"Unprocessable Entity\",\n \"message\": \"Every filter fully delivered \\u2014 the remaining gap is unclassified followers that no filter can reach (not recoverable by re-running).\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "51d10faf-6e92-5d2a-8cb1-31a791b75bdc", "name": "Rate limit exceeded.", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body/email Invalid email\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "8fba2ed7-1275-526f-9e7c-44b346baae52", "name": "Check daily scraping limit", "request": { "name": "Check daily scraping limit", "description": { "content": "Check your team's daily company follower scraping limit and current usage. No credits consumed.\n\n**Possible statuses:**\n- `approved` \u2014 Team has access; `creditsPerProfile`, `dailyLimit`, `dailyUsed`, and `dailyRemaining` are included.\n- `pending` \u2014 Application is under review.\n- `rejected` \u2014 Application was rejected.\n- `revoked` \u2014 Access was revoked.\n- `none` \u2014 No application on file.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/company-follower/limit", "host": [ "{{baseUrl}}" ], "path": [ "company-follower", "limit" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "GET", "auth": null }, "response": [ { "id": "255a1aab-0585-5b0d-b7a3-35a0987514f2", "name": "Returns the team's current access status and daily limit info. For approved teams, includes dailyLimit, dailyUsed, and d", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": false,\n \"data\": {\n \"status\": \"approved\",\n \"dailyLimit\": 5000,\n \"dailyUsed\": 1200,\n \"dailyRemaining\": 3800,\n \"creditsPerProfile\": 100\n },\n \"meta\": {\n \"requestId\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ec201146-40bf-5de1-b660-78c97a92de53", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body/email Invalid email\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c1c6b574-6d98-5a61-8dc6-ce61d46a3923", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body/email Invalid email\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "01df5e8e-ce3d-53b8-a114-f92a16d5b462", "name": "Something went wrong on our end \u2014 try again in a moment", "status": "500", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body/email Invalid email\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "98f7ce3a-973d-5490-9306-3a185865572c", "name": "Export results as CSV", "request": { "name": "Export results as CSV", "description": { "content": "> **Access required** \u2014 This endpoint is available to approved accounts only. [Contact us](https://enrich.so) to request access.\n\nDownload scrape results as a CSV file. Batch must be complete. No credits consumed.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/company-follower/{batchId}/export", "host": [ "{{baseUrl}}" ], "path": [ "company-follower", ":batchId", "export" ], "query": [], "variable": [ { "key": "batchId", "value": "", "description": "The batch identifier returned when you started the scrape" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "GET", "auth": null }, "response": [ { "id": "e846ef42-ad8f-59cd-868a-c1d28d3c155f", "name": "CSV file download containing all follower profiles", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8237df12-27f4-5ede-ab65-984d54a130e9", "name": "Batch is not yet complete. Wait for the scrape to finish before exporting.", "status": "400", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body/email Invalid email\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c8300519-e0d3-5698-9bc7-76cc592c7882", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body/email Invalid email\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "80160c6e-b0f1-530e-9f1c-a3d2aeef1610", "name": "The resource you requested doesn't exist or doesn't belong to your organization", "status": "404", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body/email Invalid email\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "38ff02ef-5561-56c9-a3a4-4f252cf9eb6e", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body/email Invalid email\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "35e3c42a-8830-59bb-b305-92350b29e6ed", "name": "Check scrape progress", "request": { "name": "Check scrape progress", "description": { "content": "> **Access required** \u2014 This endpoint is available to approved accounts only. [Contact us](https://enrich.so) to request access.\n\nPoll this endpoint to track the progress of your company follower scrape.\n\n**Cost:** Free \u2014 polling never costs credits.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/company-follower/{batchId}/progress", "host": [ "{{baseUrl}}" ], "path": [ "company-follower", ":batchId", "progress" ], "query": [], "variable": [ { "key": "batchId", "value": "", "description": "The batch identifier returned when you started the scrape" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "GET", "auth": null }, "response": [ { "id": "20ad1554-cf09-538f-ba1f-3d8c809d0d18", "name": "Current scrape progress", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"batchId\": \"665a1f4e2c3b7800129dce01\",\n \"processed\": 125,\n \"total\": 500,\n \"errors\": 0,\n \"done\": false,\n \"message\": \"Fetching profiles... 25% complete (125/500)\"\n },\n \"meta\": {\n \"requestId\": \"664f2b3c9a1e4d0012abcdef\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f14349a4-f040-512d-9bc5-181a7e8f1a7c", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2288a34b-804c-52a7-8919-7572c95d9702", "name": "The resource you requested doesn't exist or doesn't belong to your organization", "status": "404", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/not-found\",\n \"title\": \"Not Found\",\n \"status\": 404,\n \"detail\": \"No batch found with that ID\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b81554e3-3416-5844-879d-17ab8e604709", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "23fec6a7-d93a-5eff-9623-093d73ac9a73", "name": "Get scrape results", "request": { "name": "Get scrape results", "description": { "content": "> **Access required** This endpoint is available to approved accounts only. [Contact us](https://enrich.so) to request access.\n\nReturns paginated follower profiles for a completed batch. Use `page` and `limit` query params to paginate through results.\n\nCredits are charged upfront when you start the scrape. If fewer profiles are found than `max_limit`, unused credits are refunded automatically.\n\nIf you provided a `webhookUrl`, results are already delivered via webhooks and credits are auto-settled. No need to call this endpoint.\n\nOnly call this after the progress endpoint reports `done: true`.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/company-follower/{batchId}/results", "host": [ "{{baseUrl}}" ], "path": [ "company-follower", ":batchId", "results" ], "query": [ { "key": "page", "value": "1", "description": "Page number (default: 1)", "disabled": true }, { "key": "limit", "value": "100", "description": "Results per page, max 500 (default: 100)", "disabled": true } ], "variable": [ { "key": "batchId", "value": "", "description": "The batch identifier returned when you started the scrape" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "GET", "auth": null }, "response": [ { "id": "3bf5c81e-59f8-56c9-ac4a-dc074e532c9f", "name": "Follower profiles retrieved successfully", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"batchId\": \"665a1f4e2c3b7800129dce01\",\n \"count\": 100,\n \"data\": [\n {\n \"objectURN\": \"urn:li:member:123456\",\n \"name\": \"Sarah Chen\",\n \"firstName\": \"Sarah\",\n \"lastName\": \"Chen\",\n \"profileUrl\": \"https://linkedin.com/in/sarahchen\",\n \"title\": \"Senior Software Engineer\",\n \"companyName\": \"Stripe\",\n \"location\": \"San Francisco, CA\",\n \"connectionDegree\": 2,\n \"isPremium\": false,\n \"isOpenProfile\": true\n }\n ],\n \"pagination\": {\n \"page\": 1,\n \"limit\": 100,\n \"total\": 342,\n \"totalPages\": 4\n }\n },\n \"meta\": {\n \"requestId\": \"664f2b3c9a1e4d0012abcdef\",\n \"creditsUsed\": 34200,\n \"creditsRefunded\": 15800,\n \"creditsRemaining\": 0\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "121391ab-73aa-5329-99b3-afeab7f554ba", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "40a96789-48f3-53cd-a08d-a2a222fa6796", "name": "The resource you requested doesn't exist or doesn't belong to your organization", "status": "404", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/not-found\",\n \"title\": \"Not Found\",\n \"status\": 404,\n \"detail\": \"No batch found with that ID\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "22de3348-5076-5c9b-9e8a-3a41839af714", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "0f4b9047-6ff4-5b6e-91c0-77745b2b819a", "name": "Start count estimation", "request": { "name": "Start count estimation", "description": { "content": "> **Access required** \u2014 This endpoint is available to approved accounts only. [Contact us](https://enrich.so) to request access.\n\nStarts an asynchronous count estimation job. Returns the estimated number of followers matching your filters, with optional breakdowns by department and seniority.\n\n**Cost:** 100 credits (fixed). Cached results for the same company + filters within 24 hours are free.\n\n**Results:** Poll the status endpoint to get results. Typically completes within 30\u201360 seconds.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/count-estimate", "host": [ "{{baseUrl}}" ], "path": [ "count-estimate" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"companyUrl\": \"https://linkedin.com/company/stripe\",\n \"departments\": [\n \"Engineering\",\n \"Sales\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "9563f9b2-cde5-511a-b8b7-6aab720a11db", "name": "Count estimation job started successfully", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"batchId\": \"665b2a3f4c5d6e0013fgh002\",\n \"status\": \"pending\",\n \"message\": \"Count estimation job started. Results typically available within 30-60 seconds.\"\n },\n \"meta\": {\n \"requestId\": \"664f2b3c9a1e4d0012abcdef\",\n \"creditsUsed\": 100,\n \"creditsRemaining\": 24900\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9c4ce093-b4e8-5240-adff-2a4f6cc63189", "name": "Something is wrong with the request \u2014 check the `detail` field for specifics", "status": "400", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body/companyUrl Invalid url\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "997eb4c4-3fdf-555d-834e-65151eb2a476", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "66aa2cdc-adf5-5d6d-a096-1ad6a304d15a", "name": "You don't have enough credits for this request", "status": "402", "code": 402, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/insufficient-credits\",\n \"title\": \"Insufficient Credits\",\n \"status\": 402,\n \"detail\": \"Not enough credits. Required: 100, available: 3\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "907a55cf-545c-5b22-928c-15928343144e", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f9b58913-07cf-5bb9-8dab-0d3420a95509", "name": "Something went wrong on our end \u2014 try again in a moment", "status": "500", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/internal-error\",\n \"title\": \"Internal Server Error\",\n \"status\": 500,\n \"detail\": \"An unexpected error occurred. Please try again later.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "5ee75b20-31f5-58df-8aa3-0df97ced3390", "name": "Get estimation status/results", "request": { "name": "Get estimation status/results", "description": { "content": "> **Access required** \u2014 This endpoint is available to approved accounts only. [Contact us](https://enrich.so) to request access.\n\nCheck the status of a count estimation job and retrieve results when complete.\n\n**Cost:** Free \u2014 polling never costs credits.\n\n**Refunds:** If the job fails within 7 days, the 100 credits are refunded automatically on the next status check.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/count-estimate/{batchId}", "host": [ "{{baseUrl}}" ], "path": [ "count-estimate", ":batchId" ], "query": [], "variable": [ { "key": "batchId", "value": "", "description": "The batch identifier returned when you started the estimation" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "GET", "auth": null }, "response": [ { "id": "0fa17714-efcc-51a7-85ff-40621d578042", "name": "Estimation status and results", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"batchId\": \"665b2a3f4c5d6e0013fgh002\",\n \"status\": \"completed\",\n \"companyUrl\": \"https://linkedin.com/company/stripe\",\n \"message\": \"Count estimation complete. Found 8542 followers matching your criteria.\",\n \"createdAt\": \"2025-06-03T14:30:00.000Z\",\n \"completedAt\": \"2025-06-03T14:31:15.000Z\",\n \"data\": {\n \"totalCount\": 8542,\n \"functionBreakdown\": [\n {\n \"functionName\": \"Engineering\",\n \"functionId\": \"8\",\n \"count\": 3200,\n \"percentage\": 37.5\n },\n {\n \"functionName\": \"Sales\",\n \"functionId\": \"25\",\n \"count\": 1850,\n \"percentage\": 21.7\n }\n ],\n \"filtersApplied\": {\n \"departments\": [\n \"Engineering\",\n \"Sales\"\n ]\n }\n }\n },\n \"meta\": {\n \"requestId\": \"664f2b3c9a1e4d0012abcdef\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2703d77b-76eb-5a01-b240-fab43afd7a40", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b2fb64a6-c1df-5bdf-afbc-c6dee3da79e3", "name": "The resource you requested doesn't exist or doesn't belong to your organization", "status": "404", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/not-found\",\n \"title\": \"Not Found\",\n \"status\": 404,\n \"detail\": \"No batch found with that ID\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "924ef563-f742-512d-a50f-6fe3bc275f4f", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] } ] }, { "id": "523a106e-25f5-56ec-acdb-738a7b8a4fa7", "name": "IP to Company", "description": { "content": "", "type": "text/plain" }, "item": [ { "id": "243c4a3e-c37a-5d01-b0ed-a6c1acd5edbf", "name": "Resolve company from IP", "request": { "name": "Resolve company from IP", "description": { "content": "Resolves company, organization, and geolocation info from an IP address. Results are cached for 7 days.\n\n**Cost:** 100 credits. You are **not** charged if no domain is found (i.e. `ipDomain` is absent from the response).", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/ip-to-company", "host": [ "{{baseUrl}}" ], "path": [ "ip-to-company" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"ip\": \"8.8.8.8\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "b16ebb82-e6a2-5b65-9011-2886c48e0732", "name": "Domain resolved successfully", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"searchIp\": \"8.8.8.8\",\n \"ipDomain\": \"google.com\",\n \"ipOrganization\": \"Google LLC\",\n \"ipCountryName\": \"United States\",\n \"ipCountryCode\": \"US\",\n \"ipRegionName\": \"California\",\n \"ipCity\": \"Mountain View\",\n \"ipSubContinent\": \"Northern America\",\n \"ipLatitude\": 37.386,\n \"ipLongitude\": -122.0838,\n \"ipTimezone\": \"America/Los_Angeles\",\n \"ipIsp\": \"Google LLC\",\n \"ipRange\": \"8.8.8.0/24\",\n \"ipUsageType\": \"DCH\"\n },\n \"meta\": {\n \"requestId\": \"664f2b3c9a1e4d0012abcdef\",\n \"creditsUsed\": 100,\n \"creditsRemaining\": 4900\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "573c90f5-0dfd-5337-8535-17338f78a288", "name": "Something is wrong with the request \u2014 check the `detail` field for specifics", "status": "400", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"\\\"ip\\\" must be a non-empty string\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "befd85e3-010f-5a31-98d8-56de6f55f075", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"error\": \"Unauthorized\",\n \"message\": \"The API key provided is invalid or has been revoked\",\n \"statusCode\": 401\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6aecb10e-c1f9-5f25-9a70-cc7e1dcc2fa1", "name": "You don\u2019t have enough credits for this request", "status": "402", "code": 402, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"error\": \"Payment Required\",\n \"message\": \"Not enough credits. Required: 100, available: 0\",\n \"statusCode\": 402\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5c676cbe-0c18-56a7-80f0-20775dee29b4", "name": "You\u2019ve sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"error\": \"Too Many Requests\",\n \"message\": \"Rate limit exceeded. Please retry after 30 seconds.\",\n \"statusCode\": 429\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cd767734-17d7-5aad-a787-3d9e9e88cb5b", "name": "Something went wrong on our end \u2014 try again in a moment", "status": "500", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"error\": \"Internal Server Error\",\n \"message\": \"An unexpected error occurred. Please try again later.\",\n \"statusCode\": 500\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "40b1508d-1628-534a-9cb5-731c0bba2be9", "name": "Submit batch IP to company lookup", "request": { "name": "Submit batch IP to company lookup", "description": { "content": "Submit up to **500 000 IPs** in a single request for async company lookup. Duplicates are removed automatically before processing.\n\n**Cost:** 100 credits per unique IP, reserved when you submit. Credits are charged based on found domains when you fetch results \u2014 any excess is refunded automatically.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/ip-to-company/batch", "host": [ "{{baseUrl}}" ], "path": [ "ip-to-company", "batch" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"ips\": [\n {\n \"ip\": \"8.8.8.8\"\n },\n {\n \"ip\": \"1.1.1.1\"\n },\n {\n \"ip\": \"104.16.132.229\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "549a3c6a-6c26-5af9-8888-da65485b586a", "name": "Batch submitted \u2014 credits have been reserved", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"batchId\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"status\": \"processing\",\n \"itemCount\": 3,\n \"originalCount\": 3,\n \"duplicatesRemoved\": 0\n },\n \"meta\": {\n \"requestId\": \"665a1f4e2c3b7800129dce00\",\n \"creditsReserved\": 300,\n \"creditsPerItem\": 100,\n \"estimatedCredits\": 300\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "75e06a2e-4da7-53fb-8958-d1c91f345364", "name": "Something is wrong with the request \u2014 check the `detail` field for specifics", "status": "400", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"\\\"ips\\\" must be a non-empty array\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "27cd4929-b8ac-5f19-be32-5f784e83fe49", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"error\": \"Unauthorized\",\n \"message\": \"The API key provided is invalid or has been revoked\",\n \"statusCode\": 401\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ede819d2-9f59-5bd4-88bc-9393c66d0d8f", "name": "You don\u2019t have enough credits \u2014 `detail.required` shows how many are needed", "status": "402", "code": 402, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"error\": \"Payment Required\",\n \"message\": \"Insufficient credits for batch operation\",\n \"detail\": {\n \"required\": 50000,\n \"itemCount\": 500,\n \"creditCostPerItem\": 100\n },\n \"statusCode\": 402\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7d111542-ea55-5603-abed-2ca3cdb99be4", "name": "Duplicate batch submission", "status": "409", "code": 409, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"error\": \"Conflict\",\n \"message\": \"Duplicate batch submission detected\",\n \"statusCode\": 409\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dbe9869b-c0f0-5eea-8b47-2bc8f2c928b1", "name": "You\u2019ve sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"error\": \"Too Many Requests\",\n \"message\": \"Rate limit exceeded. Please retry after 30 seconds.\",\n \"statusCode\": 429\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "af662797-1444-51d6-b6fd-8ccca83cb9b6", "name": "Something went wrong on our end \u2014 try again in a moment", "status": "500", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"error\": \"Internal Server Error\",\n \"message\": \"An unexpected error occurred. Please try again later.\",\n \"statusCode\": 500\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1ed657a7-809e-53cd-88fc-80a76b46af46", "name": "Database or credit service temporarily unavailable", "status": "503", "code": 503, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"error\": \"Service Unavailable\",\n \"message\": \"The service is temporarily unavailable. Please try again later.\",\n \"statusCode\": 503\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "dd7f5571-23ea-52fd-95fd-0abd4b0916df", "name": "Check batch progress", "request": { "name": "Check batch progress", "description": { "content": "Poll this endpoint to track your batch. `progress` is a percentage (0\u2013100) and `status` will be `processing`, `completed`, or `failed`.\n\n**Cost:** Free \u2014 polling never costs credits.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/ip-to-company/batch/{batchId}", "host": [ "{{baseUrl}}" ], "path": [ "ip-to-company", "batch", ":batchId" ], "query": [], "variable": [ { "key": "batchId", "value": "", "description": "The batch identifier returned when you submitted the job" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "GET", "auth": null }, "response": [ { "id": "b214da9a-7ad0-5a32-b300-1cc648210546", "name": "Current batch status", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"batchId\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"status\": \"processing\",\n \"totalItems\": 3,\n \"processedItems\": 1,\n \"foundCount\": 1,\n \"progress\": 33,\n \"createdAt\": \"2026-05-13T10:00:00.000Z\",\n \"completedAt\": null\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "476946f8-53de-55d3-851f-337520f25ee5", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"error\": \"Unauthorized\",\n \"message\": \"The API key provided is invalid or has been revoked\",\n \"statusCode\": 401\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aea03f7e-0b3f-5114-a739-a5fdab9e735a", "name": "The resource you requested doesn\u2019t exist or doesn\u2019t belong to your organization", "status": "404", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"error\": \"Not Found\",\n \"message\": \"No batch found with that ID\",\n \"statusCode\": 404\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b145936c-dd1d-5e81-b243-438259e89f0b", "name": "You\u2019ve sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"error\": \"Too Many Requests\",\n \"message\": \"Rate limit exceeded. Please retry after 30 seconds.\",\n \"statusCode\": 429\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "c4bbcb4c-40c1-527a-a54f-d530bb3d36ae", "name": "Get batch results", "request": { "name": "Get batch results", "description": { "content": "Fetch results once your batch has finished. Results are paginated \u2014 use `page` and `limit` to walk through them.\n\n**Credit settlement:** The first time you call this after the batch reaches `completed` or `failed`, we calculate the final cost (100 credits per IP where a domain was found) and refund any excess. Subsequent calls return the cached settlement \u2014 you are never double-charged.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/ip-to-company/batch/{batchId}/results", "host": [ "{{baseUrl}}" ], "path": [ "ip-to-company", "batch", ":batchId", "results" ], "query": [ { "key": "page", "value": "1", "description": "Page number (default: 1)", "disabled": true }, { "key": "limit", "value": "100", "description": "Results per page (default: 100, max: 1 000)", "disabled": true } ], "variable": [ { "key": "batchId", "value": "", "description": "The batch identifier returned when you submitted the job" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "GET", "auth": null }, "response": [ { "id": "a5433044-87e2-54d9-b500-d1c1e3944677", "name": "Paginated IP to Company results", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"batchId\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"status\": \"completed\",\n \"totalItems\": 3,\n \"processedCount\": 3,\n \"foundCount\": 2,\n \"results\": [\n {\n \"searchIp\": \"8.8.8.8\",\n \"ipDomain\": \"google.com\",\n \"ipOrganization\": \"Google LLC\",\n \"ipCountryName\": \"United States\",\n \"ipCountryCode\": \"US\",\n \"ipCity\": \"Mountain View\",\n \"ipTimezone\": \"America/Los_Angeles\"\n },\n {\n \"searchIp\": \"1.1.1.1\",\n \"ipDomain\": \"cloudflare.com\",\n \"ipOrganization\": \"Cloudflare Inc\",\n \"ipCountryName\": \"Australia\",\n \"ipCountryCode\": \"AU\",\n \"ipCity\": \"Sydney\",\n \"ipTimezone\": \"Australia/Sydney\"\n },\n {\n \"searchIp\": \"104.16.132.229\",\n \"ipDomain\": null,\n \"ipOrganization\": \"Cloudflare Inc\"\n }\n ],\n \"page\": 1,\n \"limit\": 100\n },\n \"meta\": {\n \"requestId\": \"665a23bc2c3b7800129dce10\",\n \"creditsUsed\": 200,\n \"creditsRefunded\": 100,\n \"creditsRemaining\": 4700,\n \"totalItems\": 3,\n \"processedItems\": 3\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "de8da09e-2a0f-5cd9-b249-ffb553c16c4a", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"error\": \"Unauthorized\",\n \"message\": \"The API key provided is invalid or has been revoked\",\n \"statusCode\": 401\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3c6abdf8-7bf6-59f4-bd41-da06816e9143", "name": "The resource you requested doesn\u2019t exist or doesn\u2019t belong to your organization", "status": "404", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"error\": \"Not Found\",\n \"message\": \"No batch found with that ID\",\n \"statusCode\": 404\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f582a5ce-09df-5c82-9dee-1cbd0395c810", "name": "You\u2019ve sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"error\": \"Too Many Requests\",\n \"message\": \"Rate limit exceeded. Please retry after 30 seconds.\",\n \"statusCode\": 429\n}", "cookie": [], "_postman_previewlanguage": "json" } ] } ] }, { "id": "090d7ed1-4ac9-50e1-aa60-bc26ea8ebc60", "name": "Email Finder", "description": { "content": "", "type": "text/plain" }, "item": [ { "id": "5e952444-538a-5ef6-8a10-16aca248a87b", "name": "Find a professional email", "request": { "name": "Find a professional email", "description": { "content": "Give us a person's first name, last name, and their company domain, and we'll\nfind their professional email address.\n\n**Cost:** 10 credits. You are **not** charged if we can't find an email\n(`found: false`).", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/email-finder", "host": [ "{{baseUrl}}" ], "path": [ "email-finder" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"firstName\": \"Emily\",\n \"lastName\": \"Zhang\",\n \"domain\": \"figma.com\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "45060f85-5bab-50ef-b557-704da2b35e38", "name": "Finder result returned successfully", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"firstName\": \"Emily\",\n \"lastName\": \"Zhang\",\n \"domain\": \"figma.com\",\n \"found\": true,\n \"email\": \"emily.zhang@figma.com\",\n \"confidence\": \"high\",\n \"isCatchAll\": false,\n \"provider\": \"GOOGLE\",\n \"message\": \"Email found with high confidence\"\n },\n \"meta\": {\n \"requestId\": \"665b0a7f3e4c9200138eaf01\",\n \"creditsUsed\": 10,\n \"creditsRemaining\": 24990,\n \"processingTimeMs\": 912\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9cbcc64a-6296-5988-af1d-11f7e2a7d518", "name": "Something is wrong with the request \u2014 check the `detail` field for specifics", "status": "400", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body/email Invalid email\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "336ab839-6f43-5edf-9081-9fc4c7f038af", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2f0cbfff-05c0-587c-a3e6-ea09a43b2331", "name": "You don't have enough credits for this request", "status": "402", "code": 402, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/insufficient-credits\",\n \"title\": \"Insufficient Credits\",\n \"status\": 402,\n \"detail\": \"Not enough credits. Required: 10, available: 3\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f251ce40-8b5f-5548-aa86-080df26686dc", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f3253a33-5083-5aa2-b825-84fbd4ee77e2", "name": "Something went wrong on our end \u2014 try again in a moment", "status": "500", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/internal-error\",\n \"title\": \"Internal Server Error\",\n \"status\": 500,\n \"detail\": \"An unexpected error occurred. Please try again later.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "35d9c390-6109-5aee-97c9-c82b921301d2", "name": "Find emails in batch", "request": { "name": "Find emails in batch", "description": { "content": "Submit up to **500 000 leads** in one request. Each lead is a combination\nof first name, last name, and domain. We deduplicate the list\n(case-insensitive) so you are only charged for unique leads.\n\n**Cost:** 10 credits per unique lead, reserved at submission. Unused credits\nare refunded when you fetch results.\n\n### Webhook callbacks\n\nIf you include a `webhookUrl`, your server will receive:\n\n1. **A per-result callback** each time a single lead is processed. See\n [emailFinderResult](#tag/Webhooks/operation/webhookEmailFinderResult) for the payload.\n\n2. **A completion callback** once the entire batch is done. See\n [emailFinderCompletion](#tag/Webhooks/operation/webhookEmailFinderCompletion) for the payload.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/email-finder/batch", "host": [ "{{baseUrl}}" ], "path": [ "email-finder", "batch" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"leads\": [\n {\n \"firstName\": \"Emily\",\n \"lastName\": \"Zhang\",\n \"domain\": \"figma.com\"\n },\n {\n \"firstName\": \"David\",\n \"lastName\": \"Kim\",\n \"domain\": \"vercel.com\"\n },\n {\n \"firstName\": \"Aisha\",\n \"lastName\": \"Johnson\",\n \"domain\": \"cloudflare.com\"\n }\n ],\n \"webhookUrl\": \"https://api.yourapp.com/webhooks/enrich\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "410d46a4-8ed3-5b98-bfd5-de5d356f7c79", "name": "Batch submitted \u2014 credits have been reserved", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"batchId\": \"665b12cf3e4c9200138eaf10\",\n \"status\": \"queued\",\n \"itemCount\": 3,\n \"originalCount\": 3,\n \"duplicatesRemoved\": 0\n },\n \"meta\": {\n \"requestId\": \"665b12cf3e4c9200138eaf0f\",\n \"creditsReserved\": 30,\n \"creditsPerItem\": 10,\n \"estimatedCredits\": 30\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5cb9dcd3-ee45-52b9-a578-5cba96e8d559", "name": "Something is wrong with the request \u2014 check the `detail` field for specifics", "status": "400", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body/email Invalid email\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4605a885-d929-50ad-8443-30d63ac2a950", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "10141eff-344d-54ce-b21a-66ca981e06af", "name": "You don't have enough credits for this request", "status": "402", "code": 402, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/insufficient-credits\",\n \"title\": \"Insufficient Credits\",\n \"status\": 402,\n \"detail\": \"Not enough credits. Required: 10, available: 3\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "26239199-b9fb-5716-8b0e-aa062287794b", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7a37bd3e-7d12-5431-bab5-cb5530d5436d", "name": "Something went wrong on our end \u2014 try again in a moment", "status": "500", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/internal-error\",\n \"title\": \"Internal Server Error\",\n \"status\": 500,\n \"detail\": \"An unexpected error occurred. Please try again later.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "9060ad8d-8423-57b7-9d49-526b1151a45f", "name": "Check batch finder progress", "request": { "name": "Check batch finder progress", "description": { "content": "Poll this endpoint to track your batch. The `status` moves through\n`queued` \u2192 `processing` \u2192 `completed` (or `failed`).\n\n**Cost:** Free.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/email-finder/batch/{batchId}", "host": [ "{{baseUrl}}" ], "path": [ "email-finder", "batch", ":batchId" ], "query": [], "variable": [ { "key": "batchId", "value": "", "description": "The batch identifier returned when you submitted the job" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "GET", "auth": null }, "response": [ { "id": "fc3e122d-5401-5d6e-b82c-2c64fa1bae58", "name": "Current batch status", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"batchId\": \"665b12cf3e4c9200138eaf10\",\n \"status\": \"processing\",\n \"totalItems\": 3,\n \"processedItems\": 1,\n \"progress\": 33.3\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "99bdb458-b6b1-57cd-9e2a-33aa06eac165", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fe839dda-7bfc-5e03-b346-783a64cb0417", "name": "The resource you requested doesn't exist or doesn't belong to your organization", "status": "404", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/not-found\",\n \"title\": \"Not Found\",\n \"status\": 404,\n \"detail\": \"No batch found with that ID\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9045c052-adf0-5231-a123-10afbe4797f2", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "ff5f17f0-d4cc-5228-b8eb-10b5cde126ad", "name": "Get batch finder results", "request": { "name": "Get batch finder results", "description": { "content": "Retrieve the results once the batch has finished. Results are paginated.\n\n**Credit settlement:** On the first call after the batch reaches a terminal\nstatus, we settle the final credit charge. Leads where no email was found\nare not charged, and the difference is refunded.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/email-finder/batch/{batchId}/results", "host": [ "{{baseUrl}}" ], "path": [ "email-finder", "batch", ":batchId", "results" ], "query": [ { "key": "page", "value": "1", "description": "Page number (default: 1)", "disabled": true }, { "key": "limit", "value": "100", "description": "Results per page (default: 100, max: 1 000)", "disabled": true } ], "variable": [ { "key": "batchId", "value": "", "description": "The batch identifier returned when you submitted the job" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "GET", "auth": null }, "response": [ { "id": "afa0bc15-4e10-518b-88a7-4b462f4a7170", "name": "Paginated finder results", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"batchId\": \"665b12cf3e4c9200138eaf10\",\n \"status\": \"completed\",\n \"totalItems\": 3,\n \"processedCount\": 3,\n \"results\": [\n {\n \"firstName\": \"Emily\",\n \"lastName\": \"Zhang\",\n \"domain\": \"figma.com\",\n \"found\": true,\n \"email\": \"emily.zhang@figma.com\",\n \"confidence\": \"high\",\n \"isCatchAll\": false,\n \"provider\": \"GOOGLE\",\n \"message\": \"Email found with high confidence\"\n },\n {\n \"firstName\": \"David\",\n \"lastName\": \"Kim\",\n \"domain\": \"vercel.com\",\n \"found\": true,\n \"email\": \"david.kim@vercel.com\",\n \"confidence\": \"medium\",\n \"isCatchAll\": false,\n \"provider\": \"GOOGLE\",\n \"message\": \"Email found with medium confidence\"\n },\n {\n \"firstName\": \"Aisha\",\n \"lastName\": \"Johnson\",\n \"domain\": \"cloudflare.com\",\n \"found\": false,\n \"message\": \"No professional email could be found for this person\"\n }\n ]\n },\n \"meta\": {\n \"requestId\": \"665b18a03e4c9200138eaf20\",\n \"creditsUsed\": 20,\n \"creditsRefunded\": 10,\n \"creditsRemaining\": 24970,\n \"totalItems\": 3,\n \"processedItems\": 3\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dd3dd59d-1f29-5603-a6cd-c9f066aac705", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "012e6be0-373a-5794-b7de-e702a8100e5a", "name": "The resource you requested doesn't exist or doesn't belong to your organization", "status": "404", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/not-found\",\n \"title\": \"Not Found\",\n \"status\": 404,\n \"detail\": \"No batch found with that ID\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c09931d2-ada0-5604-a394-3e45693e62eb", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] } ] }, { "id": "2e6d9c98-2119-5df0-b79e-2ef5242ffd00", "name": "Email Validation", "description": { "content": "", "type": "text/plain" }, "item": [ { "id": "57668791-e300-5cb4-9471-1e24bab44e0d", "name": "Validate a single email", "request": { "name": "Validate a single email", "description": { "content": "Checks whether an email address is deliverable. The response tells you the\nresult (`valid`, `invalid`, or `risky`), the confidence level, the mail\nprovider, and whether the domain is a catch-all.\n\n**Cost:** 1 credit. You are **not** charged if the result is `risky`.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/email-validation", "host": [ "{{baseUrl}}" ], "path": [ "email-validation" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"email\": \"sarah.chen@stripe.com\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "63e01379-c6ba-5f64-a194-b9edc1c20c0b", "name": "Validation result returned successfully", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"email\": \"sarah.chen@stripe.com\",\n \"result\": \"valid\",\n \"message\": \"The mailbox exists and is accepting mail\",\n \"isCatchAll\": false,\n \"isFederated\": false,\n \"hasSEG\": true,\n \"segProvider\": \"Proofpoint\",\n \"provider\": \"GOOGLE\",\n \"confidence\": \"high\"\n },\n \"meta\": {\n \"requestId\": \"664f2b3c9a1e4d0012abcdef\",\n \"creditsUsed\": 1,\n \"creditsRemaining\": 24999,\n \"processingTimeMs\": 387\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "88bf6117-22b8-5e5b-a8ba-4ebce769fd58", "name": "Something is wrong with the request \u2014 check the `detail` field for specifics", "status": "400", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body/email Invalid email\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6261ca37-b576-5b92-848b-49582767ac5c", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f2e78640-1e74-5c4e-84be-12c1086c1fec", "name": "You don't have enough credits for this request", "status": "402", "code": 402, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/insufficient-credits\",\n \"title\": \"Insufficient Credits\",\n \"status\": 402,\n \"detail\": \"Not enough credits. Required: 10, available: 3\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "af0e9235-9a40-5b2e-8544-f7543a6a419e", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "91f311fd-62b7-5a2c-9ec9-8d0e21461eb9", "name": "Something went wrong on our end \u2014 try again in a moment", "status": "500", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/internal-error\",\n \"title\": \"Internal Server Error\",\n \"status\": 500,\n \"detail\": \"An unexpected error occurred. Please try again later.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "b2742d8e-e8b0-547b-8754-a1b52e114a9b", "name": "Validate emails in batch", "request": { "name": "Validate emails in batch", "description": { "content": "Submit up to **500 000 emails** in a single request. We automatically\nremove duplicates (case-insensitive) before processing, so you only pay\nfor unique addresses.\n\n**Cost:** 1 credit per unique email, reserved when you submit. Any unused\ncredits are refunded automatically when you fetch results.\n\n### Webhook callbacks\n\nIf you include a `webhookUrl`, your server will receive:\n\n1. **A per-result callback** every time an individual email finishes\n validation. See [emailValidationResult](#tag/Webhooks/operation/webhookEmailValidationResult)\n for the exact payload.\n\n2. **A completion callback** once every email in the batch has been\n processed. See [emailValidationCompletion](#tag/Webhooks/operation/webhookEmailValidationCompletion)\n for the exact payload.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/email-validation/batch", "host": [ "{{baseUrl}}" ], "path": [ "email-validation", "batch" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"emails\": [\n \"sarah.chen@stripe.com\",\n \"james.rodriguez@hubspot.com\",\n \"priya.patel@notion.so\",\n \"marco.silva@datadog.com\"\n ],\n \"webhookUrl\": \"https://api.yourapp.com/webhooks/enrich\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "ffe76902-f53a-53a4-8437-9411966ad073", "name": "Batch submitted \u2014 credits have been reserved", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"batchId\": \"665a1f4e2c3b7800129dce01\",\n \"status\": \"queued\",\n \"itemCount\": 4,\n \"originalCount\": 4,\n \"duplicatesRemoved\": 0\n },\n \"meta\": {\n \"requestId\": \"665a1f4e2c3b7800129dce00\",\n \"creditsReserved\": 4,\n \"creditsPerItem\": 1,\n \"estimatedCredits\": 4\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2ca09c30-395e-5555-b450-9d1ec9823d6e", "name": "Something is wrong with the request \u2014 check the `detail` field for specifics", "status": "400", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body/email Invalid email\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "37274c80-ef29-5669-bd6c-9246ce5f2492", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cf24316a-10e6-555f-ad3d-45cea82cfb6e", "name": "You don't have enough credits for this request", "status": "402", "code": 402, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/insufficient-credits\",\n \"title\": \"Insufficient Credits\",\n \"status\": 402,\n \"detail\": \"Not enough credits. Required: 10, available: 3\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "105b9583-4b9a-5d78-82d2-72b6f010f2b9", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "865889a0-14f7-53b7-82a3-f2ada2bcc881", "name": "Something went wrong on our end \u2014 try again in a moment", "status": "500", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/internal-error\",\n \"title\": \"Internal Server Error\",\n \"status\": 500,\n \"detail\": \"An unexpected error occurred. Please try again later.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "7d04afe6-e75f-5626-9135-a7c67265e03a", "name": "Check batch validation progress", "request": { "name": "Check batch validation progress", "description": { "content": "Poll this endpoint to see how your batch is doing. The `progress` field\ngives you a percentage, and `status` will be one of `queued`, `processing`,\n`completed`, or `failed`.\n\n**Cost:** Free \u2014 polling never costs credits.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/email-validation/batch/{batchId}", "host": [ "{{baseUrl}}" ], "path": [ "email-validation", "batch", ":batchId" ], "query": [], "variable": [ { "key": "batchId", "value": "", "description": "The batch identifier returned when you submitted the job" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "GET", "auth": null }, "response": [ { "id": "9f0725f3-345a-55a6-b784-8ef3e8c0e7f0", "name": "Current batch status", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"batchId\": \"665a1f4e2c3b7800129dce01\",\n \"status\": \"processing\",\n \"totalItems\": 4,\n \"processedItems\": 3,\n \"progress\": 75\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d067c363-4a7f-5d3b-8e2f-cca374b323f0", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "13621104-ca4a-5312-a24f-c94f5ff5c76a", "name": "The resource you requested doesn't exist or doesn't belong to your organization", "status": "404", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/not-found\",\n \"title\": \"Not Found\",\n \"status\": 404,\n \"detail\": \"No batch found with that ID\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "996ff33e-f973-53df-9e28-893ba211c2f4", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "9abd5f32-a242-5b27-bc28-7afc65b76352", "name": "Get batch validation results", "request": { "name": "Get batch validation results", "description": { "content": "Fetch the results once your batch has finished. Results are paginated \u2014 use\n`page` and `limit` to walk through them.\n\n**Credit settlement:** The first time you call this after the batch reaches\n`completed` or `failed`, we calculate the final cost and refund any excess\ncredits. Subsequent calls return the cached settlement.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/email-validation/batch/{batchId}/results", "host": [ "{{baseUrl}}" ], "path": [ "email-validation", "batch", ":batchId", "results" ], "query": [ { "key": "page", "value": "1", "description": "Page number (default: 1)", "disabled": true }, { "key": "limit", "value": "100", "description": "Results per page (default: 100, max: 1 000)", "disabled": true } ], "variable": [ { "key": "batchId", "value": "", "description": "The batch identifier returned when you submitted the job" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "GET", "auth": null }, "response": [ { "id": "d1171e80-8c81-5cec-9eb4-ab476fd233cd", "name": "Paginated validation results", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"batchId\": \"665a1f4e2c3b7800129dce01\",\n \"status\": \"completed\",\n \"totalItems\": 4,\n \"processedCount\": 4,\n \"results\": [\n {\n \"email\": \"sarah.chen@stripe.com\",\n \"result\": \"valid\",\n \"message\": \"The mailbox exists and is accepting mail\",\n \"isCatchAll\": false,\n \"provider\": \"GOOGLE\",\n \"confidence\": \"high\"\n },\n {\n \"email\": \"james.rodriguez@hubspot.com\",\n \"result\": \"valid\",\n \"message\": \"The mailbox exists and is accepting mail\",\n \"isCatchAll\": false,\n \"provider\": \"MICROSOFT\",\n \"confidence\": \"definitive\"\n },\n {\n \"email\": \"priya.patel@notion.so\",\n \"result\": \"invalid\",\n \"message\": \"The mailbox does not exist on this server\",\n \"isCatchAll\": false,\n \"provider\": \"GOOGLE\",\n \"confidence\": \"definitive\"\n },\n {\n \"email\": \"marco.silva@datadog.com\",\n \"result\": \"risky\",\n \"message\": \"The domain accepts all addresses (catch-all) so delivery cannot be guaranteed\",\n \"isCatchAll\": true,\n \"provider\": \"SMTP\",\n \"confidence\": \"low\"\n }\n ]\n },\n \"meta\": {\n \"requestId\": \"665a23bc2c3b7800129dce10\",\n \"creditsUsed\": 2,\n \"creditsRefunded\": 2,\n \"creditsRemaining\": 24997,\n \"totalItems\": 4,\n \"processedItems\": 4\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fae63a8f-0963-5848-845d-38687e0d5e58", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4d5292fd-8d32-582b-b4d1-407a4e6c9fcc", "name": "The resource you requested doesn't exist or doesn't belong to your organization", "status": "404", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/not-found\",\n \"title\": \"Not Found\",\n \"status\": 404,\n \"detail\": \"No batch found with that ID\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ba70cfd2-dbbf-552e-85ff-cbacce72c229", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] } ] }, { "id": "0a48c0a3-b040-5edd-9fcf-3eabf589b6f9", "name": "Lead Finder", "description": { "content": "", "type": "text/plain" }, "item": [ { "id": "cfca2e51-9b70-569f-85a0-d19d3fde2bb6", "name": "Count matching leads", "request": { "name": "Count matching leads", "description": { "content": "Get the total count of leads matching your filters. This endpoint is free and does not consume credits.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/lead-finder/count", "host": [ "{{baseUrl}}" ], "path": [ "lead-finder", "count" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"filters\": {\n \"firstName\": \"string\",\n \"lastName\": \"string\",\n \"middleName\": \"string\",\n \"city\": \"string\",\n \"stateName\": null,\n \"stateCode\": null,\n \"countryName\": null,\n \"countryCode\": null,\n \"continent\": null,\n \"countryRegion\": null,\n \"linkedinUrl\": \"string\",\n \"linkedinHeadline\": \"string\",\n \"personHeadline\": null,\n \"companyHeadline\": null,\n \"linkedinIndustry\": null,\n \"logoUrl\": \"string\",\n \"emailDomain\": \"string\",\n \"emailAddress\": \"string\",\n \"jobTitle\": null,\n \"jobFunction\": null,\n \"jobLevel\": null,\n \"jobDescription\": \"string\",\n \"jobLocationCity\": \"string\",\n \"jobLocationState\": \"string\",\n \"jobLocationCountry\": null,\n \"jobIsCurrent\": false,\n \"jobStartDate\": \"string\",\n \"jobCount\": 0,\n \"companyName\": null,\n \"companyNameMode\": \"string\",\n \"persona\": \"string\",\n \"languages\": null,\n \"skills\": null,\n \"certifications\": \"string\",\n \"patents\": \"string\",\n \"publications\": \"string\",\n \"websites\": \"string\",\n \"education\": \"string\",\n \"phone\": \"string\",\n \"cellphone\": \"string\",\n \"orgName\": \"string\",\n \"domain\": null,\n \"aboutUs\": null,\n \"companyEntityType\": null,\n \"companyLegalType\": null,\n \"employeeCount\": 0,\n \"employeeCountMax\": 0,\n \"employeeCountMin\": 0,\n \"foundedOn\": 0,\n \"headquartersCity\": \"string\",\n \"headquartersState\": \"string\",\n \"headquartersCountry\": null,\n \"industrySicCode\": null,\n \"industrySicDescription\": null,\n \"industryNaicsCode\": null,\n \"industryNaicsDescription\": null,\n \"orgLinkedinUrl\": \"string\",\n \"locationCity\": \"string\",\n \"locationState\": \"string\",\n \"locationCountry\": null,\n \"revenueMax\": 0,\n \"revenueMin\": 0,\n \"revenueBuckets\": null,\n \"specialties\": \"string\",\n \"crmTechOrg\": null,\n \"marketingAutomationTechOrg\": null,\n \"abmTechOrg\": null,\n \"salesAutomationTechOrg\": null,\n \"analyticsTechOrg\": null,\n \"cmsTechOrg\": null,\n \"martechCategoriesOrg\": null,\n \"conversationIntelligenceTechOrg\": null,\n \"cloudProviderTechOrg\": null,\n \"emailHostingTechOrg\": null,\n \"emailSecurityTechOrg\": null,\n \"applicationSecurityTechOrg\": null,\n \"cloudSecurityTechOrg\": null,\n \"developmentTechOrg\": null,\n \"eCommercePlatformTechOrg\": null,\n \"erpTechOrg\": null,\n \"hasMobileAppOrg\": false,\n \"hasWebAppOrg\": false,\n \"hasCisoOrg\": false,\n \"hasCioOrg\": false,\n \"locationCountOrg\": 0,\n \"isLinkedinUrlClaimedOrg\": false,\n \"marketingRoleCountOrg\": 0,\n \"salesRoleCountOrg\": 0,\n \"operationsRoleCountOrg\": 0,\n \"businessDevelopmentRoleCountOrg\": 0,\n \"customerSuccessRoleCountOrg\": 0,\n \"itRoleCountOrg\": 0,\n \"grcRoleCountOrg\": 0,\n \"securityRoleCountOrg\": 0,\n \"devopsRoleCountOrg\": 0,\n \"networkInfrastructureRoleCountOrg\": 0,\n \"mobileDevRoleCountOrg\": 0,\n \"iosDevRoleCountOrg\": 0,\n \"androidDevRoleCountOrg\": 0,\n \"engineerRoleCountOrg\": 0,\n \"qaRoleCountOrg\": 0,\n \"marketingOpenRolesCountOrg\": 0,\n \"operationsOpenRolesCountOrg\": 0,\n \"salesOpenRolesCountOrg\": 0,\n \"accountExecutiveOpenRolesCountOrg\": 0,\n \"customerSuccessOpenRolesCountOrg\": 0,\n \"demandGenerationOpenRolesCountOrg\": 0,\n \"businessDevelopmentOpenRolesCountOrg\": 0,\n \"itOpenRolesCountOrg\": 0,\n \"securityOpenRolesCountOrg\": 0,\n \"grcOpenRolesCountOrg\": 0,\n \"devopsOpenRolesCountOrg\": 0,\n \"networkInfrastructureOpenRolesCountOrg\": 0,\n \"monthlyOrganicTrafficOrg\": 0,\n \"monthlyPaidTrafficOrg\": 0,\n \"totalMonthlyTrafficOrg\": 0,\n \"monthlyGoogleAdspendOrg\": 0,\n \"employeeOnLinkedinGrowthRateOrg\": 0,\n \"isWebsiteForSaleOrg\": false,\n \"topAppleappstoreUrlOrg\": \"string\",\n \"topAppstoreRatingOrg\": 0,\n \"topAppstoreReviewCountOrg\": 0,\n \"lastAppstoreUpdateOrg\": \"string\",\n \"appstoreUpdateCountOrg\": 0,\n \"appstoreAppCategoryOrg\": \"string\",\n \"topPlaystoreUrlOrg\": \"string\",\n \"topPlaystoreRatingOrg\": 0,\n \"topPlaystoreReviewCountOrg\": 0,\n \"lastPlaystoreUpdateOrg\": \"string\",\n \"playstoreDownloadCountOrg\": 0,\n \"playstoreAppCategoryOrg\": \"string\",\n \"totalReviewsOrg\": 0,\n \"lastFundingDateOrg\": \"string\",\n \"lastFundingAmountOrg\": 0,\n \"leadInvestorsOrg\": \"string\",\n \"lastFundingTypeOrg\": null,\n \"fundingRoundNumberOfInvestorsOrg\": 0,\n \"totalFundingAmountOrg\": 0\n },\n \"excludeFilters\": {\n \"personHeadline\": null,\n \"companyHeadline\": null,\n \"aboutUs\": null,\n \"domain\": null,\n \"jobTitle\": null\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "365ebbb1-c09f-5c3a-b655-89e1ccb3b51e", "name": "Count returned successfully", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"count\": 18420,\n \"searchType\": \"unified\",\n \"searchedTotalResult\": 18420\n },\n \"meta\": {\n \"requestId\": \"req_664f2b3c9a1e4d0012abcdf0\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "295d5887-1952-513a-a07e-c817757d83c9", "name": "Something is wrong with the request \u2014 check the `detail` field for specifics", "status": "400", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body Invalid request\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "74f9d2ca-ab8d-5de8-90eb-66230e07dbdf", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f8fa70ce-619b-5754-816e-206753b3070a", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0968d439-f9a5-58b4-b001-a1897a7dad2f", "name": "Something went wrong on our end \u2014 try again in a moment", "status": "500", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/internal-error\",\n \"title\": \"Internal Server Error\",\n \"status\": 500,\n \"detail\": \"An unexpected error occurred. Please try again later.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "c940ea43-5a1b-58c5-b962-3b512dc5adc8", "name": "Enrich contacts with specific fields", "request": { "name": "Enrich contacts with specific fields", "description": { "content": "Reveal specific contact fields (email and/or phone) for up to 25 leads.\n\n**Pricing:**\n- Email: 10 credits per lead\n- Phone: 525 credits per lead\n\nPreviously revealed fields are returned from cache at no cost.\n\n**Async:** Returns a `jobId` immediately (< 100ms). Poll `GET /lead-finder/reveal-jobs/:jobId` every 2 seconds until `status` is `completed` or `failed`. Credits are charged inside the worker \u2014 insufficient credits cause the job to fail asynchronously (no synchronous 402).", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/lead-finder/enrich", "host": [ "{{baseUrl}}" ], "path": [ "lead-finder", "enrich" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"leads\": [\n {\n \"id\": \"string\"\n }\n ],\n \"fields\": [\n \"string\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "80be082a-e360-5696-8d5c-2362c36ccc77", "name": "Enrich job submitted \u2014 poll the returned jobId for results", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"jobId\": \"rj_a1b2c3d4e5f6g7h8\",\n \"status\": \"pending\",\n \"totalLeads\": 3,\n \"fields\": [\n \"email\"\n ],\n \"message\": \"Enrich job submitted. Poll GET /api/v3/lead-finder/reveal-jobs/rj_a1b2c3d4e5f6g7h8 for results.\"\n },\n \"meta\": {\n \"requestId\": \"req_664f2b3c9a1e4d0012abcdf3\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "21341be5-7f80-5fd7-9296-7f19beddbb70", "name": "Something is wrong with the request \u2014 check the `detail` field for specifics", "status": "400", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body Invalid request\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "51213133-997e-5603-9348-bace2480198f", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3370512b-808b-5f39-9c9a-30795081966a", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8338b116-1ef6-5f87-aa66-4de26173da42", "name": "Something went wrong on our end \u2014 try again in a moment", "status": "500", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/internal-error\",\n \"title\": \"Internal Server Error\",\n \"status\": 500,\n \"detail\": \"An unexpected error occurred. Please try again later.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "085fece7-1988-5e68-a2c1-e0a27cde750b", "name": "Export leads to CSV (async)", "request": { "name": "Export leads to CSV (async)", "description": { "content": "Submit an async CSV export job. Returns a `jobId` immediately \u2014 poll `GET /lead-finder/export-jobs/{jobId}` for status. Once the job reaches `completed` status, download the file via `GET /lead-finder/export-jobs/{jobId}/download`.\n\nCredits are estimated upfront and deducted during processing. Refunds are issued for leads where the requested contact info was not found.\n\n**Pricing:**\n- Preview fields only: Free\n- `includeEmail`: 10 credits per lead\n- `includePhone`: 525 credits per lead\n- `includeNames`: 1 credit per lead (full last names)\n- `includeContactInfo`: Shorthand for email + phone (535 credits/lead)", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/lead-finder/export", "host": [ "{{baseUrl}}" ], "path": [ "lead-finder", "export" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"filters\": {\n \"jobLevel\": [\n \"C-Suite\",\n \"VP\"\n ],\n \"domain\": [\n \"stripe.com\",\n \"vercel.com\"\n ]\n },\n \"maxResults\": 500,\n \"includeEmail\": true,\n \"includeNames\": true\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "8a80dfb7-67a5-5cba-b94e-6f23d51567d2", "name": "Export job submitted \u2014 poll for status using the returned jobId", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"jobId\": \"ej_a1b2c3d4e5f6a7b8\",\n \"status\": \"pending\",\n \"estimatedRows\": 500,\n \"estimatedCredits\": 25000,\n \"message\": \"Export job queued. Poll GET /lead-finder/export-jobs/ej_a1b2c3d4e5f6a7b8 for status.\"\n },\n \"meta\": {\n \"requestId\": \"665d2f8b9c5b2a0015d0bc0f\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "986685a2-8240-5d59-9d18-628e01797c79", "name": "Something is wrong with the request \u2014 check the `detail` field for specifics", "status": "400", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body Invalid request\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bb274750-5234-5efb-952f-747da11cd687", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "24da73be-cf9a-5d5f-8923-009b8a063c05", "name": "You don't have enough credits for this request", "status": "402", "code": 402, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/insufficient-credits\",\n \"title\": \"Insufficient Credits\",\n \"status\": 402,\n \"detail\": \"Not enough credits. Required: 575, available: 100\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "464011c5-fff0-53e2-8f25-d8b174415ce8", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "72491c3f-01bb-5f57-a2cf-0d105a1af9a1", "name": "Something went wrong on our end \u2014 try again in a moment", "status": "500", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/internal-error\",\n \"title\": \"Internal Server Error\",\n \"status\": 500,\n \"detail\": \"An unexpected error occurred. Please try again later.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "1163e15c-1e0e-5b63-bdb8-5f636983852a", "name": "List export jobs", "request": { "name": "List export jobs", "description": { "content": "List recent CSV export jobs for your team (last 30 days). Paginated, optionally filtered by status.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/lead-finder/export-jobs", "host": [ "{{baseUrl}}" ], "path": [ "lead-finder", "export-jobs" ], "query": [ { "key": "page", "value": "1", "description": "Page number (default: 1)", "disabled": true }, { "key": "limit", "value": "20", "description": "Results per page (default: 20, max: 100)", "disabled": true }, { "key": "status", "value": "string", "description": "Filter by job status", "disabled": true } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "GET", "auth": null }, "response": [ { "id": "263d2857-bb5e-511f-bbaf-bfb4ad6fb88a", "name": "Paginated list of export jobs", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"jobs\": [\n {\n \"jobId\": \"ej_a1b2c3d4e5f6a7b8\",\n \"status\": \"completed\",\n \"total\": 500,\n \"processed\": 500,\n \"creditsUsed\": 24750,\n \"creditsRefunded\": 250,\n \"createdAt\": \"2025-06-03T14:30:00.000Z\",\n \"completedAt\": \"2025-06-03T14:35:00.000Z\"\n }\n ],\n \"total\": 1,\n \"page\": 1,\n \"limit\": 20\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c0ea41da-3a05-52fd-9c41-bd697b9eba03", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7d325d95-9ce1-585d-b6fe-39fcd8bcfa35", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body/email Invalid email\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "724b1a64-4ed4-51f5-8d52-57ffc3fd5d82", "name": "Something went wrong on our end \u2014 try again in a moment", "status": "500", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body/email Invalid email\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "8673ca45-5bac-5f4a-b193-e9f701ae8acc", "name": "Poll export job status", "request": { "name": "Poll export job status", "description": { "content": "Poll the status of a CSV export job. The response shape varies by status:\n\n- **`pending`** \u2014 Job is queued, not yet started.\n- **`processing`** \u2014 Job is actively running. Check `progress` for completion percentage.\n- **`completed`** \u2014 Job finished successfully. Includes `results` with final credit usage. Download the file via `GET /lead-finder/export-jobs/{jobId}/download`.\n- **`failed`** \u2014 Job encountered an error. Includes `error` message and any `creditsRefunded`.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/lead-finder/export-jobs/{jobId}", "host": [ "{{baseUrl}}" ], "path": [ "lead-finder", "export-jobs", ":jobId" ], "query": [], "variable": [ { "key": "jobId", "value": "", "description": "Export job ID (format: `ej_` followed by 16 hex characters)" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "GET", "auth": null }, "response": [ { "id": "9a700a62-1801-59a1-a446-f1215b5e888f", "name": "Export job status", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": false,\n \"data\": {\n \"jobId\": \"ej_a1b2c3d4e5f6a7b8\",\n \"name\": \"string\",\n \"status\": \"string\",\n \"phase\": \"string\",\n \"progress\": 0,\n \"totalRows\": 0,\n \"processedRows\": 0,\n \"creditsUsed\": 0,\n \"creditsRefunded\": 0,\n \"error\": \"string\",\n \"downloadUrl\": \"string\",\n \"createdAt\": \"string\",\n \"completedAt\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5020f440-ccfa-566b-b0a2-2dd1ca77c479", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body/email Invalid email\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "62bd05a2-6684-5b00-bc55-54460e0fad9b", "name": "Export job not found or does not belong to your team", "status": "404", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/not-found\",\n \"title\": \"Not Found\",\n \"status\": 404,\n \"detail\": \"Export job not found\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e45260e4-a684-5cda-94a5-a1b4f78d1a30", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body/email Invalid email\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "203e6321-7007-5f46-8ad2-3c9fe8810754", "name": "Something went wrong on our end \u2014 try again in a moment", "status": "500", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body/email Invalid email\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "f0a0caa0-2ac0-5f41-8979-6088b7cee950", "name": "Download export CSV", "request": { "name": "Download export CSV", "description": { "content": "Stream the completed CSV file for an export job. Returns the file with `Content-Type: text/csv`.\n\nReturns **409 Conflict** if the job has not yet reached `completed` status or has failed. Poll `GET /lead-finder/export-jobs/{jobId}` first to confirm the job is complete before downloading.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/lead-finder/export-jobs/{jobId}/download", "host": [ "{{baseUrl}}" ], "path": [ "lead-finder", "export-jobs", ":jobId", "download" ], "query": [], "variable": [ { "key": "jobId", "value": "", "description": "Export job ID (format: `ej_` followed by 16 hex characters)" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "GET", "auth": null }, "response": [ { "id": "bf8a2140-4d14-5e74-95ba-4911a0700b1a", "name": "CSV file stream", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "57e438db-f860-5165-ab17-891b89a65bfc", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body/email Invalid email\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "390269f9-6d15-5235-ad75-8e403d0e3d9d", "name": "Export job not found or does not belong to your team", "status": "404", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/not-found\",\n \"title\": \"Not Found\",\n \"status\": 404,\n \"detail\": \"Export job not found\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0697d54a-b5e5-51ae-b2af-25a002f45d28", "name": "Job is not yet completed or has failed \u2014 cannot download", "status": "409", "code": 409, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/conflict\",\n \"title\": \"Conflict\",\n \"status\": 409,\n \"detail\": \"Export job is not yet completed. Current status: processing\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a755af35-d5b5-531f-857b-2491954e4111", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body/email Invalid email\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a3ee3ad5-543c-582a-8ed3-72af2fc0fbb5", "name": "Something went wrong on our end \u2014 try again in a moment", "status": "500", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body/email Invalid email\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "ed859faf-bd62-5eda-b589-37057ac73f52", "name": "Get filter options", "request": { "name": "Get filter options", "description": { "content": "Returns available values for multi-select filter fields (countries, departments, industries, job functions, etc.). Values are fetched from the database and cached for performance. Free endpoint.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/lead-finder/filter-options", "host": [ "{{baseUrl}}" ], "path": [ "lead-finder", "filter-options" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "GET", "auth": null }, "response": [ { "id": "519dbf4a-1334-5bd7-9dc9-10d79d9611a8", "name": "Filter options returned successfully", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"countryName\": [\n \"United States\",\n \"United Kingdom\",\n \"Germany\",\n \"...\"\n ],\n \"jobFunction\": [\n \"Engineering\",\n \"Marketing\",\n \"Sales\",\n \"...\"\n ],\n \"jobLevel\": [\n \"C-Suite\",\n \"VP\",\n \"Director\",\n \"Manager\",\n \"...\"\n ],\n \"industrySicDescription\": [\n \"Computer Processing & Data Preparation\",\n \"...\"\n ]\n },\n \"meta\": {\n \"requestId\": \"req_664f2b3c9a1e4d0012abcdf8\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e5159e1f-2f83-589b-a8cc-906729bbf167", "name": "Something is wrong with the request \u2014 check the `detail` field for specifics", "status": "400", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body Invalid request\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7b1ddfcb-83a9-548c-8f75-ff5091f327a0", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c8131b6b-f2fa-590b-9a9b-ce6a3336bf75", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "64c55778-02ca-5c8c-b16e-5f533c55e9cc", "name": "Something went wrong on our end \u2014 try again in a moment", "status": "500", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/internal-error\",\n \"title\": \"Internal Server Error\",\n \"status\": 500,\n \"detail\": \"An unexpected error occurred. Please try again later.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "b9ffbb31-1031-5af8-982f-977954d28aea", "name": "Reveal contact info", "request": { "name": "Reveal contact info", "description": { "content": "Reveal contact info for up to 25 leads. Choose which fields to reveal via the optional `fields` parameter:\n\n- `[\"email\"]` \u2014 10 credits per lead\n- `[\"phone\"]` \u2014 525 credits per lead\n- `[\"email\", \"phone\"]` \u2014 535 credits per lead (default if omitted)\n\nPreviously revealed contacts are returned from cache at no cost.\n\n**Async:** Returns a `jobId` immediately (< 100ms). Poll `GET /lead-finder/reveal-jobs/:jobId` every 2 seconds until `status` is `completed` or `failed`. Credits are charged inside the worker \u2014 insufficient credits cause the job to fail asynchronously (no synchronous 402).", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/lead-finder/reveal", "host": [ "{{baseUrl}}" ], "path": [ "lead-finder", "reveal" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"leads\": [\n {\n \"id\": \"enc_abc123def456\"\n }\n ],\n \"fields\": [\n \"email\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "9e2f9854-fbe4-5e51-a708-1df902a4d0c0", "name": "Reveal job submitted \u2014 poll the returned jobId for results", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"jobId\": \"rj_a1b2c3d4e5f6g7h8\",\n \"status\": \"pending\",\n \"totalLeads\": 1,\n \"fields\": [\n \"email\"\n ],\n \"message\": \"Reveal job submitted. Poll GET /api/v3/lead-finder/reveal-jobs/rj_a1b2c3d4e5f6g7h8 for results.\"\n },\n \"meta\": {\n \"requestId\": \"req_664f2b3c9a1e4d0012abcdf2\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1476326c-bbe7-52bc-8506-408b67605449", "name": "Something is wrong with the request \u2014 check the `detail` field for specifics", "status": "400", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body Invalid request\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "701aac81-196c-59c9-9b5f-82eda1196698", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a8201d2c-3ae6-5cac-ba62-5847f446dc86", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c56eb475-5b03-5dae-aca5-1d2bba2acdb3", "name": "Something went wrong on our end \u2014 try again in a moment", "status": "500", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/internal-error\",\n \"title\": \"Internal Server Error\",\n \"status\": 500,\n \"detail\": \"An unexpected error occurred. Please try again later.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "83271c34-be56-5f74-9366-fe61d3070c3e", "name": "List reveal/enrich jobs", "request": { "name": "List reveal/enrich jobs", "description": { "content": "List recent reveal/enrich jobs for the team (last 30 days). Free endpoint \u2014 polling is always free.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/lead-finder/reveal-jobs", "host": [ "{{baseUrl}}" ], "path": [ "lead-finder", "reveal-jobs" ], "query": [ { "key": "page", "value": "1", "description": "Page number", "disabled": true }, { "key": "limit", "value": "20", "description": "Results per page (max 100)", "disabled": true }, { "key": "status", "value": "string", "description": "Filter by job status", "disabled": true } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "GET", "auth": null }, "response": [ { "id": "b93ba710-5c54-58e9-b0ae-c25b7019191c", "name": "Jobs listed successfully", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"jobs\": [\n {\n \"jobId\": \"rj_a1b2c3d4e5f6g7h8\",\n \"status\": \"completed\",\n \"jobType\": \"reveal\",\n \"fields\": [\n \"email\",\n \"phone\"\n ],\n \"total\": 5,\n \"processed\": 5,\n \"creditsUsed\": 1725,\n \"creditsRefunded\": 50,\n \"createdAt\": \"2026-03-02T10:00:00.000Z\",\n \"completedAt\": \"2026-03-02T10:00:12.000Z\"\n }\n ],\n \"total\": 42,\n \"page\": 1,\n \"limit\": 20\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7134b530-48fb-5d01-9a3a-acabbc415821", "name": "Something is wrong with the request \u2014 check the `detail` field for specifics", "status": "400", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body Invalid request\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5b4a6bf4-4685-5de6-a8b6-735936aebe23", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "556bc65d-9197-5591-87f4-396c202a61d9", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1996b607-a3f5-5adc-947d-03c73d5dabd2", "name": "Something went wrong on our end \u2014 try again in a moment", "status": "500", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/internal-error\",\n \"title\": \"Internal Server Error\",\n \"status\": 500,\n \"detail\": \"An unexpected error occurred. Please try again later.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "6d855881-6e40-5f30-a240-e8421123fd1b", "name": "Poll reveal/enrich job", "request": { "name": "Poll reveal/enrich job", "description": { "content": "Poll the status of a reveal or enrich job. Call repeatedly until `status` is `\"completed\"` or `\"failed\"`. Polling is always free.\n\n**Recommended interval:** 2 seconds.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/lead-finder/reveal-jobs/{jobId}", "host": [ "{{baseUrl}}" ], "path": [ "lead-finder", "reveal-jobs", ":jobId" ], "query": [], "variable": [ { "key": "jobId", "value": "", "description": "Reveal/enrich job ID (starts with `rj_`)" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "GET", "auth": null }, "response": [ { "id": "c4e875e4-99cc-545a-8b85-680f1cacb428", "name": "Job status returned", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": false,\n \"data\": {\n \"jobId\": \"string\",\n \"status\": \"string\",\n \"jobType\": \"string\",\n \"fields\": [\n \"string\"\n ],\n \"progress\": {\n \"processed\": 0,\n \"total\": 0\n },\n \"results\": {\n \"revealed\": [\n {\n \"id\": null,\n \"firstName\": null,\n \"lastName\": null,\n \"jobTitle\": null,\n \"companyName\": null,\n \"emailAddress\": null,\n \"phone\": null,\n \"cellphone\": null,\n \"linkedinUrl\": null,\n \"domain\": null\n }\n ],\n \"alreadyRevealed\": 0,\n \"newlyRevealed\": 0,\n \"creditsUsed\": 0,\n \"creditsRefunded\": 0\n },\n \"error\": \"string\",\n \"creditsRefunded\": 0,\n \"createdAt\": \"string\",\n \"completedAt\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0ba2e150-9b02-5f80-9ded-872ffcb4d117", "name": "Something is wrong with the request \u2014 check the `detail` field for specifics", "status": "400", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body Invalid request\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c06c405e-3cef-5900-8f23-8fd1afdfc378", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "eee77db4-98a7-52f2-a281-a7e0a5d4a8cf", "name": "Job not found or belongs to another team", "status": "404", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/not-found\",\n \"title\": \"Not Found\",\n \"status\": 404,\n \"detail\": \"Reveal job not found\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dc31340c-cbc6-5bcf-a06e-ea104627ee9f", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "23de9156-c96c-5880-8644-647cf3bfae1e", "name": "Something went wrong on our end \u2014 try again in a moment", "status": "500", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/internal-error\",\n \"title\": \"Internal Server Error\",\n \"status\": 500,\n \"detail\": \"An unexpected error occurred. Please try again later.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "c04882b8-82f3-5545-930a-b6619be97bba", "name": "List saved searches", "request": { "name": "List saved searches", "description": { "content": "List all saved searches for the current user. Free endpoint.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/lead-finder/saved", "host": [ "{{baseUrl}}" ], "path": [ "lead-finder", "saved" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "GET", "auth": null }, "response": [ { "id": "5eba8389-1132-5359-bc95-de56abb909df", "name": "Saved searches listed successfully", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": [\n {\n \"id\": \"665e0b2f4a6d8c001abc1234\",\n \"name\": \"Engineering VPs in Bay Area\",\n \"filters\": {\n \"jobFunction\": [\n \"Engineering\"\n ],\n \"jobLevel\": [\n \"VP\"\n ],\n \"city\": \"San Francisco\"\n },\n \"createdAt\": \"2025-06-03T14:00:00.000Z\",\n \"updatedAt\": \"2025-06-03T14:00:00.000Z\"\n }\n ],\n \"meta\": {\n \"requestId\": \"req_664f2b3c9a1e4d0012abcdf5\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d173c204-081c-5bd5-879e-051659f45e63", "name": "Something is wrong with the request \u2014 check the `detail` field for specifics", "status": "400", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body Invalid request\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fed1186e-96d6-5de7-b598-3515797a89c6", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9d34ae10-620b-58b1-ad42-4ed32c235c1c", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f7c45cca-6e9c-5f53-8804-07368585e319", "name": "Something went wrong on our end \u2014 try again in a moment", "status": "500", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/internal-error\",\n \"title\": \"Internal Server Error\",\n \"status\": 500,\n \"detail\": \"An unexpected error occurred. Please try again later.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "39a7cee5-cf48-5a69-9b87-992719c91044", "name": "Save a search", "request": { "name": "Save a search", "description": { "content": "Save a search filter combination for reuse. Free endpoint.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/lead-finder/saved", "host": [ "{{baseUrl}}" ], "path": [ "lead-finder", "saved" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"name\": \"string\",\n \"filters\": {\n \"firstName\": \"string\",\n \"lastName\": \"string\",\n \"middleName\": \"string\",\n \"city\": \"string\",\n \"stateName\": null,\n \"stateCode\": null,\n \"countryName\": null,\n \"countryCode\": null,\n \"continent\": null,\n \"countryRegion\": null,\n \"linkedinUrl\": \"string\",\n \"linkedinHeadline\": \"string\",\n \"personHeadline\": null,\n \"companyHeadline\": null,\n \"linkedinIndustry\": null,\n \"logoUrl\": \"string\",\n \"emailDomain\": \"string\",\n \"emailAddress\": \"string\",\n \"jobTitle\": null,\n \"jobFunction\": null,\n \"jobLevel\": null,\n \"jobDescription\": \"string\",\n \"jobLocationCity\": \"string\",\n \"jobLocationState\": \"string\",\n \"jobLocationCountry\": null,\n \"jobIsCurrent\": false,\n \"jobStartDate\": \"string\",\n \"jobCount\": 0,\n \"companyName\": null,\n \"companyNameMode\": \"string\",\n \"persona\": \"string\",\n \"languages\": null,\n \"skills\": null,\n \"certifications\": \"string\",\n \"patents\": \"string\",\n \"publications\": \"string\",\n \"websites\": \"string\",\n \"education\": \"string\",\n \"phone\": \"string\",\n \"cellphone\": \"string\",\n \"orgName\": \"string\",\n \"domain\": null,\n \"aboutUs\": null,\n \"companyEntityType\": null,\n \"companyLegalType\": null,\n \"employeeCount\": 0,\n \"employeeCountMax\": 0,\n \"employeeCountMin\": 0,\n \"foundedOn\": 0,\n \"headquartersCity\": \"string\",\n \"headquartersState\": \"string\",\n \"headquartersCountry\": null,\n \"industrySicCode\": null,\n \"industrySicDescription\": null,\n \"industryNaicsCode\": null,\n \"industryNaicsDescription\": null,\n \"orgLinkedinUrl\": \"string\",\n \"locationCity\": \"string\",\n \"locationState\": \"string\",\n \"locationCountry\": null,\n \"revenueMax\": 0,\n \"revenueMin\": 0,\n \"revenueBuckets\": null,\n \"specialties\": \"string\",\n \"crmTechOrg\": null,\n \"marketingAutomationTechOrg\": null,\n \"abmTechOrg\": null,\n \"salesAutomationTechOrg\": null,\n \"analyticsTechOrg\": null,\n \"cmsTechOrg\": null,\n \"martechCategoriesOrg\": null,\n \"conversationIntelligenceTechOrg\": null,\n \"cloudProviderTechOrg\": null,\n \"emailHostingTechOrg\": null,\n \"emailSecurityTechOrg\": null,\n \"applicationSecurityTechOrg\": null,\n \"cloudSecurityTechOrg\": null,\n \"developmentTechOrg\": null,\n \"eCommercePlatformTechOrg\": null,\n \"erpTechOrg\": null,\n \"hasMobileAppOrg\": false,\n \"hasWebAppOrg\": false,\n \"hasCisoOrg\": false,\n \"hasCioOrg\": false,\n \"locationCountOrg\": 0,\n \"isLinkedinUrlClaimedOrg\": false,\n \"marketingRoleCountOrg\": 0,\n \"salesRoleCountOrg\": 0,\n \"operationsRoleCountOrg\": 0,\n \"businessDevelopmentRoleCountOrg\": 0,\n \"customerSuccessRoleCountOrg\": 0,\n \"itRoleCountOrg\": 0,\n \"grcRoleCountOrg\": 0,\n \"securityRoleCountOrg\": 0,\n \"devopsRoleCountOrg\": 0,\n \"networkInfrastructureRoleCountOrg\": 0,\n \"mobileDevRoleCountOrg\": 0,\n \"iosDevRoleCountOrg\": 0,\n \"androidDevRoleCountOrg\": 0,\n \"engineerRoleCountOrg\": 0,\n \"qaRoleCountOrg\": 0,\n \"marketingOpenRolesCountOrg\": 0,\n \"operationsOpenRolesCountOrg\": 0,\n \"salesOpenRolesCountOrg\": 0,\n \"accountExecutiveOpenRolesCountOrg\": 0,\n \"customerSuccessOpenRolesCountOrg\": 0,\n \"demandGenerationOpenRolesCountOrg\": 0,\n \"businessDevelopmentOpenRolesCountOrg\": 0,\n \"itOpenRolesCountOrg\": 0,\n \"securityOpenRolesCountOrg\": 0,\n \"grcOpenRolesCountOrg\": 0,\n \"devopsOpenRolesCountOrg\": 0,\n \"networkInfrastructureOpenRolesCountOrg\": 0,\n \"monthlyOrganicTrafficOrg\": 0,\n \"monthlyPaidTrafficOrg\": 0,\n \"totalMonthlyTrafficOrg\": 0,\n \"monthlyGoogleAdspendOrg\": 0,\n \"employeeOnLinkedinGrowthRateOrg\": 0,\n \"isWebsiteForSaleOrg\": false,\n \"topAppleappstoreUrlOrg\": \"string\",\n \"topAppstoreRatingOrg\": 0,\n \"topAppstoreReviewCountOrg\": 0,\n \"lastAppstoreUpdateOrg\": \"string\",\n \"appstoreUpdateCountOrg\": 0,\n \"appstoreAppCategoryOrg\": \"string\",\n \"topPlaystoreUrlOrg\": \"string\",\n \"topPlaystoreRatingOrg\": 0,\n \"topPlaystoreReviewCountOrg\": 0,\n \"lastPlaystoreUpdateOrg\": \"string\",\n \"playstoreDownloadCountOrg\": 0,\n \"playstoreAppCategoryOrg\": \"string\",\n \"totalReviewsOrg\": 0,\n \"lastFundingDateOrg\": \"string\",\n \"lastFundingAmountOrg\": 0,\n \"leadInvestorsOrg\": \"string\",\n \"lastFundingTypeOrg\": null,\n \"fundingRoundNumberOfInvestorsOrg\": 0,\n \"totalFundingAmountOrg\": 0\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "dd94950d-a3da-51a0-be43-4180cbaeb5a7", "name": "Search saved successfully", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"665e0b2f4a6d8c001abc1234\",\n \"name\": \"Engineering VPs in Bay Area\",\n \"filters\": {\n \"jobFunction\": [\n \"Engineering\"\n ],\n \"jobLevel\": [\n \"VP\"\n ]\n },\n \"createdAt\": \"2025-06-03T14:00:00.000Z\",\n \"updatedAt\": \"2025-06-03T14:00:00.000Z\"\n },\n \"meta\": {\n \"requestId\": \"req_664f2b3c9a1e4d0012abcdf6\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ff21c947-e754-5872-8b5b-0f3fa8373921", "name": "Something is wrong with the request \u2014 check the `detail` field for specifics", "status": "400", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body Invalid request\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3e1cf3b5-db3a-5870-b940-9ad58cc7aa61", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fa7cf9af-8c6b-5237-a4d8-e783de7f9289", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1c07f142-6538-5495-9d83-7858ca973599", "name": "Something went wrong on our end \u2014 try again in a moment", "status": "500", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/internal-error\",\n \"title\": \"Internal Server Error\",\n \"status\": 500,\n \"detail\": \"An unexpected error occurred. Please try again later.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "2dfad644-8c76-531a-807d-1689a9ff9fbd", "name": "Delete a saved search", "request": { "name": "Delete a saved search", "description": { "content": "Delete a saved search by ID. Only the owner can delete their own saved searches.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/lead-finder/saved/{id}", "host": [ "{{baseUrl}}" ], "path": [ "lead-finder", "saved", ":id" ], "query": [], "variable": [ { "key": "id", "value": "", "description": "Saved search ID" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "DELETE", "auth": null }, "response": [ { "id": "6a91eb52-1a59-5f27-962f-0ab6fe017e86", "name": "Saved search deleted successfully", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"deleted\": true\n },\n \"meta\": {\n \"requestId\": \"req_664f2b3c9a1e4d0012abcdf7\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f53669da-ba8e-53b1-b54e-bd8a3d7d61fc", "name": "Something is wrong with the request \u2014 check the `detail` field for specifics", "status": "400", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body Invalid request\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "af9b9584-00a3-59b0-92b1-208acde269c9", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4a5b8713-5b04-516a-a3a7-1dd4208c56c9", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "db02ff26-aa50-51b4-8cc5-dbe1402a893c", "name": "Something went wrong on our end \u2014 try again in a moment", "status": "500", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/internal-error\",\n \"title\": \"Internal Server Error\",\n \"status\": 500,\n \"detail\": \"An unexpected error occurred. Please try again later.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "85550464-cd7c-51e3-8cb5-fad73f898e77", "name": "Search leads", "request": { "name": "Search leads", "description": { "content": "Search across people, companies, and insights dimensions with comprehensive filters. Returns combined person + org + insights data.\n\n**Free tier:**\n- First 3 pages OR 75 results free per search, whichever comes first (at the default page size of 25 these match; with a larger page size the 75-result cap applies first)\n- 50 free searches per month, where a search = a unique filter combination. Paging through results or re-running the same search does not consume additional free searches.\n\n**Paid tier (page 4+):**\n- 1 credit per result returned\n- Max 40 pages\n\nResults include preview fields only. Use the **Reveal** or **Enrich** endpoints to get email and phone.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/lead-finder/search", "host": [ "{{baseUrl}}" ], "path": [ "lead-finder", "search" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"filters\": {\n \"firstName\": \"string\",\n \"lastName\": \"string\",\n \"middleName\": \"string\",\n \"city\": \"string\",\n \"stateName\": null,\n \"stateCode\": null,\n \"countryName\": null,\n \"countryCode\": null,\n \"continent\": null,\n \"countryRegion\": null,\n \"linkedinUrl\": \"string\",\n \"linkedinHeadline\": \"string\",\n \"personHeadline\": null,\n \"companyHeadline\": null,\n \"linkedinIndustry\": null,\n \"logoUrl\": \"string\",\n \"emailDomain\": \"string\",\n \"emailAddress\": \"string\",\n \"jobTitle\": null,\n \"jobFunction\": null,\n \"jobLevel\": null,\n \"jobDescription\": \"string\",\n \"jobLocationCity\": \"string\",\n \"jobLocationState\": \"string\",\n \"jobLocationCountry\": null,\n \"jobIsCurrent\": false,\n \"jobStartDate\": \"string\",\n \"jobCount\": 0,\n \"companyName\": null,\n \"companyNameMode\": \"string\",\n \"persona\": \"string\",\n \"languages\": null,\n \"skills\": null,\n \"certifications\": \"string\",\n \"patents\": \"string\",\n \"publications\": \"string\",\n \"websites\": \"string\",\n \"education\": \"string\",\n \"phone\": \"string\",\n \"cellphone\": \"string\",\n \"orgName\": \"string\",\n \"domain\": null,\n \"aboutUs\": null,\n \"companyEntityType\": null,\n \"companyLegalType\": null,\n \"employeeCount\": 0,\n \"employeeCountMax\": 0,\n \"employeeCountMin\": 0,\n \"foundedOn\": 0,\n \"headquartersCity\": \"string\",\n \"headquartersState\": \"string\",\n \"headquartersCountry\": null,\n \"industrySicCode\": null,\n \"industrySicDescription\": null,\n \"industryNaicsCode\": null,\n \"industryNaicsDescription\": null,\n \"orgLinkedinUrl\": \"string\",\n \"locationCity\": \"string\",\n \"locationState\": \"string\",\n \"locationCountry\": null,\n \"revenueMax\": 0,\n \"revenueMin\": 0,\n \"revenueBuckets\": null,\n \"specialties\": \"string\",\n \"crmTechOrg\": null,\n \"marketingAutomationTechOrg\": null,\n \"abmTechOrg\": null,\n \"salesAutomationTechOrg\": null,\n \"analyticsTechOrg\": null,\n \"cmsTechOrg\": null,\n \"martechCategoriesOrg\": null,\n \"conversationIntelligenceTechOrg\": null,\n \"cloudProviderTechOrg\": null,\n \"emailHostingTechOrg\": null,\n \"emailSecurityTechOrg\": null,\n \"applicationSecurityTechOrg\": null,\n \"cloudSecurityTechOrg\": null,\n \"developmentTechOrg\": null,\n \"eCommercePlatformTechOrg\": null,\n \"erpTechOrg\": null,\n \"hasMobileAppOrg\": false,\n \"hasWebAppOrg\": false,\n \"hasCisoOrg\": false,\n \"hasCioOrg\": false,\n \"locationCountOrg\": 0,\n \"isLinkedinUrlClaimedOrg\": false,\n \"marketingRoleCountOrg\": 0,\n \"salesRoleCountOrg\": 0,\n \"operationsRoleCountOrg\": 0,\n \"businessDevelopmentRoleCountOrg\": 0,\n \"customerSuccessRoleCountOrg\": 0,\n \"itRoleCountOrg\": 0,\n \"grcRoleCountOrg\": 0,\n \"securityRoleCountOrg\": 0,\n \"devopsRoleCountOrg\": 0,\n \"networkInfrastructureRoleCountOrg\": 0,\n \"mobileDevRoleCountOrg\": 0,\n \"iosDevRoleCountOrg\": 0,\n \"androidDevRoleCountOrg\": 0,\n \"engineerRoleCountOrg\": 0,\n \"qaRoleCountOrg\": 0,\n \"marketingOpenRolesCountOrg\": 0,\n \"operationsOpenRolesCountOrg\": 0,\n \"salesOpenRolesCountOrg\": 0,\n \"accountExecutiveOpenRolesCountOrg\": 0,\n \"customerSuccessOpenRolesCountOrg\": 0,\n \"demandGenerationOpenRolesCountOrg\": 0,\n \"businessDevelopmentOpenRolesCountOrg\": 0,\n \"itOpenRolesCountOrg\": 0,\n \"securityOpenRolesCountOrg\": 0,\n \"grcOpenRolesCountOrg\": 0,\n \"devopsOpenRolesCountOrg\": 0,\n \"networkInfrastructureOpenRolesCountOrg\": 0,\n \"monthlyOrganicTrafficOrg\": 0,\n \"monthlyPaidTrafficOrg\": 0,\n \"totalMonthlyTrafficOrg\": 0,\n \"monthlyGoogleAdspendOrg\": 0,\n \"employeeOnLinkedinGrowthRateOrg\": 0,\n \"isWebsiteForSaleOrg\": false,\n \"topAppleappstoreUrlOrg\": \"string\",\n \"topAppstoreRatingOrg\": 0,\n \"topAppstoreReviewCountOrg\": 0,\n \"lastAppstoreUpdateOrg\": \"string\",\n \"appstoreUpdateCountOrg\": 0,\n \"appstoreAppCategoryOrg\": \"string\",\n \"topPlaystoreUrlOrg\": \"string\",\n \"topPlaystoreRatingOrg\": 0,\n \"topPlaystoreReviewCountOrg\": 0,\n \"lastPlaystoreUpdateOrg\": \"string\",\n \"playstoreDownloadCountOrg\": 0,\n \"playstoreAppCategoryOrg\": \"string\",\n \"totalReviewsOrg\": 0,\n \"lastFundingDateOrg\": \"string\",\n \"lastFundingAmountOrg\": 0,\n \"leadInvestorsOrg\": \"string\",\n \"lastFundingTypeOrg\": null,\n \"fundingRoundNumberOfInvestorsOrg\": 0,\n \"totalFundingAmountOrg\": 0\n },\n \"excludeFilters\": {\n \"personHeadline\": null,\n \"companyHeadline\": null,\n \"aboutUs\": null,\n \"domain\": null,\n \"jobTitle\": null\n },\n \"page\": 1,\n \"pageSize\": 25\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "bbadb2ec-fb4f-5036-a9ee-c184fe1aa68c", "name": "Search results returned successfully", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"results\": [\n {\n \"id\": \"enc_abc123def456\",\n \"firstName\": \"Sarah\",\n \"lastName\": \"C.\",\n \"logoUrl\": \"https://media.licdn.com/dms/image/stripe-logo.jpg\",\n \"emailDomain\": \"stripe.com\",\n \"linkedinUrl\": \"https://linkedin.com/in/sarahc\",\n \"linkedinHeadline\": \"VP of Engineering at Stripe\",\n \"jobTitle\": \"VP of Engineering\",\n \"jobFunction\": \"Engineering\",\n \"jobLevel\": \"VP\",\n \"companyName\": \"Stripe\",\n \"skills\": \"Python, Distributed Systems, Cloud Architecture\",\n \"city\": \"San Francisco\",\n \"stateName\": \"California\",\n \"countryName\": \"United States\",\n \"domain\": \"stripe.com\",\n \"orgLinkedinUrl\": \"https://linkedin.com/company/stripe\",\n \"employeeCount\": 8000,\n \"industrySicDescription\": \"Computer Processing & Data Preparation\",\n \"industryNaicsDescription\": \"Data Processing, Hosting, and Related Services\",\n \"revenue\": \"$1B+\",\n \"specialties\": \"Payments, Financial Infrastructure\",\n \"foundedOn\": \"2010\",\n \"headquartersCity\": \"San Francisco\",\n \"headquartersState\": \"California\",\n \"headquartersCountry\": \"United States\",\n \"employeeOnLinkedinGrowthRateOrg\": 12,\n \"totalMonthlyTrafficOrg\": 5000000,\n \"totalFundingAmountOrg\": 8700000000,\n \"lastFundingTypeOrg\": \"Series I\",\n \"lastFundingDateOrg\": \"2023-03-15\"\n }\n ],\n \"pagination\": {\n \"page\": 1,\n \"pageSize\": 25,\n \"totalResults\": 1842,\n \"totalPages\": 74,\n \"hasMore\": true,\n \"searchedTotalResult\": 1842\n }\n },\n \"meta\": {\n \"requestId\": \"req_664f2b3c9a1e4d0012abcdef\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e8359b84-05df-51db-908e-d236a9223010", "name": "Something is wrong with the request \u2014 check the `detail` field for specifics", "status": "400", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body Invalid request\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3fd0decc-0356-51ac-bb32-c365ebc3b6eb", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6ee311ba-dcf0-5f4b-b948-f36ad9cd8086", "name": "You don't have enough credits for this request", "status": "402", "code": 402, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/insufficient-credits\",\n \"title\": \"Insufficient Credits\",\n \"status\": 402,\n \"detail\": \"Not enough credits. Required: 575, available: 100\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "51306cd5-3d00-5433-aa84-1d4b4dee4f91", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0cc31f03-8fe9-572c-8b70-c6dd16edca22", "name": "Something went wrong on our end \u2014 try again in a moment", "status": "500", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/internal-error\",\n \"title\": \"Internal Server Error\",\n \"status\": 500,\n \"detail\": \"An unexpected error occurred. Please try again later.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "470fd9be-abcd-5634-b663-748865dfdb83", "name": "Suggest company names", "request": { "name": "Suggest company names", "description": { "content": "Prefix-based company name autocomplete. Returns matching company names for search typeahead. Free endpoint.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/lead-finder/suggest", "host": [ "{{baseUrl}}" ], "path": [ "lead-finder", "suggest" ], "query": [ { "key": "q", "value": "string", "description": "Search prefix (min 2 characters)", "disabled": false }, { "key": "limit", "value": "", "description": "Max suggestions (1\u201350, default: 20)", "disabled": true } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "GET", "auth": null }, "response": [ { "id": "cbcbb785-0542-5bd2-8118-919076c0b4c0", "name": "Suggestions returned successfully", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"values\": [\n \"Stripe\",\n \"Stripe Atlas\",\n \"StripChat\"\n ]\n },\n \"meta\": {\n \"requestId\": \"req_664f2b3c9a1e4d0012abcdf9\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a139b000-935c-5333-b53c-cad9552f6512", "name": "Something is wrong with the request \u2014 check the `detail` field for specifics", "status": "400", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body Invalid request\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8c2bc816-584d-5a86-8ccd-10f2456f447a", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c340ad07-361c-51d1-ac48-342502adc008", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bf4fcdb8-ac9d-5dc7-907a-bb622d805e79", "name": "Something went wrong on our end \u2014 try again in a moment", "status": "500", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/internal-error\",\n \"title\": \"Internal Server Error\",\n \"status\": 500,\n \"detail\": \"An unexpected error occurred. Please try again later.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "823a0d5f-7669-543a-8de8-03b2105c6c08", "name": "Unlock full last names", "request": { "name": "Unlock full last names", "description": { "content": "Pay 1 credit per lead to unlock full last names. Search results mask last names by default; this endpoint reveals them.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/lead-finder/unlock-names", "host": [ "{{baseUrl}}" ], "path": [ "lead-finder", "unlock-names" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"leads\": [\n {\n \"id\": \"string\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "20ec4022-e028-5743-b3f7-72363a96ab81", "name": "Names unlocked successfully", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"results\": [\n {\n \"id\": \"enc_abc123def456\",\n \"lastName\": \"Chen\"\n },\n {\n \"id\": \"enc_xyz789ghi012\",\n \"lastName\": \"Johnson\"\n }\n ]\n },\n \"meta\": {\n \"requestId\": \"req_664f2b3c9a1e4d0012abcdf4\",\n \"creditsUsed\": 2\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4a887849-83ce-55e2-918e-14ea473cd12f", "name": "Something is wrong with the request \u2014 check the `detail` field for specifics", "status": "400", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body Invalid request\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "850b6483-0c7b-5ff3-9c3c-e07744bf37e2", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0471997c-c8a3-5671-92ef-a5711565eb7c", "name": "You don't have enough credits for this request", "status": "402", "code": 402, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/insufficient-credits\",\n \"title\": \"Insufficient Credits\",\n \"status\": 402,\n \"detail\": \"Not enough credits. Required: 575, available: 100\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c7d4cccc-e207-5728-b0cf-b2ad3a15a55b", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "229ac986-ae9e-5f91-8cce-68e56b1f6ef7", "name": "Something went wrong on our end \u2014 try again in a moment", "status": "500", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/internal-error\",\n \"title\": \"Internal Server Error\",\n \"status\": 500,\n \"detail\": \"An unexpected error occurred. Please try again later.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] } ] }, { "id": "14d78431-a053-522f-aa13-2f7b390faf2a", "name": "People Search", "description": { "content": "", "type": "text/plain" }, "item": [ { "id": "a31435d4-4f7f-5d89-9dcb-af5ddc8f1b9b", "name": "Find employees at a company", "request": { "name": "Find employees at a company", "description": { "content": "Find employees at a specific company by LinkedIn URL. Optionally filter by job level, job function, country, continent, or sales region.\n\n**Credits:** 1 credit per result returned. No charge if 0 results.\n\n**Pagination:** Use `page` and `max_results` to paginate through results.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/people-search/employee-finder", "host": [ "{{baseUrl}}" ], "path": [ "people-search", "employee-finder" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"company_linkedin_url\": \"https://www.linkedin.com/company/google/\",\n \"country\": [\n \"United States\",\n \"United Kingdom\"\n ],\n \"continent\": [\n \"North America\"\n ],\n \"sales_region\": [\n \"string\"\n ],\n \"job_level\": [\n \"C-Level\",\n \"VP\",\n \"Director\"\n ],\n \"job_function\": [\n \"Engineering\",\n \"Marketing\"\n ],\n \"max_results\": 10,\n \"page\": 1\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "74be474c-5b4c-56c4-b12f-7c7f95642f2c", "name": "Employees found successfully. Results sorted by lead quality.", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"company_linkedin_url\": \"string\",\n \"max_results\": 0,\n \"results_length\": 0,\n \"page\": 0,\n \"total_pages\": 0,\n \"total_results\": 0,\n \"results\": [\n {\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"full_name\": \"John Doe\",\n \"headline\": \"Senior Software Engineer at Google\",\n \"about_me\": \"string\",\n \"location\": {\n \"city\": \"San Francisco\",\n \"state_code\": \"CA\",\n \"country\": \"United States\",\n \"country_code\": \"US\",\n \"continent\": \"North America\"\n },\n \"linkedin_url\": \"https://www.linkedin.com/in/johndoe\",\n \"job_title\": \"Senior Software Engineer\",\n \"job_level\": \"Senior\",\n \"job_function\": \"Engineering\",\n \"job_is_current\": true,\n \"education\": \"string\",\n \"skills\": \"string\",\n \"certifications\": \"string\"\n }\n ]\n },\n \"meta\": {\n \"requestId\": \"string\",\n \"creditsUsed\": 0,\n \"creditsRemaining\": 0\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bc8f29db-5f91-55ec-9f65-0567f8413220", "name": "Invalid request \u2014 check that company_linkedin_url is a valid LinkedIn company URL", "status": "400", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body/email Invalid email\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "67b3c3f1-ac38-5365-b2ba-c97515d64e3a", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body/email Invalid email\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "38998192-a550-5d96-b364-72161303f7b0", "name": "You don't have enough credits for this request", "status": "402", "code": 402, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body/email Invalid email\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2b1bc5b9-351c-5b69-9eca-0087e1292053", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body/email Invalid email\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c8cc9d6f-98ca-5437-9f84-55652df2ee26", "name": "Something went wrong on our end \u2014 try again in a moment", "status": "500", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body/email Invalid email\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "6dbce426-f165-5017-869e-5388b710978b", "name": "Cascading ICP people search", "request": { "name": "Cascading ICP people search", "description": { "content": "Search for people at a specific company using cascading ICP (Ideal Customer Profile) filter levels.\n\n**How it works:**\n1. Provide a company LinkedIn URL to target\n2. Optionally define 1-10 cascade levels, each with independent ICP criteria. If omitted, a default 4-level cascade is used: CEO/Founder \u2192 C-Suite \u2192 VP \u2192 Director.\n3. Levels are processed in order \u2014 results from earlier levels are excluded from later ones\n4. Each candidate is scored against the ICP criteria of their matching cascade level\n5. Results are returned sorted by score descending\n\n**Scoring:** Each candidate gets a normalized 0-100 score based on title match (30pts), job level (20pts), skills overlap (15pts), location match (15pts), current job status (10pts), profile completeness (5pts), tenure (5pts), and optional seniority priority bonus (0-30pts). The score is normalized against only the dimensions specified in the cascade level.\n\n**Credits:** 1 credit per profile returned. No charge if 0 results.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/people-search/waterfall-icp-search", "host": [ "{{baseUrl}}" ], "path": [ "people-search", "waterfall-icp-search" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"company_linkedin_url\": \"https://www.linkedin.com/company/google/\",\n \"cascade\": [\n {\n \"include_title\": [\n \"CTO\",\n \"VP Engineering\"\n ],\n \"exclude_title\": [\n \"Intern\",\n \"Associate\"\n ],\n \"job_levels\": [\n \"C-Level\",\n \"VP\"\n ],\n \"job_functions\": [\n \"Engineering\",\n \"Technology\"\n ],\n \"skills\": [\n \"Python\",\n \"Machine Learning\"\n ],\n \"location\": [\n \"US\",\n \"UK\"\n ],\n \"include_headline_search\": false,\n \"priority_bonus\": 0\n }\n ],\n \"max_results\": 25,\n \"min_score\": 0\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "78a7c9d4-a34e-50d9-b914-367bf69bb2a4", "name": "Search completed successfully. Results are sorted by ICP score descending.", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"results\": [\n {\n \"person\": {\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"linkedin_url\": \"https://www.linkedin.com/in/johndoe\",\n \"linkedin_headline\": \"CTO at Google\",\n \"location\": \"San Francisco, California, United States\",\n \"email_domain\": \"google.com\"\n },\n \"current_position\": {\n \"title\": \"CTO\",\n \"company\": \"Google\",\n \"level\": \"C-Level\",\n \"function\": \"Engineering\",\n \"is_current\": true,\n \"start_date\": \"2020-01-15\"\n },\n \"skills\": [\n \"Python\",\n \"Machine Learning\",\n \"Cloud Architecture\"\n ],\n \"education\": \"Stanford University\",\n \"certifications\": null,\n \"score\": 92,\n \"ranking\": 1,\n \"cascade_level\": 0,\n \"ranking_factors\": {\n \"title_match\": 30,\n \"job_level\": 20,\n \"skills_overlap\": 10,\n \"location_match\": 15,\n \"current_job\": 10,\n \"profile_completeness\": 5,\n \"experience\": 5,\n \"priority_bonus\": 0\n },\n \"what_matched\": [\n \"Exact title match: CTO\",\n \"Exact level: C-Level\",\n \"Skills: 2/3 matched\",\n \"Country match: United States\",\n \"Current position\"\n ]\n }\n ],\n \"total_found\": 47,\n \"total_returned\": 10,\n \"cascade_stats\": [\n {\n \"level\": 0,\n \"candidates_found\": 35,\n \"candidates_kept\": 8\n }\n ]\n },\n \"meta\": {\n \"requestId\": \"1123c535-e925-4224-b5fb-3d579b75b849\",\n \"creditsUsed\": 10,\n \"creditsRemaining\": 999990\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "abca8a81-5d2d-5857-8ff5-3da1d9040a69", "name": "Invalid request \u2014 check that company_linkedin_url is a valid LinkedIn company URL, cascade has 1-10 levels, max_results ", "status": "400", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"company_linkedin_url: Must be a LinkedIn company URL (e.g. https://www.linkedin.com/company/google/)\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0f764f32-2979-5f81-983e-1623f9d051ee", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body/email Invalid email\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "854054a1-8d34-5826-a6a3-32aeb6bda376", "name": "You don't have enough credits for this request", "status": "402", "code": 402, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body/email Invalid email\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c8dbf62d-794e-5a2c-9e41-283f00b55663", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body/email Invalid email\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "31b43af3-5269-5165-9a53-9bb208a80119", "name": "Something went wrong on our end \u2014 try again in a moment", "status": "500", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body/email Invalid email\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] } ] }, { "id": "2f71eb21-7136-57dc-a56b-7e8374eb9ea5", "name": "Reverse Email Lookup", "description": { "content": "", "type": "text/plain" }, "item": [ { "id": "407a97a2-2c8a-57a8-85e0-1977a81a6263", "name": "Look up professional profiles in batch", "request": { "name": "Look up professional profiles in batch", "description": { "content": "Submit up to **100 000 emails** and get back professional profile data for each\none. Duplicate emails are removed (case-insensitive) before processing.\n\n**Cost:** 10 credits per unique email, reserved upfront. Credits for emails\nwhere no profile was found are refunded.\n\n### Webhook callbacks\n\nIf you include a `webhookUrl`, your server will receive:\n\n1. **A per-result callback** for every email as it is processed. See\n [reverseLookupResult](#tag/Webhooks/operation/webhookReverseLookupResult) for the payload.\n\n2. **A completion callback** when the entire batch finishes. See\n [reverseLookupCompletion](#tag/Webhooks/operation/webhookReverseLookupCompletion) for the payload.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/reverse-lookup/bulk-lookup", "host": [ "{{baseUrl}}" ], "path": [ "reverse-lookup", "bulk-lookup" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"emails\": [\n \"emily.zhang@figma.com\",\n \"david.kim@vercel.com\",\n \"aisha.johnson@cloudflare.com\"\n ],\n \"webhookUrl\": \"https://api.yourapp.com/webhooks/enrich\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "971557fa-fde1-51fc-96ec-b6d9e6d31252", "name": "Bulk lookup submitted \u2014 credits have been reserved", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"batchId\": \"665d2f8b9c5b2a0015d0bc10\",\n \"status\": \"queued\",\n \"itemCount\": 3,\n \"message\": \"Bulk lookup job created\",\n \"originalCount\": 3,\n \"duplicatesRemoved\": 0\n },\n \"meta\": {\n \"requestId\": \"665d2f8b9c5b2a0015d0bc0f\",\n \"creditsReserved\": 30,\n \"creditsPerItem\": 10,\n \"estimatedCredits\": 30\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "006ca547-1f3b-54af-ac5a-398b091bde60", "name": "Something is wrong with the request \u2014 check the `detail` field for specifics", "status": "400", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body/email Invalid email\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "56b2cc25-8f0b-5199-bbd5-64fc4dcc93ab", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bef51049-4cc1-5497-8cc4-92a574e78336", "name": "You don't have enough credits for this request", "status": "402", "code": 402, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/insufficient-credits\",\n \"title\": \"Insufficient Credits\",\n \"status\": 402,\n \"detail\": \"Not enough credits. Required: 10, available: 3\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fd4afc3a-3535-5e47-9984-5355c140d7ba", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6796ff7c-58c8-54e5-b61c-cf6df311dfda", "name": "Something went wrong on our end \u2014 try again in a moment", "status": "500", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/internal-error\",\n \"title\": \"Internal Server Error\",\n \"status\": 500,\n \"detail\": \"An unexpected error occurred. Please try again later.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "43ffb7f6-7696-5118-91d6-19d855a687f2", "name": "Check bulk lookup progress", "request": { "name": "Check bulk lookup progress", "description": { "content": "Poll this endpoint to track the batch.\n\n**Cost:** Free.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/reverse-lookup/bulk-lookup/{batchId}", "host": [ "{{baseUrl}}" ], "path": [ "reverse-lookup", "bulk-lookup", ":batchId" ], "query": [], "variable": [ { "key": "batchId", "value": "", "description": "The batch identifier returned when you submitted the job" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "GET", "auth": null }, "response": [ { "id": "30c0f6af-253d-5c8d-b107-00246ed17c20", "name": "Current batch status", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"batchId\": \"665d2f8b9c5b2a0015d0bc10\",\n \"status\": \"processing\",\n \"totalItems\": 3,\n \"processedItems\": 2,\n \"progress\": 66.7\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ed203fdd-0d1b-5ccf-8a83-6394fd63ea81", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e303cd3b-23dd-5a52-b466-2c0a5a8a8018", "name": "The resource you requested doesn't exist or doesn't belong to your organization", "status": "404", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/not-found\",\n \"title\": \"Not Found\",\n \"status\": 404,\n \"detail\": \"No batch found with that ID\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d70773b7-60f7-5769-ba3d-41c144a7daff", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "bcc0a4c0-2550-5365-bf30-9895eabc18fb", "name": "Get bulk lookup results", "request": { "name": "Get bulk lookup results", "description": { "content": "Retrieve paginated professional profile results. Each result contains the full\nprofile data, or the result is omitted if no profile was found for that email.\n\n**Credit settlement:** Emails with no matching profile are not charged.\nThe difference between reserved and actual credits is refunded.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/reverse-lookup/bulk-lookup/{batchId}/results", "host": [ "{{baseUrl}}" ], "path": [ "reverse-lookup", "bulk-lookup", ":batchId", "results" ], "query": [ { "key": "page", "value": "1", "description": "Page number (default: 1)", "disabled": true }, { "key": "limit", "value": "100", "description": "Results per page (default: 100, max: 1 000)", "disabled": true } ], "variable": [ { "key": "batchId", "value": "", "description": "The batch identifier returned when you submitted the job" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "GET", "auth": null }, "response": [ { "id": "06a3620f-c3c2-57de-99e1-cf258bd153d1", "name": "Paginated lookup results", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"batchId\": \"665d2f8b9c5b2a0015d0bc10\",\n \"status\": \"completed\",\n \"totalItems\": 3,\n \"processedItems\": 3,\n \"successful\": 2,\n \"failed\": 1,\n \"page\": 1,\n \"limit\": 100,\n \"results\": [\n {\n \"id\": \"ACoAABk7TGwBfn9oQe3F\",\n \"displayName\": \"Emily Zhang\",\n \"firstName\": \"Emily\",\n \"lastName\": \"Zhang\",\n \"headline\": \"Staff Product Designer at Figma\",\n \"companyName\": \"Figma\",\n \"location\": \"San Francisco, California\",\n \"profileUrl\": \"https://www.example.com/in/emilyzhang\",\n \"isPublic\": true,\n \"skills\": [\n \"Product Design\",\n \"Design Systems\",\n \"Figma\"\n ]\n },\n {\n \"id\": \"ACoAAC2dPR4BvKx9nJQm\",\n \"displayName\": \"David Kim\",\n \"firstName\": \"David\",\n \"lastName\": \"Kim\",\n \"headline\": \"Engineering Manager at Vercel\",\n \"companyName\": \"Vercel\",\n \"location\": \"New York, New York\",\n \"profileUrl\": \"https://www.example.com/in/davidkim\",\n \"isPublic\": true,\n \"skills\": [\n \"Next.js\",\n \"React\",\n \"Engineering Management\"\n ]\n }\n ]\n },\n \"meta\": {\n \"requestId\": \"665d38ca9c5b2a0015d0bc20\",\n \"creditsUsed\": 20,\n \"creditsRefunded\": 10,\n \"creditsRemaining\": 24970,\n \"totalItems\": 3,\n \"processedItems\": 3\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1f878cea-6f70-5c02-8a01-b89d0c7f160d", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3e2cd2fb-e2ff-5092-9667-60edf267df99", "name": "The resource you requested doesn't exist or doesn't belong to your organization", "status": "404", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/not-found\",\n \"title\": \"Not Found\",\n \"status\": 404,\n \"detail\": \"No batch found with that ID\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "18616f99-c9e3-5719-8379-265bb353b3c3", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "36838453-65d2-52a1-9dc7-124a58262315", "name": "Look up a professional profile by email", "request": { "name": "Look up a professional profile by email", "description": { "content": "Pass an email address and get back the person's professional profile \u2014 including\ntheir name, headline, current company, job history, education, and skills.\n\n**Cost:** 10 credits. You are **not** charged if no profile is found.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/reverse-lookup/lookup", "host": [ "{{baseUrl}}" ], "path": [ "reverse-lookup", "lookup" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"email\": \"emily.zhang@figma.com\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "ce0e1dfc-9aba-5570-a021-60b07414c821", "name": "Professional profile data returned successfully", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"ACoAABk7TGwBfn9oQe3F\",\n \"displayName\": \"Emily Zhang\",\n \"firstName\": \"Emily\",\n \"lastName\": \"Zhang\",\n \"headline\": \"Staff Product Designer at Figma\",\n \"summary\": \"Product designer focused on design systems and developer tools. Previously at Airbnb and Google.\",\n \"companyName\": \"Figma\",\n \"location\": \"San Francisco, California\",\n \"photoUrl\": \"https://media.licdn.com/dms/image/v2/D5603AQH/profile-displayphoto-shrink_200/photo.jpg\",\n \"profileUrl\": \"https://www.example.com/in/emilyzhang\",\n \"connectionCount\": 500,\n \"isConnectionCountObfuscated\": true,\n \"isPublic\": true,\n \"skills\": [\n \"Product Design\",\n \"Design Systems\",\n \"Figma\",\n \"User Research\",\n \"Prototyping\"\n ],\n \"locale\": {\n \"country\": \"US\",\n \"language\": \"en\"\n },\n \"schools\": {\n \"educationsCount\": 1,\n \"educationHistory\": [\n {\n \"degreeName\": \"B.A. Interaction Design\",\n \"schoolName\": \"Carnegie Mellon University\",\n \"schoolLocation\": \"Pittsburgh, PA\",\n \"startEndDate\": {\n \"start\": {\n \"year\": 2012\n },\n \"end\": {\n \"year\": 2016\n }\n }\n }\n ]\n },\n \"positions\": {\n \"positionsCount\": 3,\n \"positionHistory\": [\n {\n \"title\": \"Staff Product Designer\",\n \"companyName\": \"Figma\",\n \"companyLocation\": \"San Francisco, CA\",\n \"description\": \"Leading the design systems team.\",\n \"startEndDate\": {\n \"start\": {\n \"month\": 1,\n \"year\": 2022\n },\n \"end\": null\n }\n },\n {\n \"title\": \"Senior Product Designer\",\n \"companyName\": \"Airbnb\",\n \"companyLocation\": \"San Francisco, CA\",\n \"startEndDate\": {\n \"start\": {\n \"month\": 5,\n \"year\": 2019\n },\n \"end\": {\n \"month\": 12,\n \"year\": 2021\n }\n }\n },\n {\n \"title\": \"Product Designer\",\n \"companyName\": \"Google\",\n \"companyLocation\": \"Mountain View, CA\",\n \"startEndDate\": {\n \"start\": {\n \"month\": 7,\n \"year\": 2016\n },\n \"end\": {\n \"month\": 4,\n \"year\": 2019\n }\n }\n }\n ]\n },\n \"creditsConsumed\": 10\n },\n \"meta\": {\n \"requestId\": \"665d1e4a9c5b2a0015d0bc01\",\n \"creditsUsed\": 10,\n \"creditsRemaining\": 24990,\n \"processingTimeMs\": 2140\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7d9ce4fd-76d4-52d1-a40b-372831574af7", "name": "Something is wrong with the request \u2014 check the `detail` field for specifics", "status": "400", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body/email Invalid email\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "19f0cec6-b28a-5d06-8a81-fa54b8a7b824", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "76461a44-bcfd-587b-ada0-ffdef683984a", "name": "You don't have enough credits for this request", "status": "402", "code": 402, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/insufficient-credits\",\n \"title\": \"Insufficient Credits\",\n \"status\": 402,\n \"detail\": \"Not enough credits. Required: 10, available: 3\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "18794a23-7d24-5df1-9b39-982a3ca84306", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "386261e1-95bf-570e-94fd-fe5dba9da0b8", "name": "Something went wrong on our end \u2014 try again in a moment", "status": "500", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/internal-error\",\n \"title\": \"Internal Server Error\",\n \"status\": 500,\n \"detail\": \"An unexpected error occurred. Please try again later.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] } ] }, { "id": "4cb94d81-a4dd-5e73-be1c-174ca37a1ded", "name": "Phone Finder", "description": { "content": "", "type": "text/plain" }, "item": [ { "id": "0db920b8-cffc-538c-8c61-2835fafea7e4", "name": "Find phone numbers", "request": { "name": "Find phone numbers", "description": { "content": "Find phone numbers associated with a person's email address or social\nprofile URL. You must provide at least one of the two.\n\n**Cost:** 500 credits. You are **not** charged if no phone numbers are found.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/reverse-lookup/phones", "host": [ "{{baseUrl}}" ], "path": [ "reverse-lookup", "phones" ], "query": [ { "key": "email", "value": "string", "description": "The person's email address", "disabled": true }, { "key": "linkedin", "value": "string", "description": "The person's profile URL", "disabled": true } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "GET", "auth": null }, "response": [ { "id": "15e8fbf0-a11e-5a33-96ad-4304186fef0c", "name": "Phone numbers returned successfully", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"phones\": [\n \"+14158009370\",\n \"+14158009371\"\n ]\n },\n \"meta\": {\n \"requestId\": \"665c4d2a7b8e3f00149f0a01\",\n \"creditsUsed\": 500,\n \"creditsRemaining\": 24500,\n \"processingTimeMs\": 1340\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ba54e592-58b7-525c-92e9-fa3bcba9ef93", "name": "Something is wrong with the request \u2014 check the `detail` field for specifics", "status": "400", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"querystring/email Invalid email\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2ce1d25f-7287-5f6b-affa-38757d5ebc4d", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "37c9605e-abfb-5b6c-ab79-481c3b521195", "name": "You don't have enough credits for this request", "status": "402", "code": 402, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/insufficient-credits\",\n \"title\": \"Insufficient Credits\",\n \"status\": 402,\n \"detail\": \"Not enough credits. Required: 10, available: 3\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4ce943fb-2eec-568c-964b-d90e387f93af", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "154c89d6-3d2e-5145-9173-01f3165d01c7", "name": "Something went wrong on our end \u2014 try again in a moment", "status": "500", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/internal-error\",\n \"title\": \"Internal Server Error\",\n \"status\": 500,\n \"detail\": \"An unexpected error occurred. Please try again later.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "dc3057fa-c388-55c3-afd2-b30218b33c06", "name": "Find phone numbers in batch", "request": { "name": "Find phone numbers in batch", "description": { "content": "Submit up to **500 000 items** (email addresses and/or profile URLs) for\nbulk phone lookup. Emails are deduplicated case-insensitively; profile\nURLs are deduplicated as-is.\n\n**Cost:** 10 credits per unique item, reserved upfront. At settlement,\nonly items where phones were actually found are charged \u2014 the rest are\nrefunded.\n\n### Webhook callbacks\n\nIf you include a `webhookUrl`, your server will receive:\n\n1. **A per-result callback** for every item as it is processed. See\n [phoneResult](#tag/Webhooks/operation/webhookPhoneResult) for the payload.\n\n2. **A completion callback** when every item has been processed. See\n [phoneCompletion](#tag/Webhooks/operation/webhookPhoneCompletion) for the payload.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/reverse-lookup/phones/bulk", "host": [ "{{baseUrl}}" ], "path": [ "reverse-lookup", "phones", "bulk" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"emails\": [\n \"sarah.chen@stripe.com\",\n \"james.rodriguez@hubspot.com\"\n ],\n \"linkedins\": [\n \"https://www.example.com/in/priyapatel\"\n ],\n \"webhookUrl\": \"https://api.yourapp.com/webhooks/enrich\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "b2f37434-29ef-5ca9-b6f2-acc10a744fbd", "name": "Bulk job submitted \u2014 credits have been reserved", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"batchId\": \"665c52bf7b8e3f00149f0a10\",\n \"status\": \"queued\",\n \"itemCount\": 3,\n \"message\": \"Bulk phone lookup job created\",\n \"originalCount\": 3,\n \"duplicatesRemoved\": 0\n },\n \"meta\": {\n \"requestId\": \"665c52bf7b8e3f00149f0a0f\",\n \"creditsReserved\": 1500,\n \"creditsPerItem\": 500,\n \"estimatedCredits\": 1500\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "16fcba26-3516-5ee9-b3bd-cb74132b4998", "name": "Something is wrong with the request \u2014 check the `detail` field for specifics", "status": "400", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body/email Invalid email\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "26406232-54a7-5cfa-9186-ac82066d1349", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bfa4f1d2-1ec0-56be-8ca0-aa7ef93630cc", "name": "You don't have enough credits for this request", "status": "402", "code": 402, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/insufficient-credits\",\n \"title\": \"Insufficient Credits\",\n \"status\": 402,\n \"detail\": \"Not enough credits. Required: 10, available: 3\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "88915aad-f621-59ce-a1b6-8be7858cf698", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1de01dc4-d922-55cf-97dd-bb2f710abb78", "name": "Something went wrong on our end \u2014 try again in a moment", "status": "500", "code": 500, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/internal-error\",\n \"title\": \"Internal Server Error\",\n \"status\": 500,\n \"detail\": \"An unexpected error occurred. Please try again later.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "ce27fd96-9a15-5ead-8c7f-24aac91a806b", "name": "Check bulk phone lookup progress", "request": { "name": "Check bulk phone lookup progress", "description": { "content": "Poll this endpoint to track the job. The `progress` field is a percentage\nfrom 0 to 100.\n\n**Cost:** Free.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/reverse-lookup/phones/bulk/{jobId}", "host": [ "{{baseUrl}}" ], "path": [ "reverse-lookup", "phones", "bulk", ":jobId" ], "query": [], "variable": [ { "key": "jobId", "value": "", "description": "The job identifier (24-character hex string) returned when you submitted the job" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "GET", "auth": null }, "response": [ { "id": "807b4c74-d1dd-51c7-8818-0b758eff7272", "name": "Current job status", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"batchId\": \"665c52bf7b8e3f00149f0a10\",\n \"status\": \"processing\",\n \"totalItems\": 3,\n \"processedItems\": 2,\n \"progress\": 66.7\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "88003c43-840c-5adc-ae68-a33defb3d734", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d0d5a873-6c86-5996-b6c9-c227c7293ea6", "name": "The resource you requested doesn't exist or doesn't belong to your organization", "status": "404", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/not-found\",\n \"title\": \"Not Found\",\n \"status\": 404,\n \"detail\": \"No batch found with that ID\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "24fcabaf-5a49-5d41-a7d9-cee53f2118f6", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "3a9a356b-8746-5fb1-b869-021010275c9a", "name": "Get bulk phone lookup results", "request": { "name": "Get bulk phone lookup results", "description": { "content": "Retrieve paginated results. Each item shows the phones found (or an error\nmessage if the lookup failed).\n\n**Credit settlement:** Only items where at least one phone number was found\nare charged. Everything else is refunded.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/reverse-lookup/phones/bulk/{jobId}/results", "host": [ "{{baseUrl}}" ], "path": [ "reverse-lookup", "phones", "bulk", ":jobId", "results" ], "query": [ { "key": "page", "value": "1", "description": "Page number (default: 1)", "disabled": true }, { "key": "limit", "value": "100", "description": "Results per page (default: 100, max: 1 000)", "disabled": true } ], "variable": [ { "key": "jobId", "value": "", "description": "The job identifier (24-character hex string) returned when you submitted the job" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "GET", "auth": null }, "response": [ { "id": "aee8eafc-12fa-5e03-838a-d1ea7a1ab596", "name": "Paginated phone lookup results", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"batchId\": \"665c52bf7b8e3f00149f0a10\",\n \"status\": \"completed\",\n \"totalItems\": 3,\n \"processedItems\": 3,\n \"successful\": 2,\n \"failed\": 1,\n \"results\": [\n {\n \"email\": \"sarah.chen@stripe.com\",\n \"phones\": [\n \"+14158009370\"\n ]\n },\n {\n \"email\": \"james.rodriguez@hubspot.com\",\n \"phones\": [\n \"+16175551234\",\n \"+16175551235\"\n ]\n },\n {\n \"linkedin\": \"https://www.example.com/in/priyapatel\",\n \"phones\": [],\n \"error\": \"No phone numbers found for this profile\"\n }\n ],\n \"page\": 1,\n \"limit\": 100\n },\n \"meta\": {\n \"requestId\": \"665c5aef7b8e3f00149f0a20\",\n \"creditsUsed\": 1000,\n \"creditsRefunded\": 500,\n \"creditsRemaining\": 23500,\n \"totalItems\": 3,\n \"processedItems\": 3\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e697183a-32f7-5e51-b79d-91cf12b6e3bf", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e4c2c2c3-bd94-598e-b884-70a3dda89378", "name": "The resource you requested doesn't exist or doesn't belong to your organization", "status": "404", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/not-found\",\n \"title\": \"Not Found\",\n \"status\": 404,\n \"detail\": \"No batch found with that ID\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "eec48528-4f5f-53d0-a0f6-7c8a14a1d83a", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] } ] }, { "id": "00b75627-d4a7-58c8-ad33-26112ce77e41", "name": "Teams", "description": { "content": "", "type": "text/plain" }, "item": [ { "id": "1fffb9df-93cd-5f56-bf3c-ce6306f8b497", "name": "Invite someone to your team", "request": { "name": "Invite someone to your team", "description": { "content": "Sends an email invitation to join your team. You must be an **admin** or\n**owner** to invite people. The invitee can be assigned the role of `admin`\nor `member`.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/teams/{teamId}/invitations", "host": [ "{{baseUrl}}" ], "path": [ "teams", ":teamId", "invitations" ], "query": [], "variable": [ { "key": "teamId", "value": "", "description": "Your team identifier" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"email\": \"marco.silva@yourcompany.com\",\n \"role\": \"member\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "d8e7d882-7216-5372-8ea0-be0d07a8d762", "name": "Invitation sent", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"id\": \"665e2e7f4a6d8c001abc5001\",\n \"email\": \"marco.silva@yourcompany.com\",\n \"role\": \"member\",\n \"status\": \"pending\",\n \"expiresAt\": \"2025-07-03T15:00:00.000Z\",\n \"createdAt\": \"2025-06-03T15:00:00.000Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "95f431da-5991-549f-8cc7-435a312605e1", "name": "Something is wrong with the request \u2014 check the `detail` field for specifics", "status": "400", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/validation-error\",\n \"title\": \"Validation Error\",\n \"status\": 400,\n \"detail\": \"body/email Invalid email\",\n \"instance\": \"/requests/3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "554021c3-bba7-5d0f-9545-44fb8b6cfd5e", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "71d946f7-21c7-5bec-9e13-51e584dd9d3a", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "408d0bd5-ff70-568a-897a-ca21507503a0", "name": "List pending invitations", "request": { "name": "List pending invitations", "description": { "content": "See all outstanding invitations for your team. You must be an **admin** or\n**owner**.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/teams/{teamId}/invitations", "host": [ "{{baseUrl}}" ], "path": [ "teams", ":teamId", "invitations" ], "query": [], "variable": [ { "key": "teamId", "value": "", "description": "Your team identifier" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "GET", "auth": null }, "response": [ { "id": "cecf2d63-4657-5775-80c7-d0952b8498f5", "name": "List of pending invitations", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": [\n {\n \"id\": \"665e2e7f4a6d8c001abc5001\",\n \"email\": \"marco.silva@yourcompany.com\",\n \"role\": \"member\",\n \"status\": \"pending\",\n \"expiresAt\": \"2025-07-03T15:00:00.000Z\",\n \"createdAt\": \"2025-06-03T15:00:00.000Z\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fbf4d36d-c924-57d9-90d2-8ce54eff29f9", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "17107048-d6b1-5620-872e-672c3b419618", "name": "The resource you requested doesn't exist or doesn't belong to your organization", "status": "404", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/not-found\",\n \"title\": \"Not Found\",\n \"status\": 404,\n \"detail\": \"No batch found with that ID\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "472641eb-07fe-522b-9358-682eed43031f", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "5c17e44f-43a6-5aa5-924a-be9b4d19a37e", "name": "Cancel a pending invitation", "request": { "name": "Cancel a pending invitation", "description": { "content": "Withdraws an invitation before the invitee accepts it. You must be an\n**admin** or **owner**.", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/teams/{teamId}/invitations/{invitationId}", "host": [ "{{baseUrl}}" ], "path": [ "teams", ":teamId", "invitations", ":invitationId" ], "query": [], "variable": [ { "key": "teamId", "value": "", "description": "Your team identifier" }, { "key": "invitationId", "value": "", "description": "The invitation identifier" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "DELETE", "auth": null }, "response": [ { "id": "1d558a53-8684-51f1-a610-6392f277a9ce", "name": "Invitation cancelled", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": {\n \"success\": true\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "08efe445-d10e-5238-bf01-8e4b4827397f", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2cfde508-0345-5e35-a793-ff24da032570", "name": "The resource you requested doesn't exist or doesn't belong to your organization", "status": "404", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/not-found\",\n \"title\": \"Not Found\",\n \"status\": 404,\n \"detail\": \"No batch found with that ID\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5fb74076-eaa7-59e7-956c-0183865c02cb", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] }, { "id": "b1188252-8bf5-5beb-a2c2-401e9a129110", "name": "List team members", "request": { "name": "List team members", "description": { "content": "Returns everyone in your team along with their role (owner, admin, or member).", "type": "text/plain" }, "url": { "raw": "https://dev.enrich.so/api/v3/teams/{teamId}/members", "host": [ "{{baseUrl}}" ], "path": [ "teams", ":teamId", "members" ], "query": [], "variable": [ { "key": "teamId", "value": "", "description": "Your team identifier" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "key": "x-api-key", "value": "{{apiKey}}", "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" } } ], "method": "GET", "auth": null }, "response": [ { "id": "953ecdd5-9f9a-5e94-8d12-b29adb9f8c28", "name": "List of team members", "status": "200", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"data\": [\n {\n \"id\": \"665e2a104a6d8c001abc4001\",\n \"userId\": \"665e2a104a6d8c001abc4101\",\n \"email\": \"sarah.chen@yourcompany.com\",\n \"name\": \"Sarah Chen\",\n \"role\": \"owner\",\n \"createdAt\": \"2025-01-15T09:00:00.000Z\"\n },\n {\n \"id\": \"665e2a104a6d8c001abc4002\",\n \"userId\": \"665e2a104a6d8c001abc4102\",\n \"email\": \"james.rodriguez@yourcompany.com\",\n \"name\": \"James Rodriguez\",\n \"role\": \"admin\",\n \"createdAt\": \"2025-02-20T14:30:00.000Z\"\n },\n {\n \"id\": \"665e2a104a6d8c001abc4003\",\n \"userId\": \"665e2a104a6d8c001abc4103\",\n \"email\": \"priya.patel@yourcompany.com\",\n \"name\": \"Priya Patel\",\n \"role\": \"member\",\n \"createdAt\": \"2025-03-10T11:00:00.000Z\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "54f8ec1e-ffdf-5147-92a7-01c560a6739e", "name": "Your API key is missing or invalid", "status": "401", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/unauthorized\",\n \"title\": \"Unauthorized\",\n \"status\": 401,\n \"detail\": \"The API key provided is invalid or has been revoked\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0cc54c82-a4f9-5641-b2f4-ca849767b881", "name": "The resource you requested doesn't exist or doesn't belong to your organization", "status": "404", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/not-found\",\n \"title\": \"Not Found\",\n \"status\": 404,\n \"detail\": \"No batch found with that ID\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "76fba61c-9a81-5c05-ab70-4d2c5719d73f", "name": "You've sent too many requests \u2014 wait and try again", "status": "429", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"type\": \"https://dev.enrich.so/errors/rate-limit-exceeded\",\n \"title\": \"Too Many Requests\",\n \"status\": 429,\n \"detail\": \"Rate limit exceeded. Please retry after 30 seconds.\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ] } ] } ], "variable": [ { "key": "baseUrl", "value": "https://dev.enrich.so/api/v3" }, { "key": "apiKey", "value": "" } ], "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "x-api-key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }