Skip to content

Get all notifications for an account with their templates

GET
/types
curl --request GET \
  --url https://api.pingram.io/types \
  --header 'Authorization: Bearer <token>'

Authorizations

Responses

200

Successful response

Media typeapplication/json
Array<object>
object
envId
required
string
notificationId
required
string
title
required
string
channels
required
Array<string>
Allowed values: EMAIL INAPP_WEB SMS CALL PUSH WEB_PUSH SLACK
enabled
required
boolean
deduplication
object
duration
required
number
throttling
object
max
required
number
period
required
number
unit
required
string
Allowed values: seconds minutes hours days months years
forever
required
boolean
scope
required
Array<string>
>= 2 items <= 2 items
Allowed values: userId notificationId
retention
number
options
object
EMAIL
object
defaultDeliveryOption
required
string
Allowed values: off instant hourly daily weekly monthly
off
object
enabled
required
boolean
instant
object
enabled
required
boolean
hourly
object
enabled
required
boolean
daily
object
enabled
required
boolean
hour
string
weekly
object
enabled
required
boolean
hour
string
day
string
monthly
object
enabled
required
boolean
hour
string
date
string
Allowed values: first last
INAPP_WEB
object
defaultDeliveryOption
required
string
Allowed values: off instant
off
object
enabled
required
boolean
instant
object
enabled
required
boolean
batching
boolean
batchingKey
string
batchingWindow
number
SMS
object
defaultDeliveryOption
required
string
Allowed values: off instant hourly daily weekly monthly
off
object
enabled
required
boolean
instant
object
enabled
required
boolean
hourly
object
enabled
required
boolean
daily
object
enabled
required
boolean
hour
string
weekly
object
enabled
required
boolean
hour
string
day
string
monthly
object
enabled
required
boolean
hour
string
date
string
Allowed values: first last
CALL
object
defaultDeliveryOption
required
string
Allowed values: off instant hourly daily weekly monthly
off
object
enabled
required
boolean
instant
object
enabled
required
boolean
hourly
object
enabled
required
boolean
daily
object
enabled
required
boolean
hour
string
weekly
object
enabled
required
boolean
hour
string
day
string
monthly
object
enabled
required
boolean
hour
string
date
string
Allowed values: first last
PUSH
object
defaultDeliveryOption
required
string
Allowed values: off instant hourly daily weekly monthly
off
object
enabled
required
boolean
instant
object
enabled
required
boolean
hourly
object
enabled
required
boolean
daily
object
enabled
required
boolean
hour
string
weekly
object
enabled
required
boolean
hour
string
day
string
monthly
object
enabled
required
boolean
hour
string
date
string
Allowed values: first last
WEB_PUSH
object
defaultDeliveryOption
required
string
Allowed values: off instant hourly daily weekly monthly
off
object
enabled
required
boolean
instant
object
enabled
required
boolean
hourly
object
enabled
required
boolean
daily
object
enabled
required
boolean
hour
string
weekly
object
enabled
required
boolean
hour
string
day
string
monthly
object
enabled
required
boolean
hour
string
date
string
Allowed values: first last
SLACK
object
defaultDeliveryOption
required
string
Allowed values: off instant hourly daily weekly monthly
off
object
enabled
required
boolean
instant
object
enabled
required
boolean
hourly
object
enabled
required
boolean
daily
object
enabled
required
boolean
hour
string
weekly
object
enabled
required
boolean
hour
string
day
string
monthly
object
enabled
required
boolean
hour
string
date
string
Allowed values: first last
templates
Array<object>
object
channel
required
string
Allowed values: EMAIL INAPP_WEB SMS CALL PUSH WEB_PUSH SLACK
templateIds
required
Array<string>
Example
[
  {
    "channels": [
      "EMAIL"
    ],
    "throttling": {
      "unit": "seconds",
      "scope": [
        "userId"
      ]
    },
    "options": {
      "EMAIL": {
        "defaultDeliveryOption": "off",
        "monthly": {
          "date": "first"
        }
      },
      "INAPP_WEB": {
        "defaultDeliveryOption": "off"
      },
      "SMS": {
        "defaultDeliveryOption": "off",
        "monthly": {
          "date": "first"
        }
      },
      "CALL": {
        "defaultDeliveryOption": "off",
        "monthly": {
          "date": "first"
        }
      },
      "PUSH": {
        "defaultDeliveryOption": "off",
        "monthly": {
          "date": "first"
        }
      },
      "WEB_PUSH": {
        "defaultDeliveryOption": "off",
        "monthly": {
          "date": "first"
        }
      },
      "SLACK": {
        "defaultDeliveryOption": "off",
        "monthly": {
          "date": "first"
        }
      }
    },
    "templates": [
      {
        "channel": "EMAIL"
      }
    ]
  }
]

400

Bad Request - validation errors, invalid input

Media typeapplication/json

Standard error response for API errors.

object
trackingId
required

Unique tracking ID for the request.

string
error
required

Structured error details for API error responses.

object
code
required

Machine-readable error code.

string
message
required

Human-readable error message.

string
fix

Actionable hint for fixing the error.

string
Examplegenerated
{
  "trackingId": "example",
  "error": {
    "code": "example",
    "message": "example",
    "fix": "example"
  }
}

401

Unauthorized

402

Payment Required - usage limits exceeded

Media typeapplication/json

Standard error response for API errors.

object
trackingId
required

Unique tracking ID for the request.

string
error
required

Structured error details for API error responses.

object
code
required

Machine-readable error code.

string
message
required

Human-readable error message.

string
fix

Actionable hint for fixing the error.

string
Examplegenerated
{
  "trackingId": "example",
  "error": {
    "code": "example",
    "message": "example",
    "fix": "example"
  }
}

500

Internal Server Error

502

Bad Gateway - provider error

Media typeapplication/json

Standard error response for API errors.

object
trackingId
required

Unique tracking ID for the request.

string
error
required

Structured error details for API error responses.

object
code
required

Machine-readable error code.

string
message
required

Human-readable error message.

string
fix

Actionable hint for fixing the error.

string
Examplegenerated
{
  "trackingId": "example",
  "error": {
    "code": "example",
    "message": "example",
    "fix": "example"
  }
}