Skip to main content
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": "2026-01-08T06:33:22.023Z",
  "message": "Success",
  "data": {
    "historyId": "157f4338-e8d8-4881-8ab1-869b0da59aa6",
    "historyDate": "2026-01-07T11:43:46.133Z",
    "matrixId": "69a7ce2b-63f1-4fac-8aff-f75177eb9b69",
    "data": {
      "id": "151efa58-ddbb-4d4a-a99a-7c3be5736f61",
      "matrixId": "10001",
      "matrixName": "Pagac - Kuvalis Approval Matrix",
      "matrixDescription": "Vomica sursum pariatur carcer.",
      "link": "/matrix/view/base64",
      "roleMatrix": true,
      "authorityMatrix": true,
      "tenantId": "49d7d738-c73c-4bcb-a413-1f986120855a",
      "ownerId": "cbe8bfb3-8d18-4e46-8bc8-ff7b764c5cb3",
      "decisionCount": 5,
      "delegationCount": 2,
      "copiedFromMatrix": "7fee7df1-3258-4ea8-9cef-43677e080395",
      "createdOn": "2026-01-07T20:16:28.638Z",
      "updatedOn": "2026-01-07T15:41:54.037Z",
      "matrixStatus": {
        "id": "8c2af516-88d6-4265-95d8-5bbd38b29fae",
        "statusName": "Active",
        "isActive": true
      },
      "matrixSharing": {
        "id": "45ea7f06-0011-43f4-8551-55f54447f298",
        "type": "SHARED",
        "sharingOption": "USERS_GROUPS",
        "link": true,
        "viewerAdjustableFilters": true,
        "externalSharing": false,
        "users": [
          {
            "id": "8111bdb2-e098-4dae-af0f-146b35ce3cb8",
            "userId": "bd61d3b1-1ef8-4a0f-8c14-8c62083b4c0e",
            "userDetails": {
              "id": "de3695df-aaf3-4a85-a02b-1a12655ee292",
              "email": "Rubye68@hotmail.com",
              "name": "Elias Graham MD",
              "displayName": "Helen Mohr IV",
              "firstName": "Esperanza",
              "lastName": "Murray",
              "mobilePhone": "1-493-376-0816",
              "isActive": true,
              "profileImageUrl": "https://cdn.jsdelivr.net/gh/faker-js/assets-person-portrait/male/512/72.jpg",
              "positions": [
                {
                  "id": "3ded4c3f-6d9e-4b53-970d-1bd37d66ffe7",
                  "positionName": "System Administrator",
                  "autoProvisioned": true
                }
              ],
              "primaryOrganization": {
                "groupName": "North America Region",
                "displayName": "North America Region",
                "tenantGroupTypeId": "6d8cbc6e-7bb1-4b48-88bb-8180c325bcb2",
                "tenantGroupTypeName": "Region"
              },
              "positionIds": [
                "a52c5b91-0fb2-492b-bddc-7ea49ee33324"
              ],
              "primaryOrganizationId": "d64eb258-6f52-4fbc-bb25-d1550009a854",
              "manager": {
                "id": "88d95fc1-0c1f-4f15-8ec2-a8efcf97cf97",
                "name": "Leon Bogisich",
                "displayName": "Pedro Toy DDS",
                "profileImageUrl": "https://cdn.jsdelivr.net/gh/faker-js/assets-person-portrait/female/512/53.jpg"
              },
              "roles": [
                {
                  "tenantRoleId": "a3ec8adc-96fc-4885-b14e-f273a0c26554",
                  "roleName": "System Administrator"
                }
              ],
              "groups": [
                {
                  "groupId": "159004f4-e8f9-49c0-b03c-552172d769b0",
                  "groupTypeId": "fb632b5b-8a45-43e0-95b2-f81a6017ed06"
                }
              ]
            }
          }
        ],
        "groups": [
          {
            "id": "ebf12383-9fbe-4b45-82db-f1f1a53065c8",
            "groupId": "6d80952b-1dec-43e6-aeec-663e9d43bf0b",
            "groupDetails": {
              "id": "2edae481-425c-4b95-a95f-2356204c84b5",
              "groupName": "Finance Department",
              "displayName": "Finance Department",
              "legalName": "Finance Department LLC",
              "tenantId": "8c1a760b-2f94-4d63-983f-834bda0b9664",
              "groupTypeName": "Department",
              "groupTypeId": "0c543086-e010-430d-981c-f2d162434478",
              "status": "ACTIVE",
              "parentGroupIds": [
                "624636ab-7f25-4e86-bfbc-7775a67fb60c"
              ],
              "isSynced": false
            }
          }
        ]
      },
      "matrixAuthorityRoles": [
        {
          "id": "42743462-f0eb-48e6-94f7-9295ffbe0a98",
          "authorityRoleId": "25a46c38-21dd-4b7f-a53b-e7a3fc7e8d93",
          "isEnabled": true
        }
      ],
      "matrixGroups": [
        {
          "id": "c90be4ec-5306-4a00-a818-4b45193c1b9e",
          "tenantGroupsMappingId": "0504d5fc-7075-4cc2-a172-a60c4bbfe816",
          "groupDetails": {
            "id": "2edae481-425c-4b95-a95f-2356204c84b5",
            "groupName": "Finance Department",
            "displayName": "Finance Department",
            "legalName": "Finance Department LLC",
            "tenantId": "8c1a760b-2f94-4d63-983f-834bda0b9664",
            "groupTypeName": "Department",
            "groupTypeId": "0c543086-e010-430d-981c-f2d162434478",
            "status": "ACTIVE",
            "parentGroupIds": [
              "624636ab-7f25-4e86-bfbc-7775a67fb60c"
            ],
            "isSynced": false
          }
        }
      ],
      "matrixPositions": [
        {
          "id": "37d09091-7f71-4572-9ed2-7a9f6330513d",
          "positionId": "72e810ec-bbb6-4ac9-b703-6d7374d854e7",
          "positionDetails": {
            "id": "141c47ca-351b-4653-abfb-6d886c60dcdc",
            "tenantId": "7f798579-7373-49cc-831a-6f8e0064c02b",
            "positionName": "System Administrator",
            "isScimProvisioned": false,
            "status": "ACTIVE",
            "groupIds": [
              "8bcee726-cc45-4e45-9e3b-60ba3e32bd8e",
              "70e09536-afed-438a-aa40-e12e8a6abae4"
            ]
          }
        }
      ],
      "matrixUsers": [
        {
          "id": "c51ea83f-8157-437a-b4f0-936db66726ba",
          "userId": "3746c737-9003-458d-9460-85d0ffa9e27d",
          "userDetails": {
            "id": "de3695df-aaf3-4a85-a02b-1a12655ee292",
            "email": "Rubye68@hotmail.com",
            "name": "Elias Graham MD",
            "displayName": "Helen Mohr IV",
            "firstName": "Esperanza",
            "lastName": "Murray",
            "mobilePhone": "1-493-376-0816",
            "isActive": true,
            "profileImageUrl": "https://cdn.jsdelivr.net/gh/faker-js/assets-person-portrait/male/512/72.jpg",
            "positions": [
              {
                "id": "3ded4c3f-6d9e-4b53-970d-1bd37d66ffe7",
                "positionName": "System Administrator",
                "autoProvisioned": true
              }
            ],
            "primaryOrganization": {
              "groupName": "North America Region",
              "displayName": "North America Region",
              "tenantGroupTypeId": "6d8cbc6e-7bb1-4b48-88bb-8180c325bcb2",
              "tenantGroupTypeName": "Region"
            },
            "positionIds": [
              "a52c5b91-0fb2-492b-bddc-7ea49ee33324"
            ],
            "primaryOrganizationId": "d64eb258-6f52-4fbc-bb25-d1550009a854",
            "manager": {
              "id": "88d95fc1-0c1f-4f15-8ec2-a8efcf97cf97",
              "name": "Leon Bogisich",
              "displayName": "Pedro Toy DDS",
              "profileImageUrl": "https://cdn.jsdelivr.net/gh/faker-js/assets-person-portrait/female/512/53.jpg"
            },
            "roles": [
              {
                "tenantRoleId": "a3ec8adc-96fc-4885-b14e-f273a0c26554",
                "roleName": "System Administrator"
              }
            ],
            "groups": [
              {
                "groupId": "159004f4-e8f9-49c0-b03c-552172d769b0",
                "groupTypeId": "fb632b5b-8a45-43e0-95b2-f81a6017ed06"
              }
            ]
          }
        }
      ],
      "matrixDecisions": [
        {
          "id": "fbe1d724-8eff-4d93-9b59-5e7cd66abeba",
          "decisionId": "a7149654-b694-4f1c-9169-a817567d8641",
          "isDisabled": false,
          "disabledOn": null
        }
      ],
      "matrixSections": [
        {
          "sectionId": "47a84333-47ab-4b24-aa3d-4706de8b371b",
          "name": "Finance"
        }
      ],
      "matrixCategories": [
        {
          "categoryId": "fcf3c54d-3adf-4bf9-974b-6d0b093099a2",
          "name": "Approvals"
        }
      ],
      "suspendedDelegationsCount": 2,
      "pendingDelegationsCount": 2,
      "ownerDetails": {
        "id": "de3695df-aaf3-4a85-a02b-1a12655ee292",
        "email": "Rubye68@hotmail.com",
        "name": "Elias Graham MD",
        "displayName": "Helen Mohr IV",
        "firstName": "Esperanza",
        "lastName": "Murray",
        "mobilePhone": "1-493-376-0816",
        "isActive": true,
        "profileImageUrl": "https://cdn.jsdelivr.net/gh/faker-js/assets-person-portrait/male/512/72.jpg",
        "positions": [
          {
            "id": "3ded4c3f-6d9e-4b53-970d-1bd37d66ffe7",
            "positionName": "System Administrator",
            "autoProvisioned": true
          }
        ],
        "primaryOrganization": {
          "groupName": "North America Region",
          "displayName": "North America Region",
          "tenantGroupTypeId": "6d8cbc6e-7bb1-4b48-88bb-8180c325bcb2",
          "tenantGroupTypeName": "Region"
        },
        "positionIds": [
          "a52c5b91-0fb2-492b-bddc-7ea49ee33324"
        ],
        "primaryOrganizationId": "d64eb258-6f52-4fbc-bb25-d1550009a854",
        "manager": {
          "id": "88d95fc1-0c1f-4f15-8ec2-a8efcf97cf97",
          "name": "Leon Bogisich",
          "displayName": "Pedro Toy DDS",
          "profileImageUrl": "https://cdn.jsdelivr.net/gh/faker-js/assets-person-portrait/female/512/53.jpg"
        },
        "roles": [
          {
            "tenantRoleId": "a3ec8adc-96fc-4885-b14e-f273a0c26554",
            "roleName": "System Administrator"
          }
        ],
        "groups": [
          {
            "groupId": "159004f4-e8f9-49c0-b03c-552172d769b0",
            "groupTypeId": "fb632b5b-8a45-43e0-95b2-f81a6017ed06"
          }
        ]
      },
      "currentTab": "Sharing",
      "isFavorite": true,
      "matrixDelegation": {
        "delegationRole": true,
        "delegationDataDetails": true,
        "delegationDataGroups": true,
        "delegationDataDocuments": true,
        "delegationDataConditions": true,
        "delegationDataAuthorities": true,
        "delegationDataRoles": true,
        "authorityTypeIds": [
          "ef444051-af8a-4ce0-a2e8-4e0d0d588c0d",
          "e50a087e-f0e5-499b-8314-35e5856712e8"
        ],
        "roleIds": [
          "2a8bbebc-8e8c-40da-a55c-ac0f327bc3bb",
          "3cb123a4-6561-42ea-9560-7211f289ecf1"
        ],
        "issuanceStatusNames": [
          "Accepted",
          "Pending"
        ],
        "primaryLimitTypes": {
          "Value (Currency)": {
            "min": 1,
            "max": 2
          },
          "Time (Months)": {
            "min": 1,
            "max": 2
          },
          "Time (Years)": {
            "min": 1,
            "max": 2
          },
          "Authority": true
        }
      },
      "matrixAuthorityFormatting": {
        "valueAbbrevations": "Actual Values",
        "valueRounding": "0 decimals",
        "timeUnit": "Actual Values",
        "timeRounding": "0 decimals",
        "delegationIdentification": "Position Username",
        "displayCurrencyCode": "USD"
      },
      "permissions": [
        {
          "relationship_key": "<string>",
          "allowed": true
        }
      ],
      "isUserSavedPersonalView": true,
      "matrixExternalSharing": {
        "id": "<string>",
        "link": "<string>",
        "isExpirationEnabled": true,
        "expirationDate": "2026-01-08T06:33:22.245Z",
        "isPasswordRequired": true,
        "matrixSharingId": "<string>",
        "matrixId": "<string>",
        "createdOn": "2026-01-08T06:33:22.246Z",
        "updatedOn": "2026-01-08T06:33:22.246Z",
        "password": "<string>"
      }
    },
    "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": "de3695df-aaf3-4a85-a02b-1a12655ee292",
          "email": "Rubye68@hotmail.com",
          "name": "Elias Graham MD",
          "displayName": "Helen Mohr IV",
          "firstName": "Esperanza",
          "lastName": "Murray",
          "mobilePhone": "1-493-376-0816",
          "isActive": true,
          "profileImageUrl": "https://cdn.jsdelivr.net/gh/faker-js/assets-person-portrait/male/512/72.jpg",
          "positions": [
            {
              "id": "3ded4c3f-6d9e-4b53-970d-1bd37d66ffe7",
              "positionName": "System Administrator",
              "autoProvisioned": true
            }
          ],
          "primaryOrganization": {
            "groupName": "North America Region",
            "displayName": "North America Region",
            "tenantGroupTypeId": "6d8cbc6e-7bb1-4b48-88bb-8180c325bcb2",
            "tenantGroupTypeName": "Region"
          },
          "positionIds": [
            "a52c5b91-0fb2-492b-bddc-7ea49ee33324"
          ],
          "primaryOrganizationId": "d64eb258-6f52-4fbc-bb25-d1550009a854",
          "manager": {
            "id": "88d95fc1-0c1f-4f15-8ec2-a8efcf97cf97",
            "name": "Leon Bogisich",
            "displayName": "Pedro Toy DDS",
            "profileImageUrl": "https://cdn.jsdelivr.net/gh/faker-js/assets-person-portrait/female/512/53.jpg"
          },
          "roles": [
            {
              "tenantRoleId": "a3ec8adc-96fc-4885-b14e-f273a0c26554",
              "roleName": "System Administrator"
            }
          ],
          "groups": [
            {
              "groupId": "159004f4-e8f9-49c0-b03c-552172d769b0",
              "groupTypeId": "fb632b5b-8a45-43e0-95b2-f81a6017ed06"
            }
          ]
        }
      },
      "authorityTypes": [
        {
          "id": "bc1773ab-e595-44ea-af7a-adc330a53f32",
          "name": "Approval",
          "authorityHolders": [
            {
              "positionId": "aeb6a8a3-653f-4ceb-a7aa-a57ccb8750dd",
              "positionName": "Chief Financial Officer",
              "userId": "b62ca024-7fd1-4972-911e-eb0cdd2ff81a",
              "personName": "Andy Greff",
              "userDetails": {},
              "isReserved": true
            }
          ]
        }
      ],
      "sections": [
        {
          "id": "42492b67-033e-4bac-9af9-3d288e5e8561",
          "name": "Financial Authority",
          "categories": [
            {
              "id": "2853503f-486b-42a6-99d3-faabc367b4b4",
              "name": "Budget Approval",
              "decisions": [
                {
                  "id": "53ea032b-163c-4fac-b612-ccb105717174",
                  "name": "Operational Budgets: Approval of departmental operating budgets",
                  "description": "Operational Budgets: Approval of departmental operating budgets",
                  "authorityValues": [
                    {
                      "positionId": "c42f4a62-935c-428c-9955-47478b6a8d85",
                      "userId": "bd4572cd-fbf4-40b4-a73f-00639f782619",
                      "isReserved": true,
                      "authorityTypeId": "e12e3ff8-7007-45c8-8498-e42e956ff44f",
                      "primaryLimit": {
                        "authorityLimitValueType": "Value (currency)",
                        "authorityLimitValue": "1000000",
                        "authorityLimitValueUnit": "$"
                      },
                      "delegationId": "e3916c58-432a-4c36-899d-190ee076d1ba",
                      "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": "de3695df-aaf3-4a85-a02b-1a12655ee292",
          "email": "Rubye68@hotmail.com",
          "name": "Elias Graham MD",
          "displayName": "Helen Mohr IV",
          "firstName": "Esperanza",
          "lastName": "Murray",
          "mobilePhone": "1-493-376-0816",
          "isActive": true,
          "profileImageUrl": "https://cdn.jsdelivr.net/gh/faker-js/assets-person-portrait/male/512/72.jpg",
          "positions": [
            {
              "id": "3ded4c3f-6d9e-4b53-970d-1bd37d66ffe7",
              "positionName": "System Administrator",
              "autoProvisioned": true
            }
          ],
          "primaryOrganization": {
            "groupName": "North America Region",
            "displayName": "North America Region",
            "tenantGroupTypeId": "6d8cbc6e-7bb1-4b48-88bb-8180c325bcb2",
            "tenantGroupTypeName": "Region"
          },
          "positionIds": [
            "a52c5b91-0fb2-492b-bddc-7ea49ee33324"
          ],
          "primaryOrganizationId": "d64eb258-6f52-4fbc-bb25-d1550009a854",
          "manager": {
            "id": "88d95fc1-0c1f-4f15-8ec2-a8efcf97cf97",
            "name": "Leon Bogisich",
            "displayName": "Pedro Toy DDS",
            "profileImageUrl": "https://cdn.jsdelivr.net/gh/faker-js/assets-person-portrait/female/512/53.jpg"
          },
          "roles": [
            {
              "tenantRoleId": "a3ec8adc-96fc-4885-b14e-f273a0c26554",
              "roleName": "System Administrator"
            }
          ],
          "groups": [
            {
              "groupId": "159004f4-e8f9-49c0-b03c-552172d769b0",
              "groupTypeId": "fb632b5b-8a45-43e0-95b2-f81a6017ed06"
            }
          ]
        }
      },
      "authorityTypes": [
        {
          "id": "bc1773ab-e595-44ea-af7a-adc330a53f32",
          "name": "Approval",
          "authorityHolders": [
            {
              "positionId": "aeb6a8a3-653f-4ceb-a7aa-a57ccb8750dd",
              "positionName": "Chief Financial Officer",
              "userId": "b62ca024-7fd1-4972-911e-eb0cdd2ff81a",
              "personName": "Andy Greff",
              "userDetails": {},
              "isReserved": true
            }
          ]
        }
      ],
      "sections": [
        {
          "id": "42492b67-033e-4bac-9af9-3d288e5e8561",
          "name": "Financial Authority",
          "categories": [
            {
              "id": "2853503f-486b-42a6-99d3-faabc367b4b4",
              "name": "Budget Approval",
              "decisions": [
                {
                  "id": "53ea032b-163c-4fac-b612-ccb105717174",
                  "name": "Operational Budgets: Approval of departmental operating budgets",
                  "description": "Operational Budgets: Approval of departmental operating budgets",
                  "authorityValues": [
                    {
                      "positionId": "c42f4a62-935c-428c-9955-47478b6a8d85",
                      "userId": "bd4572cd-fbf4-40b4-a73f-00639f782619",
                      "isReserved": true,
                      "authorityTypeId": "e12e3ff8-7007-45c8-8498-e42e956ff44f",
                      "primaryLimit": {
                        "authorityLimitValueType": "Value (currency)",
                        "authorityLimitValue": "1000000",
                        "authorityLimitValueUnit": "$"
                      },
                      "delegationId": "e3916c58-432a-4c36-899d-190ee076d1ba",
                      "secondaryLimit": {
                        "authorityLimitValueType": "Value (currency)",
                        "authorityLimitValue": "1000000",
                        "authorityLimitValueUnit": "$"
                      },
                      "tertiaryLimit": {
                        "authorityLimitValueType": "Value (currency)",
                        "authorityLimitValue": "1000000",
                        "authorityLimitValueUnit": "$"
                      }
                    }
                  ]
                }
              ]
            }
          ]
        }
      ]
    },
    "createdOn": "2026-01-07T12:50:37.069Z",
    "updatedOn": "2026-01-07T12:08:12.997Z",
    "shareUrl": "/matrix/view-history/abc123",
    "snapshotId": "0aedfb0b-e3bb-4793-96e5-afb1bac549fd"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.aptlydone.com/llms.txt

Use this file to discover all available pages before exploring further.

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

ā€‹
statusCode
number
required

HTTP Status code

Example:

200

ā€‹
timestamp
string
required

Timestamp of the response

Example:

"2026-01-08T06:33:22.023Z"

ā€‹
message
string
required

Response message

Example:

"Success"

ā€‹
data
object
required

Response data