Docs API Reference Issue/bff/issue/my-list

getIssueAdmin BFF

/bff/issue/my-list

Returns issues where the currently authenticated user is either the primary assignee OR the reporter, resolved across every active membership of the viewer via cas__organisation_member.user_id. This is the documented second exception to the per-org WHERE invariant (after /bff/calendar/my-overlay). Each row carries an organisation block so the admin can disambiguate issue keys that would otherwise collide across tenants (two orgs can each have a "PROJ" project independently). Filters are intentionally narrower than /list — no project / assignee / reporter / contact filters, since they conflict with the cross-org "mine" semantics.

IssuegetBffIssueMy-list

Parameters

6 query

Query parameters

· 6

statusCategoryCodestringOptional

Filter by canonical status bucket — new, progress, waiting, done. Admin-facing sentinels: active (everything except done — the operator default) and all (no status filter).

Exampleactive

prioritynumberOptional

Filter by priority (1=low..5=blocker). Rows with a NULL priority column are treated as 2 (the display fallback).

Range: 1–5

Example3

isSpambooleanOptional

Spam scope: true = only rows classified as spam, omitted = hide spam (is_spam IS NULL OR false). Same policy as /list — the default keeps the personal focus view clean.

Examplefalse

orderBystringOptional

Sort key in field:direction format. Same whitelist as /list (smart, insertedDate, updatedDate, priority, velocity, status, subject, issueKey). Unknown fields fall back to smart.

Examplesmart:asc

pagenumberOptional

Page number (1-based).

Default: 1

Example1

limitnumberOptional

Items per page.

Default: 50

Example50

Response schema

1 status code documented

200Success

itemsobject[]Required

Each array item:

idstringRequired

Issue key (e.g. "PROJ-123"), used as public identifier.

internalIdnumberRequired

Internal numeric ID.

issueKeystringRequired

Issue key.

subjectstringRequired

Issue subject/title.

prioritynumberRequired

Priority number (1=low, 2=normal, 3=high, 4=critical, 5=blocker).

priorityLabelstringRequired

Human-readable priority label.

velocitynumberRequired

Effort/complexity score (0..100). DB default 25.

Range: 0–100

typeobjectRequired

idnumberRequired

Issue type ID (pm__issue_type.id).

codestringRequired

Stable slug (story, epic, task, sub_task, bug, …). Admin resolves the localized label from its dictionary.

iconstring | nullRequired

One of 2:

Variant 1

string

Lucide icon name to render alongside the subject.

Variant 2

null

statusobjectRequired

idnumberRequired

Status ID.

labelstringRequired

Status display label (localized to the viewing organisation).

categoryIdnumberRequired

Status category ID (1=new, 2=progress, 3=waiting, 4=done).

categoryCodestringRequired

Status category code.

assigneeobject | nullRequired

One of 2:

Variant 1

idnumberRequired

Contact ID.

externalIdstring | nullRequired

One of 2:

Variant 1

string

Public contact identifier used in admin URLs (/contact/{externalId}) and in /bff/contact/detail?customerId=.... null for legacy rows that predate the external-id backfill; the UI should render the name without a link in that case.

Variant 2

null

namestringRequired

Full name.

emailstring | nullRequired

One of 2:

Variant 1

string

Contact e-mail. null for phone-only contacts (no e-mail registered) and for contacts anonymised via GDPR. UI should fall back to name or the contact ID.

Variant 2

null

avatarUrlstringOptional

Avatar image URL resolved via core__blob. Falls back through the contact's own avatar_blob_id, then the linked member user's contact avatar_blob_id. Omitted when neither has an avatar uploaded.

Variant 2

null

reporterobject | nullRequired

One of 2:

Variant 1

idnumberRequired

Contact ID.

externalIdstring | nullRequired

One of 2:

Variant 1

string

Variant 2

null

namestringRequired

Full name.

emailstring | nullRequired

One of 2:

Variant 1

string

Contact e-mail. null for phone-only contacts (no e-mail registered) and for contacts anonymised via GDPR. UI should fall back to name or the contact ID.

Variant 2

null

avatarUrlstringOptional

Avatar image URL resolved via core__blob. Falls back through the contact's own avatar_blob_id, then the linked member user's contact avatar_blob_id. Omitted when neither has an avatar uploaded.

Variant 2

null

isSpamboolean | nullRequired

One of 2:

Variant 1

boolean

Spam classification. Null = not yet classified.

Variant 2

null

securedTicketbooleanRequired

pm__issue.secured_ticket. Only ever true for rows in orgs where the viewer is root (per-org filter in selectMyIssueList).

commentsCountnumberRequired

Total comments across all author kinds.

hasAttachmentsbooleanRequired

True when the issue has at least one file attached via pm__issue_attachment. Excludes the source-e-mail relation.

isStalebooleanRequired

True when the issue is progress/waiting and has not moved in 7+ days.

insertedDateDate | string | string | numberRequired

When the issue was created.

One of 4:

Variant 1

Date

When the issue was created.

Variant 2

stringdate-time

Variant 3

stringdate

Variant 4

number

updatedDateDate | string | string | number | nullRequired

One of 2:

Variant 1

Date | string | string | number

Last update timestamp.

One of 4:

Variant 1

Date

Last update timestamp.

Variant 2

stringdate-time

Variant 3

stringdate

Variant 4

number

Variant 2

null

ipstring | nullRequired

One of 2:

Variant 1

string

User IP address (IPv4 or IPv6) or null when the origin request has no captured client IP.

When null: the record was created by a server-internal actor (cron, workflow tick, manual admin backfill, mail pipeline) rather than a real HTTP visitor, so no forwarded header was available. UI should treat null as "unknown origin" (typically hide the vikitron.com deep-link and any geolocation badges), not as loopback.

When non-null, the value is the canonicalized form described by API_IP — lowercase IPv6, IPv4-mapped IPv6 unwrapped to plain IPv4, junk collapsed to 127.0.0.1.

Examples1.1.1.12001:4860:4860::8888

Variant 2

null

geoobject | nullRequired

One of 2:

Variant 1

citystring | nullRequired

One of 2:

Variant 1

string

Variant 2

null

countryNamestring | nullRequired

One of 2:

Variant 1

string

Variant 2

null

countryCodestring | nullRequired

One of 2:

Variant 1

string

Variant 2

null

Variant 2

null

organisationobjectRequired

Owning organisation of the issue. Present only on the cross-org endpoint — the admin grid uses it to disambiguate issue keys across tenants.

idnumberRequired

cas__organisation.id — internal, useful for cross-checks.

namestringRequired

Display name of the organisation.

slugstringRequired

URL slug of the organisation.

emojistring | nullRequired

One of 2:

Variant 1

string

Optional emoji chosen by the org owner (cas__organisation.emoji). The admin grid renders it as a compact prefix in the "Organisation" chip; falls back to a text-only chip when absent.

Variant 2

null

itemCountnumberRequired

Total matching issues (for pagination).

Response example

application/json

{
  "items": [
    {
      "id": "example_id",
      "internalId": 0,
      "issueKey": "example_issueKey",
      "subject": "example_subject",
      "priority": 0,
      "priorityLabel": "example_priorityLabel",
      "velocity": 0,
      "type": {
        "id": 0,
        "code": "example_code"
      },
      "status": {
        "id": 0,
        "label": "example_label",
        "categoryId": 0,
        "categoryCode": "example_categoryCode"
      },
      "securedTicket": false,
      "commentsCount": 0,
      "hasAttachments": false,
      "isStale": false,
      "organisation": {
        "id": 0,
        "name": "example_name",
        "slug": "example_slug"
      }
    }
  ],
  "itemCount": 0
}

Request example

GET /bff/issue/my-list

get

curl -X GET "https://api.bizkithub.com/bff/issue/my-list?statusCategoryCode=active&priority=3&isSpam=false&orderBy=smart%3Aasc&page=1&limit=50" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key