--- title: "Lists all the backlog items" method: GET path: "/api/backlog_items" tags: ["Backlog Items"] --- # Lists all the backlog items `GET /api/backlog_items` ## Request - Base URL: `https://api.atono.io` - URL: `https://api.atono.io/api/backlog_items` - Auth: API key in header `X-API-KEY` ## Query parameters - `include` BacklogItemControllerInclusionType[], required - `filter` BacklogItemControllerRequestFilter, required - `savedViewId` string, uuid, nullable - `assigneeIds` string, nullable - `createdAt` string, nullable - `cycleTimeMode` 'NORMAL' | 'OUTLIER' - `doneAt` string, nullable - `environmentIds` string, nullable - `excludeLinkedItemId` string, uuid, nullable - `externalId` string, nullable - `keywordSearch` string, nullable - `productThemeIds` string, nullable - `epicIds` string, nullable - `riskRating` string, nullable - `sizeIds` string, nullable - `sprintIds` string, nullable - `stepIds` string, nullable - `teamIds` string, nullable - `teams` 'ALL' | 'ACTIVE' | 'PUBLIC' | 'SPECIFIED' | 'USER_RELATED' | 'USER_RELATED_WITH_DELETED' - `timeboxIds` string, nullable - `triageGroup` 'TRIAGE' | 'NOT_TRIAGED' | 'INFO_REQUIRED' | 'REJECTED' - `type` string, nullable - `updatedAt` string, nullable - `isFollowedByUser` string, uuid, nullable - `isNotFollowedByUser` string, uuid, nullable - `tagValueIds` string, nullable - `tagIds` string, nullable - `excludeTagValueIds` string, nullable - `excludeTagIds` string, nullable - `page` PageFilter, required - `page[number]` integer, nullable: Returns a specific page of results, starting from page `0`. Use with `page[size]` to control how many items are returned per page. For example, if `page[size]` is `20`, then `page[number]=2` returns items 21-40. - `page[size]` integer, nullable: Controls how many items are returned in each response page. - `page[offset]` integer, nullable: Skips the specified number of items before starting the result set. For example, if `page[offset]` is `30` and `page[size]` is `10`, the response returns items 31-40. - `sort` string[], required - `privateItemsAtEnd` boolean, required ## Response `200` listBacklogItems 200 response - MultiResourceBodyBacklogItemResource - `data` BacklogItemResource[]: A list of returned resources, based on the request. - `type` string, required - `id` string, uuid, required - `attributes` BacklogItemResourceBacklogItemAttributes, required - `title` string, required - `handle` string, required - `position` integer, required - `deleted` boolean, required - `itemType` 'STORY' | 'BUG' | 'TASK' | 'VULNERABILITY' | 'EPIC', required - `createdAt` string, date-time, required - `updatedAt` string, date-time, required - `triage` 'NOT_TRIAGED' | 'TRIAGED' | 'REJECTED' | 'INFO_REQUIRED', required - `cycleTimeMode` 'NORMAL' | 'OUTLIER', required - `stalenessIndicatorSnoozeUntil` string, date-time, required - `doneAt` string, date-time, required - `externalId` string, required - `content` ContentChunk[], nullable, required - `type` 'DISPLAY_HTML' | 'TEXT' | 'PERSONA', required: The type of content chunk. - `DISPLAY_HTML`: HTML-formatted content. - `TEXT`: Plain text content. - `PERSONA`: A persona for a user story. - `value` string, required: The content in this chunk. - `additionalContent` ContentChunk[], nullable, required - `type` 'DISPLAY_HTML' | 'TEXT' | 'PERSONA', required: The type of content chunk. - `DISPLAY_HTML`: HTML-formatted content. - `TEXT`: Plain text content. - `PERSONA`: A persona for a user story. - `value` string, required: The content in this chunk. - `sizingMode` 'MANUAL' | 'USE_SUGGESTION', required - `epicPosition` integer, nullable, required - `relationships` BacklogItemResourceBacklogItemRelationships, required - `creator` SingleRelationship, required - `links` RelationshipLinks, required - `self` string, uri, nullable, required - `related` string, uri, nullable, required - `data` ResourceIdentifier, required - `type` string, required: Identifies the type of the linked resource. - `id` string, required: The unique identifier of the linked resource. - `meta` unknown, required - `workflowStep` SingleRelationship, required - `links` RelationshipLinks, required - `self` string, uri, nullable, required - `related` string, uri, nullable, required - `data` ResourceIdentifier, required - `type` string, required: Identifies the type of the linked resource. - `id` string, required: The unique identifier of the linked resource. - `meta` unknown, required - `assignee` SingleRelationship, required - `links` RelationshipLinks, required - `self` string, uri, nullable, required - `related` string, uri, nullable, required - `data` ResourceIdentifier, required - `type` string, required: Identifies the type of the linked resource. - `id` string, required: The unique identifier of the linked resource. - `meta` unknown, required - `acceptanceCriteria` MultipleRelationships, required - `links` RelationshipLinks, required - `self` string, uri, nullable, required - `related` string, uri, nullable, required - `data` ResourceIdentifier[], nullable, required - `type` string, required: Identifies the type of the linked resource. - `id` string, required: The unique identifier of the linked resource. - `meta` unknown, required - `attachments` MultipleRelationships, required - `links` RelationshipLinks, required - `self` string, uri, nullable, required - `related` string, uri, nullable, required - `data` ResourceIdentifier[], nullable, required - `type` string, required: Identifies the type of the linked resource. - `id` string, required: The unique identifier of the linked resource. - `meta` unknown, required - `comments` MultipleRelationships, required - `links` RelationshipLinks, required - `self` string, uri, nullable, required - `related` string, uri, nullable, required - `data` ResourceIdentifier[], nullable, required - `type` string, required: Identifies the type of the linked resource. - `id` string, required: The unique identifier of the linked resource. - `meta` unknown, required - `featureFlag` SingleRelationship, required - `links` RelationshipLinks, required - `self` string, uri, nullable, required - `related` string, uri, nullable, required - `data` ResourceIdentifier, required - `type` string, required: Identifies the type of the linked resource. - `id` string, required: The unique identifier of the linked resource. - `meta` unknown, required - `team` SingleRelationship, required - `links` RelationshipLinks, required - `self` string, uri, nullable, required - `related` string, uri, nullable, required - `data` ResourceIdentifier, required - `type` string, required: Identifies the type of the linked resource. - `id` string, required: The unique identifier of the linked resource. - `meta` unknown, required - `impact` SingleRelationship, required - `links` RelationshipLinks, required - `self` string, uri, nullable, required - `related` string, uri, nullable, required - `data` ResourceIdentifier, required - `type` string, required: Identifies the type of the linked resource. - `id` string, required: The unique identifier of the linked resource. - `meta` unknown, required - `probability` SingleRelationship, required - `links` RelationshipLinks, required - `self` string, uri, nullable, required - `related` string, uri, nullable, required - `data` ResourceIdentifier, required - `type` string, required: Identifies the type of the linked resource. - `id` string, required: The unique identifier of the linked resource. - `meta` unknown, required - `size` SingleRelationship, required - `links` RelationshipLinks, required - `self` string, uri, nullable, required - `related` string, uri, nullable, required - `data` ResourceIdentifier, required - `type` string, required: Identifies the type of the linked resource. - `id` string, required: The unique identifier of the linked resource. - `meta` unknown, required - `environments` MultipleRelationships, required - `links` RelationshipLinks, required - `self` string, uri, nullable, required - `related` string, uri, nullable, required - `data` ResourceIdentifier[], nullable, required - `type` string, required: Identifies the type of the linked resource. - `id` string, required: The unique identifier of the linked resource. - `meta` unknown, required - `linkedItems` MultipleRelationships, required - `links` RelationshipLinks, required - `self` string, uri, nullable, required - `related` string, uri, nullable, required - `data` ResourceIdentifier[], nullable, required - `type` string, required: Identifies the type of the linked resource. - `id` string, required: The unique identifier of the linked resource. - `meta` unknown, required - `timebox` SingleRelationship, required - `links` RelationshipLinks, required - `self` string, uri, nullable, required - `related` string, uri, nullable, required - `data` ResourceIdentifier, required - `type` string, required: Identifies the type of the linked resource. - `id` string, required: The unique identifier of the linked resource. - `meta` unknown, required - `sprint` SingleRelationship, required - `links` RelationshipLinks, required - `self` string, uri, nullable, required - `related` string, uri, nullable, required - `data` ResourceIdentifier, required - `type` string, required: Identifies the type of the linked resource. - `id` string, required: The unique identifier of the linked resource. - `meta` unknown, required - `productTheme` SingleRelationship, required - `links` RelationshipLinks, required - `self` string, uri, nullable, required - `related` string, uri, nullable, required - `data` ResourceIdentifier, required - `type` string, required: Identifies the type of the linked resource. - `id` string, required: The unique identifier of the linked resource. - `meta` unknown, required - `vcsPullRequests` MultipleRelationships, required - `links` RelationshipLinks, required - `self` string, uri, nullable, required - `related` string, uri, nullable, required - `data` ResourceIdentifier[], nullable, required - `type` string, required: Identifies the type of the linked resource. - `id` string, required: The unique identifier of the linked resource. - `meta` unknown, required - `epic` SingleRelationship, required - `links` RelationshipLinks, required - `self` string, uri, nullable, required - `related` string, uri, nullable, required - `data` ResourceIdentifier, required - `type` string, required: Identifies the type of the linked resource. - `id` string, required: The unique identifier of the linked resource. - `meta` unknown, required - `epicStories` MultipleRelationships, required - `links` RelationshipLinks, required - `self` string, uri, nullable, required - `related` string, uri, nullable, required - `data` ResourceIdentifier[], nullable, required - `type` string, required: Identifies the type of the linked resource. - `id` string, required: The unique identifier of the linked resource. - `meta` unknown, required - `subtasks` MultipleRelationships, required - `links` RelationshipLinks, required - `self` string, uri, nullable, required - `related` string, uri, nullable, required - `data` ResourceIdentifier[], nullable, required - `type` string, required: Identifies the type of the linked resource. - `id` string, required: The unique identifier of the linked resource. - `meta` unknown, required - `tagValues` MultipleRelationships, required - `links` RelationshipLinks, required - `self` string, uri, nullable, required - `related` string, uri, nullable, required - `data` ResourceIdentifier[], nullable, required - `type` string, required: Identifies the type of the linked resource. - `id` string, required: The unique identifier of the linked resource. - `meta` unknown, required - `meta` BacklogItemResourceBacklogItemMetadata, required - `state` 'REGULAR' | 'SAMPLE_DATA' | 'JIRA_SYNC', required: Represents the state of an entity in the system. - `riskRating` BacklogItemRiskRating, required - `rating` integer, required - `impact` integer, required - `probability` integer, required - `allowedActions` string[], required - `isFollowedItem` boolean, nullable, required - `subtaskCount` BacklogItemResourceSubtaskCount, required - `undone` integer, required - `syncDate` string, date-time, nullable, required - `syncStatus` 'IN_PROGRESS' | 'COMPLETED' | 'FAILED' | 'JIRA_NEWER' | 'UNSYNCED', required - `jiraUpdatedAt` string, date-time, nullable, required - `errors` ProblemDetail[]: A list of errors returned with the response, if the request could not be completed. Each object includes details about a specific issue. - `id` string: A unique identifier for this specific error occurrence. Useful for debugging and support. - `links` object, nullable: Links related to the error. May include a URL to relevant documentation or support resources. - `status` integer: The HTTP status code associated with the error (e.g., 400, 404, 422). - `code` string: An internal code that identifies the type or category of the error. - `title` string: A short summary of the problem. - `source` ProblemSource: Identifies the part of the request that caused the error. Only one source is present per error. - `pointer` string, nullable: Specifies the path to the field in the request body that caused the error. - `parameter` string, nullable: Identifies a query parameter in the request URL that caused the error. - `header` string, nullable: Identifies the request header that caused the error. - `detail` string: Additional information about the error, intended to provide more context than the title. - `meta` unknown - `meta` unknown - `included` unknown[]: A list of related resources included in the response, either automatically by the API or in response to an `include` parameter in the request. Each item contains a full resource object (e.g., users, teams, acceptance criteria). - unknown - `links` unknown --- [API](https://skmtc.dev/atono/apis/backend-api.md) · [All operations](https://skmtc.dev/atono/apis/backend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/atono/apis/backend-api/revisions/78a57b1d8c3d?raw)