agency-time

GET `/v1/agency/time/unbilled`

What is outstanding, per client and currency.

Authentication

Send an API key as a bearer token. The endpoint checks agency.time.view, billing.entitlement.manage, quotes.manage; a key without it is refused with 403, not 404.

Where your organisation id goes

This endpoint takes org_id as a query parameter. Leave it out and the call covers your whole tenancy subtree; send it to narrow the call to one organisation.

Your organisation id is on the API keys screen in your dashboard, beside the key itself. It is the same id in every call you make.

Try it

Replace anything in angle brackets with your own values, and the key placeholder with a key from your dashboard.

curl -X GET https://api.zinndigital.com/v1/agency/time/unbilled \
  -H "Authorization: Bearer zdk_live_…"

Signed in? The API console in your dashboard fills in your real organisation id and your own key, and runs the request against the live API so you can see the actual response. Open this endpoint in the API console

Details

The same figure a threshold trigger fires on — one function, deliberately, because two implementations of "how much is outstanding" is how a client is shown £900 and invoiced £1,100. unpriced_minutes is reported separately from the money: hours logged against work with no rate card are not worth zero, they are unpriced, and an agency that cannot see them will not fix them. can_bill says whether the invoicing suite is reachable at all, so the console never offers a Bill-now button that can only refuse.

Parameters

Name	Type	Required	What it is
`org_id (query)`	`string`	No	—
`client_id (query)`	`string`	No	—
`until (query)`	`string`	No	Only count work up to and including this date.

Response

Name	Type	Required	What it is
`data`	`UnbilledBucket[]`	Yes	—
`can_bill`	`boolean`	Yes	Whether the agency invoicing suite is reachable at all. Told to the console rather than discovered by pressing the button, so it never offers a Bill-now that can only refuse.
`billing_target`	`string<agency_invoicing, platform_checkout>`	No	Where Bill now sends the work. `platform_checkout` only for Zinn Digital®'s own organisation, whose client work is billed on Zinn®'s checkout (docs/670 §3).
`can_start_from_quote`	`boolean`	No	Whether this caller may list quote requests and start projects from them here — the issuer organisation AND the same `quotes.manage` staff permission the admin queue requires.
`can_manage_checkout_bills`	`boolean`	No	Whether this caller may send and void checkout bills here — the issuer organisation AND the same `billing.entitlement.manage` staff permission the admin console requires.

Errors this endpoint can return

401 · 403 · 422