> For the complete documentation index, see [llms.txt](https://docs.spurtcommerce.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.spurtcommerce.com/spurtapi/spurtcommerce/store-api/account-settings/support.md).

# Support

## Get Customer Support Ticket Categories

> This API retrieves a list of customer support ticket categories based on the provided query parameters.

```json
{"openapi":"3.0.1","info":{"title":"Buyer Support Ticket API","version":"1.0.0"},"tags":[],"servers":[{"url":"http://139.59.67.17/backend/api"},{"url":"https://139.59.67.17/backend/api"}],"paths":{"/api/customer-support-ticket/ticket-category":{"get":{"tags":["Customer Support Ticket Category"],"summary":"Get Customer Support Ticket Categories","description":"This API retrieves a list of customer support ticket categories based on the provided query parameters.","parameters":[{"in":"query","name":"limit","required":false,"schema":{"type":"number"},"description":"Limit for pagination"},{"in":"query","name":"offset","required":false,"schema":{"type":"number"},"description":"Offset for pagination"},{"in":"query","name":"keyword","required":false,"schema":{"type":"string"},"description":"Search keyword to filter categories"},{"in":"query","name":"parentCategoryId","required":false,"schema":{"type":"string"},"description":"Parent Category ID to filter"},{"in":"query","name":"status","required":false,"schema":{"type":"string"},"description":"Status of the category (e.g., active, inactive)"}],"responses":{"200":{"description":"Successfully retrieved ticket categories","content":{"application/json":{}}},"500":{"description":"Failed to retrieve customer support ticket categories","content":{"application/json":{}}}}}}}}
```

## Retrieve Customer Support Tickets

> This API retrieves a list of customer support tickets based on the provided query parameters.

```json
{"openapi":"3.0.1","info":{"title":"Buyer Support Ticket API","version":"1.0.0"},"tags":[],"servers":[{"url":"http://139.59.67.17/backend/api"},{"url":"https://139.59.67.17/backend/api"}],"paths":{"/api/customer-support-ticket":{"get":{"tags":["Customer Support Ticket"],"summary":"Retrieve Customer Support Tickets","description":"This API retrieves a list of customer support tickets based on the provided query parameters.","parameters":[{"in":"query","name":"limit","required":false,"schema":{"type":"number"},"description":"Limit for the number of tickets to retrieve."},{"in":"query","name":"offset","required":false,"schema":{"type":"number"},"description":"Offset for pagination."},{"in":"query","name":"keyword","required":false,"schema":{"type":"string"},"description":"Keyword to search tickets."},{"in":"query","name":"count","required":false,"schema":{"type":"number"},"description":"A flag to specify if the count of tickets should be returned."},{"in":"header","name":"Authorization","required":true,"schema":{"type":"string"},"description":"Authorization token (Bearer)"}],"responses":{"200":{"description":"Successfully retrieved customer support tickets","content":{"application/json":{}}},"500":{"description":"Failed to retrieve customer support tickets","content":{"application/json":{}}}}}}}}
```

## Create Customer Support Ticket

> This API allows customers to create a support ticket by submitting a category, sub-category, ticket details, message, and optional attachments.

```json
{"openapi":"3.0.1","info":{"title":"Buyer Support Ticket API","version":"1.0.0"},"tags":[],"servers":[{"url":"http://139.59.67.17/backend/api"},{"url":"https://139.59.67.17/backend/api"}],"paths":{"/api/customer-support-ticket":{"post":{"tags":["Customer Support Ticket"],"summary":"Create Customer Support Ticket","description":"This API allows customers to create a support ticket by submitting a category, sub-category, ticket details, message, and optional attachments.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"categoryId":{"type":"number","description":"Category ID"},"subCategoryId":{"type":"number","description":"Sub Category ID"},"ticketId":{"type":"number","description":"Ticket ID (optional)"},"subject":{"type":"string","description":"Subject of the ticket"},"description":{"type":"string","description":"Description of the issue"},"message":{"type":"string","description":"Message body for the ticket"},"attachments":{"type":"array","items":{"type":"object","properties":{"fileName":{"type":"string","description":"Name of the attachment file"},"filePath":{"type":"string","description":"Path to the attachment file"}}},"description":"List of file attachments (optional)"}}}}}},"parameters":[{"in":"header","name":"Authorization","required":true,"schema":{"type":"string"},"description":"Authorization token (Bearer)"}],"responses":{"200":{"description":"Successfully created customer support ticket","content":{"application/json":{}}},"500":{"description":"Failed to create customer support ticket","content":{"application/json":{}}}}}}}}
```

## Get Customer Support Ticket Details

> This API retrieves the details of a specific customer support ticket based on the provided ticket ID.

```json
{"openapi":"3.0.1","info":{"title":"Buyer Support Ticket API","version":"1.0.0"},"tags":[],"servers":[{"url":"http://139.59.67.17/backend/api"},{"url":"https://139.59.67.17/backend/api"}],"paths":{"/api/customer-support-ticket/{id}":{"get":{"tags":["Customer Support Ticket"],"summary":"Get Customer Support Ticket Details","description":"This API retrieves the details of a specific customer support ticket based on the provided ticket ID.","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"number"},"description":"The ID of the customer support ticket."},{"in":"header","name":"Authorization","required":true,"schema":{"type":"string"},"description":"Authorization token (Bearer)"}],"responses":{"200":{"description":"Successfully retrieved customer support ticket details","content":{"application/json":{}}},"500":{"description":"Failed to retrieve customer support ticket","content":{"application/json":{}}}}}}}}
```

## Update Customer Support Ticket Status

> This API updates the status of a specific customer support ticket based on the provided ticket ID.

```json
{"openapi":"3.0.1","info":{"title":"Buyer Support Ticket API","version":"1.0.0"},"tags":[],"servers":[{"url":"http://139.59.67.17/backend/api"},{"url":"https://139.59.67.17/backend/api"}],"paths":{"/api/customer-support-ticket/{id}":{"put":{"tags":["Customer Support Ticket"],"summary":"Update Customer Support Ticket Status","description":"This API updates the status of a specific customer support ticket based on the provided ticket ID.","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"number"},"description":"The ID of the customer support ticket."},{"in":"body","name":"status","required":true,"schema":{"type":"number"},"description":"The status of the ticket (e.g., open, closed, resolved, etc.)."},{"in":"header","name":"Authorization","required":true,"schema":{"type":"string"},"description":"Authorization token (Bearer)"}],"responses":{"200":{"description":"Successfully updated customer support ticket status","content":{"application/json":{}}},"500":{"description":"Failed to update customer support ticket status","content":{"application/json":{}}}}}}}}
```
