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

# List Logs

> Get request logs

## Description

Get a historical record of all API requests made to Sendly.

## Parameters

<ParamField query="limit" type="number">
  Results per page. Default: 20. Maximum: 100
</ParamField>

<ParamField query="page" type="number">
  Page number. Default: 1
</ParamField>

<ParamField query="status" type="number">
  Filter by HTTP status code. Example: `200`, `400`, `500`
</ParamField>

<ParamField query="method" type="string" enum="['GET', 'POST', 'PUT', 'PATCH', 'DELETE']">
  Filter by HTTP method.
</ParamField>

<ParamField query="sortOrder" type="string" enum="['asc', 'desc']">
  Sort order. Default: `desc`
</ParamField>

## Response

<ResponseField name="data" type="array">
  Array of logs.
</ResponseField>

<ResponseField name="pagination" type="object">
  Pagination information.
</ResponseField>

## Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.usesendly.app/v1/logs?limit=50&sortOrder=desc" \
    -H "Authorization: Bearer se_your_api_key"
  ```

  ```javascript SDK theme={null}
  const response = await client.logs.list({
    limit: 50,
    sortOrder: 'desc'
  })

  response.data.forEach(log => {
    console.log(`[${log.created_at}] ${log.method} ${log.url} - ${log.status}`)
  })
  ```

  ```javascript SMTP theme={null}
  // Access logs via SDK
  import { Sendly } from '@sendlyapp/sdk'

  const client = new Sendly()
  const response = await client.logs.list()
  ```
</CodeGroup>

### Filter by Status

<CodeGroup>
  ```javascript SDK theme={null}
  const response = await client.logs.list({
    status: 200,
    limit: 100
  })

  console.log(`Successful requests: ${response.data.length}`)
  ```

  ```bash cURL theme={null}
  curl "https://api.usesendly.app/v1/logs?status=200&limit=100" \
    -H "Authorization: Bearer se_your_api_key"
  ```
</CodeGroup>

## Use Cases

* **Audit**: Track who did what and when
* **Debugging**: Understand why something failed
* **Monitoring**: Detect unusual patterns
* **Compliance**: Maintain audit trails

## Retention

Logs are retained for 90 days. After that they're automatically deleted.

***

Need help? Contact [support@usesendly.app](mailto:support@usesendly.app)