> ## 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. # getApproverDetails > ## Overview This endpoint allows retrieving **Purchase Order (PO) Approver records** from CMiC. It is designed for reading approver details based on PO Request Code and Company Code using a finder. --- ## Notes - Authentication and authorization are required. - This is a read-only endpoint and does not modify data. - Results can be filtered using the `selectByReqCode` finder. - Large result sets should use `limit` and `offset`. --- ## UI Navigation **Asset Management -> Requisitions -> Enter Requisition -> Approver Asset Management -> Purchase Order -> Enter Purchase Order -> Approver** --- ## Finders The following finder is available for data filtering and optimizing request performance: - **selectByReqCode** This is a **GET (read)** endpoint and supports finders. --- ## Path Parameters Not applicable. This endpoint does not use path parameters for GET requests. --- ## Query Standards This endpoint supports the following query parameters: | Key | Recommended | Description | | --- | --- | --- | | `finder` | Yes | Filters data based on Request Code and Company Code. | | `limit` | Yes | Limits the number of records returned. | | `offset` | Yes | Skips a specified number of records before returning results. | | `orderBy` | Yes | Sorts the returned records based on a specified attribute. | --- ## Finders with Example ### Finder: **selectByReqCode** Example request: ``` {{CMIC_BaseUrl}}/po-rest-api/rest/1/poapprover?finder=selectByReqCode;porqcode=POREQ565,porqcompcode=ZZ ``` | Finder | Parameter | Data Type | Description | Example | Mandatory | | --- | --- | --- | --- | --- | --- | | selectByReqCode | porqcode | String | PO Request Code | POREQ565 | Optional | | selectByReqCode | porqcompcode | String | Company Code | ZZ | Optional | --- ## Attributes The response returns a collection of **PO Approver** records. | CMiC UI Fieldname | Object | Name | Description | Type | Data Length | Example | Mandatory | | --- | --- | --- | --- | --- | --- | --- | --- | | PoporqapAprvFlag | PoApprover | PoporqapAprvFlag | Approval Flag | String | 1 | Y | False | | PoporqapAprvCode | PoApprover | PoporqapAprvCode | Approver Code | String | 10 | DA | False | | PoporqapUserId | PoApprover | PoporqapUserId | Approver User ID | String | 30 | DA | False | | PoporqapAprvName | PoApprover | PoporqapAprvName | Approver Name | String | 30 | DA | False | | PoporqapAprvDate | PoApprover | PoporqapAprvDate | Approval Date and Time | String | N/A | 2010-02-23 14:44:23 | False | | PoporqapLevelNum | PoApprover | PoporqapLevelNum | Approval Level | Number | 2/0 | 1 | False | | PoporqapLevelDesc | PoApprover | PoporqapLevelDesc | Level Description | String | 60 | Approval Level 1 | False | | PoporqapLevelLimit | PoApprover | PoporqapLevelLimit | Approval Limit | Number | 11/2 | 999999999.0 | False | | PoporqapLocCode | PoApprover | PoporqapLocCode | Location Code | String | 5 | CHICA | False | | PoporqapDeptCode | PoApprover | PoporqapDeptCode | Department Code | String | 6 | 00 | False | | PoporqapPoReleaseNum | PoApprover | PoporqapPoReleaseNum | PO Release Number | Number | 11/0 | 1 | True | | PoporqapIuCreateDate | PoApprover | PoporqapIuCreateDate | Record Creation Date | String | N/A | System generated | False | | PoporqapIuCreateUser | PoApprover | PoporqapIuCreateUser | Created By | String | 30 | System user | False | | PoporqapIuUpdateDate | PoApprover | PoporqapIuUpdateDate | Last Updated Date | String | N/A | System generated | False | | PoporqapIuUpdateUser | PoApprover | PoporqapIuUpdateUser | Last Updated By | String | 30 | System user | False | | PoporqapVUuid | PoApprover | PoporqapVUuid | Unique Identifier (UUID) | String | 64 | CDA3D357EE1A6156E053508010AC6435 | False | ## OpenAPI ````json GET /po-rest-api/rest/1/poapprover { "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": "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": "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": "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 | RFQ (Request for Quote) Extensions" }, { "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/rest/1/poapprover": { "get": { "tags": [ "Asset Management | Purchase Order" ], "summary": "getApproverDetails", "description": "## Overview\n\nThis endpoint allows retrieving **Purchase Order (PO) Approver records** from CMiC.\n\nIt is designed for reading approver details based on PO Request Code and Company Code using a finder.\n\n---\n\n## Notes\n\n- Authentication and authorization are required.\n \n- This is a read-only endpoint and does not modify data.\n \n- Results can be filtered using the `selectByReqCode` finder.\n \n- Large result sets should use `limit` and `offset`.\n \n\n---\n\n## UI Navigation\n\n**Asset Management -> Requisitions -> Enter Requisition -> Approver \nAsset Management -> Purchase Order -> Enter Purchase Order -> Approver**\n\n---\n\n## Finders\n\nThe following finder is available for data filtering and optimizing request performance:\n\n- **selectByReqCode**\n \n\nThis is a **GET (read)** endpoint and supports finders.\n\n---\n\n## Path Parameters\n\nNot applicable.\n\nThis endpoint does not use path parameters for GET requests.\n\n---\n\n## Query Standards\n\nThis endpoint supports the following query parameters:\n\n| Key | Recommended | Description |\n| --- | --- | --- |\n| `finder` | Yes | Filters data based on Request Code and Company Code. |\n| `limit` | Yes | Limits the number of records returned. |\n| `offset` | Yes | Skips a specified number of records before returning results. |\n| `orderBy` | Yes | Sorts the returned records based on a specified attribute. |\n\n---\n\n## Finders with Example\n\n### Finder: **selectByReqCode**\n\nExample request:\n\n```\n{{CMIC_BaseUrl}}/po-rest-api/rest/1/poapprover?finder=selectByReqCode;porqcode=POREQ565,porqcompcode=ZZ\n\n ```\n\n| Finder | Parameter | Data Type | Description | Example | Mandatory |\n| --- | --- | --- | --- | --- | --- |\n| selectByReqCode | porqcode | String | PO Request Code | POREQ565 | Optional |\n| selectByReqCode | porqcompcode | String | Company Code | ZZ | Optional |\n\n---\n\n## Attributes\n\nThe response returns a collection of **PO Approver** records.\n\n| CMiC UI Fieldname | Object | Name | Description | Type | Data Length | Example | Mandatory |\n| --- | --- | --- | --- | --- | --- | --- | --- |\n| PoporqapAprvFlag | PoApprover | PoporqapAprvFlag | Approval Flag | String | 1 | Y | False |\n| PoporqapAprvCode | PoApprover | PoporqapAprvCode | Approver Code | String | 10 | DA | False |\n| PoporqapUserId | PoApprover | PoporqapUserId | Approver User ID | String | 30 | DA | False |\n| PoporqapAprvName | PoApprover | PoporqapAprvName | Approver Name | String | 30 | DA | False |\n| PoporqapAprvDate | PoApprover | PoporqapAprvDate | Approval Date and Time | String | N/A | 2010-02-23 14:44:23 | False |\n| PoporqapLevelNum | PoApprover | PoporqapLevelNum | Approval Level | Number | 2/0 | 1 | False |\n| PoporqapLevelDesc | PoApprover | PoporqapLevelDesc | Level Description | String | 60 | Approval Level 1 | False |\n| PoporqapLevelLimit | PoApprover | PoporqapLevelLimit | Approval Limit | Number | 11/2 | 999999999.0 | False |\n| PoporqapLocCode | PoApprover | PoporqapLocCode | Location Code | String | 5 | CHICA | False |\n| PoporqapDeptCode | PoApprover | PoporqapDeptCode | Department Code | String | 6 | 00 | False |\n| PoporqapPoReleaseNum | PoApprover | PoporqapPoReleaseNum | PO Release Number | Number | 11/0 | 1 | True |\n| PoporqapIuCreateDate | PoApprover | PoporqapIuCreateDate | Record Creation Date | String | N/A | System generated | False |\n| PoporqapIuCreateUser | PoApprover | PoporqapIuCreateUser | Created By | String | 30 | System user | False |\n| PoporqapIuUpdateDate | PoApprover | PoporqapIuUpdateDate | Last Updated Date | String | N/A | System generated | False |\n| PoporqapIuUpdateUser | PoApprover | PoporqapIuUpdateUser | Last Updated By | String | 30 | System user | False |\n| PoporqapVUuid | PoApprover | PoporqapVUuid | Unique Identifier (UUID) | String | 64 | CDA3D357EE1A6156E053508010AC6435 | False |", "parameters": [ { "name": "Content-Type", "in": "header", "schema": { "type": "string" }, "example": "application/vnd.oracle.adf.resourceitem+json" }, { "name": "finder", "in": "query", "schema": { "type": "string" }, "example": "selectByReqCode;porqcode=POREQ565,porqcompcode=ZZ" } ], "responses": { "200": { "description": "OK", "headers": { "Content-Type": { "schema": { "type": "string", "example": "application/vnd.oracle.adf.resourcecollection+json" } } }, "content": { "text/plain": { "schema": { "type": "string" }, "example": "{\n \"items\": [\n {\n \"PoporqapAprvCode\": \"CARRIE\",\n \"PoporqapAprvDate\": null,\n \"PoporqapAprvFlag\": \"N\",\n \"PoporqapAprvName\": \"CARRIE\",\n \"PoporqapCompCode\": \"ZZ\",\n \"PoporqapCompName\": \"CMiC-ZZ Test Company Incorp\",\n \"PoporqapDeptCode\": null,\n \"PoporqapIuCreateDate\": \"2025-11-19T10:36:41-05:00\",\n \"PoporqapIuCreateUser\": \"YASHB\",\n \"PoporqapIuUpdateDate\": \"2025-11-19T10:37:39-05:00\",\n \"PoporqapIuUpdateUser\": \"YASHB\",\n \"PoporqapLevelDesc\": \"LEVEL 1\",\n \"PoporqapLevelLimit\": 50000,\n \"PoporqapLevelNum\": 1,\n \"PoporqapLocCode\": null,\n \"PoporqapObjectOraseq\": 2580003393,\n \"PoporqapPoCode\": \"No PO\",\n \"PoporqapPoReleaseNum\": 1,\n \"PoporqapRqCode\": \"POREQ565\",\n \"PoporqapState\": \"R\",\n \"PoporqapUserId\": \"CARRIE\",\n \"PoporqapVUuid\": \"43F558C0B7A10481E0630B811DAC3915\",\n \"links\": [\n {\n \"rel\": \"self\",\n \"href\": \"http://127.0.0.1:7101/po-rest-api/rest/1/poapprover/43F558C0B7A10481E0630B811DAC3915\",\n \"name\": \"poapprover\",\n \"kind\": \"item\"\n },\n {\n \"rel\": \"canonical\",\n \"href\": \"http://127.0.0.1:7101/po-rest-api/rest/1/poapprover/43F558C0B7A10481E0630B811DAC3915\",\n \"name\": \"poapprover\",\n \"kind\": \"item\"\n }\n ]\n }\n ],\n \"count\": 1,\n \"hasMore\": false,\n \"limit\": 25,\n \"offset\": 0,\n \"links\": [\n {\n \"rel\": \"self\",\n \"href\": \"http://127.0.0.1:7101/po-rest-api/rest/1/poapprover\",\n \"name\": \"poapprover\",\n \"kind\": \"collection\"\n }\n ]\n}" } } } } } } }, "components": { "securitySchemes": { "cmicBasicAuth": { "type": "http", "scheme": "basic", "description": "Basic authentication" } } } } ````