> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lumenfall.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Requests

> Monitor and analyze your API requests

The [**Requests**](https://lumenfall.ai/app/requests) page provides detailed analytics and logs for all your API calls. Track usage, analyze performance, and debug issues with comprehensive request metadata.

<Info>
  Lumenfall does not log your prompts or generated outputs unless you explicitly enable it. See our [Privacy](/privacy) page for details on what we collect.
</Info>

## Usage statistics

At the top of the Requests page, you'll find 30-day statistics for your organization:

* **Total requests** - Number of API calls made
* **Total spend** - Amount spent across all requests
* **Average response time** - Mean request duration
* **Top model** - Your most frequently used model

Each statistic includes a sparkline showing daily trends.

## Request list

The main table displays all your API requests with the following columns:

| Column        | Description                                                     |
| ------------- | --------------------------------------------------------------- |
| **Timestamp** | Date and time when the request was made                         |
| **Model**     | The AI model used (e.g., `gemini-3-pro-image`, `gpt-image-1.5`) |
| **Modality**  | Type of generation - image, video, speech, audio, or other      |
| **Cost**      | Amount charged for the request in USD                           |
| **Duration**  | Total processing time                                           |
| **API Key**   | Which API key made the request                                  |

### Sorting

Click any column header to sort the table. Click again to toggle between ascending and descending order. Sortable columns include timestamp, model, cost, and duration.

### Filtering

Narrow down your request list using filters:

* **Modality** - Filter by generation type (image, video, speech, etc.)
* **Model** - Search for specific models
* **API Key** - View requests from a specific key
* **Date range** - Focus on a specific time period

## Request details

Click any request row to open a detailed view in a side panel. This provides comprehensive information about the individual request.

### Overview

* **Model** - The AI model that processed the request
* **Modality** - Type of generation
* **API Key** - Which key was used
* **Billing status** - Whether the request has been billed

### Timestamps

* **Started** - When the request was received
* **Ended** - When the response was sent
* **Billed** - When the cost was charged to your balance

### Cost breakdown

Detailed pricing information showing:

* **Billable quantity** - The units charged (e.g., number of images, megapixels)
* **Unit price** - Price per unit
* **Total cost** - Final amount in USD

For requests with multiple pricing components (e.g., input tokens + output images), each component is listed separately.

### Timeline

A visual timeline showing how time was spent during the request:

```
├─ Auth         ██░░░░░░░░░░░░░░░░░░  50ms
├─ Execution    ██████████████████░░  1,200ms
└─ Response     ░░░░░░░░░░░░░░░░░░██  30ms
                                      ─────────
                                      1,280ms total
```

The timeline breaks down into phases:

* **Auth** - API key validation and balance check
* **Execution** - Time spent at the AI provider generating output
* **Response** - Sending the response back to you

### Timing events

Detailed millisecond-level timing for each phase of the request:

| Event              | Description                                    |
| ------------------ | ---------------------------------------------- |
| Request received   | When Lumenfall received your API call          |
| Auth completed     | When authentication and balance check finished |
| Provider started   | When the request was sent to the AI provider   |
| First byte         | When the first response data was received      |
| Response completed | When the full response was ready               |

Use this data to understand where time is being spent and identify potential bottlenecks.

### Metadata

If the request included additional metadata or the provider returned extra information, it's displayed here as raw JSON.