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/v1/public/tickets/{ticket_id} \
  --header 'X-Api-Key: <x-api-key>'

200

{
  "ticket": {
    "id": "aaaabbbb-cccc-dddd-eeee-ffff00003333",
    "number": 42,
    "subject": "How to resolve the pending payments",
    "description": "I need your help in resolving the pending payments.",
    "priority": "medium",
    "status": "open",
    "category": "Questions",
    "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"
      }
    ]
  }
}

Deprecated: This is a v1 endpoint. It will continue to work, but we recommend migrating to the v2 equivalent for improved REST compliance (correct HTTP status codes, consistent response envelopes, and hyphenated URLs).

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 to retrieve comments for. 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:

42

ticket. subject · string

Example:

"How to resolve the pending payments"

ticket. description · string

Example:

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

ticket. priority · string

Example:

"medium"

ticket. status · string

Example:

"open"

ticket. category · string | null

Example:

"Questions"

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. Absent 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"