1. Notifications
  • Introduction
  • Getting Started
  • Authentication
  • Error Handling
  • Contact Support
  • Modaltrans API
    • Get Auth Token
      • Get Bearer Token
    • Accounting
      • Invoices
        • Retrieve an Invoice
        • List all Invoices
    • Customs
      • NCTS Declarations
        • List all NCTS Declarations
        • Retrieve an NCTS Declaration
        • Create an NCTS Declaration with XML Data
        • Create an Ens Declaration from JSON
        • Update an NCTS Declaration
        • Download an NCTS Declaration
        • List Timelines of NCTS Declaration
        • List Messages of NCTS Decalaration
      • Customs Declarations
        • List all Customs Declarations
        • Retrieve a Custom Declaration
        • Create a Customs Declaration
        • Update a Custom Declaration
        • Delete a Custom Declaration
        • Retrieve a Declaration History
        • Retrieve an MRN Status of Declaration
      • Declaration Requests
        • List all Declaration Orders
        • Retrieve a Declaration Request
        • Create a Declaration Request
        • Update a Declaration Request
        • Delete a Declaration Request
    • Logistics
      • Bookings
        • Retrieve a Booking
        • List all Bookings
        • Create a Booking
        • Update a Booking
      • Locations
        • List all Locations
        • Retrieve a Location
      • Positions
        • Update a Transport
      • Tracking
        • Available Shipping Lines
        • Retrieve a Tracking Data
        • Subscribe to Tracking
      • Shipments
        • Retrieve a Shipment
        • List All Shipments
        • Retrieve Financials of Shipment
        • List Contacts of the Shipment
        • Create a Shipment
        • Update a Shipment
    • Depot
      • Orders
        • Retrieve an Order
        • List all Orders
        • Create an Order
        • Update an Order
      • Products
        • Retrieve a Product
        • List all Products
        • Create a Product
        • Update a Product
        • List Product Stocks
      • Inventories
        • List all Inventories
    • Fleet Management
      • Drivers
        • Retrieve a Driver
        • Retrieve a Driver's Vehicle
        • List Driver Positions
        • Update a Driver
      • Vehicles
        • Retrieve a Vehicle
        • Update a Vehicle
      • Gps Service Controller
        • Create Gps Responses
      • Service Logs
        • List all Service Logs
        • Retrieve a Service Log
        • Create a Service Log
        • Delete a Service Log
        • Update a Service Log
      • Periodic Documents
        • Retrieve a Periodic Document
        • Update a Periodic Document
        • Create a Periodic Document
    • CRM
      • Companies
        • List all Companies
        • Retrieve a Company
        • Create a Company
        • Update a Company
        • Delete a Company
    • Timelines
      • Retrieve a Timeline
      • List Timelines
      • Create a Timeline
    • S3 Files
      • List all S3Files
      • Create an S3File
      • Delete an S3File
    • Notifications
      • List all Notifications
        GET
      • Update a Notification Status
        PATCH
    • User Details
      • List User Details
      • Update User Details
  1. Notifications

List all Notifications

Developing
Testing Env
https://demo.modaltrans.com
Testing Env
https://demo.modaltrans.com
GET
/api/v1/notifications
Returns list of all Notification.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Query Params
reference
string 
optional
A string that will filter the notifications based on the title. The filter is case-insensitive and partial matches are allowed.
scope
string 
optional
The scope of the notifications: When the scope query parameter is set to 'desktop', the notifications will be limited to 10. For any other value of the scope query parameter, the notifications will be limited to 100.

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://demo.modaltrans.com/api/v1/notifications?reference=&scope='

Responses

🟢200OK
application/json
Body
array of:
id
integer 
required
ID of the notification
action_type
string 
required
The type of action associated with the notification
title
string 
required
The title of the notification
target_type
string 
required
The type of the target entity related to the notification
target_id
integer 
required
The ID of the target entity
target_class_name
string 
required
The class name of the target entity
sender_id
integer 
required
The ID of the sender
sender_name
string 
required
The name of the sender
sender_avatar_url
string 
required
The URL of the sender's avatar image
object_url
string 
required
The URL related to the object of the notification
created_at
string <date-time>
required
The timestamp when the notification was created.
is_it_read?
boolean 
required
Indicates whether the notification has been read by the user
Example
[
    {
        "id": 0,
        "action_type": "string",
        "title": "string",
        "target_type": "string",
        "target_id": 0,
        "target_class_name": "string",
        "sender_id": 0,
        "sender_name": "string",
        "sender_avatar_url": "string",
        "object_url": "string",
        "created_at": "2019-08-24T14:15:22Z",
        "is_it_read?": true
    }
]
🟠400Bad Request
🟠403Forbidden
🟠404Record Not Found
Modified at 2024-08-23 13:32:45
Previous
Delete an S3File
Next
Update a Notification Status
Built with