List printers
Every printer of your organization (or of the key’s customer), with its
status, in the order of customer, location and creation. A list across the
whole organization is slow and costs more than the others: add customer
or location when you can (the lists under /customers/{customer}/printers
and /locations/{location}/printers are the same lists), and use status
with either. With client_reference_id the list holds every printer that
carries that value (it is not unique), by id, narrowed to the customer
and the location when you name them; an unknown value is an empty list. A
customer or a location that is not yours is 404. A list does not carry
profile or print_options: retrieve the printer for them.
A search reads only so many rows in one request: it may answer fewer
than limit objects, even none, with has_more true and a
next_cursor, which you send as starting_after (or ending_before)
to go on until has_more is false.
Scope: printers:read.
Authentication
A restricted API key, tc_rk_live_ and 32 characters. Send it as Authorization: Bearer <key>. A key lists its scopes, and each operation below names the one it needs; a key may also be limited to one customer. An owner or a developer of the organization makes a key in the dashboard, under API keys, after a code sent to their e-mail. The key is shown once, when it is made. An owner or a developer can revoke it there, and a revoked key stops working within a minute.
Query parameters
The id of the last object of the page you hold: returns the page that
follows it. In a search by client_reference_id the answer can be a
short page, or none, with has_more true and a next_cursor: send that
instead, and go on until has_more is false.
The id of the first object of the page you hold: returns the page
that precedes it. Not together with starting_after. In a search by
client_reference_id read backward, the next_cursor of the answer
when it has one.
Only the printers that carry this client reference id (1 to 128 characters). It is not unique, so the list can hold many; an unknown value is an empty list.
Only the printers of this customer: its id.
Only the printers of this location: its id.
Only printers with this status. Needs customer or location.
Response
Whether another page follows. Ask for it with starting_after
set to the id of the last object here, or, when the answer has
a next_cursor, with that. A search by client_reference_id
can answer a short page, or none, with has_more true: it
reads only so many rows in one request, and next_cursor is
the way on.
Always list.
Only in the answer to a search (client_reference_id) that
stopped before it could fill the page: it read all the rows it
may in one request. Then data holds what it found so
far, possibly nothing, has_more is true, and this is the
position to continue from: pass it as starting_after (or as
ending_before, if you page backward) in place of the id of
the last object. It is an id of the kind of the list, but not
necessarily the id of an object in data. Left out otherwise.