# List a Space's access logs

Returns the HTTP requests the Space served, newest first, across every hostname it has answered on, including ones it stopped serving. Covers the last 24 hours unless `since` and `until` move the window, and a start older than the plan’s log retention is clamped with a `log_retention_clamped` warning naming the effective start. Page with `cursor`; a page can come back short or empty while `hasMore` is true. Share link tokens and signed blob paths are redacted out of `path`.

## GET `/v1/spaces/{spaceId}/logs/access`

### Authorization

`Authorization` Bearer token · header required

`Authorization: Bearer <key>` with the Space key (`sfc_` prefix) of an unclaimed Space. The same key is the fragment of the claim URL and the token in the Space's `/_/<key>` sign-in URL.

or

`Authorization` Bearer token · header required

`Authorization: Bearer <token>` with an API key (`sfa_` prefix), an OAuth access token, a session token, or a Space machine credential (`sfm_` prefix).

### Path parameters

`spaceId` string required

### Query parameters

`limit` integer required

min 1 · max 100 · default: 20

`cursor` string

min length 1 · max length 4096

`since` string <date-time>

matches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$

`until` string <date-time>

### Responses

#### 200 Response for status 200

`$schema` string <uri>

Canonical JSON Schema URL for this response body. The server also sends it in the `Link: rel="describedby"` response header.

`data` object[] required

Array of `object`

- `ts` string <date-time> required

Same instant as `timestamp`. Read `timestamp`.

- `timestamp` string <date-time> required

When the request was served.

- `host` string required

Same value as `hostname`. Read `hostname`.

- `hostname` string required

Hostname the request arrived on.

- `method` string required

HTTP method, falling back to `GET` when the log omits it.

- `path` string required

Request path with share secrets redacted out of the query string.

- `status` integer required

Response status code.

- `bytes` integer required

Response size in bytes.

#### pagination object required

- `nextCursor` string | any required

Cursor for the next page. Null on the last page.

- `hasMore` boolean required

True when another page exists.

- `warnings` object[]

Diagnostics about the list itself. `log_retention_clamped` gives the `since` actually used when the requested window reaches back past the plan's log retention.

### Example CURL Request:

```sh
curl -X GET "https://api.spacefast.com/v1/spaces/string/logs/access?limit=20" \
  -H "Authorization: Bearer YOUR_TOKEN"
```

### Example of JavaScript Request:

```javascript
const response = await fetch("https://api.spacefast.com/v1/spaces/string/logs/access?limit=20", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});
```

### Example of Python Request:

```python
import requests

response = requests.get(
    "https://api.spacefast.com/v1/spaces/string/logs/access?limit=20",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)
```

### Sample Response:

```json
{
  "$schema": "http://example.com",
  "data": [
    {
      "ts": "2019-08-24T14:15:22Z",
      "timestamp": "2019-08-24T14:15:22Z",
      "host": "string",
      "hostname": "string",
      "method": "string",
      "path": "string",
      "status": -9007199254740991,
      "bytes": 9007199254740991
    }
  ],
  "pagination": {
    "nextCursor": "string",
    "hasMore": true
  },
  "warnings": [
    {
      "code": "string",
      "severity": "info",
      "message": "string",
      "path": "string",
      "provider": "infra",
      "details": {
        "property1": null,
        "property2": null
      },
      "fix": "string",
      "retryable": true
    }
  ]
}
```