v48

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-262621423.8 MB

Retrieve an end-user

Retrieves an end-user object.

get/end-users/{id}

Path parameters

idstring required

The ID of the end-user to retrieve.

Example:end_usr_1234567abcdefg

The ID of the end-user to retrieve.

Response

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

idstring 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.

objectType'end_user' required

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

createdAtstring required

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

companyNamestring required

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

sourceIdstring required

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

emailstring required

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

Example response

{
  "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",
      "lastRequestAt": "2024-01-01T12:34:56.789Z",
      "lastSuccessfulRequestAt": "2024-01-01T12:34:56.789Z"
    }
  ]
}