GET
/
end-users
/
{id}
JavaScript
import Conductor from 'conductor-node';

const conductor = new Conductor({
  apiKey: 'sk_conductor_...',
});

const endUser = await conductor.endUsers.retrieve('end_usr_1234567abcdefg');

console.log(endUser.id);
{
  "id": "end_usr_1234567abcdefg",
  "objectType": "end_user",
  "createdAt": "2024-01-01T12:34:56.789Z",
  "companyName": "Acme Inc.",
  "sourceId": "12345678-abcd-abcd-example-1234567890ab",
  "email": "bob@acme.com",
  "integrationConnections": [
    {
      "id": "int_conn_1234567abcdefg",
      "objectType": "integration_connection",
      "createdAt": "2024-01-01T12:34:56.789Z",
      "integrationSlug": "quickbooks_desktop",
      "lastRequestAt": "2024-01-01T12:34:56.789Z",
      "lastSuccessfulRequestAt": "2024-01-01T12:34:56.789Z"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Your Conductor secret key using Bearer auth (e.g., "Authorization: Bearer {{YOUR_SECRET_KEY}}").

Path Parameters

​
id
string
required

The ID of the end-user to retrieve.

Example:

"end_usr_1234567abcdefg"

Response

200 - application/json

Returns the end-user object if a valid ID was provided.

​
id
string
required

The unique identifier for this end-user. You must save this value to your database because it is how you identify which of your users to receive your API requests.

Example:

"end_usr_1234567abcdefg"

​
objectType
string
required

The type of object. This value is always "end_user".

Allowed value: "end_user"
Example:

"end_user"

​
createdAt
string
required

The date and time when this end-user record was created.

Example:

"2024-01-01T12:34:56.789Z"

​
companyName
string
required

The end-user's company name that will be shown elsewhere in Conductor.

Example:

"Acme Inc."

​
sourceId
string
required

The end-user's unique identifier from your system. Maps users between your database and Conductor.

Example:

"12345678-abcd-abcd-example-1234567890ab"

​
email
string
required

The end-user's email address for identification purposes.

Example:

"bob@acme.com"

​
integrationConnections
object[]
required

The end-user's integration connections.