# List Tags

**GET /tags**

Retrieve a paginated collection of tags belonging to your organization

Tags allow you to categorize and organize Shipments, Requests, and other resources for easier tracking and filtering. They can be created, updated, and archived by setting is_active to false. Archived tags remain linked to existing records but cannot be associated with new ones. If needed, tags can be reactivated later.

Tags are global for an organization and shared across both Live and Test modes.


## Servers
- https://api.arta.io: https://api.arta.io ()



## Parameters
### Headers
- **Authorization** (string)
  Authorize your API calls with an Arta API token


### Query parameters
- **page** (integer)
  Page number of the results to fetch.
- **page_size** (integer)
  Results per page (max 50)
- **search** (string | null)
  An optional structured search query


## Responses
### 200
A collection of Tag records
#### Headers
- **content-type** (string)

- **x-arta-request-id** (string)
  A unique identifier for the Arta API call

#### Body: application/json (object)
- **items** (array[object])

- **metadata** (object)



[Powered by Bump.sh](https://bump.sh)