🔐 Required Role Permissions: Requests
🔓 Optional Role Permissions: Save Searches, See Bulk Action
The Requests table records every request made to the API, along with the responses received. API logs play a crucial role in maintaining and troubleshooting interactions with API-connected partners. They can also be shared with external partners to collaboratively troubleshoot discrepancies in bookings and API interactions.
📗 TIP
When sharing logs externally, provide context about the issue and ensure sensitive information is excluded from shared URLs or records.
Having access to these logs is incredibly useful as it helps Ventrata diagnose problems, ensuring faster resolution times. These records not only assist in diagnosing technical issues but also help compare data with resellers or partners to identify discrepancies accurately. By default, you can view the following details in the log:
Request timestamps
Request URLs
HTTP methods used (GET, POST, etc.)
Status codes of responses
Response times
Error messages, if any
Default Columns
Default Columns
Service
Action
Subrequest
IP Address
HTTP Method
Path
Response Code - a 3-digit number that states the server's response
Duration
Request Date
Request Time
Actions
The action bar between the navigation bar and the bookings table enables you to perform a number of additional functions.
Actions
Search bar - filter the bookings table, using any parameter from the available columns
Keep Filter - when using search, tick the checkbox to make the column filters available
Saved Searches - press Saved Searches> Save Current Search to save your current search parameters and filtered columns, or Saved Searches > Manage Searches to edit or delete existing searches
📗 TIP
To learn more about saved searches, read our article Working with Saved Searches.
Reset All Filters - appears when a filter was used; press to reset filters to their default states
Bulk Actions - select one or multiple bookings and press to apply an action on your selection; options include
Bulk Action | Description |
Delete All | delete all selected requests |
Show Columns - press to add new columns, or remove existing ones from your current view
Sharing Logs
To share logs with external partners:
Filter the logs to contain only relevant details (e.g., by "Operator" or "Booking Reference").
Copy the URL of the filtered logs and share it securely.
Avoid sharing screenshots, as they may lack precision and context.
Examine units or service details in the request
Ensure no sensitive or personally identifiable information is included in shared logs.
Keep an internal record of all shared logs for potential audits or follow-ups.