## Stripe commands

Inspect details about your Stripe integration, logs, and service availability.

## 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 <values>`
  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 <values>`
  Filter request logs by HTTP method.
    - `GET`
      HTTP GET requests.
    - `POST`
      HTTP POST requests.
    - `DELETE`
      HTTP DELETE requests.

- `--filter-ip-address <values>`
  Filter request logs by IP address.

- `--filter-request-path <values>`
  Filter request logs that directly match any Stripe path (e.g. `/v1/charges`).

- `--filter-request-status <values>`
  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 <values>`
  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 <values>`
  Filter request logs by HTTP status code.

- `--filter-status-code-type <values>`
  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 <value>`
  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 [200] POST /v1/charges [req_def456]
2022-01-28 09:48:58 [200] POST /v1/charges [req_ghi789]
...
```

**Use multiple log filters**

```sh
stripe logs tail \
    --filter-http-method POST \
    --filter-status-code-type 4XX
```

**Use multiple values for log filters**

```sh
stripe logs tail --filter-http-method GET,POST
```

## open

Shortcut to open the Stripe documentation or Dashboard in your browser.

> Any Dashboard pages (that include `/test/` in the URL) can be viewed in live mode with the `--live` flag.

**Command:** `stripe open`

### Arguments

- `<shortcut>`
  Shortcut used to quickly open a page on [stripe.com](https://stripe.com).
    - `api`
      https://docs.stripe.com/api
    - `apiref`
      https://docs.stripe.com/api
    - `cliref`
      https://docs.stripe.com/cli
    - `dashboard`
      https://dashboard.stripe.com/test
    - `dashboard/apikeys`
      https://dashboard.stripe.com/test/apikeys
    - `dashboard/atlas`
      https://dashboard.stripe.com/test/atlas
    - `dashboard/balance`
      https://dashboard.stripe.com/test/balance/overview
    - `dashboard/billing`
      https://dashboard.stripe.com/test/billing
    - `dashboard/connect`
      https://dashboard.stripe.com/test/connect/overview
    - `dashboard/connect/accounts`
      https://dashboard.stripe.com/test/connect/accounts/overview
    - `dashboard/connect/collected`
      https://dashboard.stripe.com/test/connect/application_fees
    - `dashboard/connect/transfers`
      https://dashboard.stripe.com/test/connect/transfers
    - `dashboard/coupons`
      https://dashboard.stripe.com/test/coupons
    - `dashboard/customers`
      https://dashboard.stripe.com/test/customers
    - `dashboard/developers`
      https://dashboard.stripe.com/test/developers
    - `dashboard/disputes`
      https://dashboard.stripe.com/test/disputes
    - `dashboard/events`
      https://dashboard.stripe.com/test/events
    - `dashboard/invoices`
      https://dashboard.stripe.com/test/invoices
    - `dashboard/logs`
      https://dashboard.stripe.com/test/logs
    - `dashboard/orders`
      https://dashboard.stripe.com/test/orders
    - `dashboard/orders/products`
      https://dashboard.stripe.com/test/orders/products
    - `dashboard/payments`
      https://dashboard.stripe.com/test/payments
    - `dashboard/payouts`
      https://dashboard.stripe.com/test/payouts
    - `dashboard/radar`
      https://dashboard.stripe.com/test/radar
    - `dashboard/radar/list`
      https://dashboard.stripe.com/test/radar/list
    - `dashboard/radar/reviews`
      https://dashboard.stripe.com/test/radar/reviews
    - `dashboard/radar/rules`
      https://dashboard.stripe.com/test/radar/rules
    - `dashboard/settings`
      https://dashboard.stripe.com/settings
    - `dashboard/subscriptions`
      https://dashboard.stripe.com/test/subscriptions
    - `dashboard/products`
      https://dashboard.stripe.com/test/products
    - `dashboard/tax`
      https://dashboard.stripe.com/test/tax-rates
    - `dashboard/terminal`
      https://dashboard.stripe.com/test/terminal
    - `dashboard/terminal/hardware/orders`
      https://dashboard.stripe.com/test/terminal/hardware_orders
    - `dashboard/terminal/locations`
      https://dashboard.stripe.com/test/terminal/locations
    - `dashboard/topups`
      https://dashboard.stripe.com/test/topups
    - `dashboard/transactions`
      https://dashboard.stripe.com/test/balance
    - `dashboard/webhooks`
      https://dashboard.stripe.com/test/webhooks
    - `docs`
      https://docs.stripe.com/

### Flags

- `--list`
  List all supported shortcuts.

- `--live`
  Open the Dashboard for your live integration (by default, runs in test mode).

### Examples

**Basic usage**

```sh
stripe open dashboard/webhooks
```

**Open the Dashboard in live mode**

```sh
stripe open dashboard/apikeys --live
```

**List available shortcuts in live mode**

```sh
stripe open --live --list
```

```
open supports the following shortcuts:

shortcut                              url
--------                              ---------
api               => https://docs.stripe.com/api
apiref            => https://docs.stripe.com/api
cliref            => https://docs.stripe.com/cli
dashboard         => https://dashboard.stripe.com
dashboard/apikeys => https://dashboard.stripe.com/apikeys
dashboard/atlas   => https://dashboard.stripe.com/atlas
...
```
