---
updatedAt: 2026-04-28T11:29:33.000Z
agentTools:
  projectIndex: https://docs.stairwell.com/llms.txt
---

# ListObjectTags

Lists tags applied to an object.

# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "Stairwell V1 HTTP APIs",
    "description": "Restful APIs for the Stairwell platform. Most APIs expose named resources: each resource has a unique identifier that users use to reference that resource, and these names are what users should store as the canonical names for the resources. The base URL for this API is https://app.stairwell.com",
    "contact": {
      "name": "Stairwell"
    },
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://app.stairwell.com"
    }
  ],
  "paths": {
    "/v1/objects/{object}/tags": {
      "get": {
        "tags": [
          "Objects"
        ],
        "summary": "ListObjectTags",
        "description": "Lists tags applied to an object.",
        "operationId": "Objects_ListTags",
        "parameters": [
          {
            "name": "object",
            "in": "path",
            "description": "The object hash (MD5, SHA1, or SHA256).",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "b1674e80e7bda2b0b1a9ebc14f8e7f17ce3bce72cb04a52c26f1f4b5fa60a546"
          },
          {
            "name": "pageSize",
            "in": "query",
            "description": "Maximum number of tags to return per page. Defaults to 100, max 1000.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageToken",
            "in": "query",
            "description": "A page token received from a previous `ListTags` call.\n Provide this to retrieve the subsequent page. When paginating, all\n other parameters provided to `ListTags` must match the call that\n provided the page token.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListTagsResponse"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "ListTagsResponse": {
        "type": "object",
        "properties": {
          "tags": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Tag"
            },
            "description": "Tags attached to the entity."
          },
          "nextPageToken": {
            "type": "string",
            "description": "Token for retrieving the next page. Empty if no more results."
          }
        },
        "description": "Response message for ListTags RPC."
      },
      "Tag": {
        "required": [
          "value",
          "environment"
        ],
        "type": "object",
        "properties": {
          "name": {
            "readOnly": true,
            "type": "string",
            "description": "Resource name of this tag (opaque identifier, returned by the API)."
          },
          "value": {
            "type": "string",
            "description": "The tag label (e.g. \"incident-2024-001\", \"apt29\", \"production-server\")."
          },
          "environment": {
            "type": "string",
            "description": "Environment where this tag is visible. Tags are scoped to environments."
          }
        },
        "description": "A tag is a user-defined label attached to an entity for organization and filtering."
      }
    },
    "securitySchemes": {
      "AuthToken": {
        "type": "apiKey",
        "name": "Authorization",
        "in": "header"
      }
    }
  },
  "security": [
    {
      "AuthToken": []
    }
  ],
  "tags": [
    {
      "name": "Objects",
      "description": "Service for interacting with objects (files) on the Stairwell platform.\n Objects are uniquely identified by their SHA256 hash, though the API accepts\n MD5, SHA1, or SHA256 when looking up objects. The same file appearing on\n different machines or with different filenames is the same object. Objects\n are the foundation of Stairwell's analysis: they accumulate metadata, variant\n relationships, network indicators, and verdicts over time."
    }
  ]
}
```

# Sibling pages

* [GenerateRunToGround](https://docs.stairwell.com/reference/objects_generateruntoground.md)
* [ListObjectMetadata](https://docs.stairwell.com/reference/objects_listobjectmetadata.md)
* [ListObjectComments](https://docs.stairwell.com/reference/objects_listcomments.md)
* [CreateObjectComment](https://docs.stairwell.com/reference/objects_createcomment.md)
* [GetObjectDetonation](https://docs.stairwell.com/reference/objects_getobjectdetonation.md)
* [TriggerObjectDetonation](https://docs.stairwell.com/reference/objects_triggerobjectdetonation.md)
* [GetObjectMetadata](https://docs.stairwell.com/reference/objects_getobjectmetadata.md)
* [ListObjectOpinions](https://docs.stairwell.com/reference/objects_listopinions.md)
* [CreateObjectOpinion](https://docs.stairwell.com/reference/objects_createopinion.md)
* [ListObjectRelationships](https://docs.stairwell.com/reference/objects_listobjectrelationships.md)
* [ListObjectSightings](https://docs.stairwell.com/reference/objects_listobjectsightings.md)
* [CreateObjectTag](https://docs.stairwell.com/reference/objects_createtag.md)
* [GetObjectTag](https://docs.stairwell.com/reference/objects_gettag.md)
* [DeleteObjectTag](https://docs.stairwell.com/reference/objects_deletetag.md)
* [ListObjectVariants](https://docs.stairwell.com/reference/objects_listobjectvariants.md)
* [DownloadObject](https://docs.stairwell.com/reference/objects_downloadobject.md)
* [DownloadObjectV2](https://docs.stairwell.com/reference/objects_downloadobjectv2.md)