API Reference

Retrieve an action update

Retrieves the details for a specific update to an action. Append the Id value for the specific action update you wish to retrieve. This value can be obtained by listing all action updates first.

🚧

Note

impact.com recommends using action lifecycle postbacks instead of the ActionUpdates endpoint for all but occasional requests in order to receive low latency (near realtime) action updates. Learn more about enabling postbacks here.

Parameters

No parameters.

Returns

Returns an action update object.

Example request

curl 'https://api.impact.com/Mediapartners/<AccountSID>/ActionUpdates/<ID>' \
	-X GET \
	-u '<AccountSID>:<AuthToken>' \
	-H 'Accept: application/json'

Example response

{
  "Id": "1000.1234.56789.10111213",
  "ActionId": "1000.1234.56789",
  "CampaignId": "1000",
  "ActionTrackerId": "10000",
  "EventCode": "",
  "State": "PENDING",
  "StateDetail": "",
  "StateDetailDescription": "Action comes in DEFAULT and a locking date has not been set yet",
  "AdId": "123456",
  "ReportingState": "IR_BLANK",
  "DeltaPayout": "0.26",
  "DeltaAmount": "17.29",
  "Currency": "USD",
  "Category": "Sports",
  "Sku": "123ABC456",
  "Quantity": "1",
  "CatalogName": "",
  "CatalogCategory": "",
  "CatalogDescription": "",
  "CatalogManufacturer": "",
  "CatalogOriginalFormatCategory": "",
  "CatalogSubCategory": "",
  "UpdateDate": "2021-04-25T02:07:45-04:00",
  "LockingDate": "2021-05-16T00:00:00-04:00",
  "ClearingDate": "2021-05-16T00:00:00-04:00",
  "ActionDate": "2021-04-24T19:50:23-04:00",
  "Oid": "O987654",
  "SubId1": "Blog",
  "SubId2": "Website",
  "SubId3": "",
  "PaystubId": "116142",
  "ContractId": "S-7751552",
  "EventTypeId": "10000",
  "EventTypeName": "Sale",
  "PayoutLevel": "ORDER",
  "DefaultPayout": "5.00",
  "DefaultPayoutCurrency": "USD",
  "SharedId": "",
  "ActionUri": "/Mediapartners/<AccountSID>/Actions/1000.1234.56789",
  "Uri": "/Mediapartners/<AccountSID>/ActionUpdates/1000.1234.56789.10111213"
}