# List yanked hub refs

Source: https://stratadb.org/docs/reference/hub/list_yanked

List yanked refs from the selected StrataHub.

| | |
|---|---|
| Command | `hub.list_yanked` |
| CLI | `strata hub list-yanked` |
| Wire type | `hub_list_yanked` |
| Python | `db.hub.list_yanked(*, since: 'Union[str, datetime, None]' = None, hub_url: 'Optional[str]' = None) -> 'Any'` |
| Access | read |
| Commit | no commit |
| Wire status | stable |

Reads `GET /v1/yanked` from the effective hub URL. `since`, when supplied, must be an RFC 3339 timestamp.

Status commands return a scalar or compact status payload and do not mutate database state.

## Examples

### Python

```python
db.hub.list_yanked(since="2026-09-01T00:00:00Z").total   # doctest: +SKIP
```

## Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `hub_url` | `string or null` | no | Explicit hub URL; when absent the 5-layer resolver runs. |
| `since` | `string or null` | no | RFC 3339 lower-bound timestamp. |

## Returns

`StatusResponse<HubYankedList>`

- `data` (`HubYankedList`)
- `type` (`string`)

## Errors

Recover by code, never by message.

| Code | Retry | Commit outcome |
|---|---|---|
| [`failed_precondition.engine.runtime_closed`](https://stratadb.org/e/failed_precondition.engine.runtime_closed) | never | not_started |
| [`not_found.engine.branch`](https://stratadb.org/e/not_found.engine.branch) | never | not_applicable |
| [`unsupported.executor.hub_feature_disabled`](https://stratadb.org/e/unsupported.executor.hub_feature_disabled) | after_state_change | not_started |
| [`invalid_argument.executor.hub_url`](https://stratadb.org/e/invalid_argument.executor.hub_url) | never | not_started |
| [`unavailable.executor.hub_transport`](https://stratadb.org/e/unavailable.executor.hub_transport) | same_request | not_started |
| [`invalid_argument.executor.hub_since`](https://stratadb.org/e/invalid_argument.executor.hub_since) | never | not_started |
| [`not_found.executor.hub_resource`](https://stratadb.org/e/not_found.executor.hub_resource) | never | not_started |

## Related

- [Read hub dataset](https://stratadb.org/docs/reference/hub/get_dataset)
- [Read hub info](https://stratadb.org/docs/reference/hub/info)
- [List hub datasets](https://stratadb.org/docs/reference/hub/list_datasets)
- [List hub dataset refs](https://stratadb.org/docs/reference/hub/list_refs)