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

# Search Ticket Types

> **Tool name:** `search_ticket_type` · **Behaviour:** 🔒 Read-only

Search ticket types and add-ons in the caller's organization by event ID, ticket type IDs, and/or name (case-insensitive substring). Both regular ticket types and add-ons are returned. Results are always scoped to the caller's organization. Returns each match's ticketTypeId and name. Use a returned ticketTypeId with a ticketTypeId filter on search_attendees / search_attendee_count to scope attendees to a specific ticket type.

**MCP-only:** this tool has no equivalent Public API endpoint.



## OpenAPI

````yaml https://api.prod.zuddl.com/api/v3/api-docs/mcp-tools post /tools/search_ticket_type
openapi: 3.1.0
info:
  title: Zuddl MCP Tools Reference
  description: >-
    The Zuddl MCP server lets AI assistants such as Claude and ChatGPT work with
    your Zuddl organization through the [Model Context
    Protocol](https://modelcontextprotocol.io). This reference lists every tool
    the server offers. It is generated from the live server, so it always
    matches what your assistant sees.


    # Connecting


    Add `https://setup.zuddl.com/api/mcp` as a remote MCP server in your
    assistant. It signs you in to Zuddl with OAuth and then calls tools on your
    behalf, with your permissions. AI features must be enabled for your
    organization.


    # Calling a tool


    Assistants call a tool with a JSON-RPC `tools/call` request whose `name` is
    the tool name and whose `arguments` match the request body documented on the
    tool's page. The `/tools/<name>` paths in this reference identify tools;
    they are not HTTP endpoints.


    # Behaviour labels


    | Label | Meaning |

    | --- | --- |

    | 🔒 Read-only | Reads data and changes nothing. |

    | ✏️ Write | Creates or updates data, but does not delete it. |

    | ⚠️ Destructive | Deletes or removes data. Most assistants ask you to
    approve these calls. |

    | 🔁 Idempotent | Calling it again with the same arguments has no further
    effect. |


    A tool that mirrors a Public API endpoint links to that endpoint's page.
    MCP-only tools have no Public API equivalent.
  version: 1.0.0
servers:
  - url: https://setup.zuddl.com/api/mcp
    description: Zuddl MCP server
security:
  - oauth: []
tags:
  - name: Events
  - name: Attendees
  - name: Sessions
  - name: Speakers
  - name: Sponsors
  - name: Locations
  - name: Teams
  - name: Brand Kits
  - name: Registration flows & tickets
  - name: Analytics
paths:
  /tools/search_ticket_type:
    post:
      tags:
        - Registration flows & tickets
      summary: Search Ticket Types
      description: >-
        **Tool name:** `search_ticket_type` · **Behaviour:** 🔒 Read-only


        Search ticket types and add-ons in the caller's organization by event
        ID, ticket type IDs, and/or name (case-insensitive substring). Both
        regular ticket types and add-ons are returned. Results are always scoped
        to the caller's organization. Returns each match's ticketTypeId and
        name. Use a returned ticketTypeId with a ticketTypeId filter on
        search_attendees / search_attendee_count to scope attendees to a
        specific ticket type.


        **MCP-only:** this tool has no equivalent Public API endpoint.
      operationId: search_ticket_type
      requestBody:
        description: The tool's `arguments`, as sent in a JSON-RPC `tools/call` request.
        content:
          application/json:
            schema:
              type: object
              properties:
                eventId:
                  type: string
                  description: >-
                    Zuddl event ID (UUID) to scope the search to a single event.
                    Omit to search across all events in the caller's
                    organization.
                ticketTypeIds:
                  type: array
                  description: >-
                    One or more ticket type IDs (UUIDs) to fetch (ticket types
                    or add-ons). IDs outside the caller's organization are
                    ignored; the call fails if none of the supplied IDs belong
                    to the organization. Omit to search by event and/or name
                    instead.
                  items:
                    type: string
                name:
                  type: string
                  description: >-
                    Ticket type or add-on name to search for (case-insensitive
                    substring match). Use when the user names a ticket type
                    rather than giving an ID.
        required: true
      responses:
        '200':
          description: A JSON-RPC `tools/call` result. The tool's output is in `content`.
components:
  securitySchemes:
    oauth:
      type: http
      description: >-
        OAuth 2.1 access token. MCP clients obtain it themselves (dynamic client
        registration + PKCE) when you connect them to the server URL above.
      scheme: bearer

````

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