> ## Documentation Index > Fetch the complete documentation index at: https://developers.cmicglobal.com/llms.txt > Use this file to discover all available pages before exploring further. # Master Records By Query Filters > # Get Change Order Masters (List API) ## Overview Returns a **paginated list of PO Change Order master (header) records only**, without any detail lines. This API is used when you need header-level information about change orders — such as vendor, status, amounts, and dates — without the overhead of fetching line items. Sourced from `PO_COMAST_API_V`. --- ## Notes - Pagination is supported using `limit` and `offset`. - At least **one filter parameter** is required. Requests with no filters return `400 Bad Request`. - All string filter values are automatically **uppercased** before being applied. - Results can be sorted using `orderBy`. Accepted sort keys: `companyCode`, `poNumber`, `coNumber`, `releaseNumber`, `createDate`, `updateDate`, `oraseq`. Append `DESC` for descending order. - Maximum `limit` is **200**. Values above 200 are clamped to 200. - Authentication is required to access this endpoint. --- ## UI Navigation **Asset Management → Purchase Orders → Change Orders** --- ## View Objects | Section | View Object | Database View | | --- | --- | --- | | Header | `PoComastViewObj` | `PO_COMAST_API_V` | --- ## Finders | Finder | Parameter | Description | | --- | --- | --- | | Filter by Company | `companyCode` | Filters by company code (`POCOH_COMP_CODE`) | | Filter by PO Number | `poNumber` | Filters by purchase order number (`POCOH_PO_NUM`) | | Filter by CO Number | `coNumber` | Filters by change order number (`POCOH_NUM`) | | Filter by Release | `releaseNumber` | Filters by release number (`POCOH_RELEASE_NUM`) — must be a valid integer | | Audit Date | `auditDate` | Returns records where the later of create date / update date ≥ supplied date. Format: `YYYY-MM-DD` | --- ## HTTP Method & Endpoint **Method:** GET **Endpoint:** ``` /po-rest-api/jersey/v1/po-change-order/master ``` --- ## Path Parameters | Parameter | Description | Example | | --- | --- | --- | | N/A | This endpoint does not require path parameters | N/A | --- ## Query Parameters | Field | Type | Required | Default | Description | | --- | --- | --- | --- | --- | | companyCode | String | Conditional\* | — | Company code filter | | poNumber | String | Conditional\* | — | Purchase order number filter | | coNumber | String | Conditional\* | — | Change order number filter | | releaseNumber | Integer | Conditional\* | — | Release number filter (must be a valid integer) | | auditDate | String | Conditional\* | — | Audit date filter in `YYYY-MM-DD` format | | limit | Integer | No | 25 | Number of records to return (max 200) | | offset | Integer | No | 0 | Starting index of records | | orderBy | String | No | — | Sort field and direction e.g. `createDate DESC` | > <p >\* At least one filter parameter is required.</p> --- ## Example Request ``` /po-rest-api/jersey/v1/po-change-order/master?companyCode=QAT&limit=25&offset=0 /po-rest-api/jersey/v1/po-change-order/master?companyCode=QAT&poNumber=PO000004&orderBy=coNumber DESC /po-rest-api/jersey/v1/po-change-order/master?auditDate=2024-01-01&limit=50 ``` --- ## Attributes The response contains an **items** array. Each object in the array represents one change order master record. | CMiC UI Fieldname | Object | Name | Description | Type | Data Length | Example | Mandatory | | --- | --- | --- | --- | --- | --- | --- | --- | | PocohVUuid | changeOrderHeader | pocohVUuid | Unique virtual identifier for the change order header | String | 64 | 4E69C78976F5FD36E0630B811DAC6604 | System Generated | | PocohCompCode | changeOrderHeader | pocohCompCode | Company code the change order belongs to | String | 8 | QAT | True | | PocohCompName | changeOrderHeader | pocohCompName | Full name of the company | String | 60 | QAT Company | False | | PocohPoNum | changeOrderHeader | pocohPoNum | Parent purchase order number | String | 20 | PO000004 | True | | PocohNum | changeOrderHeader | pocohNum | Change order number | String | 10 | 1 | True | | PocohReleaseNum | changeOrderHeader | pocohReleaseNum | PO release number | Number | 10 | 1 | True | | PocohBchNum | changeOrderHeader | pocohBchNum | Batch number | Number | 10 | 42 | False | | PocohVenCode | changeOrderHeader | pocohVenCode | Vendor code | String | 16 | AETNA | False | | PocohVenName | changeOrderHeader | pocohVenName | Vendor full name | String | 60 | Aetna Insurance | False | | PocohDeptCode | changeOrderHeader | pocohDeptCode | Department code | String | 6 | ADMIN | False | | PocohDeptName | changeOrderHeader | pocohDeptName | Department name | String | 60 | Administration | False | | PocohExptdDate | changeOrderHeader | pocohExptdDate | Expected delivery date | Date | N/A | 2024-03-31 | False | | PocohOrdDate | changeOrderHeader | pocohOrdDate | Date the order was placed | Date | N/A | 2024-01-15 | False | | PocohRecDate | changeOrderHeader | pocohRecDate | Actual receive date | Date | N/A | 2024-04-05 | False | | PocohTypeCode | changeOrderHeader | pocohTypeCode | PO type code (e.g. S = Standard) | String | 1 | S | False | | PocohAdjCode | changeOrderHeader | pocohAdjCode | Adjustment code | String | 1 | A | False | | PocohStatCode | changeOrderHeader | pocohStatCode | Status code (R = Released, C = Closed) | String | 1 | R | False | | PocohChgCode | changeOrderHeader | pocohChgCode | Change code | String | 16 | MOD | False | | PocohTermCode | changeOrderHeader | pocohTermCode | Payment term code | String | 8 | NET30 | False | | PocohTermName | changeOrderHeader | pocohTermName | Payment term description | String | 30 | Net 30 Days | False | | PocohCurrCode | changeOrderHeader | pocohCurrCode | Currency code | String | 3 | US | False | | PocohCurrName | changeOrderHeader | pocohCurrName | Currency name | String | 30 | US Dollar | False | | PocohFobCode | changeOrderHeader | pocohFobCode | Freight on board code | String | 8 | DEST | False | | PocohBuyCode | changeOrderHeader | pocohBuyCode | Buyer code | String | 8 | JSMITH | False | | PocohAddCode | changeOrderHeader | pocohAddCode | Ship-to address code | String | 10 | MAIN | False | | PocohAddName | changeOrderHeader | pocohAddName | Ship-to address name | String | 60 | Main Office | False | | PocohShplneCode | changeOrderHeader | pocohShplneCode | Shipping line code | String | 8 | FEDEX | False | | PocohShpmetCode | changeOrderHeader | pocohShpmetCode | Shipping method code | String | 8 | GROUND | False | | PocohShpinstDesc | changeOrderHeader | pocohShpinstDesc | Shipping instructions description | String | 240 | Handle with care | False | | PocohDesc1 | changeOrderHeader | pocohDesc1 | Change order description line 1 | String | 60 | Office supplies amendment | False | | PocohDesc2 | changeOrderHeader | pocohDesc2 | Change order description line 2 | String | 60 | Additional items added | False | | PocohAdjPrice | changeOrderHeader | pocohAdjPrice | Adjusted price total | Number | 10,2 | 1250.00 | False | | PocohUnadjPrice | changeOrderHeader | pocohUnadjPrice | Unadjusted price total | Number | 10,2 | 1200.00 | False | | PocohCurrConvNum | changeOrderHeader | pocohCurrConvNum | Currency conversion number | Number | 10,6 | 1.0 | False | | PocohCostedCode | changeOrderHeader | pocohCostedCode | Costed code | String | 1 | Y | False | | PocohRefNum | changeOrderHeader | pocohRefNum | Reference number | String | 20 | REF-2024-001 | False | | PocohRefDate | changeOrderHeader | pocohRefDate | Reference date | Date | N/A | 2024-01-10 | False | | PocohReqCode | changeOrderHeader | pocohReqCode | Requisition code | String | 8 | REQ001 | False | | PocohRecCode | changeOrderHeader | pocohRecCode | Receiving code | String | 1 | P | False | | PocohReprintDate | changeOrderHeader | pocohReprintDate | Last reprint date | Date | N/A | 2024-02-20 | False | | PocohWipAccCode | changeOrderHeader | pocohWipAccCode | WIP account code | String | 8 | WIP-01 | False | | PocohWipAccName | changeOrderHeader | pocohWipAccName | WIP account name | String | 60 | Work In Progress 01 | False | | PocohWipDeptCode | changeOrderHeader | pocohWipDeptCode | WIP department code | String | 6 | WIPD01 | False | | PocohWipDeptName | changeOrderHeader | pocohWipDeptName | WIP department name | String | 60 | WIP Department 01 | False | | PocohBilltoAddCode | changeOrderHeader | pocohBilltoAddCode | Bill-to address code | String | 10 | BILLTO01 | False | | PocohReqReason | changeOrderHeader | pocohReqReason | Requisition reason text | String | 240 | Price adjustment | False | | PocohInvTypeCode | changeOrderHeader | pocohInvTypeCode | Invoice type code | String | 8 | STD | False | | PocohImageFilename | changeOrderHeader | pocohImageFilename | Attached image filename | String | 60 | co_signed.pdf | False | | PocohInvSerCode | changeOrderHeader | pocohInvSerCode | Invoice serial code | String | 4 | SER001 | False | | PocohVendOrderAddCode | changeOrderHeader | pocohVendOrderAddCode | Vendor ordering address code | String | 10 | VEND-ADDR-01 | False | | PocohComplianceFlag | changeOrderHeader | pocohComplianceFlag | Compliance flag (Y/N) | String | 1 | Y | False | | PocohJobCompCode | changeOrderHeader | pocohJobCompCode | Job company code | String | 8 | QAT | False | | PocohJobCompName | changeOrderHeader | pocohJobCompName | Job company name | String | 60 | QAT Company | False | | PocohJobCode | changeOrderHeader | pocohJobCode | Job code | String | 16 | JOB001 | False | | PocohJobName | changeOrderHeader | pocohJobName | Job name | String | 60 | Office Renovation | False | | PocohContactCode | changeOrderHeader | pocohContactCode | Vendor contact code | String | 8 | CONT01 | False | | PocohAddCompCode | changeOrderHeader | pocohAddCompCode | Address company code | String | 8 | QAT | False | | PocohAddCompName | changeOrderHeader | pocohAddCompName | Address company name | String | 60 | QAT Company | False | | PocohPrintDate | changeOrderHeader | pocohPrintDate | Date the CO was printed | Date | N/A | 2024-01-16 | False | | PocohDefaultRecCode | changeOrderHeader | pocohDefaultRecCode | Default receiving code | String | 1 | F | False | | PocohDate | changeOrderHeader | pocohDate | Change order date | Date | N/A | 2024-01-15 | False | | PocohPoTotal | changeOrderHeader | pocohPoTotal | Total amount of the purchase change order | Number | 10,2 | 37 | False | | PocohManPoRecFlag | changeOrderHeader | pocohManPoRecFlag | Manual PO receipt flag (Y/N) | String | 1 | N | False | | PocohAcctDescription | changeOrderHeader | pocohAcctDescription | Account description | String | 60 | Operating Expenses | False | | PocohLumpSumPoFlag | changeOrderHeader | pocohLumpSumPoFlag | Indicates lump sum PO (Y/N) | String | 1 | N | False | | PocohLumpSumPoAmt | changeOrderHeader | pocohLumpSumPoAmt | Lump sum PO amount | Number | 10,2 | 0.00 | False | | PocohVenTax1 | changeOrderHeader | pocohVenTax1 | Vendor tax code 1 | String | 8 | HST | False | | PocohVenTax2 | changeOrderHeader | pocohVenTax2 | Vendor tax code 2 | String | 8 | — | False | | PocohVenTax3 | changeOrderHeader | pocohVenTax3 | Vendor tax code 3 | String | 8 | — | False | | PocohJobTax1 | changeOrderHeader | pocohJobTax1 | Job tax code 1 | String | 8 | HST | False | | PocohJobTax2 | changeOrderHeader | pocohJobTax2 | Job tax code 2 | String | 8 | — | False | | PocohJobTax3 | changeOrderHeader | pocohJobTax3 | Job tax code 3 | String | 8 | — | False | | PocohDiscountPct | changeOrderHeader | pocohDiscountPct | Discount percentage | Number | 6,2 | 5.00 | False | | PocohBlkLineItemsFlag | changeOrderHeader | pocohBlkLineItemsFlag | Block individual line item edits (Y/N) | String | 1 | N | False | | PocohSelectFlag | changeOrderHeader | pocohSelectFlag | Record selection flag | String | 1 | Y | False | | PocohIuCreateDate | changeOrderHeader | pocohIuCreateDate | Record creation timestamp (ISO-8601) | Timestamp | N/A | 2013-11-14T14:25:45-05:00 | System Generated | | PocohIuCreateUser | changeOrderHeader | pocohIuCreateUser | User who created the record | String | 30 | DA | System Generated | | PocohIuUpdateDate | changeOrderHeader | pocohIuUpdateDate | Record last update timestamp (ISO-8601) | Timestamp | N/A | 2014-08-18T09:45:37-04:00 | System Generated | | PocohIuUpdateUser | changeOrderHeader | pocohIuUpdateUser | User who last updated the record | String | 30 | DA | System Generated | --- ## OpenAPI ````json GET /po-rest-api/jersey/v1/purchase-change-order/master { "openapi": "3.0.0", "info": { "title": "API Catalog", "description": "", "version": "1.0.0" }, "servers": [ { "url": "https://mobtest.cmiccloudr12.com/cmictestrti", "description": "CMIC API Server" } ], "security": [ { "cmicBasicAuth": [] } ], "tags": [ { "name": "Highlights" }, { "name": "Asset Management | Equipment" }, { "name": "Asset Management | Fixed Assets" }, { "name": "Asset Management | Purchase Order" }, { "name": "Asset Management | Inventory" }, { "name": "Asset Management | Requisition" }, { "name": "Asset Management | Purchase Change Order" }, { "name": "Bim Model" }, { "name": "Bim Model Revision" }, { "name": "Bim Tag Model" }, { "name": "Bim Tags" }, { "name": "Bim FileUpload Jersey" }, { "name": "Core System | Business Partners" }, { "name": "Core System | Business Partner Addresses" }, { "name": "Core System | Bank" }, { "name": "Core System | Currency" }, { "name": "Core System | Exchange Rates" }, { "name": "Core System | Global Table Text Codes" }, { "name": "Core System | Global Table Regions" }, { "name": "Core System | Terms" }, { "name": "Core System | System Contact" }, { "name": "Core System | Weight Measures" }, { "name": "Core System | Field User Defined Classifiers" }, { "name": "Core System | User Defined Classifiers by Object" }, { "name": "Core System | User Extension Definitions by Object" }, { "name": "Core System | User Extention Field Data Value" }, { "name": "Core System | User Extension Values by Object" }, { "name": "Core System | User System Role" }, { "name": "Core System | User Project Role" }, { "name": "Core System | Documents by Object" }, { "name": "Core System | Audit Status Log by Object" }, { "name": "Core System | Licensed Users" }, { "name": "Core System | Company Access" }, { "name": "Core System | Copy User Settings" }, { "name": "Core System | User Maintenance" }, { "name": "Core System | User Roles" }, { "name": "Core System | Security Groups" }, { "name": "Core System | Job/Project Security" }, { "name": "Core System | Weight Measure with Conversions Code" }, { "name": "Core System | Weight Measure Conversions Code" }, { "name": "Core System | User-defined-fields" }, { "name": "Core System | User-extension" }, { "name": "ECM and Workflow | Image Manager" }, { "name": "Financials | General Ledger" }, { "name": "Financials | Accounts Payable" }, { "name": "Financials | Accounts Receivable" }, { "name": "Preventative Maintenance | Issue Work Orders" }, { "name": "Preventative Maintenance | Issue Work Items" }, { "name": "Preventative Maintenance | Issue Work Budgets" }, { "name": "Preventative Maintenance | Issue Priorities" }, { "name": "Preventative Maintenance | Issue Status" }, { "name": "Preventative Maintenance | Issue Types" }, { "name": "Preventative Maintenance | Accumulative Equipment" }, { "name": "Preventative Maintenance | Work Orders" }, { "name": "Preventative Maintenance | Work Items" }, { "name": "Preventative Maintenance | Work Budgets" }, { "name": "Preventative Maintenance | Priorities" }, { "name": "Preventative Maintenance | Tasks" }, { "name": "HCM | UKG Pay Deductions" }, { "name": "HCM | UKG Pay Earnings" }, { "name": "HCM | UKG Pay Headers" }, { "name": "HCM | UKG Pay Taxes" }, { "name": "HCM | Payroll Geographical States" }, { "name": "HCM | Payroll Trades" }, { "name": "HCM | Payroll Union" }, { "name": "HCM | Payroll Pay Runs" }, { "name": "HCM | Payroll Pay Groups" }, { "name": "HCM | Payroll Tax" }, { "name": "HCM | Payroll Worker Compensation" }, { "name": "HCM | Payroll Work Locations" }, { "name": "HCM | Payroll Trade Pay Rates" }, { "name": "HCM | Payroll Union Pay Rates" }, { "name": "HCM | Payroll Job Pay Rates" }, { "name": "HCM | Payroll Master Benefits" }, { "name": "HCM | Payroll Master Deductions" }, { "name": "HCM | Payroll Ben/Ded/Leave Base Codes" }, { "name": "HCM | Payroll Ben/Ded Plans" }, { "name": "HCM | Payroll Ben/Ded Plan Options" }, { "name": "HCM | Payroll Company Benefits" }, { "name": "HCM | Payroll Company Deductions" }, { "name": "HCM | Payroll Vertex Geographic Locations" }, { "name": "HCM | Payroll Checks" }, { "name": "HCM | Payroll Timesheets" }, { "name": "HCM | Employee" }, { "name": "HCM | Employee (Minimum payload)" }, { "name": "HCM | Employee History" }, { "name": "HCM | Tax Exemptions" }, { "name": "HCM | Employee Tax Overrides" }, { "name": "HCM | Employee Pay Splits" }, { "name": "HCM | Employee Benefits" }, { "name": "HCM | Employee Clock In and Out" }, { "name": "HCM | Employee Deductions" }, { "name": "HCM | Employee Leaves" }, { "name": "HCM | Employee Leave History" }, { "name": "HCM | Employee Hour Types" }, { "name": "HCM | Employee Pay History" }, { "name": "HCM | Employee Work Statuses" }, { "name": "HCM | Employee Security Group" }, { "name": "HCM | Crewtime Crew" }, { "name": "HCM | Crewtime Employee Timesheet" }, { "name": "HCM | Crewtime Equipment Timesheet" }, { "name": "HCM | Crew Maintenance Activity Assignment" }, { "name": "HCM | Crew Maintenance Member Assignment" }, { "name": "HCM | Crew Maintenance Member Trade and Union Assignment" }, { "name": "HCM | Crew Maintenance Equipment Assignment" }, { "name": "HCM | Crew Maintenance Equipment Detail Assignment" }, { "name": "HCM | HR Requisitions" }, { "name": "HCM | HR Relations" }, { "name": "HCM | HR Employee Skills" }, { "name": "HCM | HR Incident" }, { "name": "HCM | HR Employee Relatives / Dependents" }, { "name": "HCM | HR Employee Positions" }, { "name": "HCM | HR Applicants" }, { "name": "HCM | HR Applications" }, { "name": "HCM | Vertex Location City" }, { "name": "HCM | HR Application History" }, { "name": "HCM | HR Dependent Benefits" }, { "name": "HCM | HR Dependent Deductions" }, { "name": "HCM | HR Employee Elected Plans" }, { "name": "HCM | HR Employee Training Certifications" }, { "name": "HCM | HR Trainings" }, { "name": "HCM | E-Timesheets" }, { "name": "HCM | System Contacts" }, { "name": "HCM | System User Payroll Security Group" }, { "name": "HCM | Payroll Timesheet Posting" }, { "name": "HCM | CrewTimesheet Posting" }, { "name": "HCM | HR Positions Master" }, { "name": "HCM | Payroll Pay Periods" }, { "name": "HCM | Payroll Rate Codes" }, { "name": "HCM | Payroll Overhead Codes and Rates" }, { "name": "HCM | Payroll Assigned Overhead to Jobs" }, { "name": "Materials Management | Material Sale Orders" }, { "name": "Materials Management | Material Sale Orders Details" }, { "name": "Materials Management | Truck Rate Detail" }, { "name": "Opportunity Management | Competitors" }, { "name": "Opportunity Management | Opportunities" }, { "name": "Opportunity Management | Revenue Details" }, { "name": "Opportunity Management | Opportunity History" }, { "name": "Opportunity Management | Organization" }, { "name": "Project Controls | Job Billing" }, { "name": "Project Controls | Job Cost" }, { "name": "Project Controls | PCI Details" }, { "name": "Project Controls | Unposted PCI Details" }, { "name": "Project Controls | PCI Headers" }, { "name": "Project Controls | Owner Change Orders" }, { "name": "Project Controls | CM Statuses" }, { "name": "Project Controls | CM Types" }, { "name": "Project Controls | CM Vendor Details" }, { "name": "Project Controls | Post PCI" }, { "name": "Project Management | Uploading Documents" }, { "name": "Project Management | Downloading Documents" }, { "name": "Project Management | Foreign Bid Item Imports" }, { "name": "Project Management | Communications" }, { "name": "Project Management | Daily Journals" }, { "name": "Project Management | Communications Types" }, { "name": "Project Management | Daily Journal Daily Work Plans" }, { "name": "Project Management | Daily Journal Field Forces" }, { "name": "Project Management | Daily Journal Labour" }, { "name": "Project Management | Daily Journal Materials" }, { "name": "Project Management | Daily Journal Owner Equipment" }, { "name": "Project Management | Daily Journal Quality Control" }, { "name": "Project Management | Daily Journal Tasks" }, { "name": "Project Management | Daily Journal Trade Equipment" }, { "name": "Project Management | Daily Journal Transactions" }, { "name": "Project Management | Daily Journal User Defined Data" }, { "name": "Project Management | Daily Journal Visitors" }, { "name": "Project Management | Daily Journal Bill Details" }, { "name": "Project Management | Field Work Directives" }, { "name": "Project Management | Contract Types" }, { "name": "Project Management | Company Contacts" }, { "name": "Project Management | Distribution BCC" }, { "name": "Project Management | Distribution CC" }, { "name": "Project Management | Field Work Directive Statuses" }, { "name": "Project Management | Issues" }, { "name": "Project Management | Key Players" }, { "name": "Project Management | Meetings" }, { "name": "Project Management | Meeting Attendees" }, { "name": "Project Management | Meeting Item Statuses" }, { "name": "Project Management | Meeting Tracks" }, { "name": "Project Management | Notes" }, { "name": "Project Management | Projects" }, { "name": "Project Management | Project Items" }, { "name": "Project Management | Project Item Phase Segment Sums" }, { "name": "Project Management | Project Partners" }, { "name": "Project Management | Notices" }, { "name": "Project Management | Notice Statuses" }, { "name": "Project Management | Owner JS Query" }, { "name": "Project Management | PCI Real Locations" }, { "name": "Project Management | Project Contacts" }, { "name": "Project Management | RFIs (Requests for Information)" }, { "name": "Project Management | RFI Statuses" }, { "name": "Project Management | Submittal Packages" }, { "name": "Project Management | Submittal Package Details" }, { "name": "Project Management | Submittal Package Status" }, { "name": "Project Management | Submittals" }, { "name": "Project Management | Submittal Status" }, { "name": "Project Management | Transmittals" }, { "name": "Project Management | Subcontract Headers" }, { "name": "Project Management | Subcontract Schedules" }, { "name": "Project Management | Subcontract Sechedule Phase Segment Sums" }, { "name": "Project Management | User Roles" }, { "name": "Project Management | Punchlists" }, { "name": "Project Management | Punchlist Details" }, { "name": "Project Management | Punchlist Statuses" }, { "name": "Project Management | Meeting Items" }, { "name": "Project Management | Self Perform Vendor" }, { "name": "Project Management | Submittal Types" }, { "name": "Project Management | Assign contact and partner to project" }, { "name": "Project Management | Subcontract Prequal" }, { "name": "Project Management | Bid Item Package" } ], "paths": { "/po-rest-api/jersey/v1/purchase-change-order/master": { "get": { "tags": [ "Asset Management | Purchase Order" ], "summary": "Master Records By Query Filters", "description": "# Get Change Order Masters (List API)\n\n## Overview\n\nReturns a **paginated list of PO Change Order master (header) records only**, without any detail lines.\n\nThis API is used when you need header-level information about change orders — such as vendor, status, amounts, and dates — without the overhead of fetching line items. Sourced from `PO_COMAST_API_V`.\n\n---\n\n## Notes\n\n- Pagination is supported using `limit` and `offset`.\n \n- At least **one filter parameter** is required. Requests with no filters return `400 Bad Request`.\n \n- All string filter values are automatically **uppercased** before being applied.\n \n- Results can be sorted using `orderBy`. Accepted sort keys: `companyCode`, `poNumber`, `coNumber`, `releaseNumber`, `createDate`, `updateDate`, `oraseq`. Append `DESC` for descending order.\n \n- Maximum `limit` is **200**. Values above 200 are clamped to 200.\n \n- Authentication is required to access this endpoint.\n \n\n---\n\n## UI Navigation\n\n**Asset Management → Purchase Orders → Change Orders**\n\n---\n\n## View Objects\n\n| Section | View Object | Database View |\n| --- | --- | --- |\n| Header | `PoComastViewObj` | `PO_COMAST_API_V` |\n\n---\n\n## Finders\n\n| Finder | Parameter | Description |\n| --- | --- | --- |\n| Filter by Company | `companyCode` | Filters by company code (`POCOH_COMP_CODE`) |\n| Filter by PO Number | `poNumber` | Filters by purchase order number (`POCOH_PO_NUM`) |\n| Filter by CO Number | `coNumber` | Filters by change order number (`POCOH_NUM`) |\n| Filter by Release | `releaseNumber` | Filters by release number (`POCOH_RELEASE_NUM`) — must be a valid integer |\n| Audit Date | `auditDate` | Returns records where the later of create date / update date ≥ supplied date. Format: `YYYY-MM-DD` |\n\n---\n\n## HTTP Method & Endpoint\n\n**Method:** GET\n\n**Endpoint:**\n\n```\n/po-rest-api/jersey/v1/po-change-order/master\n\n ```\n\n---\n\n## Path Parameters\n\n| Parameter | Description | Example |\n| --- | --- | --- |\n| N/A | This endpoint does not require path parameters | N/A |\n\n---\n\n## Query Parameters\n\n| Field | Type | Required | Default | Description |\n| --- | --- | --- | --- | --- |\n| companyCode | String | Conditional\\* | — | Company code filter |\n| poNumber | String | Conditional\\* | — | Purchase order number filter |\n| coNumber | String | Conditional\\* | — | Change order number filter |\n| releaseNumber | Integer | Conditional\\* | — | Release number filter (must be a valid integer) |\n| auditDate | String | Conditional\\* | — | Audit date filter in `YYYY-MM-DD` format |\n| limit | Integer | No | 25 | Number of records to return (max 200) |\n| offset | Integer | No | 0 | Starting index of records |\n| orderBy | String | No | — | Sort field and direction e.g. `createDate DESC` |\n\n> <p >\\* At least one filter parameter is required.</p> \n \n\n---\n\n## Example Request\n\n```\n/po-rest-api/jersey/v1/po-change-order/master?companyCode=QAT&limit=25&offset=0\n/po-rest-api/jersey/v1/po-change-order/master?companyCode=QAT&poNumber=PO000004&orderBy=coNumber DESC\n/po-rest-api/jersey/v1/po-change-order/master?auditDate=2024-01-01&limit=50\n\n ```\n\n---\n\n## Attributes\n\nThe response contains an **items** array. Each object in the array represents one change order master record.\n\n| CMiC UI Fieldname | Object | Name | Description | Type | Data Length | Example | Mandatory |\n| --- | --- | --- | --- | --- | --- | --- | --- |\n| PocohVUuid | changeOrderHeader | pocohVUuid | Unique virtual identifier for the change order header | String | 64 | 4E69C78976F5FD36E0630B811DAC6604 | System Generated |\n| PocohCompCode | changeOrderHeader | pocohCompCode | Company code the change order belongs to | String | 8 | QAT | True |\n| PocohCompName | changeOrderHeader | pocohCompName | Full name of the company | String | 60 | QAT Company | False |\n| PocohPoNum | changeOrderHeader | pocohPoNum | Parent purchase order number | String | 20 | PO000004 | True |\n| PocohNum | changeOrderHeader | pocohNum | Change order number | String | 10 | 1 | True |\n| PocohReleaseNum | changeOrderHeader | pocohReleaseNum | PO release number | Number | 10 | 1 | True |\n| PocohBchNum | changeOrderHeader | pocohBchNum | Batch number | Number | 10 | 42 | False |\n| PocohVenCode | changeOrderHeader | pocohVenCode | Vendor code | String | 16 | AETNA | False |\n| PocohVenName | changeOrderHeader | pocohVenName | Vendor full name | String | 60 | Aetna Insurance | False |\n| PocohDeptCode | changeOrderHeader | pocohDeptCode | Department code | String | 6 | ADMIN | False |\n| PocohDeptName | changeOrderHeader | pocohDeptName | Department name | String | 60 | Administration | False |\n| PocohExptdDate | changeOrderHeader | pocohExptdDate | Expected delivery date | Date | N/A | 2024-03-31 | False |\n| PocohOrdDate | changeOrderHeader | pocohOrdDate | Date the order was placed | Date | N/A | 2024-01-15 | False |\n| PocohRecDate | changeOrderHeader | pocohRecDate | Actual receive date | Date | N/A | 2024-04-05 | False |\n| PocohTypeCode | changeOrderHeader | pocohTypeCode | PO type code (e.g. S = Standard) | String | 1 | S | False |\n| PocohAdjCode | changeOrderHeader | pocohAdjCode | Adjustment code | String | 1 | A | False |\n| PocohStatCode | changeOrderHeader | pocohStatCode | Status code (R = Released, C = Closed) | String | 1 | R | False |\n| PocohChgCode | changeOrderHeader | pocohChgCode | Change code | String | 16 | MOD | False |\n| PocohTermCode | changeOrderHeader | pocohTermCode | Payment term code | String | 8 | NET30 | False |\n| PocohTermName | changeOrderHeader | pocohTermName | Payment term description | String | 30 | Net 30 Days | False |\n| PocohCurrCode | changeOrderHeader | pocohCurrCode | Currency code | String | 3 | US | False |\n| PocohCurrName | changeOrderHeader | pocohCurrName | Currency name | String | 30 | US Dollar | False |\n| PocohFobCode | changeOrderHeader | pocohFobCode | Freight on board code | String | 8 | DEST | False |\n| PocohBuyCode | changeOrderHeader | pocohBuyCode | Buyer code | String | 8 | JSMITH | False |\n| PocohAddCode | changeOrderHeader | pocohAddCode | Ship-to address code | String | 10 | MAIN | False |\n| PocohAddName | changeOrderHeader | pocohAddName | Ship-to address name | String | 60 | Main Office | False |\n| PocohShplneCode | changeOrderHeader | pocohShplneCode | Shipping line code | String | 8 | FEDEX | False |\n| PocohShpmetCode | changeOrderHeader | pocohShpmetCode | Shipping method code | String | 8 | GROUND | False |\n| PocohShpinstDesc | changeOrderHeader | pocohShpinstDesc | Shipping instructions description | String | 240 | Handle with care | False |\n| PocohDesc1 | changeOrderHeader | pocohDesc1 | Change order description line 1 | String | 60 | Office supplies amendment | False |\n| PocohDesc2 | changeOrderHeader | pocohDesc2 | Change order description line 2 | String | 60 | Additional items added | False |\n| PocohAdjPrice | changeOrderHeader | pocohAdjPrice | Adjusted price total | Number | 10,2 | 1250.00 | False |\n| PocohUnadjPrice | changeOrderHeader | pocohUnadjPrice | Unadjusted price total | Number | 10,2 | 1200.00 | False |\n| PocohCurrConvNum | changeOrderHeader | pocohCurrConvNum | Currency conversion number | Number | 10,6 | 1.0 | False |\n| PocohCostedCode | changeOrderHeader | pocohCostedCode | Costed code | String | 1 | Y | False |\n| PocohRefNum | changeOrderHeader | pocohRefNum | Reference number | String | 20 | REF-2024-001 | False |\n| PocohRefDate | changeOrderHeader | pocohRefDate | Reference date | Date | N/A | 2024-01-10 | False |\n| PocohReqCode | changeOrderHeader | pocohReqCode | Requisition code | String | 8 | REQ001 | False |\n| PocohRecCode | changeOrderHeader | pocohRecCode | Receiving code | String | 1 | P | False |\n| PocohReprintDate | changeOrderHeader | pocohReprintDate | Last reprint date | Date | N/A | 2024-02-20 | False |\n| PocohWipAccCode | changeOrderHeader | pocohWipAccCode | WIP account code | String | 8 | WIP-01 | False |\n| PocohWipAccName | changeOrderHeader | pocohWipAccName | WIP account name | String | 60 | Work In Progress 01 | False |\n| PocohWipDeptCode | changeOrderHeader | pocohWipDeptCode | WIP department code | String | 6 | WIPD01 | False |\n| PocohWipDeptName | changeOrderHeader | pocohWipDeptName | WIP department name | String | 60 | WIP Department 01 | False |\n| PocohBilltoAddCode | changeOrderHeader | pocohBilltoAddCode | Bill-to address code | String | 10 | BILLTO01 | False |\n| PocohReqReason | changeOrderHeader | pocohReqReason | Requisition reason text | String | 240 | Price adjustment | False |\n| PocohInvTypeCode | changeOrderHeader | pocohInvTypeCode | Invoice type code | String | 8 | STD | False |\n| PocohImageFilename | changeOrderHeader | pocohImageFilename | Attached image filename | String | 60 | co_signed.pdf | False |\n| PocohInvSerCode | changeOrderHeader | pocohInvSerCode | Invoice serial code | String | 4 | SER001 | False |\n| PocohVendOrderAddCode | changeOrderHeader | pocohVendOrderAddCode | Vendor ordering address code | String | 10 | VEND-ADDR-01 | False |\n| PocohComplianceFlag | changeOrderHeader | pocohComplianceFlag | Compliance flag (Y/N) | String | 1 | Y | False |\n| PocohJobCompCode | changeOrderHeader | pocohJobCompCode | Job company code | String | 8 | QAT | False |\n| PocohJobCompName | changeOrderHeader | pocohJobCompName | Job company name | String | 60 | QAT Company | False |\n| PocohJobCode | changeOrderHeader | pocohJobCode | Job code | String | 16 | JOB001 | False |\n| PocohJobName | changeOrderHeader | pocohJobName | Job name | String | 60 | Office Renovation | False |\n| PocohContactCode | changeOrderHeader | pocohContactCode | Vendor contact code | String | 8 | CONT01 | False |\n| PocohAddCompCode | changeOrderHeader | pocohAddCompCode | Address company code | String | 8 | QAT | False |\n| PocohAddCompName | changeOrderHeader | pocohAddCompName | Address company name | String | 60 | QAT Company | False |\n| PocohPrintDate | changeOrderHeader | pocohPrintDate | Date the CO was printed | Date | N/A | 2024-01-16 | False |\n| PocohDefaultRecCode | changeOrderHeader | pocohDefaultRecCode | Default receiving code | String | 1 | F | False |\n| PocohDate | changeOrderHeader | pocohDate | Change order date | Date | N/A | 2024-01-15 | False |\n| PocohPoTotal | changeOrderHeader | pocohPoTotal | Total amount of the purchase change order | Number | 10,2 | 37 | False |\n| PocohManPoRecFlag | changeOrderHeader | pocohManPoRecFlag | Manual PO receipt flag (Y/N) | String | 1 | N | False |\n| PocohAcctDescription | changeOrderHeader | pocohAcctDescription | Account description | String | 60 | Operating Expenses | False |\n| PocohLumpSumPoFlag | changeOrderHeader | pocohLumpSumPoFlag | Indicates lump sum PO (Y/N) | String | 1 | N | False |\n| PocohLumpSumPoAmt | changeOrderHeader | pocohLumpSumPoAmt | Lump sum PO amount | Number | 10,2 | 0.00 | False |\n| PocohVenTax1 | changeOrderHeader | pocohVenTax1 | Vendor tax code 1 | String | 8 | HST | False |\n| PocohVenTax2 | changeOrderHeader | pocohVenTax2 | Vendor tax code 2 | String | 8 | — | False |\n| PocohVenTax3 | changeOrderHeader | pocohVenTax3 | Vendor tax code 3 | String | 8 | — | False |\n| PocohJobTax1 | changeOrderHeader | pocohJobTax1 | Job tax code 1 | String | 8 | HST | False |\n| PocohJobTax2 | changeOrderHeader | pocohJobTax2 | Job tax code 2 | String | 8 | — | False |\n| PocohJobTax3 | changeOrderHeader | pocohJobTax3 | Job tax code 3 | String | 8 | — | False |\n| PocohDiscountPct | changeOrderHeader | pocohDiscountPct | Discount percentage | Number | 6,2 | 5.00 | False |\n| PocohBlkLineItemsFlag | changeOrderHeader | pocohBlkLineItemsFlag | Block individual line item edits (Y/N) | String | 1 | N | False |\n| PocohSelectFlag | changeOrderHeader | pocohSelectFlag | Record selection flag | String | 1 | Y | False |\n| PocohIuCreateDate | changeOrderHeader | pocohIuCreateDate | Record creation timestamp (ISO-8601) | Timestamp | N/A | 2013-11-14T14:25:45-05:00 | System Generated |\n| PocohIuCreateUser | changeOrderHeader | pocohIuCreateUser | User who created the record | String | 30 | DA | System Generated |\n| PocohIuUpdateDate | changeOrderHeader | pocohIuUpdateDate | Record last update timestamp (ISO-8601) | Timestamp | N/A | 2014-08-18T09:45:37-04:00 | System Generated |\n| PocohIuUpdateUser | changeOrderHeader | pocohIuUpdateUser | User who last updated the record | String | 30 | DA | System Generated |\n\n---", "parameters": [ { "name": "companyCode", "in": "query", "schema": { "type": "string" }, "example": "ALT" }, { "name": "poNumber", "in": "query", "schema": { "type": "string" }, "example": "JP000017" } ], "responses": { "200": { "description": "OK", "headers": { "Content-Type": { "schema": { "type": "string", "example": "application/json" } } }, "content": { "text/plain": { "schema": { "type": "string" }, "example": "{\n \"items\": [\n {\n \"pocohVUuid\": \"4E69C789753EFD36E0630B811DAC6604\",\n \"pocohCompCode\": \"ALT\",\n \"pocohCompName\": \"Andy's Company ALT\",\n \"pocohPoNum\": \"JP000017\",\n \"pocohNum\": \"*\",\n \"pocohBchNum\": 670,\n \"pocohVenCode\": \"ALIED\",\n \"pocohVenName\": \"Alied Recycling\",\n \"pocohDeptCode\": null,\n \"pocohDeptName\": null,\n \"pocohExptdDate\": \"2010-04-22\",\n \"pocohOrdDate\": \"2010-04-08T12:49:12-04:00\",\n \"pocohRecDate\": null,\n \"pocohTypeCode\": \"S\",\n \"pocohAdjCode\": null,\n \"pocohStatCode\": \"O\",\n \"pocohChgCode\": \"O\",\n \"pocohTermCode\": \"NET30\",\n \"pocohTermName\": \"Net 30\",\n \"pocohInvCode\": null,\n \"pocohInvDate\": null,\n \"pocohInvDueDate\": null,\n \"pocohInvDiscDate\": null,\n \"pocohInvDiscAmt\": null,\n \"pocohCurrCode\": \"US\",\n \"pocohCurrName\": \"US Dollars\",\n \"pocohFobCode\": null,\n \"pocohBuyCode\": \"DA\",\n \"pocohAddCode\": null,\n \"pocohShplneCode\": null,\n \"pocohShpmetCode\": null,\n \"pocohTxt1Code\": null,\n \"pocohTxt2Code\": null,\n \"pocohShpinstDesc\": null,\n \"pocohDesc1\": null,\n \"pocohDesc2\": null,\n \"pocohAdjPrice\": null,\n \"pocohUnadjPrice\": null,\n \"pocohCurrConvNum\": null,\n \"pocohCostedCode\": null,\n \"pocohRefNum\": null,\n \"pocohRefDate\": \"2010-04-08T12:49:12-04:00\",\n \"pocohReqCode\": \"DA\",\n \"pocohRecCode\": null,\n \"pocohReprintDate\": null,\n \"pocohWipAccCode\": null,\n \"pocohWipAccName\": null,\n \"pocohWipDeptCode\": null,\n \"pocohWipDeptName\": null,\n \"pocohShipinstTxt1Code\": null,\n \"pocohShipinstTxt2Code\": null,\n \"pocohShipinstTxt3Code\": null,\n \"pocohShipinstTxt4Code\": null,\n \"pocohShipinstTxt5Code\": null,\n \"pocohReleaseNum\": 1,\n \"pocohBilltoAddCode\": null,\n \"pocohReqReason\": null,\n \"pocohInvTypeCode\": null,\n \"pocohImageFilename\": null,\n \"pocohInvSerCode\": null,\n \"pocohVendOrderAddCode\": null,\n \"pocohComplianceFlag\": null,\n \"pocohJobCompCode\": null,\n \"pocohJobCompName\": null,\n \"pocohJobCode\": null,\n \"pocohJobName\": null,\n \"pocohContactCode\": null,\n \"pocohAddCompCode\": null,\n \"pocohAddCompName\": null,\n \"pocohPrintDate\": null,\n \"pocohDefaultRecCode\": null,\n \"pocohDate\": null,\n \"pocohPoTotal\": 85000,\n \"pocohIuCreateDate\": \"2010-04-08T12:52:07-04:00\",\n \"pocohIuCreateUser\": \"ANDYTESTV10\",\n \"pocohIuUpdateDate\": null,\n \"pocohIuUpdateUser\": null,\n \"pocohManPoRecFlag\": null,\n \"pocohAcctDescription\": null,\n \"pocohLumpSumPoFlag\": null,\n \"pocohLumpSumPoAmt\": null,\n \"pocohVenTax1\": null,\n \"pocohVenTax2\": null,\n \"pocohVenTax3\": null,\n \"pocohJobTax1\": null,\n \"pocohJobTax2\": null,\n \"pocohJobTax3\": null,\n \"pocohDiscountPct\": 0,\n \"pocohAddName\": null,\n \"pocohBlkLineItemsFlag\": null,\n \"pocohSelectFlag\": \"N\"\n }\n ],\n \"totalCount\": 1,\n \"limit\": 25,\n \"offset\": 0,\n \"hasMore\": false,\n \"count\": 1\n}" } } } } } } }, "components": { "securitySchemes": { "cmicBasicAuth": { "type": "http", "scheme": "basic", "description": "Basic authentication" } } } } ````