Get tags — Monite Documentation

Get a list of all tags. Tags can be assigned to resources to assist with searching and filtering. Tags can also be used as trigger conditions in payable approval policies.

Headers

Auth

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

x-monite-versionstringRequired

x-monite-entity-idstringRequired

The ID of the entity that owns the requested resource.

Query parameters

order"asc" or "desc"Optional

Order by

Allowed values: ascdesc

limitintegerOptional

Max is 100

pagination_tokenstringOptional

A token, obtained from previous page. Prior over other filters

sort"created_at" or "updated_at"Optional

Allowed sort fields

Allowed values: created_atupdated_at

created_by_entity_user_idstringOptional

name__instringOptional

id__instringOptional

Response

This endpoint returns an object.

datalist of objects

Represents a user-defined tag that can be assigned to resources to filter them.

next_pagination_tokenstringOptional

A token that can be sent in the pagination_token query parameter to get the next page of results, or null if there is no next page (i.e. you’ve reached the last page).

prev_pagination_tokenstringOptional

A token that can be sent in the pagination_token query parameter to get the previous page of results, or null if there is no previous page (i.e. you’ve reached the first page).

Errors

1 curl https://api.sandbox.monite.com/v1/tags \ 2 -H "x-monite-version: 2024-01-31" \ 3 -H "x-monite-entity-id: x-monite-entity-id" \ 4 -H "Authorization: Bearer <token>"

1 { 2 "data": [ 3 { 4 "id": "ea837e28-509b-4b6a-a600-d54b6aa0b1f5", 5 "created_at": "2022-09-07T16:35:18Z", 6 "updated_at": "2022-09-07T16:35:18Z", 7 "name": "Marketing", 8 "category": "document_type", 9 "created_by_entity_user_id": "ea837e28-509b-4b6a-a600-d54b6aa0b1f5", 10 "description": "Tag for the Marketing Department" 11 } 12 ], 13 "next_pagination_token": "eyJvcmRlciI6ImFzYyIsImxpbWl0IjoyLCJwYWdpbmF0aW9uX2ZpbHRlcnMiOnsiZW50aXR5X2lkIjoiOWQyYjRjOGYtMjA4Ny00NzM4LWJhOTEtNzM1OTY4M2M0OWE0In0sInBhZ2luYXRpb25fdG9rZW5fdHlwZSI6Im5leHQiLCJjdXJzb3JfZmllbGQiOm51bGwsImN1cnNvcl9maWVsZF92YWx1ZSI6bnVsbCwiY3VycmVudF9vaWQiOjR9", 14 "prev_pagination_token": "eyJvcmRlciI6ImFzYyIsImxpbWl0IjoyLCJwYWdpbmF0aW9uX2ZpbHRlcnMiOnsiZW50aXR5X2lkIjoiOWQyYjRjOGYtMjA4Ny00NzM4LWJhOTEtNzM1OTY4M2M0OWE0In0sInBhZ2luYXRpb25fdG9rZW5fdHlwZSI6Im5leHQiLCJjdXJzb3JfZmllbGQiOm51bGwsImN1cnNvcl9maWVsZF92YWx1ZSI6bnVsbCwiY3VycmVudF9vaWQiOjR9" 15 }

1	curl https://api.sandbox.monite.com/v1/tags \
2	-H "x-monite-version: 2024-01-31" \
3	-H "x-monite-entity-id: x-monite-entity-id" \
4	-H "Authorization: Bearer <token>"

1	{
2	"data": [
3	{
4	"id": "ea837e28-509b-4b6a-a600-d54b6aa0b1f5",
5	"created_at": "2022-09-07T16:35:18Z",
6	"updated_at": "2022-09-07T16:35:18Z",
7	"name": "Marketing",
8	"category": "document_type",
9	"created_by_entity_user_id": "ea837e28-509b-4b6a-a600-d54b6aa0b1f5",
10	"description": "Tag for the Marketing Department"
11	}
12	],
13	"next_pagination_token": "eyJvcmRlciI6ImFzYyIsImxpbWl0IjoyLCJwYWdpbmF0aW9uX2ZpbHRlcnMiOnsiZW50aXR5X2lkIjoiOWQyYjRjOGYtMjA4Ny00NzM4LWJhOTEtNzM1OTY4M2M0OWE0In0sInBhZ2luYXRpb25fdG9rZW5fdHlwZSI6Im5leHQiLCJjdXJzb3JfZmllbGQiOm51bGwsImN1cnNvcl9maWVsZF92YWx1ZSI6bnVsbCwiY3VycmVudF9vaWQiOjR9",
14	"prev_pagination_token": "eyJvcmRlciI6ImFzYyIsImxpbWl0IjoyLCJwYWdpbmF0aW9uX2ZpbHRlcnMiOnsiZW50aXR5X2lkIjoiOWQyYjRjOGYtMjA4Ny00NzM4LWJhOTEtNzM1OTY4M2M0OWE0In0sInBhZ2luYXRpb25fdG9rZW5fdHlwZSI6Im5leHQiLCJjdXJzb3JfZmllbGQiOm51bGwsImN1cnNvcl9maWVsZF92YWx1ZSI6bnVsbCwiY3VycmVudF9vaWQiOjR9"
15	}