> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encrata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IP Ports

> Map an IP's attack surface open ports & services with banners and CVEs, TLS/JARM fingerprint, and certificate transparency.

## Authentication

Requires an API key in the `Authorization` header.

```bash theme={"dark"}
Authorization: Bearer YOUR_API_KEY
```

## Request

<ParamField body="ip" type="string" required>
  The IP address to scan (IPv4 or IPv6).
</ParamField>

## Response

Returns the standard IP lookup shape with only the attack-surface sections populated: `ports` (open ports, services, software, CVEs), `tls` (JARM + certificate), and `certificates` (crt.sh transparency).

<ResponseExample>
  ```json theme={"dark"}
  {
    "query": "1.1.1.1",
    "ip": "1.1.1.1",
    "credits": 1,
    "ports": {
      "ports": [53, 80, 443],
      "software": ["nginx"],
      "vulns": [],
      "services": [ { "port": 443, "service": "https", "banner": "cloudflare" } ]
    },
    "tls": { "probed": true, "has_tls": true, "jarm": "29d29d...", "tls_version": "TLS 1.3" }
  }
  ```
</ResponseExample>

## Credits

1 credit per lookup.