> ## Documentation Index > Fetch the complete documentation index at: https://docs.theymes.com/llms.txt > Use this file to discover all available pages before exploring further. # Get tickets > Get tickets ## OpenAPI ````yaml https://api.theymes.com/openapi get /tickets openapi: 3.1.0 info: title: Theymes API version: 1.0.0 description: >- Theymes API allows you to interact with the Theymes platform. Most endpoints require an API key for authentication. You can generate an API key in the Theymes dashboard. The API key should be included in the Authorization header (```Authorization: Bearer ```). The public support link endpoints do not require authentication and are grouped separately below. servers: [] security: [] tags: - name: Authenticated endpoints (API key) description: Endpoints that require an API key in the Authorization header. - name: Public support links (no authentication) description: >- Endpoints for creating web support sessions and links. These require no authentication and are identified by a game environment token. paths: /tickets: get: tags: - Authenticated endpoints (API key) description: Get tickets operationId: getTickets parameters: - schema: type: string required: false name: playerId in: query - schema: type: string required: false name: email in: query - schema: type: string format: uuid required: false name: gameId in: query - schema: type: string format: uuid required: false name: ticketId in: query - schema: type: string description: >- JSON-encoded array of tag names. A ticket must contain every supplied tag. Example: `["vip","billing"]`. required: false description: >- JSON-encoded array of tag names. A ticket must contain every supplied tag. Example: `["vip","billing"]`. name: tags in: query - schema: type: string description: >- JSON-encoded object of custom field keys and values. A ticket must match every supplied field; dropdown fields must contain all supplied options. Example: `{"priority":["high"],"escalated":true}`. required: false description: >- JSON-encoded object of custom field keys and values. A ticket must match every supplied field; dropdown fields must contain all supplied options. Example: `{"priority":["high"],"escalated":true}`. name: fields in: query - schema: type: string format: date description: Only return tickets created on or after this date required: false description: Only return tickets created on or after this date name: createdAfter in: query - schema: type: string format: date description: Only return tickets created on or before this date required: false description: Only return tickets created on or before this date name: createdBefore in: query - schema: type: string enum: - asc - desc default: asc description: Sort by ticket creation order, oldest first or newest first required: false description: Sort by ticket creation order, oldest first or newest first name: order in: query - schema: type: string description: >- Pagination cursor returned from a previous response. Must be used with the same `order` direction it was obtained with. Omit when starting a new scan. required: false description: >- Pagination cursor returned from a previous response. Must be used with the same `order` direction it was obtained with. Omit when starting a new scan. name: cursor in: query - schema: type: integer minimum: 1 maximum: 1000 default: 100 required: false name: limit in: query - schema: type: string description: Bearer token API key required: true description: Bearer token API key name: Authorization in: header responses: '200': description: A list of tickets content: application/json: schema: type: object properties: tickets: type: array items: type: object properties: id: type: string format: uuid runningId: type: integer description: Human-readable running ticket number url: type: string description: >- URL to view the conversation in the support application gameId: type: string format: uuid gameEnvironmentId: type: string format: uuid theymesPlayerId: type: string nullable: true format: uuid description: Theymes internal player ID playerId: type: string nullable: true description: >- External player ID provided by the game, null for email/web tickets playerName: type: string nullable: true description: >- Player name associated with the ticket, when available email: type: string nullable: true description: >- Player email associated with the ticket, when available status: type: string enum: - new - assigned - unassigned - waiting - on_hold - closed supportSource: type: string nullable: true enum: - IN_APP - WIDGET - EMAIL - MESSENGER - WEB - API - STARTED_BY_AGENT - null description: Origin through which the ticket was created channels: type: array items: type: string enum: - chat - email - messenger language: type: string enum: - en - de - es - es-AR - es-MX - fi - fil - fr - id - ja - ko - ms - pt - pt-BR - ru - tr - uk - vi - zh - zh-Hans - zh-Hant - ar - cs - da - nl - el - hu - it - 'no' - nb - pl - ro - sk - sv - th resolutionType: type: string nullable: true enum: - resolved - rejected - auto_closed - null csatScore: type: integer nullable: true minimum: 1 maximum: 5 csatReview: type: string nullable: true issueSummary: type: string nullable: true issueResolution: type: string nullable: true followUpTicketId: type: string nullable: true format: uuid reopenedFromTicketId: type: string nullable: true format: uuid createdAt: type: string format: date-time lastActivityAt: type: string nullable: true format: date-time tags: type: array items: type: string fields: type: object additionalProperties: anyOf: - type: string - type: number - type: array items: type: string - type: boolean description: >- Custom fields associated with the ticket, keyed by the configured field key metadata: type: object additionalProperties: anyOf: - type: string - type: number - type: array items: type: string - type: boolean description: Builtin metadata fields associated with the ticket required: - id - runningId - url - gameId - gameEnvironmentId - theymesPlayerId - playerId - playerName - email - status - supportSource - channels - language - resolutionType - csatScore - csatReview - issueSummary - issueResolution - followUpTicketId - reopenedFromTicketId - createdAt - lastActivityAt - tags - fields - metadata pagination: type: object properties: cursor: type: string nullable: true description: >- Cursor for pagination if more results are available else null required: - cursor required: - tickets - pagination ````