> ## Documentation Index > Fetch the complete documentation index at: https://docs.cedarai.com/llms.txt > Use this file to discover all available pages before exploring further. # List class list tasks > Retrieves the list of tasks associated with specified class lists. Usage notes: - Pagination: Use pageSize, pageNextToken, and pagePrevToken to navigate paginated results. - Filtering: Combine multiple criteria (e.g., workOrderId, status, equipmentName) to narrow results. - Date ranges: carrierDateRange is assumed to be in the carrier's timezone. ## OpenAPI ````yaml /user-docs/api-reference/external-openapi.json post /ims/work-orders/class-lists/tasks openapi: 3.1.0 info: title: ARMS External API version: 1.0.0 description: >- OpenAPI specification generated from external API schemas. Endpoints require query parameter carrierId and headers x-arms-api-key and x-arms-assume-user. license: name: Proprietary url: https://cedarai.com servers: - url: https://api-lg.arms.cedarai.com description: Production (US) - url: https://api-lg.arms.cedarai.se description: Production (EU) security: - ApiKeyAuth: [] AssumeUser: [] paths: /ims/work-orders/class-lists/tasks: post: summary: List class list tasks description: >- Retrieves the list of tasks associated with specified class lists. Usage notes: - Pagination: Use pageSize, pageNextToken, and pagePrevToken to navigate paginated results. - Filtering: Combine multiple criteria (e.g., workOrderId, status, equipmentName) to narrow results. - Date ranges: carrierDateRange is assumed to be in the carrier's timezone. operationId: listClassListTasks parameters: - $ref: '#/components/parameters/CarrierId' - $ref: '#/components/parameters/ViewAsUserGroup' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ListClassListTasksInput' examples: basic: summary: Basic pagination value: carrierId: 1234 pageSize: 20 filterByWorkOrder: summary: Filter by class list ID value: carrierId: 1234 workOrderId: 5678 filterByStatus: summary: Filter by status value: carrierId: 1234 status: - NOT_STARTED - COMPLETED filterByEquipment: summary: Filter by equipment value: carrierId: 1234 equipmentName: ABC 12345 filterByTracks: summary: Filter by tracks value: carrierId: 1234 currentTrackName: Track 1 assignedTrackName: Track 5 responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ListClassListTasksOutput' '400': description: Bad Request '401': description: Unauthorized '500': description: Internal Server Error default: description: Error content: application/json: schema: $ref: '#/components/schemas/Error' components: parameters: CarrierId: name: carrierId in: query required: true schema: type: integer description: Carrier identifier; required for all endpoints ViewAsUserGroup: name: viewAsUserGroup in: query required: false schema: type: string description: Optional user group context schemas: ListClassListTasksInput: type: object properties: pageSize: type: integer minimum: 1 description: >- Number of items per page. Use with pageNextToken/pagePrevToken for pagination. pageNextToken: type: string description: >- Token to fetch the next page of results returned from a previous call. pagePrevToken: type: string description: >- Token to fetch the previous page of results returned from a previous call. carrierId: type: integer description: Carrier identifier. May also be supplied via query parameter. workOrderId: type: integer description: Class list (work order) ID to filter tasks by customerName: type: string description: Filter by customer name equipmentName: type: string description: Filter by equipment initial and number (e.g., 'XYZ 123456') equipmentIds: type: array items: type: integer description: Filter by specific equipment resource IDs taskIds: type: array items: type: integer description: Filter by specific task resource IDs status: type: array items: type: string enum: - NOT_STARTED - COMPLETED - CANCELED description: Filter by task status assignedTrackName: type: string description: Filter by assigned track name finalTrackName: type: string description: Filter by final track name currentTrackName: type: string description: Filter by current track name carrierDateRange: $ref: '#/components/schemas/DateRange' description: Date range assumed to be in the carrier timezone required: - carrierId ListClassListTasksOutput: type: object properties: tasks: type: array items: $ref: '#/components/schemas/ClassListTask' description: List of tasks matching the filter criteria statusCode: type: integer nextToken: type: string description: Token to fetch the next page of results prevToken: type: string description: Token to fetch the previous page of results required: - tasks - statusCode Error: type: object properties: message: type: string DateRange: type: object properties: startDate: type: string format: date description: Start date of the range endDate: type: string format: date description: End date of the range ClassListTask: type: object description: >- A task within a class list representing a switching operation for a single piece of equipment. properties: resourceId: type: integer uuid: type: string description: UUID that complements the legacy numeric resourceId. carrier: $ref: '#/components/schemas/CarrierResource' equipment: $ref: '#/components/schemas/EquipmentResource' equipmentId: type: integer description: Equipment resource ID taskType: type: string enum: - SWITCH description: Type of task (always SWITCH for class lists) status: type: string enum: - NOT_STARTED - COMPLETED - CANCELED description: Status of the task currentTrack: $ref: '#/components/schemas/GroupingResource' assignedTrack: $ref: '#/components/schemas/GroupingResource' assignedSpot: $ref: '#/components/schemas/SpotResource' finalTrack: $ref: '#/components/schemas/GroupingResource' finalSpot: $ref: '#/components/schemas/SpotResource' createdAt: type: string format: date-time description: When the task was created completedAt: type: string format: date-time description: When the task was completed customer: $ref: '#/components/schemas/CustomerResource' CarrierResource: type: object properties: resourceType: type: string enum: - Carrier resourceId: type: integer uuid: type: string description: UUID that complements the legacy numeric resourceId. carrierCode: type: string name: type: string EquipmentResource: type: object properties: resourceType: type: string enum: - Equipment resourceId: type: integer uuid: type: string description: UUID that complements the legacy numeric resourceId. equipmentInitial: type: string equipmentNumber: type: integer GroupingResource: type: object properties: resourceType: type: string enum: - Grouping resourceId: type: integer uuid: type: string description: UUID that complements the legacy numeric resourceId. name: type: string groupingType: type: string sortOrder: type: integer colorToken: type: string SpotResource: type: object properties: resourceType: type: string enum: - Spot resourceId: type: integer uuid: type: string description: UUID that complements the legacy numeric resourceId. name: type: string CustomerResource: type: object properties: resourceType: type: string enum: - Customer resourceId: type: integer uuid: type: string description: UUID that complements the legacy numeric resourceId. name: type: string securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-arms-api-key description: Your ARMS API key AssumeUser: type: apiKey in: header name: x-arms-assume-user description: Email of a user assigned to the appropriate user group ````