Skip to main content
End Users API

Get End User

GET /end-users/{uuid}

Returns the details of an existing End User.

Response Fields

uuid

string

The End User’s UUID.

Example value:  eur_747536f4-1efd-4cad-91b3-cc8aaeed93e3

code

string

The End User’s code.

Example value:  ECSCDSVFGH

type

string

The type of end user. Whether a company or an individual.

Example value:  COMPANY

first_name

string

The user’s first name.

Example value:  John

last_name

string

The user’s last name.

Example value:  Smith

organization

string

The organization’s name.

Example value:  DRUO

local_id

string

The user’s ID number.

Example value:  45235553

local_id_type

string

The user’s ID type.

Example value:  NATIONAL_ID

local_id_country

string

The user’s citizenship in 3-letter ISO code.

Example value:  COL

date_of_birth

string

The user’s date of birth in YYYY-MM-DD format.

Example value:  2021-07-19

email

string

The user’s phone number.

Example value:  john.smith@gmail.com

phone_number

object

The user’s phone number.

Example Value:

"phone_number": {
    "country_code": 1,
    "number": 2025550198
}

Attributes

  • country_code* | string | The user’s phone number’s country code.
  • number* | number | The user’s phone number without country code.

* Both fields required

address

Address

The user’s address.

Example Value:

"address": {
  "address_line_1": "1600 Pennsylvania Ave NW",
  "address_line_2": "Apt 101",
  "address_line_3": null,
  "locality": "Washington",
  "sublocality": null,
  "administrative_district": "DC",
  "postal_code": "20500",
  "country": "USA"
}

Attributes

  • address_line1 | string | Address line 1.
  • address_line2 | string | Address line 2.
  • address_line3 | string | Address line 3.
  • locality | string | Locality of the provided address.
  • sublocality | string | Sublocality of the provided address.
  • adminisrative_district | string | Administrative disctrict of the provided address.
  • postal_code | string | Postal code of the provided address.
  • country | Country | Country of the provided address
preferred_language

string

The user’s preferred language. Used for system notifications.

Example value:  en_US

note

string

A custom note associated with this end user.

Example value:  This is a special customer.

primary_reference

string

The End User’s primary reference. Can be any value to associate the end user to an entity in an external system.

Example value:  23423524

secondary_reference

string

The End User’s secondary reference. Can be any value to associate the end user to an entity in an external system.

Example value:  bj39fhow39fhqp3f0hfae4344

metadata

 

string

Set of key-value pairs that you can attach to an object. You can specify up to 50 keys, with key names up to 40 characters long and values up to 500 characters long.

Example value:  {"order_id": "6735"}

creation_source

 

string

The channel through which the end user was created.

date_created_gmt

date-time

Create date of the end user

Example value:  2021-11-15T23:23:38Z

date_updated_gmt

date-time

Updated date of the end user

Example value:  2021-11-15T23:23:38Z

GET /end-users/{uuid}
curl --location 'https://api.druo.com/end-users/eur_fddecc16-2ab1-4db5-a295-25f19e69bec3
--header 'Authorization: Bearer ACCESS_TOKEN'
Response
{
    "end_user": {
        "uuid": "eur_fddecc16-2ab1-4db5-a295-25f19e69bec3",
        "code": "E9K9HRFTRP7",
        "type": "INDIVIDUAL",
        "first_name": "John",
        "last_name": "Doe",
        "organization": null,
        "local_id": "987654321",
        "local_id_type": "DRIVERS_LICENSE",
        "local_id_country": "USA",
        "date_of_birth": null,
        "email": "john.doe@example.com",
        "phone_number": {
            "country_code": 1,
            "number": 2025550198
         },
        "address": {
            "address_line_1": "1600 Pennsylvania Ave NW",
            "address_line_2": "Apt 101",
            "address_line_3": null,
            "locality": "Washington",
            "sublocality": null,
            "administrative_district": "DC",
            "postal_code": "20500",
            "country": "USA"
         },
        "preferred_language": "en_US",
        "note": null,
        "primary_reference": null,
        "secondary_reference": null,
        "metadata": {
            "example_key": "example_value"
        },
        "creation_source": "MERCHANT_API",
        "date_created_gmt": "2023-10-09T16:00:30.115Z",
        "date_updated_gmt": "2023-10-09T16:00:30.115Z"
    }
}