# Stripe CLI: Logs

The Stripe CLI provides powerful tools for interacting with your Stripe integration directly from your terminal. This section covers commands related to inspecting and managing your Stripe logs.

## `stripe logs tail`

Establishes a direct connection with Stripe, allowing you to tail your test mode Stripe API request logs in real-time from your terminal. Multiple filters can be used together, and a log entry must match all filters to be shown. When specifying a filter, multiple values can be provided as a comma-separated list. A log entry only needs to match one of the values.

> `logs tail` only supports displaying *test mode* request logs.

**Command:** `stripe logs tail`

### Flags

*   `--filter-account `
    Filter request logs by the source and destination account.
    *   `connect_in`: Incoming Connect requests.
    *   `connect_out`: Outgoing Connect requests.
    *   `self`: Non-Connect requests.
*   `--filter-http-method `
    Filter request logs by HTTP method.
    *   `GET`: HTTP GET requests.
    *   `POST`: HTTP POST requests.
    *   `DELETE`: HTTP DELETE requests.
*   `--filter-ip-address `
    Filter request logs by IP address.
*   `--filter-request-path `
    Filter request logs that directly match any Stripe path (e.g. `/v1/charges`).
*   `--filter-request-status `
    Filter request logs by the response status.
    *   `SUCCEEDED`: Requests that succeeded (HTTP 200, 201, 202 status codes).
    *   `FAILED`: Requests that failed (HTTP 4xx and 5xx status codes).
*   `--filter-source `
    Filter request logs by the source of each request.
    *   `API`: Requests created with the Stripe API.
    *   `DASHBOARD`: Requests created from the Dashboard.
*   `--filter-status-code `
    Filter request logs by HTTP status code.
*   `--filter-status-code-type `
    Filter request logs by the type of HTTP status code.
    *   `2XX`: HTTP 2xx status codes.
    *   `4XX`: HTTP 4xx status codes.
    *   `5XX`: HTTP 5xx status codes.
*   `--format `
    Specifies the output format for request logs.
    *   `JSON`: Output logs in JSON format.

### Examples

**Basic usage**

```sh
stripe logs tail
```

```
> Ready! You're now waiting to receive API request logs
2022-01-28 09:47:46 [200] POST /v1/customers [req_abc123]
2022-01-28 09:48:22
```