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

# Listing Specifications

> List specifications with optional filters.

> [!WARNING]
>
> You are reading the docs of Galtea 5.15. [Read this page in the latest version](https://docs.galtea.ai/sdk/api/specification/list.md).

## Returns

Returns a list of [Specification](https://docs.galtea.ai/v5.15/concepts/product/specification.md) objects.

## Example

```python theme={"system"}
specifications = galtea.specifications.list(
    product_id=product_id,
    type="CAPABILITY",
)

critical_specifications = galtea.specifications.list(
    product_id=product_id,
    is_critical=True,
)
```

## Parameters

**product\_id** `string`

Filter specifications by product ID.

**type** `string | SpecificationType`

Filter by specification type.
Possible values: `CAPABILITY`, `INABILITY`, `POLICY`. Other string values are sent to the API unchanged, so values added in newer API versions can be used; the API rejects invalid ones.

**dataset\_type** `string | DatasetType`

Filter by dataset type.
Possible values: `ACCURACY`, `SECURITY`, `BEHAVIOR`.

**name** `string`

Filter by specification name (partial, case-insensitive match).

**is\_critical** `bool`

`True` lists only critical specifications, `False` only the others. Omit it to list both.

**from\_created\_at** `str | int` (default: None)

Filter specifications created at or after this timestamp. Accepts ISO 8601 string (e.g., `'2024-01-01T00:00:00Z'`) or Unix timestamp in seconds.

**to\_created\_at** `str | int` (default: None)

Filter specifications created at or before this timestamp. Accepts ISO 8601 string (e.g., `'2024-12-31T23:59:59Z'`) or Unix timestamp in seconds.

**sort\_by\_created\_at** `string`

Sort specifications by creation date. Valid values are `"asc"` and `"desc"`.

**offset** `int` (default: 0)

Number of specifications to skip before starting to collect results. Use for pagination.

**limit** `int` (default: 10000)

Maximum number of specifications to return in a single request.

**id** `string | list[string]` (default: None)

The ID or IDs of the specification(s) to retrieve.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.