Skip to content

Private Scanning

November 17, 2026

Netlas Private Scanner uses the same scanning technology as Netlas internet-wide scans, with an expanded port scope and on-demand execution. Each scan runs on a scanning agent, which sends requests to the targets and collects service responses. The collected data is then processed into a scan report and a private search index.

The Private Scanner guide describes how to create scans and access their results. This article explains how scans are scheduled, executed, and charged.

Scanning Agents

A scanning agent is the scan source selected when creating a private scan. Its location determines where scan traffic originates.

Shared and Dedicated Agents

  • Shared agents serve multiple users. Other users' scans can affect waiting times.
  • Dedicated agents serve one customer exclusively and are available only with Enterprise.

Enterprise can include several dedicated agents in requested locations, assigned to one or more accounts belonging to the same customer.

Internal Queues

Each agent has one or more queues. Each queue corresponds to one public source IP address and runs one scan at a time. An agent with four IP addresses therefore has four queues and can run four scans in parallel.

GET /api/scanner/agents/ lists the agents available to your account. The ip_address array contains their source addresses, one per queue. Allowlist all addresses of the selected agent if your targets restrict incoming scan traffic.

The same response includes queue_eta, the estimated queue waiting time in seconds for each agent.

Parallel Scans

Scans from the same user are sent to agents one at a time. The next scan is sent only after the previous scan reaches scanning; the scheduler checks this condition once a minute. The scans can then run in parallel.

A shared agent runs at most two scans from the same user simultaneously, subject to queue availability. Additional scans from that user wait, even if other queues on the agent are free. This keeps capacity available for other users.

There is no global per-user concurrency limit: the limit applies independently to each shared agent.

Example Simultaneous scans
One shared agent with four queues Two from one user and up to two from another.
Ten shared agents with two queues each Up to twenty from one user, provided the queues are available.

Scanning Modes and Port Coverage

Private Scanner supports two modes with different TCP port coverage:

  • Top Ports scans a predefined list of commonly used TCP ports.
  • All Ports scans all TCP ports from 1 to 65,535.

Both modes also scan the same seven UDP ports: 53, 123, 137, 161, 162, 3671, and 47808.

List of TCP ports scanned by Private Scanner in Top Ports mode

11, 13, 15, 17, 19, 20, 21, 22, 23, 24, 25, 26, 37, 38, 43, 49, 51, 53, 69, 70, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 95, 96, 97, 98, 99, 100, 102, 104, 106, 110, 111, 113, 119, 121, 122, 123, 129, 131, 135, 137, 139, 143, 154, 161, 175, 179, 180, 189, 190, 192, 195, 199, 211, 221, 222, 225, 263, 264, 285, 311, 314, 340, 389, 400, 427, 440, 441, 443, 444, 445, 447, 448, 449, 450, 465, 480, 491, 500, 502, 503, 513, 515, 520, 522, 523, 541, 548, 554, 555, 556, 587, 593, 623, 626, 631, 636, 646, 666, 675, 685, 771, 772, 777, 785, 789, 800, 801, 805, 806, 808, 811, 830, 843, 853, 873, 880, 886, 887, 888, 902, 943, 953, 990, 992, 993, 994, 995, 999, 1000, 1002, 1010, 1012, 1022, 1023, 1024, 1025, 1026, 1027, 1028, 1029, 1050, 1063, 1080, 1099, 1110, 1111, 1119, 1153, 1167, 1177, 1180, 1194, 1200, 1207, 1234, 1250, 1290, 1311, 1337, 1344, 1355, 1366, 1388, 1400, 1414, 1433, 1434, 1443, 1447, 1471, 1494, 1500, 1515, 1521, 1554, 1588, 1599, 1604, 1605, 1650, 1660, 1701, 1723, 1741, 1777, 1800, 1801, 1820, 1830, 1833, 1883, 1900, 1901, 1911, 1925, 1926, 1935, 1947, 1950, 1951, 1958, 1962, 1965, 1966, 1970, 1980, 1981, 1984, 1990, 1991, 2000, 2001, 2002, 2003, 2006, 2008, 2010, 2012, 2018, 2020, 2021, 2022, 2030, 2031, 2048, 2049, 2050, 2051, 2052, 2053, 2054, 2055, 2056, 2057, 2058, 2059, 2060, 2061, 2062, 2063, 2064, 2065, 2066, 2067, 2068, 2069, 2070, 2077, 2079, 2080, 2081, 2082, 2083, 2086, 2087, 2095, 2096, 2100, 2103, 2107, 2111, 2121, 2122, 2123, 2126, 2150, 2152, 2154, 2181, 2200, 2201, 2202, 2211, 2220, 2221, 2222, 2223, 2225, 2232, 2233, 2250, 2259, 2266, 2271, 2320, 2323, 2332, 2345, 2351, 2352, 2375, 2376, 2379, 2382, 2404, 2423, 2443, 2455, 2480, 2506, 2525, 2548, 2549, 2550, 2551, 2552, 2553, 2554, 2555, 2556, 2557, 2558, 2559, 2560, 2561, 2562, 2563, 2566, 2567, 2568, 2569, 2570, 2572, 2598, 2599, 2601, 2602, 2626, 2628, 2650, 2701, 2709, 2761, 2762, 2806, 2850, 2985, 3000, 3001, 3002, 3005, 3048, 3049, 3050, 3051, 3052, 3053, 3054, 3055, 3056, 3057, 3058, 3059, 3060, 3061, 3062, 3063, 3066, 3067, 3068, 3069, 3070, 3071, 3072, 3073, 3074, 3075, 3076, 3077, 3078, 3079, 3080, 3081, 3082, 3083, 3084, 3085, 3086, 3087, 3088, 3089, 3090, 3091, 3092, 3093, 3094, 3095, 3096, 3097, 3098, 3099, 3100, 3101, 3102, 3103, 3104, 3105, 3106, 3107, 3108, 3109, 3110, 3111, 3112, 3113, 3114, 3115, 3116, 3117, 3118, 3119, 3120, 3121, 3128, 3129, 3160, 3165, 3200, 3211, 3221, 3260, 3268, 3269, 3270, 3283, 3299, 3301, 3306, 3307, 3310, 3311, 3333, 3337, 3341, 3352, 3386, 3388, 3389, 3391, 3400, 3401, 3402, 3403, 3404, 3405, 3406, 3407, 3408, 3409, 3410, 3412, 3443, 3460, 3479, 3498, 3503, 3510, 3521, 3522, 3523, 3524, 3531, 3541, 3542, 3548, 3549, 3550, 3551, 3552, 3554, 3555, 3556, 3557, 3558, 3559, 3560, 3561, 3562, 3563, 3566, 3567, 3568, 3569, 3570, 3580, 3590, 3671, 3689, 3690, 3702, 3749, 3780, 3784, 3790, 3791, 3792, 3793, 3794, 3838, 3910, 3922, 3950, 3951, 3952, 3953, 3954, 4000, 4001, 4002, 4010, 4022, 4040, 4042, 4043, 4063, 4064, 4070, 4085, 4100, 4117, 4118, 4150, 4157, 4165, 4190, 4200, 4242, 4243, 4244, 4282, 4321, 4343, 4344, 4369, 4401, 4430, 4433, 4434, 4443, 4444, 4445, 4447, 4449, 4461, 4477, 4482, 4500, 4502, 4505, 4506, 4523, 4524, 4545, 4550, 4567, 4572, 4643, 4646, 4664, 4700, 4730, 4734, 4747, 4782, 4786, 4800, 4808, 4840, 4848, 4899, 4911, 4949, 4999, 5000, 5001, 5002, 5003, 5004, 5005, 5006, 5007, 5008, 5009, 5010, 5025, 5050, 5060, 5061, 5070, 5080, 5083, 5090, 5094, 5100, 5105, 5120, 5122, 5130, 5135, 5150, 5160, 5172, 5190, 5201, 5209, 5222, 5225, 5226, 5227, 5229, 5231, 5234, 5235, 5236, 5237, 5240, 5242, 5244, 5245, 5246, 5248, 5249, 5251, 5252, 5255, 5256, 5269, 5271, 5272, 5277, 5280, 5321, 5353, 5357, 5400, 5431, 5432, 5433, 5435, 5440, 5443, 5446, 5454, 5494, 5500, 5503, 5542, 5544, 5552, 5555, 5560, 5567, 5568, 5569, 5577, 5590, 5591, 5592, 5593, 5594, 5595, 5596, 5597, 5598, 5599, 5600, 5601, 5602, 5603, 5604, 5605, 5606, 5607, 5608, 5609, 5620, 5632, 5640, 5671, 5672, 5673, 5680, 5683, 5684, 5701, 5800, 5801, 5804, 5822, 5853, 5858, 5900, 5901, 5902, 5903, 5904, 5905, 5906, 5907, 5908, 5909, 5910, 5911, 5914, 5915, 5916, 5917, 5918, 5920, 5938, 5984, 5985, 5986, 5989, 5991, 5995, 5997, 5998, 6000, 6001, 6002, 6003, 6004, 6005, 6006, 6007, 6008, 6009, 6010, 6020, 6036, 6050, 6060, 6061, 6066, 6080, 6100, 6102, 6161, 6262, 6264, 6308, 6352, 6363, 6379, 6380, 6440, 6443, 6464, 6482, 6501, 6503, 6510, 6511, 6512, 6543, 6550, 6560, 6561, 6565, 6580, 6581, 6588, 6590, 6600, 6601, 6602, 6603, 6605, 6606, 6622, 6633, 6650, 6653, 6662, 6664, 6666, 6667, 6668, 6686, 6688, 6697, 6699, 6748, 6789, 6881, 6887, 6955, 6969, 6998, 7000, 7001, 7002, 7003, 7004, 7005, 7007, 7010, 7013, 7014, 7020, 7022, 7025, 7050, 7070, 7071, 7078, 7079, 7080, 7081, 7082, 7083, 7084, 7085, 7086, 7087, 7088, 7090, 7100, 7102, 7105, 7170, 7171, 7218, 7272, 7401, 7403, 7415, 7433, 7434, 7443, 7444, 7445, 7465, 7474, 7493, 7500, 7510, 7535, 7537, 7547, 7548, 7634, 7654, 7657, 7676, 7700, 7707, 7771, 7773, 7775, 7776, 7777, 7778, 7779, 7788, 7887, 7900, 7979, 7989, 7998, 7999, 8000, 8001, 8002, 8003, 8004, 8005, 8006, 8007, 8008, 8009, 8010, 8011, 8012, 8013, 8014, 8015, 8016, 8017, 8018, 8019, 8020, 8021, 8022, 8023, 8024, 8025, 8026, 8027, 8028, 8029, 8030, 8031, 8032, 8033, 8034, 8035, 8036, 8037, 8038, 8039, 8040, 8041, 8042, 8043, 8044, 8045, 8046, 8047, 8048, 8049, 8050, 8051, 8052, 8053, 8054, 8055, 8056, 8057, 8058, 8060, 8061, 8064, 8066, 8069, 8071, 8072, 8080, 8081, 8082, 8083, 8084, 8085, 8086, 8087, 8088, 8089, 8090, 8091, 8092, 8093, 8094, 8095, 8096, 8097, 8098, 8099, 8100, 8101, 8102, 8103, 8104, 8105, 8106, 8107, 8108, 8109, 8110, 8111, 8112, 8113, 8118, 8123, 8126, 8139, 8140, 8143, 8159, 8180, 8181, 8182, 8184, 8188, 8190, 8200, 8203, 8222, 8236, 8237, 8238, 8239, 8241, 8243, 8248, 8249, 8251, 8252, 8282, 8291, 8300, 8333, 8334, 8343, 8383, 8401, 8402, 8403, 8404, 8405, 8406, 8407, 8408, 8409, 8410, 8411, 8412, 8413, 8414, 8415, 8416, 8417, 8418, 8419, 8420, 8421, 8422, 8423, 8424, 8425, 8426, 8427, 8428, 8429, 8430, 8431, 8432, 8433, 8440, 8441, 8442, 8443, 8444, 8445, 8446, 8447, 8448, 8449, 8451, 8453, 8454, 8455, 8500, 8502, 8503, 8506, 8513, 8520, 8521, 8525, 8528, 8529, 8536, 8543, 8544, 8545, 8549, 8553, 8554, 8556, 8562, 8566, 8570, 8573, 8575, 8576, 8578, 8581, 8585, 8586, 8590, 8591, 8593, 8594, 8599, 8602, 8606, 8621, 8622, 8623, 8637, 8649, 8663, 8666, 8686, 8688, 8700, 8702, 8703, 8704, 8705, 8708, 8709, 8728, 8731, 8732, 8733, 8764, 8765, 8766, 8767, 8779, 8782, 8784, 8787, 8788, 8789, 8790, 8791, 8800, 8801, 8802, 8803, 8804, 8805, 8806, 8807, 8808, 8809, 8810, 8811, 8812, 8813, 8814, 8815, 8816, 8817, 8818, 8819, 8820, 8821, 8822, 8823, 8824, 8825, 8826, 8827, 8828, 8829, 8830, 8831, 8832, 8833, 8834, 8835, 8836, 8837, 8838, 8839, 8840, 8841, 8842, 8843, 8844, 8845, 8846, 8847, 8848, 8849, 8850, 8851, 8852, 8853, 8854, 8855, 8856, 8857, 8858, 8859, 8860, 8861, 8862, 8863, 8864, 8865, 8866, 8867, 8868, 8869, 8870, 8871, 8872, 8873, 8874, 8875, 8876, 8877, 8878, 8879, 8880, 8881, 8885, 8886, 8887, 8888, 8889, 8890, 8891, 8899, 8935, 8969, 8988, 8989, 8990, 8991, 8993, 8999, 9000, 9001, 9002, 9003, 9004, 9005, 9006, 9007, 9008, 9009, 9010, 9011, 9012, 9013, 9014, 9015, 9016, 9017, 9018, 9019, 9020, 9021, 9022, 9023, 9024, 9025, 9026, 9027, 9028, 9029, 9030, 9031, 9032, 9033, 9034, 9035, 9036, 9037, 9038, 9039, 9040, 9041, 9042, 9043, 9044, 9045, 9046, 9047, 9048, 9049, 9050, 9051, 9052, 9053, 9054, 9055, 9056, 9057, 9061, 9062, 9063, 9064, 9065, 9066, 9068, 9069, 9070, 9072, 9073, 9074, 9075, 9076, 9077, 9080, 9082, 9084, 9087, 9088, 9089, 9090, 9091, 9092, 9093, 9094, 9095, 9096, 9097, 9098, 9099, 9100, 9101, 9102, 9103, 9104, 9105, 9106, 9107, 9108, 9109, 9110, 9111, 9112, 9113, 9114, 9115, 9116, 9117, 9118, 9119, 9120, 9121, 9122, 9123, 9124, 9125, 9128, 9134, 9136, 9140, 9141, 9142, 9143, 9144, 9145, 9146, 9147, 9148, 9149, 9150, 9151, 9152, 9153, 9157, 9158, 9159, 9160, 9161, 9162, 9163, 9164, 9165, 9166, 9167, 9168, 9169, 9170, 9172, 9174, 9175, 9176, 9177, 9178, 9179, 9180, 9181, 9182, 9183, 9184, 9185, 9186, 9187, 9188, 9189, 9190, 9191, 9192, 9193, 9195, 9196, 9197, 9198, 9199, 9200, 9201, 9202, 9203, 9204, 9205, 9206, 9207, 9208, 9209, 9210, 9211, 9212, 9213, 9214, 9215, 9216, 9217, 9218, 9219, 9220, 9221, 9222, 9243, 9251, 9289, 9295, 9299, 9300, 9301, 9302, 9303, 9304, 9305, 9306, 9307, 9308, 9309, 9310, 9311, 9333, 9350, 9387, 9389, 9398, 9410, 9418, 9433, 9441, 9443, 9444, 9445, 9454, 9455, 9456, 9500, 9501, 9510, 9527, 9530, 9532, 9550, 9595, 9600, 9606, 9633, 9663, 9674, 9682, 9690, 9704, 9710, 9711, 9734, 9743, 9754, 9761, 9765, 9773, 9779, 9800, 9803, 9804, 9861, 9869, 9876, 9898, 9899, 9901, 9943, 9944, 9950, 9955, 9966, 9981, 9988, 9990, 9991, 9992, 9993, 9994, 9997, 9998, 9999, 10000, 10001, 10002, 10003, 10004, 10005, 10006, 10007, 10008, 10009, 10013, 10020, 10022, 10050, 10051, 10065, 10075, 10080, 10081, 10100, 10134, 10225, 10243, 10250, 10324, 10380, 10443, 10533, 10554, 10892, 10909, 10911, 10934, 10935, 10936, 11000, 11002, 11007, 11101, 11110, 11112, 11180, 11210, 11211, 11288, 11300, 11371, 11401, 11434, 11601, 11602, 11680, 11681, 11701, 12000, 12111, 12323, 12324, 12325, 12326, 12345, 12443, 13579, 14101, 14130, 14147, 14265, 14344, 14401, 14402, 14403, 14404, 14406, 14407, 14873, 14875, 14880, 14894, 14895, 14896, 14897, 14900, 14901, 14903, 14905, 14909, 15000, 15001, 15018, 15038, 15040, 15042, 15044, 15123, 15151, 15443, 15588, 15831, 16010, 16030, 16316, 16464, 16800, 16831, 16992, 16993, 17000, 17443, 18080, 18081, 18245, 18264, 18443, 19000, 19015, 19071, 19233, 20000, 20001, 20010, 20018, 20020, 20030, 20040, 20050, 20060, 20070, 20080, 20087, 20090, 20100, 20106, 20107, 20121, 20200, 20201, 20208, 20256, 20500, 20512, 20547, 20600, 20880, 21001, 21002, 21025, 21200, 21242, 21300, 21305, 21379, 22000, 22022, 22103, 22107, 22206, 22222, 22556, 22705, 23023, 23424, 24442, 24808, 25000, 25001, 25002, 25006, 25007, 25105, 25565, 27015, 27016, 27017, 27036, 28015, 28017, 29840, 29842, 29984, 30000, 30001, 30002, 30003, 30005, 30006, 30050, 30104, 30106, 30110, 30111, 30112, 30113, 30120, 30121, 30122, 30123, 30443, 30718, 31337, 31444, 32080, 32101, 32102, 32303, 32400, 32764, 33060, 33338, 35000, 37215, 37777, 38520, 40000, 40056, 40443, 40894, 41337, 41794, 41800, 42901, 44158, 44303, 44304, 44305, 44306, 44310, 44333, 44336, 44345, 44350, 44444, 44818, 45000, 45001, 47001, 47808, 47990, 48899, 49152, 49153, 49501, 49502, 49592, 49682, 49684, 49686, 49688, 49692, 49767, 50000, 50001, 50011, 50012, 50050, 50070, 50100, 50101, 50113, 50443, 50805, 50995, 50996, 50997, 50999, 51000, 51001, 51002, 51003, 51005, 51007, 51106, 51235, 52230, 52311, 52869, 52881, 52931, 52951, 53413, 54138, 54984, 55000, 55442, 55443, 55553, 55554, 55555, 58000, 58603, 60001, 60010, 60030, 60129, 60443, 61234, 61613, 61616, 61617, 62078, 62237, 62865, 63260, 64295, 64738.

Scan Lifecycle

A successful scan passes through five states:

State What happens
pending The scan waits for its turn to be sent to an agent under the Parallel Scans rules and for available capacity. Its priority can still be changed.
scheduled The scan has been queued for execution but has not started scanning. Its priority can no longer be changed.
scanning The agent prepares the targets, discovers exposed TCP and UDP ports, and collects service responses. This is the stage that sends traffic to the targets and occupies a queue.
finalizing Netlas retrieves, enriches, and indexes the collected data. No traffic is sent to the targets. Another scan can use the queue while these results are processed.
done Processing is complete and the scan results are ready.

Scanning speed is the same across agents and cannot be adjusted by the user. Duration depends on the target count, responsive services, and collected data, and does not scale directly with the number of targets.

The Get Scan API returns the current state and a scan_progress history with descriptions and timestamps. Several progress entries can belong to the same state, such as port discovery and response collection within scanning.

Use state: done as the completion signal. The scan_ended_at timestamp marks the end of scanning, before finalization finishes.

A scan that cannot complete successfully ends with failed. Its progress history provides the failure description.

Scan Cancellation and Deleting

Deleting a running scan initiates cancellation. The stop request must propagate through several infrastructure components, so traffic to the targets can continue for up to three minutes after deletion. An immediate halt is not available.

Deleting a scan also deletes its associated private index. Results must be exported before deletion if they need to be retained elsewhere.

Scan Coin Accounting

Scan Coins are reserved when a scan is created. The reservation corresponds to the number of targets in the scan scope. The final status determines whether coins are deducted or returned.

Scan outcome Scan Coin behavior
Deleted while queued Reserved coins are returned.
Deleted while running Reserved coins are returned.
Failed with “No reachable ports found” Reserved coins are returned.
Completed with status done Coins are deducted for all targets in the scan scope.

If only some targets have open ports, the charge still covers all targets in the scope.

Completed scans with zero records

A scan can discover exposed ports but produce zero records when services return no data. If its final status is done, Scan Coins are deducted. This differs from a scan that ends as failed with “No reachable ports found”, which returns the reserved coins.

Capacity and API Limits

The subscription plan determines the monthly target allowance, maximum targets per scan, and maximum number of stored scans. Completed scans can be deleted after their results are imported to another system, freeing space within the stored-scan limit.

Scanner endpoints have an API rate limit of 60 requests per minute. Scan submission, progress polling, result retrieval, and deletion must operate within this limit. Endpoint details and request formats are described in the API Reference.