---
title: "What the port has cost and what it will cost"
method: GET
path: "/v1/ports/{id}/billing"
tags: ["ports"]
---

# What the port has cost and what it will cost

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

## Request

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

The order that bought the port (with its invoice once paid), every renewal and refund of its term, the total paid so far, the next automatic renewal (when it runs, the price, whether the wallet covers it) and what happens when the term ends.

## Path parameters

- `id` string, required

## Response `200`

Default Response

- object
  - `port_id` string, required
  - `currency` 'EUR' | 'USD', required
  - `term` 'monthly' | 'weekly' | 'daily', nullable, required
  - `term_started_at` string, date-time, nullable, required
  - `term_ends_at` string, date-time, nullable, required
  - `paid_cents` integer, required
  - `order` object, nullable, required
    - `id` string, required
    - `number` string, required
    - `status` 'draft' | 'awaiting_payment' | 'awaiting_kyb' | 'paid' | 'provisioning' | 'fulfilled' | 'partially_fulfilled' | 'failed_refunded' | 'cancelled' | 'refunded', required
    - `paid_at` string, date-time, nullable, required
    - `invoice_url` string, nullable, required
  - `entries` object[], required
    - `id` string, required
    - `kind` 'purchase' | 'renewal' | 'refund', required
    - `state` 'paid' | 'awaiting_payment' | 'confirming' | 'failed' | 'refunded' | 'cancelled', required
    - `amount_cents` integer, required
    - `currency` 'EUR' | 'USD', required
    - `paid_from` 'wallet' | 'crypto' | 'invoice' | 'other', nullable, required
    - `at` string, date-time, required
    - `order` object, nullable, required
      - `id` string, required
      - `number` string, required
      - `status` 'draft' | 'awaiting_payment' | 'awaiting_kyb' | 'paid' | 'provisioning' | 'fulfilled' | 'partially_fulfilled' | 'failed_refunded' | 'cancelled' | 'refunded', required
      - `paid_at` string, date-time, nullable, required
      - `invoice_url` string, nullable, required
  - `next_renewal` object, nullable, required
    - `price_cents` integer, required
    - `currency` 'EUR' | 'USD', required
    - `from` string, date-time, required
    - `until` string, date-time, required
    - `paid_from` 'wallet' | 'crypto' | 'invoice' | 'other', required
    - `wallet_balance_cents` integer, nullable, required
    - `covered` boolean, nullable, required
  - `at_expiry` 'renews' | 'ends' | 'ended', required
  - `grace_hours` integer, 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)