Skip to content

NP6 API Reference (8.1.0)

This documentation provides comprehensive access to the full range of functionalities offered by the NP6 platform through a standardized RESTful interface.

If you have any questions or need assistance, please contact our support team at https://support.chapsvision.com.

Languages
Servers
Production server
https://api-cm.np6.com

Email & SMS

Operations

Notification

Operations

Archives

Operations

Email & SMS

Operations

Retrieve events of all actions

Request

Query
startstring(date-time)

Defines a start date filter
Specify this parameter to retrieve only events with a timestamp greater than or equal to the specified value
You can use an ISO format date or a timestamp

endstring(date-time)

Defines an end date filter
Specify this parameter to retrieve only events with a timestamp less than the specified value
You can use an ISO format date or a timestamp

sortstring

Defines a sort order applied on events timestamp
By default, events are unordered and may not streamed in the same order between two requests
You should use this query parameter if you want to guarantee the sort order of events

Enum"asc""desc"
Headers
X-Keystringrequired

A unique API key used to authenticate requests to the NP6 platform. This key must be included in every API call to validate the identity and permissions of the client. Keep your API key secure and do not expose it in public code or logs.

curl -i -X GET \
  'https://api-cm.np6.com/actions/events?start=2019-08-24T14%3A15%3A22Z&end=2019-08-24T14%3A15%3A22Z&sort=asc' \
  -H 'X-Key: string'

Responses

An array of events

Bodyapplication/jsonArray [
typestring
Discriminator
idstring(uuid)

Uuid of the event

timestampinteger(int64)

Publication timestamp of the event
This is the number of milliseconds elapsed since January 1, 1970 00:00:00 UTC.

identityobject

Underlying identity of the event

typestring
Discriminator
sourceobject

Source of the event

typestring
Discriminator
detailobject

Detail of the execution

]
Response
application/json
[
  {
    "type": "bounce",
    "id": "14d3d192-bd40-4c0b-9048-4469ab3a981c",
    "timestamp": 1614089593000,
    "identity": {
      "type": "customer",
      "agency": "DEMO",
      "customer": "028"
    },
    "source": {
      "type": "email",
      "detail": {
        "activation": {
          "id": "000PE4",
          "kind": "message",
          "receiver": {
            "type": "id",
            "value": "0013KDC8"
          },
          "stamp": {
            "time": 1614089576625,
            "id": "4d3eb218-1887-4c43-b287-cac59acec5ea",
            "thread": "671d5989-3bdb-41fc-96c4-7acbdcb8de5e"
          },
          "recipient": "example@blabla.com"
        },
        "bounce": {
          "status": {
            "type": "sync",
            "code": {
              "enhanced": "5.1.2"
            },
            "diagnostic": "bad destination system: no such domain",
            "mta": ""
          },
          "analysis": {
            "verdict": "hard",
            "subject": {
              "type": "address",
              "detail": {
                "type": "bad destination system address"
              }
            }
          }
        }
      }
    }
  },
  {
    "type": "hit",
    "id": "d6d3af4e-762d-4c8b-bbe3-578ad5925f02",
    "timestamp": 1623673176622,
    "identity": {
      "type": "customer",
      "agency": "DEMO",
      "customer": "028"
    },
    "source": {
      "type": "email",
      "detail": {
        "activation": {
          "id": "000PE4",
          "kind": "message",
          "receiver": {
            "type": "footprint",
            "id": "000R4M0T",
            "unicity": "example@np6.com",
            "hash": "0441619ab4631d18548aa8835dd2c28b"
          },
          "stamp": {
            "time": 1614089576625,
            "id": "d52055cd-e854-4177-8ef5-b10fd8d568a7",
            "thread": "a3078b19-b379-4bc2-b29a-e8229a9c9332"
          },
          "recipient": "example@np6.com"
        },
        "link": {
          "type": "redirection",
          "label": "homepage",
          "source": "html",
          "destination": "https://www.np6.fr"
        },
        "client": {
          "type": "web",
          "ip": {
            "type": "v4",
            "value": "10.1.1.1"
          },
          "ua": {
            "type": "parsed",
            "ua": "Mozilla/5.0 (Linux; Android 9; AMN-LX9) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.88 Mobile Safari/537.36",
            "client": {
              "type": "Mobile browser",
              "name": "Chrome Mobile",
              "version": "91.0.4472.88",
              "vendor": "Google Inc."
            },
            "os": {
              "name": "Android 9.0 Pie",
              "family": "Android",
              "vendor": "Google Inc."
            },
            "device": {
              "type": "Smartphone",
              "name": "Y5 (2019)",
              "brand": "Huawei"
            }
          }
        }
      }
    }
  }
]

Retrieve activations of all actions

Request

Query
startstring(date-time)

Defines a start date filter
Specify this parameter to retrieve only events with a timestamp greater than or equal to the specified value
You can use an ISO format date or a timestamp

endstring(date-time)

Defines an end date filter
Specify this parameter to retrieve only events with a timestamp less than the specified value
You can use an ISO format date or a timestamp

sortstring

Defines a sort order applied on events timestamp
By default, events are unordered and may not streamed in the same order between two requests
You should use this query parameter if you want to guarantee the sort order of events

Enum"asc""desc"
Headers
X-Keystringrequired

A unique API key used to authenticate requests to the NP6 platform. This key must be included in every API call to validate the identity and permissions of the client. Keep your API key secure and do not expose it in public code or logs.

curl -i -X GET \
  'https://api-cm.np6.com/actions/events/activations?start=2019-08-24T14%3A15%3A22Z&end=2019-08-24T14%3A15%3A22Z&sort=asc' \
  -H 'X-Key: string'

Responses

An array of activation events

Bodyapplication/jsonArray [
idstring(uuid)

Uuid of the event

timestampinteger(int64)

Publication timestamp of the event
This is the number of milliseconds elapsed since January 1, 1970 00:00:00 UTC.

identityobject

Underlying identity of the event

typestring
Discriminator
sourceobject

Source of the event

typestring
Discriminator
detailobject

Detail of the activation

]
Response
application/json
[
  {
    "type": "activation",
    "id": "86bc0a5d-28cb-5128-af60-5efd273d7f75",
    "timestamp": 1614089582000,
    "identity": {
      "type": "customer",
      "agency": "DEMO",
      "customer": "028"
    },
    "source": {
      "type": "email",
      "detail": {
        "activation": {
          "id": "000PE4",
          "kind": "message",
          "receiver": {
            "type": "footprint",
            "id": "000R4M0T",
            "unicity": "example@np6.com",
            "hash": "0441619ab4631d18548aa8835dd2c28b"
          },
          "stamp": {
            "time": 1614089576625,
            "id": "d52055cd-e854-4177-8ef5-b10fd8d568a7",
            "thread": "a3078b19-b379-4bc2-b29a-e8229a9c9332"
          },
          "recipient": "example@np6.com"
        }
      }
    }
  },
  {
    "type": "activation",
    "id": "5db566ce-fdd9-408b-a8ce-890e2a707f26",
    "timestamp": 1614089593000,
    "identity": {
      "type": "customer",
      "agency": "DEMO",
      "customer": "028"
    },
    "source": {
      "type": "email",
      "detail": {
        "activation": {
          "id": "000PE5",
          "kind": "message",
          "receiver": {
            "type": "footprint",
            "id": "000R4M0T",
            "unicity": "example@np6.com",
            "hash": "0441619ab4631d18548aa8835dd2c28b"
          },
          "stamp": {
            "time": 1614089576625,
            "id": "593acc91-85bd-4690-8bb8-560a62c3d937",
            "thread": "5238bbb7-aa4a-4114-b280-f083f42575c3"
          },
          "recipient": "example@np6.com"
        }
      }
    }
  }
]

Retrieve cancellations of all actions

Request

Query
startstring(date-time)

Defines a start date filter
Specify this parameter to retrieve only events with a timestamp greater than or equal to the specified value
You can use an ISO format date or a timestamp

endstring(date-time)

Defines an end date filter
Specify this parameter to retrieve only events with a timestamp less than the specified value
You can use an ISO format date or a timestamp

sortstring

Defines a sort order applied on events timestamp
By default, events are unordered and may not streamed in the same order between two requests
You should use this query parameter if you want to guarantee the sort order of events

Enum"asc""desc"
Headers
X-Keystringrequired

A unique API key used to authenticate requests to the NP6 platform. This key must be included in every API call to validate the identity and permissions of the client. Keep your API key secure and do not expose it in public code or logs.

curl -i -X GET \
  'https://api-cm.np6.com/actions/events/cancellations?start=2019-08-24T14%3A15%3A22Z&end=2019-08-24T14%3A15%3A22Z&sort=asc' \
  -H 'X-Key: string'

Responses

An array of cancellation events

Bodyapplication/jsonArray [
idstring(uuid)

Uuid of the event

timestampinteger(int64)

Publication timestamp of the event
This is the number of milliseconds elapsed since January 1, 1970 00:00:00 UTC.

identityobject

Underlying identity of the event

typestring
Discriminator
sourceobject

Source of the event

typestring
Discriminator
detailobject

Detail of the cancellation

]
Response
application/json
[
  {
    "type": "cancellation",
    "id": "84b10b69-6761-434f-be85-d56ddfaf0f20",
    "timestamp": 1614089582000,
    "identity": {
      "type": "customer",
      "agency": "DEMO",
      "customer": "028"
    },
    "source": {
      "type": "email",
      "detail": {
        "execution": {
          "id": "000PE4",
          "kind": "message",
          "recipient": {
            "type": "footprint",
            "id": "000R4M0T",
            "unicity": "example@np6.com",
            "hash": "0441619ab4631d18548aa8835dd2c28b"
          },
          "data": {
            "foo": 1,
            "bar": 2
          },
          "stamp": {
            "time": 1614089576625,
            "id": "d52055cd-e854-4177-8ef5-b10fd8d568a7",
            "thread": "a3078b19-b379-4bc2-b29a-e8229a9c9332"
          }
        },
        "cancellation": {
          "type": "user defined policy",
          "value": {
            "type": "render",
            "message": "Lorem ipsum dolor sit amet..."
          }
        }
      }
    }
  },
  {
    "type": "cancellation",
    "id": "ed715f1b-cc57-43b8-9bbe-e18b58d7e38c",
    "timestamp": 1614089593000,
    "identity": {
      "type": "customer",
      "agency": "DEMO",
      "customer": "028"
    },
    "source": {
      "type": "email",
      "detail": {
        "execution": {
          "id": "000PE5",
          "kind": "message",
          "recipient": {
            "type": "footprint",
            "id": "000R4M0T",
            "unicity": "example@np6.com",
            "hash": "0441619ab4631d18548aa8835dd2c28b"
          },
          "stamp": {
            "time": 1614089576625,
            "id": "40e7f10f-9f96-4891-a340-bccc49b13155",
            "thread": "cbce7a1c-793e-45fb-baa1-5bfcb8998a36"
          }
        },
        "cancellation": {
          "type": "redlisted target"
        }
      }
    }
  },
  {
    "type": "cancellation",
    "id": "fab220eb-9408-482f-8e0f-932aa31736bb",
    "timestamp": 1614089582000,
    "identity": {
      "type": "customer",
      "agency": "DEMO",
      "customer": "028"
    },
    "source": {
      "type": "email",
      "detail": {
        "execution": {
          "id": "000PE4",
          "kind": "message",
          "recipient": {
            "type": "footprint",
            "id": "000R4M0T",
            "unicity": "example@np6.com",
            "hash": "0441619ab4631d18548aa8835dd2c28b"
          },
          "data": {
            "foo": 1,
            "bar": 2
          },
          "stamp": {
            "time": 1614089576625,
            "id": "808ddab2-c672-4c0d-b591-8967c0d4c5c0",
            "thread": "212f8f9e-5f74-4a92-a692-726cbf5472cc"
          }
        },
        "cancellation": {
          "type": "marketing pressure",
          "rule": "a67562eb-c56c-476d-aa0b-dd1d6977fb77"
        }
      }
    }
  }
]

Notification

Operations

Display

Operations

Email & SMS

Operations

Notification

Operations

Workflow

Operations

Campaign

Operations

Campaign

Operations

Contact

Operations

Field

Operations

Enumeration

Operations

Segment

Operations

Import

Operations

Subscription

Operations

Contact

Operations

Webtask

Operations

Compilable

Operations

Mobile Application

Operations

Category

Operations

Marketing Pressure

Operations
© 2025 - ChapsVision - All Rights Reserved.