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

# Get list of Actor OAuth accounts

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

## Request

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

Gets the accounts you connected through the Actor OAuth connection, including their OAuth tokens. Only accounts
that finished authorization are returned.

There are at most 5 accounts per user and connection, so the list is not paginated.

## Path parameters

- `connectionId` string, required

## Response `200`

- ListOfActorOAuthAccountsResponse
  - `data` ListOfActorOAuthAccounts, required
    - `total` integer, required
    - `items` ActorOAuthAccount[], required
      - `_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/:connectionId/accounts/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)