---
title: "Port scan"
method: GET
path: "/scan/port"
tags: ["Scan"]
---

# Port scan

`GET /scan/port`

Port scanner API.

## Query parameters

- `technique` string
- `ip` string, required
- `port` string, required
- `timeout` string

## Response `200`

Success. This not mean that the port is open! The possible results are: `open`, `closed` or `filtered`

- ResultStr
  - `result` string

## Other responses

- `400` — Invalid or missing query parameter.
- `403` — The address is blacklisted. Not scanning!
- `500` — Error.

## Changes

- **2022-05-11** `6f9dfc068163` — 2 breaking, 2 warning, 3 info
  - added the new required `query` request parameter `port`
  - the response's body type/format changed from `array`/`` to `object`/`` for status `200`
  - deleted the `query` request parameter `ports`
  - removed the optional property `errors` from the response with the `500` status
  - …3 more
- **2022-05-05** `784d1c9e20bc` — 1 breaking, 1 warning
  - the response's body type/format changed from `object`/`` to `array`/`` for status `200`
  - removed the optional property `result` from the response with the `200` status
- **2022-04-29** `320f28510c71` — 2 breaking, 3 warning, 1 info
  - added the new required `query` request parameter `ports`
  - the `result` response's property type/format changed from `string`/`` to `array`/`` for status `200`
  - deleted the `query` request parameter `port`
  - deleted the `query` request parameter `timeout`
  - …2 more

[Change history](https://skmtc.dev/elmasy-com/apis/elmasy-api/changes/scan/port/get.md)

---

[API](https://skmtc.dev/elmasy-com/apis/elmasy-api.md) · [All operations](https://skmtc.dev/elmasy-com/apis/elmasy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/elmasy-com/elmasy-api/revisions/7e77337b2cee/schema)