atoms_list_items

List items in an ATOMS project with optional type, domain, and level filters. Returns paginated results sorted by creation date.

Parameters

Parameter	Type	Required	Description
`project_id`	`string (UUID)`	Yes	The project to list items from
`type`	`string`	No	Filter by item type: `requirement`, `test-case`, `note`, or `table`
`domain`	`string`	No	Filter by domain tag
`level`	`string`	No	Filter by level: `System`, `Subsystem`, or `Component`
`limit`	`number`	No	Max results per page (1-200). Default: `50`
`offset`	`number`	No	Pagination offset. Default: `0`

Example Response

{
  "status": "success",
  "data": [
    {
      "id": "REQ-001",
      "type": "requirement",
      "title": "System shall maintain audit trail",
      "summary": "All user actions must be logged with timestamp and actor",
      "domains": ["security", "compliance"],
      "level": "System"
    },
    {
      "id": "TC-012",
      "type": "test-case",
      "title": "Verify audit log entries are created on login",
      "summary": "Confirm that a log entry is written after successful authentication",
      "domains": ["security"],
      "level": "System"
    }
  ],
  "meta": {
    "total_count": 142,
    "limit": 50,
    "offset": 0,
    "has_more": true
  }
}

Notes

This tool is read-only and does not modify any data (readOnlyHint: true).
Use the offset parameter together with limit to paginate through large result sets. Check meta.has_more to determine if additional pages exist.
Omit all optional filters to retrieve every item in the project.
Combine filters to narrow results : for example, set type to requirement and level to System to list only system-level requirements.

Parameters

Example Response

Notes

On this page