---
title: "Port details (API object `passport`)"
method: GET
path: "/v1/ports/{id}/passport"
tags: ["ports"]
---

# Port details (API object \`passport\`)

`GET /v1/ports/{id}/passport`

## Request

- Base URL: `https://api.portproof.org`
- URL: `https://api.portproof.org/v1/ports/{id}/passport`
- Auth: HTTP bearer

`?format=json` (default) returns the port details document; `?format=card` returns a self-contained `text/html` share card.

## Path parameters

- `id` string, required

## Query parameters

- `format` 'json' | 'card'

## Response `200`

Default Response

- object
  - `port_id` string, required
  - `generated_at` string, date-time, required
  - `site_code` string, required
  - `country` string, required
  - `operator` 'owned' | 'partner', required
  - `evidence` 'signed' | 'observed'
  - `network` 'own' | 'partner'
  - `carrier` object, required
    - `name` string, required
    - `mcc_mnc` string, required
    - `asn` string, nullable, required
    - `gateway_region` string, nullable, required
    - `ip_stack` 'v4' | 'v6_464xlat' | 'dual', required
  - `sim_contract_class` 'prepaid' | 'business' | 'm2m', required
  - `egress` object, required
    - `v4` string, nullable, required
    - `v6_prefix` string, nullable, required
    - `v4_is_nat64` boolean, required
    - `ip_since` string, date-time, required
  - `geo` object, required
    - `country` string, nullable, required
    - `region` string, nullable, required
    - `city` string, nullable, required
    - `sources` object[], required
      - `provider` string, required
      - `country` string, nullable, required
      - `region` string, nullable, required
      - `city` string, nullable, required
  - `reputation` object, required
    - `flagged` boolean, required
    - `hosting` boolean, required
    - `providers` string[], required
    - `scored_at` string, date-time, nullable, required
  - `rotation` object, required
    - `interval_s` integer, required
    - `sticky_until` string, date-time, nullable, required
    - `last_rotation_at` string, date-time, nullable, required
    - `last_30d` object, required
      - `count` integer, required
      - `first_attempt_success_pct` number, nullable, required
      - `p50_ms` number, nullable, required
  - `uptime` object, required
    - `d30_pct` number, nullable, required
    - `d90_pct` number, nullable, required
    - `probes_30d` integer, required
  - `throughput` object, required
    - `last_sample_mbps` number, nullable, required
    - `p50_7d_mbps` number, nullable, required
  - `usage` object, required
    - `bytes_today` integer, required
    - `cap_bytes` integer, required
  - `sessions` object, required
    - `concurrent_now` integer, required
    - `peak_24h` integer, required
  - `ip_shared_with_own_ports` integer, required
  - `exclusivity` 'modem+sim+credentials', required
  - `receipts_url` string, uri, required

## Other responses

- `404`: Default Response

---

[API](https://skmtc.dev/portproof/apis/portproof-api.md) · [All operations](https://skmtc.dev/portproof/apis/portproof-api/llms.txt) · [OpenAPI document](https://skmtc.dev/portproof/apis/portproof-api/revisions/4143916c0fac?raw)