NomonoPlatform docs

Reference

Usage

Usage counts your organization's jobs and billed minutes for a range of UTC days, in total and per day. Each job counts on the UTC day it was created, and it still counts after its session is deleted.

A job is billed for its minutes once processing has started, and failed and cancelled jobs aren't billed. Its minutes count toward enhancement and toward every other product the job used.

The usage object

  • fromdate

    The first day of the period.

  • todate

    The day after the period's last day.

  • jobsobject

    The jobs created in the period, by status.

  • minutesobject

    Billed minutes of the jobs created in the period, per product.

  • daysarray of objects

    One entry per day of the period, in order, including days with no jobs and days still to come.

GET/v1/usage

Retrieve usage

Returns your organization's usage for a range of UTC days. to must be after from and no more than 366 days later, or the request returns 400 validation_error.

Needs the outputs:read scope.

Query parameters

  • fromdate

    The first day of the period, as YYYY-MM-DD, which defaults to the first day of the current UTC month.

  • todate

    The day after the period's last day, as YYYY-MM-DD, which defaults to the first day of the next UTC month.

Returns

The usage object.

curl "https://platform-api.nomono.co/v1/usage?from=2026-10-01&to=2026-10-04" \  -H "Authorization: Bearer $NOMONO_API_KEY"
200 OK
{  "from": "2026-10-01",  "to": "2026-10-04",  "jobs": {    "done": 3,    "failed": 1,    "cancelled": 1,    "in_progress": 1  },  "minutes": {    "enhancement": 103.71,    "separation": 30.57,    "analysis": 30.57,    "spatialization": 42.57  },  "days": [    {      "date": "2026-10-01",      "jobs": {        "done": 2,        "failed": 0,        "cancelled": 0,        "in_progress": 0      },      "minutes": {        "enhancement": 61.14,        "separation": 30.57,        "analysis": 30.57,        "spatialization": 0      }    },    {      "date": "2026-10-02",      "jobs": {        "done": 1,        "failed": 1,        "cancelled": 1,        "in_progress": 0      },      "minutes": {        "enhancement": 30.57,        "separation": 0,        "analysis": 0,        "spatialization": 30.57      }    },    {      "date": "2026-10-03",      "jobs": {        "done": 0,        "failed": 0,        "cancelled": 0,        "in_progress": 1      },      "minutes": {        "enhancement": 12,        "separation": 0,        "analysis": 0,        "spatialization": 12      }    }  ]}