Changelog & Sync Status

Endpoints for tracking what’s changed and when your data was last synced.

Get Changelog

GET /v1/changelog

View recent changes for the entity bound to your API key. All API writes are logged to the changelog.

Required scope: Any read scope

Query Parameters

Parameter	Default	Description
`page`	1	Page number
`limit`	100	Results per page
`since`		ISO 8601 timestamp — only return changes after this time

Example

curl "https://api.artland.com/v1/changelog?limit=10" \
  -H "Authorization: Bearer ak_liv...n```bash
curl "https://api.artland.com/v1/changelog?since=2026-06-15T00:00:00Z" \
  -H "Authorization: Bearer ak_liv...n### Response

```json
{
  "changes": [
    {
      "entity_type": "artwork",
      "entity_id": 123,
      "action": "create",
      "source": "api:ak_live_a1b2",
      "field_changes": {
        "title": { "old": null, "new": "Composition in Blue" }
      },
      "created_at": "2026-06-19T10:30:00Z"
    },
    {
      "entity_type": "artwork",
      "entity_id": 123,
      "action": "update",
      "source": "api:ak_live_a1b2",
      "field_changes": {
        "price": { "old": 45000, "new": 52000 }
      },
      "created_at": "2026-06-19T11:15:00Z"
    }
  ],
  "total": 47,
  "page": 1,
  "limit": 10
}

Changelog Fields

Field	Description
`entity_type`	`artwork`, `artist`, `event`, or `profile`
`entity_id`	ID of the affected entity
`action`	`create` or `update`
`source`	API key prefix that made the change
`field_changes`	Object showing old and new values for changed fields
`created_at`	ISO 8601 timestamp

Get Sync Status

GET /v1/sync/status

View when each entity type was last synced and how many records exist.

Required scope: Any read scope

Example

curl https://api.artland.com/v1/sync/status \
  -H "Authorization: Bearer ak_liv...n### Response

```json
{
  "artworks": {
    "last_synced": "2026-06-19T10:30:00Z",
    "count": 42
  },
  "artists": {
    "last_synced": "2026-06-19T09:15:00Z",
    "count": 8
  },
  "events": {
    "last_synced": "2026-06-18T16:00:00Z",
    "count": 3
  }
}