Table of Contents
Teamamerica Delta API Documentation
Overview
This API provides access to a list of hotels and rooms that have been created, updated, or deleted within a specific time frame. The response is formatted in XML and contains detailed information about each record, including date ranges for changes.
## Request Structure
To retrieve updated data, send an XML request formatted as follows:
### Request XML Example
```xml <RetrieveUpdatedData>
<UserName>username</UserName> <Password>********</Password> <OrderCode></OrderCode> <!-- Optional --> <ListID></ListID> <!-- Optional --> <LastSynced>2023-10-02T12:00:00Z</LastSynced> <IncludeDeleted>0</IncludeDeleted>
</RetrieveUpdatedData> ```
### Request Parameters
| Parameter | Type | Required | Description |
| ————– | ——- | ——– | ——————————————————– |
| UserName | String | Yes | API username for authentication |
| Password | String | Yes | API password for authentication |
| OrderCode | String | No | Filter records by order code |
| ListID | String | No | Filter records by list ID |
| LastSynced | String | Yes | Timestamp of the last synchronization in ISO 8601 format |
| IncludeDeleted | Integer | No | Whether to include deleted records (0 = No, 1 = Yes) |
## Response Structure
The response XML contains a timestamp and a list of updated records.
### Response XML Example
```xml <TimeStamp>2023-10-02T12:00:00Z</TimeStamp> <Lists>
<List id="1">
<ListItem code="ASDFG">
<Created>
<DateRange>
<From>2025-09-11</From>
<To>2025-09-30</To>
</DateRange>
<DateRange>
<From>2025-10-15</From>
<To>2025-10-31</To>
</DateRange>
</Created>
<Updated>
<Rate>
<DateRange>
<From>2025-07-11</From>
<To>2025-07-15</To>
</DateRange>
<DateRange>
<From>2025-07-19</From>
<To>2025-07-25</To>
</DateRange>
</Rate>
<Inventory>
<Status Type="AS">
<DateRange>
<From>2025-07-11</From>
<To>2025-07-15</To>
</DateRange>
</Status>
<Status Type="SE">
<DateRange>
<From>2025-07-11</From>
<To>2025-07-15</To>
</DateRange>
</Status>
</Inventory>
</Updated>
<Deleted>
<DateRange>
<From>2025-07-11</From>
<To>2025-07-15</To>
</DateRange>
</Deleted>
</ListItem>
</List>
</Lists> ```
### Response Elements
| Element | Description |
| ——— | ———————————————————- |
| TimeStamp | The timestamp of the response in ISO 8601 format |
| Lists | Container for all record lists |
| List | A collection of items, each identified by an ID |
| ListItem | A specific item within a list, identified by a unique code |
| Created | Contains date ranges indicating when the item was created |
| Updated | Contains details about rate and inventory changes |
| Deleted | Contains date ranges indicating when the item was deleted |
### Updated Data
- Rate: Changes in pricing, with associated date ranges. - Inventory: Status updates with specified types (e.g., “AS”, “SE”).
Error Handling
If an error occurs, the API will return an error message in below formats:
XML format:
<ErrorResponse> <Code>DCA101</Code> <Message>Unauthorized Access: Invalid login credentials</Message> <Timestamp>2025-02-19T12:34:56Z</Timestamp> </ErrorResponse>
JSON format:
{
"ErrorResponse": {
"Code": "DCA101",
"Message": "Unauthorized Access: Invalid login credentials",
"Timestamp": "2025-02-19T12:34:56Z"
}
}
Common Error Codes
| Code | Description |
| DCA101 | Unauthorized Access: Invalid login credentials. |
| DCA111 | Validation Error: One or more fields failed validation checks. |
| DCA106 | Bad Request: The request is malformed or missing required parameters. |
| DCA104 | Data Type Mismatch: Invalid data type detected in the request. |
## Notes
- The API requires authentication using a valid username and password. - Date fields follow the format `YYYY-MM-DD`. - Ensure `LastSynced` is provided to fetch only the necessary changes.
For further assistance, contact API support.