---
title: "Get Actor OAuth account"
method: GET
path: "/v2/actor-oauth-accounts/{accountId}"
tags: ["Actors"]
---

# Get Actor OAuth account

`GET /v2/actor-oauth-accounts/{accountId}`

## Request

- Base URL: `https://api.apify.com`
- URL: `https://api.apify.com/v2/actor-oauth-accounts/{accountId}`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `token`

Gets an account connected through an Actor OAuth connection, including its OAuth tokens.

This endpoint only accepts the API token of an Actor run (the `APIFY_TOKEN` environment variable of the run).
The run must belong to the Actor that the account's OAuth connection is configured on, and the account must
belong to the user the run's token acts for. Any other token gets a `403` error.

## Path parameters

- `accountId` string, required

## Response `200`

- ActorOAuthAccountResponse
  - `data` ActorOAuthAccount, required: An account a user connected through an Actor OAuth connection.
    - `_id` string, required
    - `userId` string, required
    - `connectionId` string, required
    - `createdAt` string, date-time, required
    - `modifiedAt` string, date-time, required
    - `authorizedAt` string, date-time, nullable
    - `description` string, nullable: Label of the connected account, usually its email address.
    - `data` object, required: The OAuth tokens of the account, such as `access_token`, `refresh_token`, `scope` and `expiry_date`. The exact fields depend on the OAuth provider.

## Other responses

- `400`: Bad request - invalid input parameters or request body.
- `401`: Unauthorized - authentication required or invalid token.
- `403`: Forbidden - insufficient permissions to perform this action.
- `404`: Not found - the requested resource does not exist.
- `405`: Method not allowed.
- `429`: Too many requests - rate limit exceeded.

## Changes

> 25 revisions in range; 1 not diffed.

- **2026-10-27** `ec76185eb934`: 6 info
  - added the optional property `error/data` to the response with the `400` status
  - added the optional property `error/data` to the response with the `401` status
  - added the optional property `error/data` to the response with the `403` status
  - added the optional property `error/data` to the response with the `404` status
  - …2 more
- **2026-10-27** `e52dd2239cee`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/apify/apis/apify-api/changes/v2/actor-oauth-accounts/:accountId/get.md)

---

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