> This page is for Unified.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Linked Accounts

> The /linked-accounts endpoint. Query which integrations a customer has connected and what operations (read, write, delete) each supports.

---

## Overview

The Linked Accounts endpoint returns a list of `LinkedAccount` objects. Each `LinkedAccount` contains, among other things, the following information about the models and actions available for that account:

* `integration`: Includes name, categories, image, square image, and primary color. You can use this information to build an adaptive UI that accurately reflects the integration your user has chosen to link.
* `passthrough_available`: defines whether you are able to use the [Passthrough endpoint](/merge-unified/supplemental-data/passthrough-request/overview) to make custom requests of any kind to the given API. This value is almost always true.
* `available_model_operations`: For the provided integration, we return each supported data model, the supported operations (`FETCH`/`CREATE`/`UPDATE`/`DELETE`), the supported fields, and the required fields to create an instance of that model.

---

## Request

The request will return all linked accounts regardless of which category is passed into the URL.

You will also want to include an Authorization header that includes your Merge API key - see the [Authentication](/merge-unified/hris/merge-api-basics/authentication) section for more details.

```bash
GET https://api.merge.dev/api/ats/linked-accounts
```

---

**`Example Linked Accounts response`**

```json Example Linked Accounts response
{
  "next": "cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw",
  "previous": "cj1sZXdwd2VycWVtY29zZnNkc2NzUWxNMEUxTXk0ME16UXpNallsTWtJ",
  "results": [
    {
      "id": "e59b1821-f85c-4e28-a6b3-1804156f3563",
      "category": "hris",
      "status": "INCOMPLETE",
      "status_detail": "Invalid login credentials",
      "end_user_origin_id": "3ac95cde-6c7f-4eef-afec-be710b42308d",
      "end_user_organization_name": "Foo Bar, LLC",
      "end_user_email_address": "hradmin@foobar.dev",
      "subdomain": "foobar",
      "webhook_listener_url": "https://api.merge.dev/api/integrations/webhook-listener/7fc3mee0UW8ecV4",
      "is_duplicate": true,
      "integration": {
        "name": "SAP SuccessFactors",
        "categories": [
          "hris",
          "ats"
        ],
        "image": "https://cdn.merge.dev/SuccessFactors_Logo.png",
        "square_image": "https://cdn.merge.dev/SuccessFactors_Square_Logo.jpg",
        "color": "#F6A704",
        "slug": "sap-successfactors",
        "passthrough_available": true,
        "available_model_operations": [
          {
            "model_name": "Candidate",
            "available_operations": [
              "FETCH",
              "CREATE"
            ],
            "required_post_parameters": [
              "remote_user_id"
            ],
            "supported_fields": [
              "first_name",
              "last_name",
              "company",
              "title"
            ]
          }
        ]
      },
      "account_type": "PRODUCTION",
      "completed_at": "2024-08-26T20:11:19.277118Z",
      "integration_specific_fields": {
        "integration_specific_field": "Varies by platform"
      }
    }
  ]
}
```