> ## Documentation Index
> Fetch the complete documentation index at: https://openrouter-d02e98a0-mintlify-7021d5f4.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ListData - Python SDK

> ListData method reference

<Warning>
  The Python SDK and docs are currently in beta.
  Report issues on [GitHub](https://github.com/OpenRouterTeam/python-sdk/issues).
</Warning>

## Fields

| Field                   | Type                                                                 | Required             | Description                                                               | Example                                                                   |
| ----------------------- | -------------------------------------------------------------------- | -------------------- | ------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| `hash`                  | *str*                                                                | :heavy\_check\_mark: | Unique hash identifier for the API key                                    | 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 |
| `name`                  | *str*                                                                | :heavy\_check\_mark: | Name of the API key                                                       | My Production Key                                                         |
| `label`                 | *str*                                                                | :heavy\_check\_mark: | Human-readable label for the API key                                      | Production API Key                                                        |
| `disabled`              | *bool*                                                               | :heavy\_check\_mark: | Whether the API key is disabled                                           | false                                                                     |
| `limit`                 | *Nullable\[float]*                                                   | :heavy\_check\_mark: | Spending limit for the API key in USD                                     | 100                                                                       |
| `limit_remaining`       | *Nullable\[float]*                                                   | :heavy\_check\_mark: | Remaining spending limit in USD                                           | 74.5                                                                      |
| `limit_reset`           | *Nullable\[str]*                                                     | :heavy\_check\_mark: | Type of limit reset for the API key                                       | monthly                                                                   |
| `include_byok_in_limit` | *bool*                                                               | :heavy\_check\_mark: | Whether to include external BYOK usage in the credit limit                | false                                                                     |
| `usage`                 | *float*                                                              | :heavy\_check\_mark: | Total OpenRouter credit usage (in USD) for the API key                    | 25.5                                                                      |
| `usage_daily`           | *float*                                                              | :heavy\_check\_mark: | OpenRouter credit usage (in USD) for the current UTC day                  | 25.5                                                                      |
| `usage_weekly`          | *float*                                                              | :heavy\_check\_mark: | OpenRouter credit usage (in USD) for the current UTC week (Monday-Sunday) | 25.5                                                                      |
| `usage_monthly`         | *float*                                                              | :heavy\_check\_mark: | OpenRouter credit usage (in USD) for the current UTC month                | 25.5                                                                      |
| `byok_usage`            | *float*                                                              | :heavy\_check\_mark: | Total external BYOK usage (in USD) for the API key                        | 17.38                                                                     |
| `byok_usage_daily`      | *float*                                                              | :heavy\_check\_mark: | External BYOK usage (in USD) for the current UTC day                      | 17.38                                                                     |
| `byok_usage_weekly`     | *float*                                                              | :heavy\_check\_mark: | External BYOK usage (in USD) for the current UTC week (Monday-Sunday)     | 17.38                                                                     |
| `byok_usage_monthly`    | *float*                                                              | :heavy\_check\_mark: | External BYOK usage (in USD) for current UTC month                        | 17.38                                                                     |
| `created_at`            | *str*                                                                | :heavy\_check\_mark: | ISO 8601 timestamp of when the API key was created                        | 2025-08-24T10:30:00Z                                                      |
| `updated_at`            | *Nullable\[str]*                                                     | :heavy\_check\_mark: | ISO 8601 timestamp of when the API key was last updated                   | 2025-08-24T15:45:00Z                                                      |
| `expires_at`            | [date](https://docs.python.org/3/library/datetime.html#date-objects) | :heavy\_minus\_sign: | ISO 8601 UTC timestamp when the API key expires, or null if no expiration | 2027-12-31T23:59:59Z                                                      |
