Changelog API

Change logs can be viewed using the API.

Getting Changelogs

REST API

Method: GET

Endpoint: /api/v1/changelogs

Query Parameters (all are optional):

change_type
- created
- updated
- destroyed
time (recommended)
- today
- yesterday
- last_7_days
- last_30_days
- last_year
user
- exclude_system_updates (recommended by default)
- user@email.com (a specific user email)
- 1234 (ID of user account)
versioned_type
- Account
- AccountSetting
- Bill
- UserAccount
- DirectConnection
- DemandPartner
- Campaign
- DemandTag
- Creative
- DemandLabel
- ModifierRule
- Modifier
- Deal
- HbBidMap
- SupplyPartner
- SupplyRouter
- SupplyTag
- Pod
- SupplyLabel
- PodSchedule
- InventoryGroup
- DomainList
- AppBundleList
- AppNameList
- DealList
- IabCategoryList
- AdvertiserDomainList
- ScannedCreativeList
- IpList
- TargetingList
- GeoList
- ObjectIdList
- PartnerSegment
- AccountPartnerSegment
- Segment
- SegmentGroup
- TargetingTimeProfile
- TargetingSpendProfile
- TargetingPageAttributeProfile
- TargetingGeoProfile
- BillItem
- Key
- ValueList
- ScheduledReport
- ReportTemplate
- ObjectForecast
- GlobalFcapPixel
- UiTheme

cURL Example

Example for "Find change logs in the past 7 days for IP Lists, exclude system updates":

curl -X GET \ 'https://console.springserve.com/api/v1/changelogs?time=last_7_days&user=exclude_system_updates&versioned_type=IpList' \ --header 'Accept: /' \ --header 'Authorization: authtokenhere'

Response: Status code 200

{
  "count": 1,
  "total_count": 1,
  "current_page": 1,
  "total_pages": 1,
  "includable_fields": [
    "user",
    "version_object_change"
  ],
  "results": [
    {
      "id": 633104052,
      "versioned_type": "IpList",
      "versioned_id": 2315,
      "description": "Changed Items count",
      "change_type": "updated",
      "updated_at": "2024-09-25T21:08:05.806Z",
      "user": {
        "id": 12345,
        "name": "SpringServe Admin User",
        "email": "admin-user@springserve.com"
      }
    }
  ]
}