get_coverage_summary_by_serial
Retrieve brief coverage status and key dates for up to 75 Cisco device serial numbers to quickly check warranty or support eligibility.
Instructions
Get summary coverage information for up to 75 serial numbers. Returns brief coverage status and key dates. Use this for quick coverage lookups without full details.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| serial_numbers | Yes | Comma-separated list of serial numbers (max 75, e.g., "SAL09232Q0Z,FOC0903N5J9,INM07501EC3") | |
| page_index | No | Page number for pagination (starts at 1) |
Implementation Reference
- src/apis/serial-api.ts:118-126 (handler)Handler logic for the 'get_coverage_summary_by_serial' tool: parses comma-separated serial numbers, constructs the API endpoint '/coverage/summary/serial_numbers/{serialNumbers}', sets pagination params, and calls makeApiCall to retrieve coverage summary data.case 'get_coverage_summary_by_serial': { const serialNumbers = (processedArgs.serial_numbers as string) .split(',') .map(s => s.trim()) .join(','); const endpoint = `/coverage/summary/serial_numbers/${serialNumbers}`; const params = { page_index: processedArgs.page_index }; return await this.makeApiCall(endpoint, params) as SerialApiResponse; }
- src/apis/serial-api.ts:59-79 (registration)Tool registration in the getTools() method of SerialApi class, defining the tool name, description, and input schema for validating serial numbers and optional page_index.{ name: 'get_coverage_summary_by_serial', description: 'Get summary coverage information for up to 75 serial numbers. Returns brief coverage status and key dates. Use this for quick coverage lookups without full details.', inputSchema: { type: 'object', properties: { serial_numbers: { type: 'string', description: 'Comma-separated list of serial numbers (max 75, e.g., "SAL09232Q0Z,FOC0903N5J9,INM07501EC3")', pattern: '^[A-Za-z0-9,\\s]+$' }, page_index: { type: 'integer', description: 'Page number for pagination (starts at 1)', minimum: 1, default: 1 } }, required: ['serial_numbers'] } },
- src/apis/serial-api.ts:6-30 (schema)Output schema definition (SerialApiResponse interface) used by the tool to type the API response, including serial number details and pagination info.export interface SerialApiResponse extends ApiResponse { serial_numbers?: Array<{ sr_no?: string; sr_no_list?: string[]; is_valid?: string; base_pid?: string; orderable_pid?: string; item_description?: string; item_type?: string; instance_id?: number; warranty_type?: string; warranty_end_date?: string; covered_product_line_end_date?: string; is_covered?: string; service_contract_number?: string; service_line_descr?: string; parent_sr_no?: string; }>; pagination_response_record?: { page_index?: number; page_records?: number; total_records?: number; last_index?: number; }; }