---
title: "Get Integration"
method: GET
path: "/workspaces/{workspace_id}/integrations/{provider_id}"
tags: ["integrations"]
---

# Get Integration

`GET /workspaces/{workspace_id}/integrations/{provider_id}`

## Request

- Base URL: `https://platform.tracecat.com/api`
- URL: `https://platform.tracecat.com/api/workspaces/{workspace_id}/integrations/{provider_id}`
- Auth: one of:
  - API key in cookie `fastapiusersauth`
  - HTTP bearer

Get integration for the specified provider.

## Path parameters

- `workspace_id` string, uuid, required
- `provider_id` string, required

## Query parameters

- `grant_type` 'authorization_code' | 'client_credentials': Grant type for OAuth 2.0.

## Response `200`

Successful Response

- IntegrationRead: Response model for user integration.
  - `id` string, uuid4, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `user_id` string, uuid, nullable
  - `provider_id` string, required
  - `authorization_endpoint` string, nullable: OAuth authorization endpoint configured for this integration.
  - `token_endpoint` string, nullable: OAuth token endpoint configured for this integration.
  - `token_type` string, required
  - `expires_at` string, date-time, nullable, required
  - `client_id` string, nullable: OAuth client ID for the provider
  - `granted_scopes` string[], nullable: OAuth scopes granted for this integration
  - `requested_scopes` string[], nullable: OAuth scopes requested by user for this integration
  - `status` 'not_configured' | 'configured' | 'connected' | 'reauth_required', required: Status of an integration.
  - `is_expired` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tracecat/apis/tracecat-api.md) - [All operations](https://skmtc.dev/tracecat/apis/tracecat-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tracecat/apis/tracecat-api/revisions/2efdda25045f?raw)