> ## Documentation Index > Fetch the complete documentation index at: https://docs.useparagon.com/llms.txt > Use this file to discover all available pages before exploring further. # Search Tickets **Provider API:** Zendesk Support API (v2). ## OpenAPI ````yaml actionkit/openapi.json POST /projects/{project_id}/tools/#ZENDESK_SEARCH_TICKETS_V2 openapi: 3.0.0 info: title: ActionKit Tools API version: 1.0.0 servers: - url: https://actionkit.useparagon.com description: US Cloud security: [] paths: /projects/{project_id}/tools/#ZENDESK_SEARCH_TICKETS_V2: post: summary: Search Tickets parameters: - name: project_id in: path required: true schema: type: string description: >- Your Paragon Project ID. You can copy your Project ID from your dashboard URL or by clicking Copy Project ID under the Environment switcher. requestBody: required: true content: application/json: schema: type: object properties: tool: type: string default: ZENDESK_SEARCH_TICKETS_V2 parameters: type: object properties: ticketSubject: type: string ticketDescription: type: string description: >- Please enter the details of your request. A member of our support staff will respond as soon as possible. ticketStatus: type: string description: Request ticket status enum: - new - open - pending - solved ticketType: type: string description: Request type enum: - question - incident - problem - task createdDate-left: type: string description: >- Created Date : Filter tickets by their created date. (example: "YYYY-MM-DD") enum: - EQUALS - LESS_THAN_EQUALS - GREATER_THAN_EQUALS createdDate-right: type: string description: >- Created Date Value : Filter tickets by their created date. (example: "YYYY-MM-DD") updatedDate-left: type: string description: >- Updated Date : Filter tickets by their updated date. (example: "YYYY-MM-DD") enum: - EQUALS - LESS_THAN_EQUALS - GREATER_THAN_EQUALS updatedDate-right: type: string description: >- Updated Date Value : Filter tickets by their updated date. (example: "YYYY-MM-DD") dueDate-left: type: string description: >- Due Date : Filter tickets by their due date. (example: "YYYY-MM-DD") enum: - EQUALS - LESS_THAN_EQUALS - GREATER_THAN_EQUALS dueDate-right: type: string description: >- Due Date Value : Filter tickets by their due date. (example: "YYYY-MM-DD") requesterId: type: string description: >- Requester ID : Filter by the user who requested this ticket. assigneeId: type: string description: Agent assigned to your request recipientEmail: type: string description: >- Recipient : Filter by the original recipient e-mail address of the ticket. (example: "name@example.com") ticketPriority: type: string description: Request priority enum: - low - normal - high - urgent ticketTags: type: string description: 'Tags : Filter tickets by their tag.' ticketExternalId: type: string description: 'External ID : Filter by tickets by their external ID.' sort_by: type: string description: Sort By enum: - created_at - updated_at - priority - status - ticket_type sort_order: type: string description: Sort Order enum: - asc - desc paginationParameters: type: object description: Pagination Parameters properties: pageCursor: type: string description: >- The cursor to use for requesting additional results. Use if you received a previous response with a page cursor and require more results. limit: type: number description: >- The maximum number of records to load in one page of results. dueDate: type: object description: Due Date properties: operator: type: string description: Due Date Operator enum: - EQUALS - LESS_THAN_EQUALS - GREATER_THAN_EQUALS value: type: string description: Due Date Value format: date required: - operator - value createdDate: type: object description: Created Date properties: operator: type: string description: Created Date Operator enum: - EQUALS - LESS_THAN_EQUALS - GREATER_THAN_EQUALS value: type: string description: Created Date Value format: date required: - operator - value updatedDate: type: object description: Updated Date properties: operator: type: string description: Updated Date operator enum: - EQUALS - LESS_THAN_EQUALS - GREATER_THAN_EQUALS value: type: string description: Updated Date value format: date required: - operator - value x-integration: zendesk required: - tool - parameters responses: '200': description: >- A page of matching Zendesk tickets, each with `result_type: "ticket"`. A full page has 100 tickets. `nextPageCursor` is `null` on the last page; otherwise pass it as `paginationParameters.pageCursor` to load the next page. Zendesk search returns at most 1,000 results, so `nextPageCursor` is `null` once that limit is reached. content: application/json: examples: Response (first page): summary: First page, more pages available (abbreviated) value: records: - url: https://example.zendesk.com/api/v2/tickets/35436.json id: 35436 external_id: null via: channel: api source: from: {} to: {} rel: null created_at: '2026-10-16T05:54:37Z' updated_at: '2026-10-16T05:54:39Z' generated_timestamp: 360000780079 type: null subject: '[Paragon docs test] safe to delete' raw_subject: '[Paragon docs test] safe to delete' description: >- Temporary ticket created while documenting ActionKit responses. Deleted right after. priority: high status: open recipient: null requester_id: 360000020441 submitter_id: 360000020441 assignee_id: 360000040777 organization_id: null group_id: 360000060358 collaborator_ids: [] follower_ids: [] email_cc_ids: [] forum_topic_id: null problem_id: null has_incidents: false is_public: true due_at: null tags: [] custom_fields: - id: 360000080418 value: null - id: 360000100193 value: null - id: 360000120129 value: null - id: 360000140177 value: null - id: 360000160113 value: null - id: 360000180609 value: null - id: 360000200409 value: null - id: 360000220953 value: null - id: 360000240465 value: null - id: 360000260201 value: null - id: 360000280353 value: null - id: 360000300641 value: null - id: 360000320209 value: null satisfaction_rating: score: unoffered sharing_agreement_ids: [] custom_status_id: 360000340813 encoded_id: V0WRRD-5DM05 fields: - id: 360000080418 value: null - id: 360000100193 value: null - id: 360000120129 value: null - id: 360000140177 value: null - id: 360000160113 value: null - id: 360000180609 value: null - id: 360000200409 value: null - id: 360000220953 value: null - id: 360000240465 value: null - id: 360000260201 value: null - id: 360000280353 value: null - id: 360000300641 value: null - id: 360000320209 value: null followup_ids: [] brand_id: 360000360398 allow_channelback: false allow_attachments: true from_messaging_channel: false support_type: agent result_type: ticket nextPageCursor: '2' Response (last page): summary: Last page value: records: - url: https://example.zendesk.com/api/v2/tickets/35436.json id: 35436 external_id: null via: channel: api source: from: {} to: {} rel: null created_at: '2026-10-16T05:54:37Z' updated_at: '2026-10-16T05:54:39Z' generated_timestamp: 360000780079 type: null subject: '[Paragon docs test] safe to delete' raw_subject: '[Paragon docs test] safe to delete' description: >- Temporary ticket created while documenting ActionKit responses. Deleted right after. priority: high status: open recipient: null requester_id: 360000020441 submitter_id: 360000020441 assignee_id: 360000040777 organization_id: null group_id: 360000060358 collaborator_ids: [] follower_ids: [] email_cc_ids: [] forum_topic_id: null problem_id: null has_incidents: false is_public: true due_at: null tags: [] custom_fields: - id: 360000080418 value: null - id: 360000100193 value: null - id: 360000120129 value: null - id: 360000140177 value: null - id: 360000160113 value: null - id: 360000180609 value: null - id: 360000200409 value: null - id: 360000220953 value: null - id: 360000240465 value: null - id: 360000260201 value: null - id: 360000280353 value: null - id: 360000300641 value: null - id: 360000320209 value: null satisfaction_rating: score: unoffered sharing_agreement_ids: [] custom_status_id: 360000340813 encoded_id: V0WRRD-5DM05 fields: - id: 360000080418 value: null - id: 360000100193 value: null - id: 360000120129 value: null - id: 360000140177 value: null - id: 360000160113 value: null - id: 360000180609 value: null - id: 360000200409 value: null - id: 360000220953 value: null - id: 360000240465 value: null - id: 360000260201 value: null - id: 360000280353 value: null - id: 360000300641 value: null - id: 360000320209 value: null followup_ids: [] brand_id: 360000360398 allow_channelback: false allow_attachments: true from_messaging_channel: false support_type: agent result_type: ticket nextPageCursor: null security: - BearerAuth: [] components: securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- Your [Paragon User Token](/getting-started/installing-the-connect-sdk#setup) (JWT), which you can generate using your project's signing keys. ````