Skip to main content
GET
/
api
/
v1
/
registered-users
/
{registered_user_id}
Get Registered User
curl --request GET \
  --url https://ah-api.merge.dev/api/v1/registered-users/{registered_user_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "91b2b905-e866-40c8-8be2-efe53827a0aa",
  "origin_user_id": "user1234",
  "origin_user_name": "Yash",
  "shared_credential_group": {
    "origin_company_id": "merge-1234",
    "origin_company_name": "Merge",
    "custom_groupings": {
      "department": "engineering"
    }
  },
  "user_type": "HUMAN",
  "authenticated_connectors": [
    "linear",
    "jira",
    "slack"
  ],
  "is_test": false
}

Authorizations

​
Authorization
string
header
required

Token-based authentication with required prefix "Bearer"

Path Parameters

​
registered_user_id
string<uuid>
required

Agent Handler ID of the Registered User

Response

200 - application/json
​
id
string
required
​
origin_user_id
string
required

Unique identifier for Registered User

​
shared_credential_group
object
required

Object used to identify which the groupings a Registered User is part of and can share credentials across.

​
authenticated_connectors
string[]
required

List of connector slugs that the user has authenticated with

​
origin_user_name
string
default:Yash

The human readable name of Registered User

​
user_type
string
default:HUMAN

ENUM of HUMAN or SYSTEM

​
is_test
boolean
default:false

Whether this is a test user or production user