# S4 object storage API

> An introduction to the Bitiful S4 API.

## Get a console API token

Get one from the console: <https://console.bitiful.com/apiToken>

## Storage usage and object count

No parameters.

```shell
curl -H "Authorization: {API Token from: https://console.bitiful.com/apiToken}" "https://api.bitiful.com/s4/data/{bucket-name}/usage"
```

## S4 real-time logs

Only logs from the last 3 days are available.

> **Tip**
>
> **Parameters**
>
> **start_time**   Start time as a timestamp in nanoseconds, used for pagination. Example: 1723046499000000000
>
> **codes**        Filter by HTTP status code. One of 2XX / 3XX / 4XX / 5XX / ALL. Defaults to ALL.
>
> **limit**        Number of entries to return per request. Maximum: 1000.

```shell
curl --get -H "Authorization: {API Token from: https://console.bitiful.com/apiToken}" "https://api.bitiful.com/s4/data/{bucket-name}/logs?start_time={start_time}&codes={codes}&limit={limit}"
```
