# SecretMetadataList

> A page of SecretMetadata objects.

A page of SecretMetadata objects.

## Fields

| Field | Type | Description |
| --- | --- | --- |
| `data` * | array of [SecretMetadata](/docs/api/objects/secret-metadata/) |  |
| `next_cursor` * | string or null | Pass as `cursor` to get the next page; null on the last page. |
| `has_more` * | boolean |  |

\* always present

## Example

```json
{
  "data": [
    {
      "id": "sec_01jbx2m9k7q4r8t5v6w3y0z1sc",
      "name": "stripe-secret-key",
      "environment_id": "env_01jbx2m9k7q4r8t5v6w3y0z1en",
      "service_id": null,
      "version": 3,
      "injected_as": null,
      "build": false,
      "description": "Stripe live secret key",
      "display": "••••••• (set 2 min ago by Stewart Webb)",
      "set_by": {
        "type": "user",
        "id": "usr_01jbx2m9k7q4r8t5v6w3y0z1us",
        "display": "Stewart Webb"
      },
      "referenced_by": [
        {
          "service": "web",
          "variable": "STRIPE_SECRET_KEY"
        }
      ],
      "last_used_at": "2026-10-23T14:04:00Z",
      "last_used_by_deployment_id": "dep_01jbx2m9k7q4r8t5v6w3y0z1dp",
      "decrypts_last_7_days": 14,
      "created_at": "2026-10-01T09:00:00Z",
      "updated_at": "2026-10-23T14:00:00Z"
    }
  ],
  "next_cursor": "string",
  "has_more": false
}
```

## Used by

- [List secrets (names and metadata only)](/docs/api/secrets/#list-secrets-names-and-metadata-only)