GET
/
v1
/
matrix
/
history
/
{tenantId}
/
{matrixId}
/
{historyDate}
Get matrix history
curl --request GET \
  --url https://staging.api.us.aptlydone.com/matrix/v1/matrix/history/{tenantId}/{matrixId}/{historyDate} \
  --header 'Authorization: Bearer <token>'
{
  "statusCode": 200,
  "timestamp": "2025-06-24T08:51:11.638Z",
  "message": "Success",
  "data": {
    "historyId": "e6a4369f-690e-4bdd-a84d-2107e53bdbdb",
    "historyDate": "2025-06-24T07:24:34.412Z",
    "matrixId": "6c12fc56-400f-48ea-bd1b-f3086f61b044",
    "shareUrl": "/matrix/view-history/abc123",
    "data": {
      "id": "d1019e1d-b9cd-4a72-873b-b864a49fea82",
      "matrixId": "10001",
      "matrixName": "Beahan Group Approval Matrix",
      "matrixDescription": "Audeo campana speculum thymum accusantium tenus.",
      "link": "/matrix/view/base64",
      "roleMatrix": true,
      "authorityMatrix": true,
      "tenantId": "b72c2ad3-3676-479c-b6e6-7f754c488663",
      "ownerId": "05747826-2033-450d-9947-a66ff1766e26",
      "matrixSections": [
        {
          "sectionId": "2ff23fd9-6dea-4876-8da2-3a43bc58f71a",
          "name": "Finance"
        }
      ],
      "matrixCategories": [
        {
          "categoryId": "891c8bdd-a089-4f44-ab22-00a5b2911f72",
          "name": "Approvals"
        }
      ],
      "decisionCount": 5,
      "delegationCount": 2,
      "suspendedDelegationsCount": 2,
      "pendingDelegationsCount": 2,
      "copiedFromMatrix": "4b9ea214-ddd7-4b5e-b161-d8b903656bb3",
      "ownerDetails": {
        "id": "c127e8f7-13da-4a50-859f-8564ed38294b",
        "email": "[email protected]",
        "name": "Roy Powlowski I",
        "firstName": "Dorthy",
        "lastName": "Kertzmann",
        "mobilePhone": "635-388-2189 x775",
        "isActive": true,
        "profileImageUrl": "https://avatars.githubusercontent.com/u/66649439",
        "positions": [
          {
            "id": "435effb5-898b-456b-aabe-4795bd4e260b",
            "positionName": "System Administrator",
            "autoProvisioned": true
          }
        ]
      },
      "createdOn": "2025-06-24T04:16:48.882Z",
      "updatedOn": "2025-06-24T00:37:13.311Z",
      "currentTab": "Sharing",
      "isFavorite": true,
      "matrixStatus": {
        "id": "4a548542-f1c7-444e-9064-dda8ab4168ba",
        "statusName": "Active",
        "isActive": true
      },
      "matrixSharing": {
        "id": "29a1b66a-16ab-4e84-b802-46ff07fffbd9",
        "type": "SHARED",
        "sharingOption": "USERS_GROUPS",
        "link": true,
        "viewerAdjustableFilters": true,
        "externalSharing": false,
        "users": [
          {
            "id": "32fdd6f8-6aaf-4bc6-af89-ea50865b91bf",
            "userId": "baf5a26a-26ec-475d-a18e-1817a47ca7cc",
            "userDetails": {
              "id": "c127e8f7-13da-4a50-859f-8564ed38294b",
              "email": "[email protected]",
              "name": "Roy Powlowski I",
              "firstName": "Dorthy",
              "lastName": "Kertzmann",
              "mobilePhone": "635-388-2189 x775",
              "isActive": true,
              "profileImageUrl": "https://avatars.githubusercontent.com/u/66649439",
              "positions": [
                {
                  "id": "435effb5-898b-456b-aabe-4795bd4e260b",
                  "positionName": "System Administrator",
                  "autoProvisioned": true
                }
              ]
            }
          }
        ],
        "groups": [
          {
            "id": "c07b3db7-621e-4d25-bad4-3c6ddc06a4da",
            "groupId": "cbbb3152-1d16-43ec-a5ad-eb604fbf3f3e",
            "groupDetails": {
              "id": "66bc5e67-4a01-4f6c-99d9-75d259ebf088",
              "groupName": "Finance Department",
              "tenantId": "251baf0f-d015-4fd3-ba86-28eb729f342c",
              "groupTypeName": "Department",
              "groupTypeId": "43754328-308d-43a7-9097-7ebc51474c7a",
              "status": "ACTIVE",
              "parentGroupIds": [
                "b8be636a-849a-4a09-bc28-e624104e980d"
              ],
              "isSynced": false
            }
          }
        ]
      },
      "matrixAuthorityRoles": [
        {
          "id": "9f787fb3-897b-4863-86ca-dc494d49a42e",
          "authorityRoleId": "320f5be2-3998-4231-8417-ebd9d29f7eeb",
          "isEnabled": true
        }
      ],
      "matrixGroups": [
        {
          "id": "d087ff44-f5f6-461c-9add-5305e4f60920",
          "tenantGroupsMappingId": "f9f7efc8-4dca-4914-910a-22915228ce94",
          "groupDetails": {
            "id": "66bc5e67-4a01-4f6c-99d9-75d259ebf088",
            "groupName": "Finance Department",
            "tenantId": "251baf0f-d015-4fd3-ba86-28eb729f342c",
            "groupTypeName": "Department",
            "groupTypeId": "43754328-308d-43a7-9097-7ebc51474c7a",
            "status": "ACTIVE",
            "parentGroupIds": [
              "b8be636a-849a-4a09-bc28-e624104e980d"
            ],
            "isSynced": false
          }
        }
      ],
      "matrixPositions": [
        {
          "id": "7aa8d2ad-82e2-4dd2-95f5-aca238f8ba5e",
          "positionId": "c864683d-a440-40df-8561-c310ea3c4e17",
          "positionDetails": {
            "id": "e5a73191-c107-47e2-a883-cad51e5abd03",
            "tenantId": "e9ffaaae-07b0-4960-a32d-80e1f600bd0f",
            "positionName": "System Administrator",
            "isScimProvisioned": false,
            "status": "ACTIVE",
            "groupIds": [
              "b52424e3-a334-4171-818c-d863ac406de4",
              "a6d41d50-fb63-4e8b-b8a4-241d2534ec25"
            ]
          }
        }
      ],
      "matrixUsers": [
        {
          "id": "d5316153-7c42-4a38-9136-4b41c656343f",
          "userId": "95e4fa48-9fb5-4fa2-b193-df89187be95d",
          "userDetails": {
            "id": "c127e8f7-13da-4a50-859f-8564ed38294b",
            "email": "[email protected]",
            "name": "Roy Powlowski I",
            "firstName": "Dorthy",
            "lastName": "Kertzmann",
            "mobilePhone": "635-388-2189 x775",
            "isActive": true,
            "profileImageUrl": "https://avatars.githubusercontent.com/u/66649439",
            "positions": [
              {
                "id": "435effb5-898b-456b-aabe-4795bd4e260b",
                "positionName": "System Administrator",
                "autoProvisioned": true
              }
            ]
          }
        }
      ],
      "matrixDecisions": [
        {
          "id": "88ae98b4-62fb-42d5-99cd-6c533840b562",
          "decisionId": "d5122be0-9c67-4172-942d-d6b53680f519",
          "isDisabled": false,
          "disabledOn": null
        }
      ],
      "matrixDelegation": {
        "authorityTypeIds": [
          "f0b63af0-99d8-47bb-a567-1ef3cf8cc338",
          "f3ca4dc6-c85c-4512-abff-d7fecdccff86"
        ],
        "delegationRole": true,
        "roleIds": [
          "b2692430-9e07-48bb-bfba-8b736b029192",
          "6830fc5c-3d3b-43b8-b2c0-49f02c926c8c"
        ],
        "issuanceStatusNames": [
          "Accepted",
          "Pending"
        ],
        "primaryLimitTypes": {
          "Value (Currency)": {
            "min": 1,
            "max": 2
          },
          "Time (Months)": {
            "min": 1,
            "max": 2
          },
          "Time (Years)": {
            "min": 1,
            "max": 2
          },
          "Authority": true
        },
        "delegationDataDetails": true,
        "delegationDataGroups": true,
        "delegationDataDocuments": true,
        "delegationDataConditions": true,
        "delegationDataAuthorities": true,
        "delegationDataRoles": true
      },
      "matrixAuthorityFormatting": {
        "valueAbbrevations": "Actual Values",
        "valueRounding": "0 decimals",
        "timeUnit": "Actual Values",
        "timeRounding": "0 decimals",
        "delegationIdentification": "Position Username",
        "displayCurrencyCode": "USD"
      },
      "permissions": [
        {
          "allowed": true,
          "relationship_key": "<string>"
        }
      ],
      "isUserSavedPersonalView": true
    },
    "authorityMatrix": {
      "header": {
        "name": "ProxyComm DOA Matrix 2024 (North America)",
        "description": "This authority matrix defines approval and signatory responsibilities across financial, operational, and strategic areas...",
        "decisionsCount": 25,
        "delegationsCount": 25,
        "owner": {
          "id": "c127e8f7-13da-4a50-859f-8564ed38294b",
          "email": "[email protected]",
          "name": "Roy Powlowski I",
          "firstName": "Dorthy",
          "lastName": "Kertzmann",
          "mobilePhone": "635-388-2189 x775",
          "isActive": true,
          "profileImageUrl": "https://avatars.githubusercontent.com/u/66649439",
          "positions": [
            {
              "id": "435effb5-898b-456b-aabe-4795bd4e260b",
              "positionName": "System Administrator",
              "autoProvisioned": true
            }
          ]
        }
      },
      "authorityTypes": [
        {
          "id": "5c9b2e7a-a07e-43a9-9eae-49cff13f44cd",
          "name": "Approval",
          "authorityHolders": [
            {
              "positionId": "a3fd1521-126e-4bbf-ac3b-258db4b33018",
              "positionName": "Chief Financial Officer",
              "userId": "c560de75-970c-4247-a0bb-0b98b01e2727",
              "personName": "Andy Greff",
              "userDetails": {},
              "isReserved": true
            }
          ]
        }
      ],
      "sections": [
        {
          "id": "5715626c-d8a7-4634-bdcd-49d56ac7e55e",
          "name": "Financial Authority",
          "categories": [
            {
              "id": "25e56bb1-c755-409b-8fc2-2018fd3384a4",
              "name": "Budget Approval",
              "decisions": [
                {
                  "id": "13ba655e-2915-4229-8af3-67498f0c24cb",
                  "name": "Operational Budgets: Approval of departmental operating budgets",
                  "authorityValues": [
                    {
                      "positionId": "dd052d01-86b3-415d-90a8-cb6903f34cd2",
                      "userId": "b8b8f20e-9604-495d-87c4-2a82ba939223",
                      "isReserved": true,
                      "authorityTypeId": "7bb8721f-fdb1-462b-968c-340f2e73a7dc",
                      "delegationId": "ccd57f37-87bd-4754-91df-38b6e7136664",
                      "primaryLimit": {
                        "authorityLimitValueType": "Value (currency)",
                        "authorityLimitValue": "1000000",
                        "authorityLimitValueUnit": "$"
                      },
                      "secondaryLimit": {
                        "authorityLimitValueType": "Value (currency)",
                        "authorityLimitValue": "1000000",
                        "authorityLimitValueUnit": "$"
                      },
                      "tertiaryLimit": {
                        "authorityLimitValueType": "Value (currency)",
                        "authorityLimitValue": "1000000",
                        "authorityLimitValueUnit": "$"
                      }
                    }
                  ]
                }
              ]
            }
          ]
        }
      ]
    },
    "roleMatrix": {
      "header": {
        "name": "ProxyComm DOA Matrix 2024 (North America)",
        "description": "This authority matrix defines approval and signatory responsibilities across financial, operational, and strategic areas...",
        "decisionsCount": 25,
        "delegationsCount": 25,
        "owner": {
          "id": "c127e8f7-13da-4a50-859f-8564ed38294b",
          "email": "[email protected]",
          "name": "Roy Powlowski I",
          "firstName": "Dorthy",
          "lastName": "Kertzmann",
          "mobilePhone": "635-388-2189 x775",
          "isActive": true,
          "profileImageUrl": "https://avatars.githubusercontent.com/u/66649439",
          "positions": [
            {
              "id": "435effb5-898b-456b-aabe-4795bd4e260b",
              "positionName": "System Administrator",
              "autoProvisioned": true
            }
          ]
        }
      },
      "authorityTypes": [
        {
          "id": "5c9b2e7a-a07e-43a9-9eae-49cff13f44cd",
          "name": "Approval",
          "authorityHolders": [
            {
              "positionId": "a3fd1521-126e-4bbf-ac3b-258db4b33018",
              "positionName": "Chief Financial Officer",
              "userId": "c560de75-970c-4247-a0bb-0b98b01e2727",
              "personName": "Andy Greff",
              "userDetails": {},
              "isReserved": true
            }
          ]
        }
      ],
      "sections": [
        {
          "id": "5715626c-d8a7-4634-bdcd-49d56ac7e55e",
          "name": "Financial Authority",
          "categories": [
            {
              "id": "25e56bb1-c755-409b-8fc2-2018fd3384a4",
              "name": "Budget Approval",
              "decisions": [
                {
                  "id": "13ba655e-2915-4229-8af3-67498f0c24cb",
                  "name": "Operational Budgets: Approval of departmental operating budgets",
                  "authorityValues": [
                    {
                      "positionId": "dd052d01-86b3-415d-90a8-cb6903f34cd2",
                      "userId": "b8b8f20e-9604-495d-87c4-2a82ba939223",
                      "isReserved": true,
                      "authorityTypeId": "7bb8721f-fdb1-462b-968c-340f2e73a7dc",
                      "delegationId": "ccd57f37-87bd-4754-91df-38b6e7136664",
                      "primaryLimit": {
                        "authorityLimitValueType": "Value (currency)",
                        "authorityLimitValue": "1000000",
                        "authorityLimitValueUnit": "$"
                      },
                      "secondaryLimit": {
                        "authorityLimitValueType": "Value (currency)",
                        "authorityLimitValue": "1000000",
                        "authorityLimitValueUnit": "$"
                      },
                      "tertiaryLimit": {
                        "authorityLimitValueType": "Value (currency)",
                        "authorityLimitValue": "1000000",
                        "authorityLimitValueUnit": "$"
                      }
                    }
                  ]
                }
              ]
            }
          ]
        }
      ]
    },
    "snapshotId": "386709a3-47f5-44f3-b1ec-9284c6df4873",
    "createdOn": "2025-06-23T22:03:20.658Z",
    "updatedOn": "2025-06-24T07:34:50.528Z"
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

tenantId
string
required
matrixId
string
required
historyDate
string
required

Response

200 - application/json

Matrix history retrieved successfully

The response is of type object.