> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chemcloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Lists the buyer's tags



## OpenAPI

````yaml https://app.chemcloud.com.au/api-docs/public/buyer/v1/openapi.yaml get /api/public/buyer/v1/tags
openapi: 3.0.1
info:
  title: ChemCloud Buyer API
  version: v1
  description: >
    ## Rate limits


    | Scope | Limit |

    |---|---|

    | Requests per API key | 6,000 per minute |

    | Requests with no `X-API-KEY` header, per IP address | 30 per minute |

    | Invalid API keys, per IP address | 20 in 10 minutes, then a 1 hour ban |


    A throttled request returns `429 Too Many Requests` with a JSON body

    `{"error": "Too many requests. Retry in N seconds."}` and a `Retry-After`
    header (seconds).

    A banned IP address returns `429` with `Retry-After: 3600` for every request
    until the ban expires.
servers:
  - url: https://app.chemcloud.com.au
    description: Production
security: []
paths:
  /api/public/buyer/v1/tags:
    get:
      tags:
        - Tags
      summary: Lists the buyer's tags
      parameters:
        - name: taggable_type
          in: query
          required: false
          description: >-
            Restrict to tags attachable to this entity type (BuyerProduct,
            BuyerProductApproval, Delivery, NonConformanceReport, Shipment,
            SourcingRequest)
          schema:
            type: string
        - name: category
          in: query
          required: false
          description: Restrict to one tag category (custom, buyer_product_category)
          schema:
            type: string
        - name: name
          in: query
          required: false
          description: Only return tags whose name contains this text (case-insensitive)
          schema:
            type: string
      responses:
        '200':
          description: Tags retrieved
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      format: uuid
                      example: 99999a99-b888-777c-666d-55555555555e
                    name:
                      type: string
                      example: Urgent
                    category:
                      type: string
                      enum:
                        - custom
                        - buyer_product_category
                      example: custom
                    tag_group:
                      type: object
                      nullable: true
                      properties:
                        id:
                          type: string
                          format: uuid
                          example: 99999a99-b888-777c-666d-55555555555e
                        name:
                          type: string
                          example: Priority
                        allow_inline_creation:
                          type: boolean
                          example: false
                        taggable_types:
                          type: array
                          items:
                            type: string
                            enum:
                              - BuyerProduct
                              - BuyerProductApproval
                              - Delivery
                              - NonConformanceReport
                              - Shipment
                              - SourcingRequest
                          description: Empty means the group applies to every entity type
      security:
        - apiKey: []
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-API-KEY

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.