Lectico
GET
/v1/tickets

Authorization

AuthorizationBearer <token>

Preferred. Pass your API key as Authorization: Bearer sk_live_... (or sk_test_... for sandbox). Keys are created in the Lectico admin panel under API keys.

In: header

Query Parameters

limit?integer

Max results per page (1 - 100, default 20).

Default20
Range1 <= value <= 100
starting_after?string

Cursor from the previous response's meta.pagination.next_cursor.

status?array<>

Filter by one or more ticket statuses. Repeat to OR: ?status=open&status=pending_user. Omit for all statuses.

priority?array<>

Filter by one or more priorities (multi-value).

agent_id?string

Filter tickets from a specific agent (assistant).

assigned_to?string

Filter by assigned workspace member UID.

visitor_email?string
Formatemail
created_after?string
Formatdate-time
created_before?string
Formatdate-time
include?array<>

Opt-in response expansions. total_count populates meta.pagination.total_count. Omit to skip the extra count query for performance.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.lectico.com/v1/tickets"
{
  "meta": {
    "request_id": "req_abc123xyz",
    "pagination": {
      "has_more": true,
      "next_cursor": "string"
    }
  },
  "data": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "public_id": "tck_b7d2a1c4f8e9",
      "agent_id": "string",
      "course_id": "string",
      "conversation_id": "string",
      "lead_id": "9bddab70-98e6-43a9-8f32-c9788b9de0c0",
      "status": "open",
      "priority": "low",
      "subject": "string",
      "visitor_name": "string",
      "visitor_email": "user@example.com",
      "origin": "widget_button",
      "page_url": "http://example.com",
      "user_agent": "string",
      "assigned_to": "string",
      "tags": [],
      "metadata": {},
      "first_response_at": "2019-08-24T14:15:22Z",
      "resolved_at": "2019-08-24T14:15:22Z",
      "last_activity_at": "2019-08-24T14:15:22Z",
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z"
    }
  ]
}
{
  "error": {
    "type": "invalid_request",
    "code": "invalid_limit",
    "message": "string",
    "param": "string",
    "doc_url": "http://example.com"
  },
  "meta": {
    "request_id": "req_abc123xyz",
    "pagination": {
      "has_more": true,
      "next_cursor": "string"
    }
  }
}
{
  "error": {
    "type": "invalid_request",
    "code": "invalid_limit",
    "message": "string",
    "param": "string",
    "doc_url": "http://example.com"
  },
  "meta": {
    "request_id": "req_abc123xyz",
    "pagination": {
      "has_more": true,
      "next_cursor": "string"
    }
  }
}
{
  "error": {
    "type": "invalid_request",
    "code": "invalid_limit",
    "message": "string",
    "param": "string",
    "doc_url": "http://example.com"
  },
  "meta": {
    "request_id": "req_abc123xyz",
    "pagination": {
      "has_more": true,
      "next_cursor": "string"
    }
  }
}
{
  "error": {
    "type": "invalid_request",
    "code": "invalid_limit",
    "message": "string",
    "param": "string",
    "doc_url": "http://example.com"
  },
  "meta": {
    "request_id": "req_abc123xyz",
    "pagination": {
      "has_more": true,
      "next_cursor": "string"
    }
  }
}