POST

Ticket.List

Return tickets visible to the logged-in user as structured JSON. Owners/managers can see account tickets; regular members see tickets they own, are assigned to, or created. By default only type=my_tickets is returned (same as the dashboard Biz1 Support table). Send type=company_tickets for Customers Tickets. Use Ticket.Count with the same filters to get only the total count.

Permissions

User must be logged in with a valid bearer token.
Returned or changed records are limited by the user permissions, team access, folder access, and account settings.

Action

Returns Ticket rows as JSON.
Supports the documented filters and paging fields.
List responses are capped at 25 rows per call.

Push Service

No push is sent because this function only reads data or returns helper information.

Automation

No automation is run for this function.

Special Instructions

Matches dashboard customer-tickets list_json filters (search, status, team, department, customer, phone, address, open/due dates).
type defaults to my_tickets (Biz1 Support). Send type=company_tickets for Customers Tickets.
Page size is capped at 25. Use Ticket.Counts for All/Open/Closed pills (not Ticket.Count).
Ticket.Search and Ticket.UnassignedList reuse these same optional filters.

Required Parameters

No body parameters are required for this function.

Optional Parameters

Name	Type	Sample	What it gives
`type` post	string	`my_tickets`	Ticket bucket. my_tickets (default, Biz1 Support table) or company_tickets (Customers Tickets). When omitted, my_tickets is used so the count matches the dashboard main tickets list.
`start` post	int	`0`	First row offset for paging.
`limit` post	int	`25`	Maximum number of rows. Values above 25 are capped to 25. You may also send length or per_page.
`page` post	int	`1`	Alternative page number. Used only when start is not sent.
`searchh` post	string	`payment`	Search ticket id, subject, customer name, email, phone, and mobile. You may also send search, filter_data, or search[value].
`status_filter_val` post	array\|string	`1,3`	Status ids to include. You may also send status_id or status.
`team_member` post	array\|string	`47,48`	Assigned team member filter. You may also send team_member_id or assign_member_id.
`department` post	array\|string	`2`	Department ids to include.
`customer_id` post	int	`123`	Only tickets connected to this customer. You may also send cust_id.
`phone` post	string	`0500000000`	Search phone and mobile fields.
`address` post	string	`Main street`	Search address text.
`from_date` post	date	`2026-07-01`	Open date range start, inclusive. Send date filters and date values as UTC Y-m-d H:i:s when the route accepts date/time; date-only table columns store the Y-m-d date part.
`to_date` post	date	`2026-07-31`	Open date range end, inclusive. Send date filters and date values as UTC Y-m-d H:i:s when the route accepts date/time; date-only table columns store the Y-m-d date part.
`start_date_of_Due` post	date	`2026-07-01`	Due date range start, inclusive. Send date filters and date values as UTC Y-m-d H:i:s when the route accepts date/time; date-only table columns store the Y-m-d date part.
`end_date_of_Due` post	date	`2026-07-31`	Due date range end, inclusive. Send date filters and date values as UTC Y-m-d H:i:s when the route accepts date/time; date-only table columns store the Y-m-d date part.
`tickets_id_sort` post	string	`DESC`	Sort ticket id ASC or DESC. You may also send sort or order_dir.

Authentication

Send the bearer token returned by Login in the request header.

Authorization: Bearer YOUR TOKEN

Sample Request

{
    "url": "\/app\/Ticket.List",
    "method": "POST",
    "headers": {
        "Authorization": "Bearer YOUR TOKEN"
    },
    "body": {
        "limit": "25",
        "type": "my_tickets",
        "searchh": "payment",
        "status_filter_val": "1,3"
    },
    "url_user": "https:\/\/{user}.bull36.com\/app\/Ticket.List",
    "url_domain": "https:\/\/{domain}\/app\/Ticket.List"
}

Endpoint

POST /app/Ticket.List
POST https://{user}.bull36.com/app/Ticket.List
POST https://{domain}/app/Ticket.List

Sample Output

{
    "success": 1,
    "count": 10,
    "recordsTotal": 10,
    "recordsFiltered": 10,
    "total_record": 10,
    "start": 0,
    "limit": 25,
    "type": "my_tickets",
    "data": [
        {
            "id": 900,
            "ticket_id": 900,
            "subject": "Payment issue",
            "type": "my_tickets",
            "messages": []
        }
    ]
}

Count Only

Use the matching count route with the same filters when the UI only needs total rows for paging.

{
    "url": "\/app\/Ticket.Count",
    "url_user": "https:\/\/{user}.bull36.com\/app\/Ticket.Count",
    "url_domain": "https:\/\/{domain}\/app\/Ticket.Count",
    "method": "POST",
    "headers": {
        "Authorization": "Bearer YOUR TOKEN"
    },
    "body": {
        "type": "my_tickets",
        "searchh": "payment",
        "status_filter_val": "1,3"
    },
    "sample_output": {
        "success": 1,
        "count": 123
    },
    "notes": {
        "count": "Total matching tickets is returned as count, recordsTotal, recordsFiltered, and total_record. For count-only calls use Ticket.Count with the same filters."
    }
}

Count JavaScript

const token = 'YOUR TOKEN';
const body = new URLSearchParams();
body.set('type', 'my_tickets');
body.set('searchh', 'payment');
body.set('status_filter_val', '1,3');

const res = await fetch('https://{domain}/app/Ticket.Count', {
  method: 'POST',
  headers: { Authorization: `Bearer ${token}` },
  body
});
const data = await res.json();
console.log(data.count);

JavaScript Example

const token = 'YOUR TOKEN';
const body = new URLSearchParams({ limit: '25', type: 'my_tickets', searchh: 'payment' });

const res = await fetch('/app/Ticket.List', {
  method: 'POST',
  headers: { Authorization: 'Bearer ' + token },
  body
});

const data = await res.json();
console.log(data.count, data.data);

Error Example

{
    "success": "0",
    "error": "bearer_token_required",
    "message": "Authorization bearer token is required. Send header: Authorization: Bearer YOUR TOKEN"
}