1-877-548-3001 Sign in About Contact
Developer

GET

/api/ticket/search

Get a list of tickets for your account based on the generic search

Scope:

client

or

operator

Request Parameters

Query

A

search_term

required

The search term you would like to use

2

start_index

optional

Set start index for result set

2

count

optional

Set the count/limit for page

Response

Schema

{}

payload

The ticket search data

{}

2

count

The number of tickets returned within the payload

2

start_index

The start index for the current tickets within the payload

tickets

The list of tickets

[]

{}

A

acknowledged

The acknowledge state of the ticket (Acknowledged or Unacknowledged)

2

assigned_to

The id of the operator who assigned to the ticket

A

assigned_to_name

The name of the operator who assigned to the ticket

A

body

The ticket body

A

category

The category of the ticket

2

client_id

The client identifier for the ticket

A

country_code

The country code for the ticket/visitor

A

created_time

The time the ticket was created

A

email

The email address for the customer who submitted the ticket

has_attachments

If the ticket has attachments associated with it

2

id

A unique identifier for the ticket

A

name

The name for the customer who submitted the ticket

A

priority

The ticket priority

A

source

The source of the ticket

  • Form
  • Email to Ticket
  • Twitter

A

status

The current status of the ticket

  • Open
  • Response Received
  • Comment Added
  • Working
  • Waiting for Response
  • Closed

tags

A list of tags associated with the ticket

[]

A

The tag names

A

title

The title of the ticket

A

updated_time

The time the ticket was last updated

A

visitor_id

The unique identifier for the visitor associated with the ticket

2

total_rows

The total number of tickets matched

A

status

The system response status. Will be ok or error

curl

example request

1

curl -H "Authorization: Bearer {{Oauth Token}}"

2

https://developer.livehelpnow.net/api/ticket/search\?search_term\=help

example response

      
        

1

 {

2

   "payload": {

3

     "count"

: 20,

4

     "start_index"

: 1,

5

     "tickets": [{

6

       "acknowledged"

: "Acknowledged",

7

       "assigned_to"

: 1234,

8

       "assigned_to_name"

: "John Smith",

9

       "body"

: "",

10

      "category"

: "Billing",

11

      "client_id"

: 1,

12

      "country_code"

: "US",

13

      "created_time"

: "2020-05-21T14:50:43",

14

      "email"

: "jdoe@livehelpnow.com",

15

      "has_attachments"

: false,

16

      "id"

: 1234567,

17

      "name"

: "John Doe",

18

      "priority"

: "High [Private]",

19

      "source"

: "Form",

20

      "status"

: "Closed",

21

      "tags"

: ["general", "customer service", "billing"],

22

      "title"

: "test",

23

      "updated_time"

: "2020-05-21T14:54:42",

24

      "visitor_id"

: "773bb26414957327cd1b97d-1-22255319"

25

    }],

26

    "total_rows"

: 547

27

  },

28

  "status": "ok"

29

 }