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

# List credentials

> This endpoint lists all the credentials in your account.

## Request parameters

<Note>Request parameters are coming soon.</Note>

<ParamField query="provider" type="string">
  Filter for credentials for this provider (e.g. `github`, `stripe`, etc). See [the list of possible values](/management-api/objects#sync-providers).
</ParamField>

<ParamField query="kind" type="string">
  Kind of credential (e.g. `stripe_oauth2`, `stripe_sequin`, etc). See [the list of possible values](/management-api/objects#credential-properties).
</ParamField>

<ParamField query="health.status" type="string">
  Filter for credentials with this health status (e.g. `ok`, `error`, etc). See [the list of possible credential `health.status` values](/management-api/objects#health).
</ParamField>

<ParamField query="metadata" type="json">
  Filter for credentials matching the properties supplied in this map. For example, `{"custom_property": 42}` will return all credentials with a `custom_property` of `42`.
</ParamField>

## Response fields

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "data": [
      {
        "id": "c906b4a4-0cda-4f46-bd80-255f570c195d",
        "provider": "stripe",
        "oauth_app_id": "8ff58ef0-d376-4ae8-b2e2-9f0206aa65b8",
        "oauth_app": {
          "name": "Arakkis - Stripe",
          "id": "8ff58ef0-d376-4ae8-b2e2-9f0206aa65b8"
          "client_id": "b9f074c939140210e8c231845bbe8b98",
          "client_secret": "**********",
          "metadata": {},
          "provider": "stripe",
          "created_at": "2024-02-20T02:10:52Z",
          "updated_at": "2024-02-20T02:10:52Z"

        },
        "properties": {
          "kind": "stripe_key",
          "name": "TEST ACCOUNT",
          "secret": "***********",
          "test": true
        },
        "metadata": { "custom_property": 42 },
        // The health field is coming soon
        "health": {
          "status": "error",
          "notes": [
            "We're receiving 401s from Stripe for this token. That usually means the token is expired or revoked. We've emailed the owner of this credential to let them know."
          ],
          "time": "2023-12-15 01:29:29"
        },
        "created_at": "2024-02-19T22:59:41Z",
        "updated_at": "2024-02-19T22:59:41Z"
      },
      { ... },
      { ... }
    ]
  }
  ```
</ResponseExample>

<ResponseField name="id" type="string">
  ID of the credential.
</ResponseField>

<ResponseField name="provider" type="string">
  Provider of the credential (e.g. `github`, `stripe`, etc). See [the list of possible values](/management-api/objects#sync-providers).
</ResponseField>

<ResponseField name="kind" type="string">
  Kind of credential (e.g. `stripe_oauth`, `github`, etc). See [the list of possible values](/management-api/objects#credential-properties).
</ResponseField>

<ResponseField name="health" type="object">
  Status of the credential. Learn more about [the health object](/management-api/objects#health).
</ResponseField>

<ResponseField name="oauth_app" type="object">
  OAuth app associated to the credential. Learn more about [the OAuth app object](/management-api/oauth-apps/list).
</ResponseField>

<ResponseField name="properties" type="credential_properties">
  The properties for the credential. This field is polymorphic based on the credential kind. Learn more about [credential properties](/management-api/objects#credential-properties).
</ResponseField>

<ResponseField name="metadata" type="string">
  Metadata for the credential. This is a free-form object that you can use to store any additional information you want to associate with the credential.
</ResponseField>

<ResponseField name="created_at" type="string">
  Timestamp of when the credential was created, in ISO 8601 format.
</ResponseField>

<ResponseField name="updated_at" type="string">
  Timestamp of when the credential was last updated, in ISO 8601 format.
</ResponseField>
