---
title: "Retrieve an OAuth Connection"
method: GET
path: "/oauth_connections/{oauth_connection_id}"
---

# Retrieve an OAuth Connection

`GET /oauth_connections/{oauth_connection_id}`

## Path parameters

- `oauth_connection_id` string, required — The identifier of the OAuth Connection.

## Response `200`

OAuth Connection

- OauthConnection — When a user authorizes your OAuth application, an OAuth Connection object is created. Learn more about OAuth [here](https://increase.com/documentation/oauth).
  - `created_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp when the OAuth Connection was created.
  - `deleted_at` string, date-time, nullable, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp when the OAuth Connection was deleted.
  - `group_id` string, required — The identifier of the Group that has authorized your OAuth application.
  - `id` string, required — The OAuth Connection's identifier.
  - `oauth_application_id` string, required — The identifier of the OAuth application this connection is for.
  - `status` 'active' | 'inactive', required — Whether the connection is active.
  - `type` 'oauth_connection', required — A constant representing the object's type. For this resource it will always be `oauth_connection`.

## Other responses

- `4XX` — Error
- `5XX` — Error

---

[API](https://skmtc.net/increase/apis/increase-api-2.md) · [All operations](https://skmtc.net/increase/apis/increase-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/increase/increase-api-2/versions/e968bcd4dcf9/schema)