---
updatedAt: 2026-08-13T20:37:34.000Z
agentTools:
  projectIndex: https://apidocs.graphiteconnect.com/llms.txt
---

# Get changes for a connection

Use this when retrieving changed data for a specific connected company.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "paths": {
    "/changes/{publicId}": {
      "get": {
        "operationId": "changes.get_for_connection",
        "summary": "Get changes for a connection",
        "description": "Use this when retrieving changed data for a specific connected company.",
        "parameters": [
          {
            "name": "publicId",
            "required": true,
            "in": "path",
            "description": "Graphite Public ID tied to the entity being queried",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "since",
            "required": false,
            "in": "query",
            "description": "Date to fetch all changes since.",
            "schema": {
              "format": "date-time",
              "type": "string"
            }
          },
          {
            "name": "interface",
            "required": false,
            "in": "query",
            "description": "Integration interface to fetch changes on",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "changeAnswerKeys",
            "required": false,
            "in": "query",
            "description": "List of change answer keys to fetch from graphite connect",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "referenceAnswerKeys",
            "required": false,
            "in": "query",
            "description": "List of answers keys to display regardless of change status. Will not display if changes in the object are only reference answer keys. Use alwaysVisibleAnswerKeys to always display answer key.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "alwaysVisibleAnswerKeys",
            "required": false,
            "in": "query",
            "description": "List of answers keys to display regardless of change status. Will still display if the key exists in an object with no other changes.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "excludedChangeTypes",
            "required": false,
            "in": "query",
            "description": "Change types to exclude.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "applyVisibilityRules",
            "required": false,
            "in": "query",
            "description": "Apply Visibility Rules",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "connectionRole",
            "required": false,
            "in": "query",
            "description": "Connection role to fetch answers as",
            "schema": {
              "enum": [
                "buyer",
                "seller",
                "both"
              ],
              "type": "string"
            }
          },
          {
            "name": "locale",
            "required": false,
            "in": "query",
            "description": "Graphite locale code to fetch answers in.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "translateValues",
            "required": false,
            "in": "query",
            "description": "Indicates if answers should be returned as their labels (e.g. United States) rather than their codes (e.g. US). Applies to any field that has a defined list of values. Can be set to a comma-delimited list of answer keys if a limited set of fields should be translated or set to \"true\" to have all fields translated.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "transformation",
            "required": false,
            "in": "query",
            "description": "The name of a transformation rule to apply to the payload",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "skipDiff",
            "required": false,
            "in": "query",
            "description": "Enable to skip diffing answers and return both the answers from history and the current answers",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "includeAllEntityAnswers",
            "required": false,
            "in": "query",
            "description": "Return all entity owned data regardless of change status",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "variables",
            "required": false,
            "in": "query",
            "description": "Pass additional variables to answers. Commonly used to filter transformations. Pipe Delimited key:value pairs",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "JSON document of changed company data.\n\t\t\tThis document contains changes that have occurred since the last time the client acknowledged\n\t\t\twith the Interface Parameter or after a provided date data with the Since parameter\n\t\t",
            "content": {
              "application/json": {
                "schema": {
                  "example": {
                    "entityId": "62a167c36c87a85464a4161da8bf87c2",
                    "connectionId": "62a167c36c87a85464a4161da8bf87c3",
                    "updatedAt": "2020-02-01T00:00:00Z",
                    "Entity_Name": "Test Company",
                    "ERP_Record": [
                      {
                        "_id": "62a167c36c87a85464a4161da8bf87c4",
                        "ERP_ID": "1234567",
                        "__changeType": "update"
                      }
                    ]
                  },
                  "type": "object",
                  "description": "Answer key"
                }
              }
            }
          }
        },
        "tags": [
          "Changes API"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    }
  },
  "info": {
    "title": "graphiteConnect Public API",
    "description": "graphiteConnect Public API Documentation",
    "version": "1.0",
    "contact": {}
  },
  "servers": [
    {
      "url": "/v1/"
    }
  ],
  "components": {
    "securitySchemes": {
      "bearer": {
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "type": "http"
      }
    }
  },
  "externalDocs": {
    "description": "Architectural documentation",
    "url": "https://projectgraphite.atlassian.net/wiki/spaces/GCPAD"
  }
}
```