List the distinct device tags in scope

The distinct tags of the devices the token may read (its company, plus
descendants when its user type allows it) and the device filters select,
exactly as stored, with how many of those devices carry each tag.

The device tag filters on GET /devices (tags_incany, tags_incall)
match the stored spelling exactly and case-sensitively. Use this endpoint
to find that spelling: tag_ilike=field pilot returns Field Pilot and
any other stored spelling. Spellings that differ only by case are separate
rows, each with its own device_count. A device that lists a tag twice
counts once.

Rows are ordered by tag, case-insensitively (ties by byte order, so
Field Pilot precedes field pilot). Without page_meta=true the
response is a bare array of rows.

Device filters are the ones GET /devices accepts, as
<field>_<operator>=<value> (for example company_id_in,
device_type_id_eq, heartbeat_status_in); the most used are listed
below.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

Only tags containing this text, case-insensitively. %, _ and \ match themselves, not any text.

string
enum

The only order is by tag; any other value is a 400.

Allowed:
integer
≥ 1
Defaults to 1

Page number for pagination

integer
0 to 1000
Defaults to 20

Tags per page. 0 returns no rows, only total (with page_meta=true).

boolean
Defaults to false

Include pagination metadata in response

Partial case-insensitive search term

string

Only devices of this company. company_id_in takes a comma-separated list.

string

Only devices of this company and its descendants.

string

Only devices in this fleet.

string
Responses

400

per_page outside 0..1000, an order_by other than tag, or unparseable device filters.

401

You are not authorized

403

You are forbidden from accessing this resource

500

An unexpected error was encountered.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json