Notifications

Notifications Documentation

Notification [LIST]

Request

Endpoint

GET /api/v2/account_lists/f57c62c4-d83c-48d9-9ffe-c8637aa567ad/notifications
Content-Type: application/vnd.api+json

Body

Parameters

Filters

cleared

Type boolean

Description Filter checks if cleared is either "true" or "false"

Required No

Response

Headers

Content-Type: application/vnd.api+json; charset=utf-8
200 OK

Body

{
  "data": [
    {
      "id": "e3b7973f-7763-489b-ae8d-43355350dc9a",
      "type": "notifications",
      "attributes": {
        "cleared": false,
        "created_at": "2021-11-23T14:38:22Z",
        "event_date": "2012-10-23T17:03:15Z",
        "updated_at": "2021-11-23T14:38:22Z",
        "updated_in_db_at": "2021-11-23T14:38:22Z"
      },
      "relationships": {
        "contact": {
          "data": {
            "id": "b823319d-abe8-43ae-89bb-2eeb43192474",
            "type": "contacts"
          }
        },
        "notification_type": {
          "data": {
            "id": "72cbdca4-49d3-44a2-9ae1-49f0aa170c0a",
            "type": "notification_type"
          }
        },
        "donation": {
          "data": {
            "id": "e07e1053-cc90-4f95-9330-5573e126d3ab",
            "type": "donations"
          }
        }
      }
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "per_page": 25,
      "total_count": 1,
      "total_pages": 1
    },
    "sort": null,
    "filter": {
    }
  }
}

Fields

data

Type [Notification]

Description An array of Notifications

Notification [GET]

Request

Endpoint

GET /api/v2/account_lists/a35401f6-3a0d-4024-a45f-f921c824a999/notifications/fd0700ad-352c-4a44-808f-1f20b48e1f73
Content-Type: application/vnd.api+json

Body

Response

Headers

Content-Type: application/vnd.api+json; charset=utf-8
200 OK

Body

{
  "data": {
    "id": "fd0700ad-352c-4a44-808f-1f20b48e1f73",
    "type": "notifications",
    "attributes": {
      "cleared": false,
      "created_at": "2021-11-23T14:38:22Z",
      "event_date": "2012-10-23T17:03:15Z",
      "updated_at": "2021-11-23T14:38:22Z",
      "updated_in_db_at": "2021-11-23T14:38:22Z"
    },
    "relationships": {
      "contact": {
        "data": {
          "id": "7060709a-635e-4442-8f4d-82cfd79d02e7",
          "type": "contacts"
        }
      },
      "notification_type": {
        "data": {
          "id": "c1a2cf2a-dfda-4318-9518-889865061c02",
          "type": "notification_type"
        }
      },
      "donation": {
        "data": {
          "id": "2792d5ef-3599-4f64-82bd-2045f7ef63e0",
          "type": "donations"
        }
      }
    }
  }
}

Fields

Attributes

cleared

Type boolean

Description If this notification has been read by the user then cleared should be marked as true

created_at

Type date

Description The timestamp of when this resource was created

event_date

Type date

Description The date the event that triggered the notification occured

updated_at

Type date

Description The timestamp of when this resource was last updated

updated_in_db_at

Type date

Description This is to be used as a reference for the last time the resource was updated in the remote database - specifically for when data is updated while the client is offline.

Relationships

contact.data

Type Contact

Description The Contact the notification applies to

donation.data

Type Donation

Description The Donation the notification applies to (Optional)

notification_type.data

Type NotificationType

Description The notification type indicating what event triggered the notification

Notification [PUT]

Request

Endpoint

PUT /api/v2/account_lists/25d4e465-0350-40b9-9394-9bf548728a94/notifications/af606ec5-9441-4f3c-a2f6-5fb17bcfa68f
Content-Type: application/vnd.api+json

Body

{
  "data": {
    "type": "notifications",
    "attributes": {
      "cleared": false,
      "updated_in_db_at": "2021-11-23 14:38:22 UTC"
    }
  }
}

Parameters

Attributes

cleared

Type boolean

Description If this notification has been read by the user then cleared should be marked as true

Required No

created_at

Type date

Description The timestamp of when this resource was created

Required No

overwrite

Type boolean

Description Only used for updating a record where you want to ignore the server's ' 'updated_in_db_at value and force overwrite the values for the record. ' 'Must be true to work.

Required No

updated_at

Type date

Description The timestamp of when this resource was last updated

Required No

updated_in_db_at

Type date

Description This is to be used as a reference for the last time the resource was updated in the remote database - specifically for when data is updated while the client is offline.

Required No

Response

Headers

Content-Type: application/vnd.api+json; charset=utf-8
200 OK

Body

{
  "data": {
    "id": "af606ec5-9441-4f3c-a2f6-5fb17bcfa68f",
    "type": "notifications",
    "attributes": {
      "cleared": false,
      "created_at": "2021-11-23T14:38:22Z",
      "event_date": "2012-10-23T17:03:15Z",
      "updated_at": "2021-11-23T14:38:22Z",
      "updated_in_db_at": "2021-11-23T14:38:22Z"
    },
    "relationships": {
      "contact": {
        "data": {
          "id": "47e8ec2f-f554-4064-8ad3-5765d2da84d1",
          "type": "contacts"
        }
      },
      "notification_type": {
        "data": {
          "id": "adf0831b-42ca-4ca8-9a1c-66c2fd33de20",
          "type": "notification_type"
        }
      },
      "donation": {
        "data": {
          "id": "2abad75f-bfda-47f2-87bf-276a1bea6e7b",
          "type": "donations"
        }
      }
    }
  }
}

Fields

Attributes

cleared

Type boolean

Description If this notification has been read by the user then cleared should be marked as true

created_at

Type date

Description The timestamp of when this resource was created

event_date

Type date

Description The date the event that triggered the notification occured

updated_at

Type date

Description The timestamp of when this resource was last updated

updated_in_db_at

Type date

Description This is to be used as a reference for the last time the resource was updated in the remote database - specifically for when data is updated while the client is offline.

Relationships

contact.data

Type Contact

Description The Contact the notification applies to

donation.data

Type Donation

Description The Donation the notification applies to (Optional)

notification_type.data

Type NotificationType

Description The notification type indicating what event triggered the notification

Notification [CLEAR]

Request

Endpoint

PUT /api/v2/account_lists/53cec1a6-9a5d-4b59-98ae-d2b348cca2f1/notifications/clear
Content-Type: application/vnd.api+json

Body

Response

Headers

Content-Type: text/html
200 OK

Body

Fields

Attributes

created_at

Type date

Description The timestamp of when this resource was created

updated_at

Type date

Description The timestamp of when this resource was last updated

updated_in_db_at

Type date

Description This is to be used as a reference for the last time the resource was updated in the remote database - specifically for when data is updated while the client is offline.

PreviousBulk NextPledges

Last updated 2 years ago