Get paginated list of tickets with advanced filtering

POST

/openapi/thread/ticketsforreading/paged

const url = 'https://open-api.replyco.com/openapi/thread/ticketsforreading/paged';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json-patch+json'},
  body: '{ "page": 1, "count": 100, "users": [ "c4e8a1b2-5d6f-4a7b-8c9d-0e1f2a3b4c5d" ] }'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://open-api.replyco.com/openapi/thread/ticketsforreading/paged \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json-patch+json' \
  --data '{ "page": 1, "count": 100, "users": [ "c4e8a1b2-5d6f-4a7b-8c9d-0e1f2a3b4c5d" ] }'

Returns a paginated list of tickets/threads with support for complex filtering.

Available filters:

Status (Open, Resolved, Snoozed, etc.)
Assigned user
Priority
Date range (created, updated)
Tags
Customer
Search term (searches in subject and messages)

Pagination:

Default page size: 50
Maximum page size: 100

Sample request:

POST /thread/ticketsForReading/paged
{
  "page": 1,
  "count": 50,
  "status": ["Open", "Pending"],
  "assignedUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "term": "order issue"
}

Authorizations

Bearer

Request Body

Filter settings for tickets including pagination, status, user, and search criteria

object

page

integer format: int32

nullable

count

integer format: int32

nullable

term

string

nullable

searchTerm

string

nullable

asc

boolean

sort

string

nullable

tab

integer format: int32

Allowed values: 0 - None 1 - MyTickets 2 - NotResolved 4 - Unassigned 8 - Resolved 16 - AllTickets 32 - Blocked 64 - Archive 128 - AllForSearch 256 - Snoozed 512 - Delayed 1024 - Starred 1919 - Default -1 - All

folderId

string format: uuid

nullable

searchUnassigned

boolean

searchAssignedToMe

boolean

searchNoLabel

boolean

searchNoAiCategory

boolean

marketplaces

Array<integer>

nullable

Allowed values: 0 - PlaceholderDoNotUse 1 - Ebay 2 - Etsy 3 - Mail 4 - BigCommerce 5 - WooCommerce 6 - Magento 7 - Shopify 8 - Linnworks 10 - Gmail 11 - Telegram 12 - Widget 13 - Cdiscount 14 - Facebook 15 - Fruugo 16 - AmazonSP 17 - Instagram 18 - Wish 19 - ChannelAdvisor 20 - CustomIntegration 21 - Outlook 22 - Veeqo 23 - Aircall 24 - Katana 25 - Billbee 26 - Kaufland 27 - WhatsApp 28 - ShopLine 29 - Brightpearl 30 - TikTok 31 - Otto 32 - RestApiEbay

languages

Array<integer>

nullable

Allowed values: 0 - None 1 - Arabic 2 - Chinese 3 - Danish 4 - Dutch 5 - English 6 - French 7 - German 8 - Greek 9 - Hindi 10 - Italian 11 - Japanese 12 - Korean 13 - Norwegian 14 - Polish 15 - Portuguese 16 - Russian 17 - Spanish 18 - Swedish 19 - Turkish 20 - Ukrainian

accounts

Array<string>

nullable

folders

Array<string>

nullable

aiCategories

Array<string>

nullable

users

Array<string>

nullable

startDate

string format: date-time

nullable

endDate

string format: date-time

nullable

filterTypes

Array<integer>

nullable

Allowed values: 0 - New 1 - NotResolved 2 - Resolved 3 - Unread 4 - OnlySentMessages 5 - WithProcessingMessages 6 - WithFailedMessaged 7 - Starred

slaTypes

Array<integer>

nullable

Allowed values: 0 - RespondDue 1 - RespondOverdue 2 - RespondCompleted 3 - RespondNoPriority 4 - ResolveDue 5 - ResolveOverdue 6 - ResolveNoPriority

customerId

string format: uuid

nullable

advancedSearch

Array<Array<object>>

nullable

Example

{
  "page": 1,
  "count": 100,
  "users": [
    "c4e8a1b2-5d6f-4a7b-8c9d-0e1f2a3b4c5d"
  ]
}

Responses

200

Returns the paginated ticket list

400

Invalid filter parameters (e.g., page size exceeds 100)

401

User is not authenticated or authorized