Skip to content
Longport WhaleLongport Whale
Flow Tickets

Get Ticket List V2

Get Ticket List V2.

Request parameters

  • Optional: tab (Tab), id (Ticket ID), flow_key (Flow Key), actor_id (Actor ID), all (All), last_handler_id (Last Handler ID), applied_time_range (Applied Time Range), page (Page), page_size (Page Size)
  • See each field for its format, allowed values, and business meaning.

Result

On success, the endpoint completes the operation. See the 200 response schema for returned data and subsequent state information.

POSThttps://b-api.lbkrs.com/admin-api/v2/tickets

Production: https://b-api.lbkrs.com · Test: https://b-api.longbridge.xyz

Authorization

AuthorizationstringheaderRequired

Send the Broker ACCESS_TOKEN as Authorization: Bearer <token>.

Permission

No dedicated permission key. Any authenticated Broker ACCESS_TOKEN with access to this scope can call it.

Request body application/json

tabstring

Ticket category to query.

pending · Pending my approvalcreated · Created by medone · Already reviewedcc · Copied to me

idstring

Ticket ID associated with this request.

flow_keystring

Specifies Flow Key.

actor_idstring

Actor ID associated with this request.

allboolean

Boolean flag for all.

Boolean values:

  • true - The condition applies
  • false - The condition does not apply
last_handler_idstring

Last Handler ID associated with this request.

applied_time_rangestring

Specifies Applied Time Range.

pagenumber

Page number to query, starting from 1.

page_sizenumber

Maximum number of records to return per page. Use a positive integer.

Responses

HTTP 200The request was processed successfully. The response data does not contain additional business fields.
Standard response envelopecodemessagedata
dataobjectdata structure
pageinteger

Page

page_sizeinteger

Page size

ticketsarray<object>

Tickets

Child attributes
idstring

Id

flow_keystring

Flow key

flow_titlestring

Flow title

titlestring

Title

statusinteger

Status

actorobject

Actor

Child attributes
idstring

ID

namestring

Name

emailstring

Email

avatarstring

Avatar

resignedboolean

Resigned

feishu_idstring

Feishu id

callback_errorstring

Callback error

resolved_atstring

Resolved at

created_atstring

Created at

updated_atstring

Updated at

approved_payloadobject

Approved payload

rejected_payloadobject

Rejected payload

front_payloadobject

Front payload

contentstring

Content

target_typestring

Target type

target_idsarray<string>

Target ids

target_preview_urlstring

Target preview url

settingobject

Setting

timelinesarray<object>

Timelines

Child attributes
idstring

ID

typestring

Type

operatorobject

Operator

Child attributes
idstring

ID

namestring

Name

emailstring

Email

avatarstring

Avatar

resignedboolean

Resigned

feishu_idstring

Feishu id

handlersarray<object>

Handlers

Child attributes
idstring

ID

namestring

Name

emailstring

Email

avatarstring

Avatar

resignedboolean

Resigned

feishu_idstring

Feishu id

commentobject

Comment

Child attributes
bodystring

Body

deleted_atstring

Deleted at

idstring

Id

template_idstring

Template id

detail_template_idstring

Detail template id

statusinteger

Status

done_atstring

Done at

created_atstring

Created at

updated_atstring

Updated at

errorstring

Error

settingobject

Setting

capacityobject

Capacity

categorystring

Category

descriptionstring

Description

flow_node_configure_typestring

Flow node configure type

sub_titlesarray<string>

Sub titles

biz_payloadsobject

Biz payloads

HTTP 400Bad request. Check the business error code in code and the error details in message.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

HTTP 401The user is not authenticated, or the login session has expired.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

HTTP 403The current account is not authorized to use this feature. Grant the required permission to the account in User Permission.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

HTTP 408The request timed out. Check the business error code in code and the error details in message.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

Whale Docs