15.2.8 Retrieve Confirmations by Environment

This endpoint is used to retrieve confirmation records related to published EPC content (such as processes, documents, and assets) within a specific environment. Admins can use this API to audit and verify which users have confirmed specific items for compliance or training purposes.

Possible Use Cases:

• Tracking compliance by logging user acknowledgements of critical updates.
• Auditing employee confirmations of updated objects.
• Building dashboards or reports to monitor confirmation status across users and content.
  

Response Example

15 > GET http://localhost:3080/api/v1/admin/confirmations?environment=A9CCB5F4-9A79-8AE7-8C4C-289A025D0D88&userId=FDA5D819-A13A-4E24-8871-2B8802C2DFA2
15 > Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.
15 > Host: localhost:3080
15 > Connection: Keep-Alive
15 > User-Agent: Apache-HttpClient/4.5.13 (Java/11.0.23)
15 > Accept-Encoding: gzip,deflate
15:57:29.562 [main] DEBUG com.intuit.karate - response time in milliseconds: 9
15 < 200
15 < Server: nginx/1.27.4
15 < Date: Fri, 25 Apr 2025 19:57:29 GMT
15 < Content-Type: application/json
15 < Content-Length: 3249
15 < Cache-Control: no-transform, no-store
15 < X-Varnish: 492945
15 < Age: 0
15 < Via: 1.1 280ef6a640ef (Varnish/7.7)
15 < Connection: keep-alive
{
  "currentPage": 1,
  "pageSize": 10,
  "totalRecords": 3,
  "sortKey": "cluster_id",
  "order": "ASC",
  "results": [
    {
      "confirmId": "094CAF75-D7EE-4259-932B-CCF11DCFEABF",
      "node": {
        "@type": "BaseElement",
        "nodeId": "25A6D17A-D2FD-4CD9-ACE1-09CA7B3AC5C6",
        "nodeType": "PROCESS",
        "name": "652cf367-7b51-4b21-8e43-1e8f98a7d916",
        "nodeVersionId": "72AE4A9F-927D-4E1F-8A25-4B232EDA8EDB",
        "version": "1.0000",
        "creationDate": "2025-04-25T15:57:27.143-04:00",
        "modificationDate": "2025-04-25T15:57:27.437-04:00",
        "nodeSubType": null,
        "nodeSubTypeName": null,
        "userNodeSubType": null,
        "nodeStatus": "PUBLISHED",
        "environmentId": "A9CCB5F4-9A79-8AE7-8C4C-289A025D0D88",
        "systemSerialNumber": "PROC-16879",
        "deleted": false,
        "locked": false,
        "system": false,
        "referenceNumber": null,
        "favorite": false,
        "publishedNodeVersionId": "72AE4A9F-927D-4E1F-8A25-4B232EDA8EDB",
        "extensions": null
      },
      "user": {
        "principalId": "FDA5D819-A13A-4E24-8871-2B8802C2DFA2",
        "username": "user_4bf33031-7b98-4eee-8db0-998b8eb6c72e",
        "firstName": "user1",
        "middleName": null,
        "lastName": null,
        "name": "user1 (user_4bf33031-7b98-4eee-8db0-998b8eb6c72e)",
        "email": "user1_8e655c61-7cb3-40b2-a79e-92258664f91e@dummy.com",
        "phone": null
      },
      "date": null,
      "comment": null
    },
    {
      "confirmId": "0A1F4DA5-E433-4986-BABA-3C89CCD1033F",
      "node": {
        "@type": "BaseElement",
        "nodeId": "9AFC3BF7-5B5D-4694-BD71-90BA9FF1D3F0",
        "nodeType": "ASSET",
        "name": "8776efa8-dced-44fe-8e5d-402c654b904b",
        "nodeVersionId": "1A1268E9-9CF8-454F-8CAE-211CFBB1FB41",
        "version": "1.0000",
        "creationDate": "2025-04-25T15:57:26.517-04:00",
        "modificationDate": "2025-04-25T15:57:27.717-04:00",
        "nodeSubType": null,
        "nodeSubTypeName": null,
        "userNodeSubType": null,
        "nodeStatus": "PUBLISHED",
        "environmentId": "A9CCB5F4-9A79-8AE7-8C4C-289A025D0D88",
        "systemSerialNumber": "ASSET-16876",
        "deleted": false,
        "locked": false,
        "system": false,
        "referenceNumber": null,
        "favorite": false,
        "publishedNodeVersionId": "1A1268E9-9CF8-454F-8CAE-211CFBB1FB41",
        "extensions": null
      },
      "user": {
        "principalId": "FDA5D819-A13A-4E24-8871-2B8802C2DFA2",
        "username": "user_4bf33031-7b98-4eee-8db0-998b8eb6c72e",
        "firstName": "user1",
        "middleName": null,
        "lastName": null,
        "name": "user1 (user_4bf33031-7b98-4eee-8db0-998b8eb6c72e)",
        "email": "user1_8e655c61-7cb3-40b2-a79e-92258664f91e@dummy.com",
        "phone": null
      },
      "date": null,
      "comment": null
    },
    {
      "confirmId": "4F34772A-8882-412A-B68D-69D736F6B912",
      "node": {
        "@type": "BaseElement",
        "nodeId": "08262620-14FF-44B8-9CF3-B6CA8DB7F0B6",
        "nodeType": "DOCUMENT",
        "name": "8f42f851-eeaa-46b7-9768-fd3fd924564b",
        "nodeVersionId": "DC6ADF83-EDDF-410B-B76F-264F7C228D86",
        "version": "1.0000",
        "creationDate": "2025-04-25T15:57:26.203-04:00",
        "modificationDate": "2025-04-25T15:57:28.197-04:00",
        "nodeSubType": null,
        "nodeSubTypeName": null,
        "userNodeSubType": null,
        "nodeStatus": "PUBLISHED",
        "environmentId": "A9CCB5F4-9A79-8AE7-8C4C-289A025D0D88",
        "systemSerialNumber": "DOC-16872",
        "deleted": false,
        "locked": false,
        "system": false,
        "referenceNumber": null,
        "favorite": false,
        "publishedNodeVersionId": "DC6ADF83-EDDF-410B-B76F-264F7C228D86",
        "extensions": null
      },
      "user": {
        "principalId": "FDA5D819-A13A-4E24-8871-2B8802C2DFA2",
        "username": "user_4bf33031-7b98-4eee-8db0-998b8eb6c72e",
        "firstName": "user1",
        "middleName": null,
        "lastName": null,
        "name": "user1 (user_4bf33031-7b98-4eee-8db0-998b8eb6c72e)",
        "email": "user1_8e655c61-7cb3-40b2-a79e-92258664f91e@dummy.com",
        "phone": null
      },
      "date": null,
      "comment": null
    }
  ]
}

Technical Information

Endpoint URL: https://YOUREPC.interfacing.com/api/v1/admin/confirmations

Query Parameters:

• environment (required): Environment UUID to filter results.
• userId (optional): Filter confirmations by user.
• nodeId (optional): Filter confirmations by specific object.
• confirmed (optional): Filter by confirmation status (true, false). Defaults to both.

What is this feature in EPC?

Confirmations in EPC are used to ensure that users are aware of and acknowledge changes to content relevant to their roles. After an approval cycle is completed, users assigned to an object (such as a process, document, or asset) through the RASCI-VS model are prompted to confirm they have read and understood the changes.

This mechanism helps maintain accountability and ensures alignment across teams regarding updated information.

To learn more about confirmations, please click here.