> ## 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 OAuth apps

> This endpoint lists all the OAuth apps in your account.

## Request parameters

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

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

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

<ParamField query="truncate_secrets" type="boolean" default="true">
  Determines whether the response contains truncated or full secrets.
</ParamField>

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

## Response fields

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "data": [
      {
        "id": "8ff58ef0-d376-4ae8-b2e2-9f0206aa65b8",
        "provider": "stripe",
        "name": "My Stripe OAuth App",
        "client_id": "8ff58ef0-d376-4ae8-b2e2-9f0206aa65b8",
        "client_secret": "**********",
        "metadata": { "custom_property": 42 },
        // the health field is coming soon
        "health": {
          "status": "ok",
          "notes": [],
          "time": "2023-12-15 01:29:29"
        },
        "created_at": "2024-02-20T02:10:52Z",
        "updated_at": "2024-02-20T02:10:52Z"
      },
      { ... },
      { ... }
    ]
  }
  ```
</ResponseExample>

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

<ResponseField name="name" type="string">
  Display name of the OAuth app.
</ResponseField>

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

<ResponseField name="provider" type="string">
  The provider of the OAuth app. See a list of supported providers [here](/management-api/objects#sync-providers).
</ResponseField>

<ResponseField name="client_id" type="string">
  The client ID of the OAuth app.
</ResponseField>

<ResponseField name="client_secret" type="string">
  The client secret of the OAuth app.
</ResponseField>

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

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

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