---
title: "REST API Logs"
description: "REST API Logs"
keywords: "REST API Logs"
url: "https://myrapidi.com/wiki/rest_api_logs"
locale: "en"
published: "2021-01-22T13:55:12Z"
modified: "2023-04-06T15:02:46Z"
---

Logs are used to store information about every transaction run. [Read more about Logs](/wiki/logs "Read More About Logs")

| **Field** | **Type** | **Notes** |
| --- | --- | --- |
| id | integer | |
| logdate | date | |
| logtime | time | UTC |
| transfer | string | |
| sub\_transfer | string | |
| group | string | |
| schedule | string | |
| source | string | |
| destination | string | |
| description | string | |
| is\_error | boolean | |
| time\_used | integer | |
| log\_type | string | "information", "error", "transfer\_control", "connection\_control", "protocol\_control", "communication\_control", "scheduler\_control", "server\_control" |
| message\_code | string | |
| service\_code | string | |
| filename | string | |
| run\_id | string | |
| run\_type | integer | |
| read\_source | integer | |
| read\_destination | integer | |
| skipped\_source | integer | |
| read\_action | integer | |
| updated | integer | |
| inserted | integer | |
| deleted | integer | |
| source\_deleted | integer | |
| initialized | integer | |
| packages\_sent | integer | |
| bytes\_sent | integer | |
| packages\_received | integer | |
| bytes\_received | integer | |

| 

**Query Parameters**

 | 

**Notes**

 | **Examples**   
 |
| id | Unique identifier of the log. | id=100 |
| --- | --- | --- |
| fromdate | Minimum datetime of logs to retrieve (inclusive, Accepted datetime formats are: 2020-12-01T12:12Z or 202012011212). | fromdate=202012011000 |
| todate | Maximum datetime of logs to retrieve (inclusive, Accepted datetime formats are: 2020-12-01T12:12Z or 202012011212). | todate=202103011000 |
| log\_datetime | Exact datetime of the logs you want to retrieve (inclusive, Accepted datetime formats are: 2020-12-01T12:12:12Z or 20201201121212). | log\_datetime=20201201100022 |
| search | Finds log entries where searchable fields contain the provided value. | search="TEST\_22" |
| limit | Maximum number of log entries to retrieve with each database query. Used for paginated results | limit=100 |
| offset | Number of log entries the query should skip before beginning to read and apply filters, used for paginated results | offset=100 |

| 

**Searchable fields**

 |
| id |
| --- |
| description |
| transfercode |
| groupcode |

# **Filtering**

To avoid generating queries that can overload the system, a distinction is made between indexed and non-indexed fields available for filtering:

- Indexed fields are optimized for searching, allowing the Database query to consume fewer resources when filtering the logs.

- Filtering using non-indexed fields (as well as searching) take a heavier toll on the database, and therefore it is required to have less than 300 000 entries readable after the indexed filters are applied, or the query will return an error asking the user to restrict their query further using the indexed filters or timedate query parameters.

## **Using Indexed fields:**

Indexed fields are optimized for searching, allowing the Database query to consume less resources when filtering logs.

| 

**Indexed filters**

 | 

**non\_indexed filters (includes the search query term)**

 |
| runid | source |
| --- | --- |
| transfercode | destination |
| schedulercode | groupcode |
| logtype | description |
| iserror | |

Pagination:Pagination uses the _limit_ and _offset_ parameters to separate the retrieval of large volumes of logs into smaller chunks called pages.  
Setting the _limit_ parameter allows us to define the page size, and setting _offset_ to a multiple of _limit_ sets which page we are getting back for the request.Once you've made your first query with _offset=0_ and a specific _limit_, only the _offset_ parameter should vary for future requests. [REST API Logs Get Logs](https://myrapidi.com/wiki/rest_api_logs_get_logs.md)