ovahub
Skip to documentation
DocumentationAPI referenceList billing history
GETBearer token

List billing history

/api/v1/history

Read server and private-network purchases and renewals in the fixed team, filtered by product and time before pagination. Twenty records per page; an uncertain outcome stays unknown.

Request example

cURL
curl "https://tovahub.com/api/v1/history?product=all&page=1" \
  -H "Authorization: Bearer $TOVAHUB_TOKEN"

Examples only. No requests are sent from this page.

Illustrative response
JSON
{
  "userId": "507f1f77bcf86cd799439012",
  "page": 1,
  "limit": 20,
  "total": 1,
  "items": [
    {
      "_id": "network:507f1f77bcf86cd799439013",
      "product": "network",
      "kind": "purchase",
      "amount": "990",
      "coin": "USD",
      "hostname": "team-switch",
      "status": "completed",
      "createdAt": "2026-11-12T00:00:00.000Z"
    }
  ]
}

Parameters

productQuery · Optional

string

all, server or network. Defaults to all.

pageQuery · Optional

integer

Page number, 1–10000. Twenty records per page.

fromQuery · Optional

string

Inclusive ISO 8601 UTC start. Supply both from and to, or neither.

toQuery · Optional

string

Exclusive ISO 8601 UTC end after from. Convert inclusive local calendar dates to midnight boundaries in the client time zone.

Response

HTTP status 200

Purchase and renewal records for servers and private networks; filtered before pagination.

userIdstring

Authenticated reader ID. The team is fixed by authentication.

pageinteger

Requested page, starting at 1.

limit20

Fixed page size.

totalinteger

Total matching records in this fixed team.

itemsarray

Safe rows with _id, product (server/network), kind (purchase/renew), integer-string amount, coin (USD/xTOVA), hostname, status and createdAt. No provider payload or credentials.

Related

Requests & errorsAuthentication