**Click to Play or Pause the Video**
### **Search Bar** To conduct searches within your API requests, take advantage of our distinct search parameters, namely "REQUEST\_ID" or "ID," both accessible to the left of the "Search" button. - **REQUEST\_ID:** This identifier is determined by the user within their request. Typically, it corresponds to the UNIX timestamp denoting the request time. You can adopt this approach in scenarios where the "request\_id" aligns with the request time. Moreover, the "request\_id" content in your request JSON can be configured as per your requirements. - **ID:** The Voila API system assigns a unique global ID to each specific request. This numeric identifier is sequential and perpetually increasing. For instance, if a request bears an ID of "51," the subsequent request will be assigned an ID of "52."**Click to Play or Pause the Video**
### **Filtering by Date** You also have the option to specify a particular date range for viewing API requests. As demonstrated in the image below, selecting a date range within which our requests are present becomes necessary when the default date range does not yield any results. To modify the date range, click on the calendar icon in the screen's top-right corner. You will find two distinct options: one permits manual selection of a date range directly from the calendar, while the other provides a convenient "Fast Date Picker." The latter offers a variety of pre-defined date ranges frequently used, such as "This Week," "Last Week," "This Month," and more. It empowers you to swiftly narrow down your API request logs according to your needs.**Click to Play or Pause the Video**
### **Filters** Filters are powerful tools to fine-tune your search amidst the array of requests. - **Request URL:** The Request URL corresponds to the Voila API endpoint to which your request is directed. You can retrieve API Requests containing the specified keywords by inputting either the complete URL or a portion of it. It's unnecessary to input the entire request URL to apply this filter effectively. For instance, typing "RoyalMail" in the search field will display a comprehensive list of requests linked to Royal Mail. Similarly, if you seek "create-label" requests, a simple "create" filter will suffice. - **API Account:** If you function as a reseller or agency managing Voila API on behalf of diverse clients, you may need multiple API user accounts (these accounts can be established in the "API Accounts" section). In this context, the API Account filter allows you to select the specific API account(s) for which you wish to evaluate requests. - **Response Code:** This pertains to the HTTP response code assigned to requests. By specifying the code within this filter, you can zero in on API requests of interest. For instance, entering and selecting the "400" code, as depicted in the image below, will exclusively present a list of requests bearing this particular response code.**Click to Play or Pause the Video**
### **Request Details** Once you've selected your desired date and applied filters, a comprehensive list of requests and their corresponding details will be presented. As illustrated in the image below, this section encompasses a range of more information and features, each of which we will examine individually: - **Date Time:** This field displays the precise date and time when the requests were transmitted. - **Request Method:** This column showcases the HTTP request methods employed for each request. Typically, these methods include GET and POST requests. - **Request Authenticated:** The numerical value here corresponds to the API user ID. As shown in the subsequent image, this number is distinct for each API account. - **Duration (ms):** This field denotes the duration between the moment the server received the request and the subsequent transmission of the response, with the time interval measured in milliseconds. Furthermore, additional fields exist like ID, Request ID, Request URL, and API Account. These have been previously discussed within this documentation's "Search" and "Filters" sections. [](https://shipping-documentation.despatchcloud.app/uploads/images/gallery/2025-02/request-details.webp) ### **Response Code** The Response Code refers to the HTTP response code. While sending requests, you may encounter several common response codes, each with its distinct implications: - **200:** This code signifies that the request has been successfully processed. - **400:** This code indicates a client error, which means that the server is unable or unwilling to proceed with the request due to perceived issues with the client's input. - **401:** This code reflects an incomplete client request arising from a lack of valid authentication credentials for the specified resource. Among the most frequently encountered errors on the Voila API, this isn't a system flaw but rather an indication that the submitted information does not match the required criteria. - **500:** This code indicates an unexpected server condition that hinders the request's fulfilment. It's often employed when no other error code precisely fits the situation. [](https://shipping-documentation.despatchcloud.app/uploads/images/gallery/2025-02/response-code.webp) ### **Logs** When you click on the Logs icon associated with any given request, you'll notice two distinct sections: "Request Data" and "Response Data." These sections provide insight into both the data sent and received. In the following areas, we'll delve into the details of the codes in both the request and response data. - **Request Data:** This section encompasses the body of the request sent to the Voila API. Below is an example of Request Data: -Click to Play or Pause the Video
### **Request** **Logs** Request Logs offer a comprehensive view of a request's journey from inception to culmination. They include tracking how numerous requests are initiated, transmitted, and processed until the final response is obtained and presented. A window will appear when selecting a specific request, showcasing key details like the Date, Time, ID, Method, URL, Duration (ms), and Status (Response Code) of the API request. Clicking the "View logs" button unveils the logs for requests flowing between the Voila API and the courier's servers, displayed as both Request Data and Response Data. - **Request Data:** This section encompasses the requests despatched from the Voila API to the courier's servers. - **Response Data:** In this section, you gain visibility into the responses received by the Voila API from the courier's servers.Click to Play or Pause the Video