Get Tickets

Returns a paginated list of ticket summary records, optionally filtered by date range, status, department, merchant, category, sub-category, or attachment presence. This is the primary endpoint for building ticket dashboards and monitoring open requests across all merchants managed by an ISO.

Endpoint

GET /api/v1/tickets/getTickets

Authentication

Basic HTTP Authentication required.
Encode username:password in Base64 and pass in the Authorization header:

Authorization: Basic {base64(username:password)}

When to use

Use this endpoint to generate a list view of tickets for operational monitoring — for example, to find all open Underwriting tickets created in the last 30 days, or to identify which merchants have tickets in Pending status. Combine with pagination parameters to handle large portfolios efficiently.

Query Parameters

Response

200 OK

{
  "pageNumber": 1,
  "pageSize": 20,
  "totalCount": 47,
  "items": [
    {
      "ticketId": 48291,
      "status": "InProgress",
      "merchantProfileId": 70269,
      "dba": "Sunshine Retail LLC",
      "subject": "Instant Funding",
      "priority": "Low",
      "department": "Underwriting",
      "description": "Please enable Instant Funding for this merchant.",
      "category": "Funding",
      "subCategory": "Instant Funding",
      "assigned": "[email protected]",
      "resolution": null,
      "type": "Request",
      "created": "2026-05-15T09:00:00Z",
      "updated": "2026-05-20T14:32:00Z",
      "hasAttachment": true,
      "creationType": "API"
    },
    {
      "ticketId": 48305,
      "status": "New",
      "merchantProfileId": 70315,
      "dba": "Harbor Coffee Co",
      "subject": "Chargeback Inquiry",
      "priority": "Medium",
      "department": "CustomerService",
      "description": "Merchant received chargeback on transaction 8843221.",
      "category": "Chargebacks",
      "subCategory": null,
      "assigned": null,
      "resolution": null,
      "type": "Inquiry",
      "created": "2026-05-22T11:15:00Z",
      "updated": "2026-05-22T11:15:00Z",
      "hasAttachment": false,
      "creationType": "Portal"
    }
  ],
  "requestId": 98131,
  "success": true,
  "error": null,
  "validationErrors": []
}

Error Codes

Common Mistakes

• Using date strings without timezone information — always supply ISO 8601 timestamps with a timezone offset (e.g., 2026-05-01T00:00:00Z).
• Not supplying pageNumber and pageSize on large portfolios, which may result in slow responses or truncated result sets.
• Filtering by category or subCategory using display names that differ from the internal enum values stored on the ticket.
• Expecting items to be populated when there are no matching tickets — an empty array is a valid response.

Related Endpoints

• GET /api/v1/tickets/getTicketById — Retrieve full detail for a specific ticket from this list.
• POST /api/v1/tickets/create — Create a new ticket.
• POST /api/v1/tickets/update — Update the status of a ticket returned in this list.

Example

curl -X GET "https://hq.staging.netevia.dev/api/v1/tickets/getTickets?status=InProgress&department=Underwriting&pageNumber=1&pageSize=20" \
  -H "Authorization: Basic $(echo -n 'username:password' | base64)"