> For the complete documentation index, see [llms.txt](https://resources.atriptech.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://resources.atriptech.com/popular-topics/notification/email-list.md).

# Email List

**Background**

Some airlines block bookings which have emails from OTAs and travel companies as they want to promote their own sales channels. To overcome this blockage from airlines and to provide unique content to our customers, Atlas uses their own email service and changes the original email to an Atlas email when creating the booking with the airline.

The customer will not receive this email as the airline does not have the customer email id. Hence, Atlas has developed a feature whereby these emails can be viewed and actioned by the customer’s operations team members.

The “Email List” can be accessed with the below 3 methods:

1. ATRIP
2. Email List API
3. Email Notification Webhook

**Objective**

The objective of having this list is that the customer can inform the passenger of any schedule changes or other important announcements made by the airline.

**Email List Categories**

The emails for the below categories will be displayed in the “Email List”:

* Schedule change
* Receipt
* Payment Success
* Verification
* Trip Reminder
* Promo code
* Travel Itinerary
* Advertisement
* PNR Cancellation Success
* Payment Due
* Unidentified
* Duplicated Schedule Change
* Unaccounted Cancellation

**ATRIP**

![](/files/c4nI35nfjWOECTY7Veek)

All emails can be managed here, including flight changes, itineraries, etc. All emails sent by the airline to the contact email address will be displayed here, including advertisements.

The location of the email list is ATRIP --> Bookings --> Email List&#x20;

**Processing of the Email List**

The email received in the email list can be “viewed”, “downloaded” and then “processed”.

**Viewing the Email**

![](/files/dbXPQ6EuTsZpddiXX4mN)

Click on the “View” hyperlink. The email received from the airline will open in a new tab as shown below. The customer may then forward the email to the passenger as per their in-house process.

![](/files/vLmJC1bXFjD9MIBxUf0k)

**Downloading the Email**

![](/files/8RpPCtinD8xRxPZZUmoi)

Click on the “Download” hyperlink. The email received from the airline will be downloaded on the laptop/PC. The customer may then forward the email to the passenger as per their in-house process.

**Processing the Email**

The emails can be processed in 2 ways:

1. By clicking on “View” and then clicking on the “Handle” button.
2. By clicking on one or more emails on the summary screen and then clicking on the “Batch Handle” button.

*“**View” and click on the “Handle” button***

Once the “View” hyperlink is clicked, the below screen will be displayed with the email in the browser.

Click on the “Handle” button on the top right of the screen

![](/files/a6vecMPRPcKq4Xwa4SY3)

On clicking the “Handle” button, the below pop-up window will be displayed with the drop-down options.

![](/files/euVdnieFIuXk90yFwc2A)

Select the appropriate option and click ”Confirm”. When you check the Email List summary, the status would have changed to ”Processed”.

**The options available are:**

* No Change (There is no change in the booking)
* Flight Change Confirmed (There has been no flight change)
* Micro Schedule Change (The schedule change is minimal)
* API Notified (The customer has been notified via the email list API)
* Wait (Customer will be informed later)

***Batch Update***

Select one or more emails from the email list. Then click on “Batch Handle” button.

![
](/files/GHoD0D4oyDpxzyrQdsxg)

A pop-up window will be displayed as shown below:

![](/files/vyrU3hgsOE2X2Wchcmau)

Select the appropriate option and click ”Confirm”. When you check the Email List summary, the status would have changed to ”Processed”.

**Email List API**

Endpoint: <https://api-sg.atriptech.com/mail.do> &#x20;

**Request**

```
{
    "orderNo":null,
    "emailReceivingDateStart":"2023-11-01 00:00:00",
    "emailReceivingDateEnd":"2023-11-30 00:00:00",
    "createTimeStart":null,
    "createTimeEnd":null,
    "emailCategories": ["Travel Itinerary","Verification"],
    "pageIndex":1,
    "pageSize":100
}
```

![](/files/6Csd2dhrbN7SCecqRHm5)

|                         |          |                                                                                                                                                                                                                                                                     |
| ----------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| orderNo                 | Optional | Order Number                                                                                                                                                                                                                                                        |
| emailReceivingDateStart | Optional | Receiving time Start.                                                                                                                                                                                                                                               |
| emailReceivingDateEnd   | Optional | <p>Receiving time End.</p><p>You can only query data for up to one month at a time.</p>                                                                                                                                                                             |
| createTimeStart         | Optional | Create time Start.                                                                                                                                                                                                                                                  |
| createTimeEnd           | Optional | <p>Create time End.</p><p>You can only query data for up to one month at a time.</p>                                                                                                                                                                                |
| emailCategory           | Optional | <p>Options:</p><ul><li>Schedule change</li><li>Receipt</li><li>Payment Success</li><li>Verification</li><li>Trip Reminder</li><li>Promo code</li><li>Travel Itinerary</li><li>Advertisement</li></ul><p>Multiple categories can be added, separated by a comma.</p> |
| pageIndex               | Required | Pagination                                                                                                                                                                                                                                                          |
| pageSize                | Required | <p>Number of records per page</p><p>maximum number=1000</p>                                                                                                                                                                                                         |

**Response**

<pre><code><a data-footnote-ref href="#user-content-fn-1">{</a>
"records": [
{
"orderNo": "OPQRN20230520100137937",
"emailReceivingDate": "2023-11-02 07:29:28",
"uniqueCode": "d08a419d46bb93b8fd9e7ac3ea29a227",
"emailCategory": "Travel Itinerary",
"from": "infoEticket@lionair.co.id",
"to": "bearrpemvgwqyafo@nwt.ttjipiao.top",
"emailSubject": "Lion Group Reservation to PANGKALANBUUN, INDONESIA, November 02 for MS CATHERINE DEWOLFF",
"emailLink": "http://order-oss-sg.oss-ap-southeast-1.aliyuncs.com/2023/11/d08a419d46bb93b8fd9e7ac3ea29a227.eml?Expires=1706010036&#x26;OSSAccessKeyId=LTAI5tDmTE9iwtNdsqxVXuom&#x26;Signature=9%2Bwzk6GcZRcnUIx8w5rbBHCirjI%3D",
"createTime": "2023-11-02 07:29:32"
},
{
"orderNo": "OPQRN20230520100137937",
"emailReceivingDate": "2023-11-02 07:31:06",
"uniqueCode": "4c5f214942b33659ad21d54366af32fa",
"emailCategory": "Travel Itinerary",
"from": "infoEticket@lionair.co.id",
"to": "bearrpemvgwqyafo@nwt.ttjipiao.top",
"emailSubject": "Lion Group Reservation to PANGKALANBUUN, INDONESIA, November 03 for MS CATHERINE DEWOLFF",
"emailLink": "http://order-oss-sg.oss-ap-southeast-1.aliyuncs.com/2023/11/4c5f214942b33659ad21d54366af32fa.eml?Expires=1706010036&#x26;OSSAccessKeyId=LTAI5tDmTE9iwtNdsqxVXuom&#x26;Signature=RWgF9%2BQcrUi7bv%2FA9Q29Zf%2BkZqM%3D",
"createTime": "2023-11-02 07:31:09"
}
],
"hasNext": false,
"status": 0,
"msg": "success"
}
</code></pre>

|                         |          |                                                                                                                                                                                                       |
| ----------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| orderNo                 | Required | Order Number                                                                                                                                                                                          |
| emailReceivingDate      | Required | The time at which the email has been received from the airline.                                                                                                                                       |
| uniqueCode              | Required | Unique Code of the email                                                                                                                                                                              |
| emailCategory           | Required | <p>Options:</p><ul><li>Schedule change</li><li>Receipt</li><li>Payment Success</li><li>Verification</li><li>Trip Reminder</li><li>Promo code</li><li>Travel Itinerary</li><li>Advertisement</li></ul> |
| from                    | Required | Email “from” address                                                                                                                                                                                  |
| to                      | Required | Email “to” address                                                                                                                                                                                    |
| emailSubject            | Required | Email “Subject”                                                                                                                                                                                       |
| emailLink               | Required | Email Link. Email Link is only valid for 10 mins.                                                                                                                                                     |
| createTime              | Required | <p>Create time End.</p><p>You can only query data for up to one month at a time</p>                                                                                                                   |
| emailNotificationStatus | Optional | <p>Notification Status</p><p>0=Notification not sent successfully</p><p>1=Notification sent successfully</p>                                                                                          |

The customer can download “emailLink”.

The email will be downloaded and when opened, it will show the email as sent by the airline: &#x20;

![](/files/84k4H0gSeoTpJErJSpxd)

**Email Notification via Webhook**

The customer server URL needs to be configured in ATRIP to receive the webhook notifications.

**Webhook Notification**

```
{
"cid":"pxmhg93103",
"data":{
"orderNo":"AEQTO20230711142920543",
"emailReceivingDate":"2023-08-04 15:58:52",
"uniqueCode":"017e7e70d729f6392144953bae1a68
68",
"emailCategory":"Unidentified",
"from":"brb@blueribbonbags.com",
"to":"dioneblebp@msbzt.com",
"emailSubject":"Change to the time of your flydubai flight: Booking reference: 7RGWPY",
"emailLink":"http://order-oss-sg.oss-ap-southeast-1.aliyuncs.com/2023/08/42e157e7f9f60e2ccda3693b19d2659a.eml?Expires=1691139906&OSSAccessKeyId=LTAI5tDmTE9iwtNdsqxVXuom&Signature=r69CnS7lt1rc8f4nZRrdxufI7Fk%3D",
"createTime":"2023-08-04 15:58:56"
},
"notificationId":"20230804160506282JUWFJ",
"status": -1,
"type":"email.all"
}
```

| orderNo            | Order Number                                                                                                                                                                                                                                                                                                                        |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| emailReceivingDate | <p>The time Atlas received the airline's email.   </p><p>Format: yyyy-MM-dd HH:mm:ss UTC+08:00  </p>                                                                                                                                                                                                                                |
| uniqueCode         | Unique Code of the email                                                                                                                                                                                                                                                                                                            |
| emailCategory      | <p>Atlas email categories. Atlas categorizes emails but does not guarantee accuracy in classification.  </p><p>Options:  </p><ul><li>Schedule change  </li><li>Receipt  </li><li>Payment Success  </li><li>Verification  </li><li>Trip Reminder  </li><li>Promo code  </li><li>Travel Itinerary  </li><li>Advertisement  </li></ul> |
| from               | Email “from” address                                                                                                                                                                                                                                                                                                                |
| to                 | Email “to” address                                                                                                                                                                                                                                                                                                                  |
| emailSubject       | Email “Subject”                                                                                                                                                                                                                                                                                                                     |
| emailLink          | Email Link. Email Link is only valid for 10 mins.                                                                                                                                                                                                                                                                                   |
| createTime         | The time when Atlas created this email record in the Email list. Generally, it will be later than the receiving time.                                                                                                                                                                                                               |
| notificationId     | Unique Code of the notification                                                                                                                                                                                                                                                                                                     |
| status             | Always equal to -1, internal field                                                                                                                                                                                                                                                                                                  |
| type               | Notification type. When type=email.all, the notification is the Email Notification.                                                                                                                                                                                                                                                 |

[^1]:


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://resources.atriptech.com/popular-topics/notification/email-list.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
