4.Tickets

4.Tickets

Ticket resources represent ATS support tickets. All ticket endpoints are restricted to ATS managers.

4.1.Ticket resource fields

The following attributes appear in ticket resources. Fields marked (item only) are returned only by the single-resource endpoint, not by the list endpoint.

id (integer)

Unique ticket ID.

catid (integer)

ID of the ATS category this ticket belongs to.

title (string)

Ticket subject line. HTML tags are stripped when the ticket is saved through the API.

alias (string)

URL-safe slug derived from the title, used in SEF URLs.

status (string)

Current ticket status. Built-in values are O (Open), P (Pending — awaiting customer reply), and C (Closed). Custom numeric statuses 199 may also be present if configured on the site.

public (integer)

1 if the ticket is visible to all visitors; 0 if it is private (visible only to the ticket author and support staff).

priority (integer)

Ticket priority: 0 = High, 5 = Normal (the default), 10 = Low. This field is only meaningful when the "Ticket priorities" component option is enabled.

origin (string)

How the ticket was created. Always web for tickets created through the API. Other values (e.g. email) appear on tickets created by other means such as the mail-fetch plugin.

assigned_to (integer)

Joomla user ID of the support staff member assigned to this ticket, or 0 if unassigned.

assigned_to_info (object or null)

User information object for the assigned staff member. See Section2.6, “User information objects”.

timespent (float)

Total hours of tracked time recorded against this ticket.

language (string)

Language tag of the ticket (e.g. en-GB), or * for all languages.

tags (array)

Array of Joomla tag objects attached to this ticket. Each element is the Joomla tag object as returned by the Joomla Tags API.

created (string)

ISO 8601 date-time when the ticket was created (UTC). Example: 2026-04-01T09:23:00+00:00.

created_by (integer)

Joomla user ID of the user who filed the ticket.

created_by_info (object or null)

User information object for the ticket author. See Section2.6, “User information objects”.

modified (string)

ISO 8601 date-time of the last modification (UTC).

modified_by (integer, item only)

Joomla user ID of the user who last modified the ticket.

modified_by_info (object or null, item only)

User information object for the last editor. See Section2.6, “User information objects”.

enabled (integer)

Publication state: 1 = published, 0 = unpublished.

params (object, item only)

Ticket-level parameter overrides (e.g. per-ticket notification preferences). The structure mirrors the ticket-level parameters available in the ATS component options.

Custom fields (varies)

Any Joomla custom fields attached to the com_ats.ticket context are included as additional top-level attributes using the field name as the key and the field API value as the value. Custom field attributes are included in both list and item responses.

posts (array, item only, when requested)

Array of raw post objects belonging to this ticket. Only present when ?include=posts is appended to the single-resource URL. Each element is the raw database row for the post (not a full JSON:API resource object). Posts are ordered chronologically (oldest first) and only published posts are included.

notes (array, item only, when requested, Pro only)

Array of raw manager note objects belonging to this ticket. Only present when ?include=notes (or ?include=posts,notes) is appended to the single-resource URL. Only published notes are included, in chronological order.