---
title: "The video-time balance"
method: GET
path: "/wallet"
tags: ["wallet"]
---

# The video-time balance

`GET /wallet`

## Request

- Base URL: `https://api.gogoscreen.com/api/v1`
- URL: `https://api.gogoscreen.com/api/v1/wallet`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

How many seconds of finished video this account can still make, by bucket: a plan's seconds for the current billing month (which end with the period), top up seconds (which never expire), free seconds, and what is currently held by work in flight. `availableSeconds` is the one number a reservation is judged against.

## Response `200`

The video-time balance

- object
  - `wallet` object, required
    - `availableSeconds` number, required: What a new render or export may be reserved against, right now.
    - `freeSeconds` number, required
    - `paygSeconds` number, required
    - `planActive` boolean, required
    - `planExpiresAt` string, date-time, nullable, required
    - `planId` string, nullable, required
    - `planSeconds` number, required
    - `reservedSeconds` number, required

## Other responses

- `400`: `validation_failed` — That request is not valid.
- `401`: `unauthorized` — Authentication is required.
- `403`: `forbidden_scope` — This credential does not carry the scope this operation needs.
- `404`: `not_found` — No such resource.
- `429`: `rate_limited` — Too many requests. Try again shortly.
- `500`: `internal_error` — Something went wrong. Try again.

---

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