Get ticket

Retrieves details of a specific ticket.

GET /tickets/{ticket_id}

Get ticket details

cURL

curl --request GET \
  --url https://{your-subdomain}.neetodesk.com/api/external/v2/tickets/{ticket_id} \
  --header 'X-Api-Key: <x-api-key>'

200

{
  "ticket": {
    "id": "aaaabbbb-cccc-dddd-eeee-ffff00003333",
    "number": 33,
    "subject": "How to resolve the pending payments",
    "description": "I need your help in resolving the pending payments.",
    "priority": "low",
    "status": "open",
    "category": "Problem",
    "sub_category_one": "Billing",
    "sub_category_two": "Refund",
    "group": "Sales",
    "tags": [
      "refund",
      "urgent"
    ],
    "assignee": {
      "id": "aaaabbbb-cccc-dddd-eeee-ffff00001111",
      "name": "Oliver Smith",
      "email": "[e-mail]"
    },
    "customer": {
      "id": "aaaabbbb-cccc-dddd-eeee-ffff00002222",
      "name": "John Luther",
      "email": "[e-mail]",
      "phone_numbers": [
        "[phone]"
      ]
    },
    "fields": [
      {
        "field_name": "Country",
        "field_value": "USA"
      }
    ]
  }
}

Replace {your-subdomain} with your workspace’s subdomain.
Learn how to find your subdomain in Workspace subdomain.

Headers

X-Api-Key · string · default: your-api-key · required

Use the X-Api-Key header to provide your workspace API key. Refer to Authentication for more information.

Path Parameters

ticket_id · string · required

ID of the ticket. You can use either the ticket ID (UUID) or ticket number (sequential number) interchangeably. Refer to Getting Ticket ID section for detailed instructions.

Response

200 - application/json

OK - Request succeeded

ticket · object

Hide child attributes

ticket. id · string

Example:

"aaaabbbb-cccc-dddd-eeee-ffff00003333"

ticket. number · integer

Example:

33

ticket. subject · string

Example:

"How to resolve the pending payments"

ticket. description · string

HTML content of the ticket description.

Example:

"I need your help in resolving the pending payments."

ticket. priority · string

Example:

"low"

ticket. status · string

Example:

"open"

ticket. category · string | null

Example:

"Problem"

ticket. sub_category_one · string | null

Example:

"Billing"

ticket. sub_category_two · string | null

Example:

"Refund"

ticket. group · string | null

Name of the assigned group.

Example:

"Sales"

ticket. tags · string[]

Example:

["refund", "urgent"]

ticket. assignee · object

The assigned team member. null if unassigned.

Hide child attributes

ticket.assignee. id · string

Example:

"aaaabbbb-cccc-dddd-eeee-ffff00001111"

ticket.assignee. name · string

Example:

"Oliver Smith"

ticket.assignee. email · string

Example:

"[e-mail]"

ticket. customer · object

Hide child attributes

ticket.customer. id · string

Example:

"aaaabbbb-cccc-dddd-eeee-ffff00002222"

ticket.customer. name · string

Example:

"John Luther"

ticket.customer. email · string

Example:

"[e-mail]"

ticket.customer. phone_numbers · string[]

Example:

["[phone]"]

ticket. fields · object[]

Custom ticket field values.

Hide child attributes

ticket.fields. field_name · string

Example:

"Country"

ticket.fields. field_value · string

Example:

"USA"