GetItDoneGetItDone Docs
API ReferenceUsage

Get plan usage

GET
/v1/usage

Reports the current billing period, per-meter consumption against the plan, and the per-credential burst allowance. Reading usage never consumes the API-call quota (the meter cost is zero), so this endpoint stays reachable even when the period allowance is exhausted.

Authorization

bearerAuth
headerAuthorizationBearer <token>

A gid_ API key (Profile → API Keys) or an OAuth 2.1 access token.

Response Body

The organization's current usage snapshot.

application/json
  1. response

The organization's consumption against its plan for the current billing period, plus the burst policy.

plan*string

The organization's current plan tier.

Value in"FREE""PRO""TEAM"
period_start*string

Start of the current billing period, ISO-8601 UTC. Paid plans anchor at their subscription renewal; free plans at the first of the calendar month.

Match^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
Formatdate-time
period_end*string

End of the current billing period, ISO-8601 UTC — when period meters reset.

Match^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
Formatdate-time
meters*array<>

Per-meter consumption for the current period.

burst*

The per-credential burst policy (separate from period quotas; every key/token gets its own window).

Example Request
curl -X GET 'https://app.nowgetitdone.com/v1/usage'
Example Response
{  "plan": "FREE",  "period_start": "2026-07-01T00:00:00.000Z",  "period_end": "2026-08-01T00:00:00.000Z",  "meters": [    {      "meter": "api_calls",      "used": 27,      "limit": 50,      "remaining": 23    }  ],  "burst": {    "per_minute_limit": 10  }}

Append to a task's notes POST

Appends a dated entry to the end of a task's notes without rewriting them. The task_id may be the stable id or the short id. Use this for progress updates,…

List webhook endpoints GET

Cursor-paginated list of the organization's webhook endpoints. PRO plan and above (outbound_webhooks) — a FREE-plan credential gets 403 feature_not_enabled.…