Identities

Profile and employment information.

#The identity object

Attributes
  • #
    idstring (uuid)

    Unique ID of the identity.

  • #
    accountstring (uuid)

    ID of the account associated with the identity.

  • #
    addressobject

    Object containing the employee's personal home or contact address.

  • #
    citystring

    Name of the city, town, district, or similar regional entity.

  • #
    line1string

    Address-Line 1, usually street address or P.O. Box information.

  • #
    line2string

    Address-Line 2, usually the apartment or unit number.

  • #
    statestring

    State, county, province, region, or equivalent.

  • #
    countrystring

    Two-letter country code (ISO 3166-1 alpha-2 format).

  • #
    postal_codestring

    Zip code, or equivalent.

  • #
    first_namestring

    First name of the employee. Usually the legal first name.

  • #
    last_namestring

    Last name of the employee. Usually the legal last name.

  • #
    full_namestring

    Full name of the employee. Sourced from payroll data if available, otherwise constructed from available names and suffixes.

  • #
    birth_datestring (date)

    Date of birth in ISO 8601 format. If values are obfuscated (rare), a dash will replace the value (e.g. --01-31 when the year is obfuscated).

  • #
    emailstring

    Email address.

  • #
    phone_numberstring

    Phone number (E.164 international format).

  • #
    picture_urlstring

    URL location of the user's profile image.

  • #
    employment_statusstring (enum)

    The employment status relevant to the identity.

  • #
    employment_typestring (enum)

    Type of employment.

  • #
    job_titlestring

    Job title.

  • #
    ssnstring

    Social Security number.

  • #
    marital_statusstring

    Marital status.

  • #
    genderstring

    Gender.

  • #
    original_hire_datestring (date)

    Timestamp (ISO 8601) of the user's earliest employment start date.

  • #
    hire_datestring (date)

    Timestamp (ISO 8601) of the user's most recent employment start date.

    hire_date may differ from original_hire_date due to a promotion, a re-hiring event, or similar.

  • #
    termination_datestring (date)

    Timestamp (ISO 8601) when the user was terminated.

  • #
    termination_reasonstring

    Reason for termination.

  • #
    employerstring

    Name of the employer.

  • #
    base_payobject

    Object containing basic income information for the user.

  • #
    amountstring

    Defined pay amount per period. Does not include bonus, commission or similar incentive-based income.

  • #
    periodstring (enum)

    Payment interval that specifically corresponds to the base pay amount.

  • #
    currencystring

    Pay currency (ISO 4217 currency code).

  • #
    pay_cyclestring (enum)

    Payment frequency.

  • #
    platform_idsobject

    Object containing internal user ID's specific to the employer or payroll system. Distinct from Argyle ID's.

  • #
    employee_idstring

    Internal user ID assigned by the employer.

  • #
    position_idstring

    Internal position ID assigned by the employer.

  • #
    platform_user_idstring

    ID assigned by the payroll system.

  • #
    created_atstring (datetime)

    Timestamp (ISO 8601) when the identity object was created.

  • #
    updated_atstring (datetime)

    Timestamp (ISO 8601) when a property value of the identity object most recently changed.

  • #
    metadataobject

    Additional, non-categorized information.

Example
1{
2  "id": "0153b145-7ab9-bea2-cc16-a8b71328942f",
3  "account": "0187c66e-e7e5-811c-b006-2232f00f426a",
4  "address": {
5    "city": "New York",
6    "line1": "852 North W St",
7    "line2": "Apt 221",
8    "state": "NY",
9    "country": "US",
10    "postal_code": "10014"
11  },
12  "first_name": "Sarah",
13  "last_name": "Longfield",
14  "full_name": "Sarah Longfield",
15  "birth_date": "1980-10-30",
16  "email": "[email protected]",
17  "phone_number": "+12125555555",
18  "picture_url": "www.argyle.com/logofoldername",
19  "employment_status": "active",
20  "employment_type": "full-time",
21  "job_title": "Store Manager",
22  "ssn": "522-09-1191",
23  "marital_status": "Married filing jointly",
24  "gender": "Female",
25  "original_hire_date": "2019-01-03",
26  "hire_date": "2020-04-08",
27  "termination_date": null,
28  "termination_reason": null,
29  "employer": "Whole Goods",
30  "base_pay": {
31    "amount": "58024.50",
32    "period": "annual",
33    "currency": "USD"
34  },
35  "pay_cycle": "semimonthly",
36  "platform_ids": {
37    "employee_id": "OB238HDW5",
38    "position_id": "6ELL4O7PM",
39    "platform_user_id": "JLH7B9V6O6YGN9O7"
40  },
41  "created_at": "2023-01-30T12:53:24.561594Z",
42  "updated_at": "2023-01-30T12:55:06.478699Z",
43  "metadata": {}
44}

#Retrieve an identity

get/v2/identities/{id}

Retrieves an identity object.

Path parameters
  • #
    idstring (uuid)
    required

    ID of the identity object to be retrieved.

Example Request
1curl --request GET \
2     --url https://api.argyle.com/v2/identities/{id} \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'
Example Response
1{
2  "id": "0153b145-7ab9-bea2-cc16-a8b71328942f",
3  "account": "0187c66e-e7e5-811c-b006-2232f00f426a",
4  "address": {
5    "city": "New York",
6    "line1": "852 North W St",
7    "line2": "Apt 221",
8    "state": "NY",
9    "country": "US",
10    "postal_code": "10014"
11  },
12  "first_name": "Sarah",
13  "last_name": "Longfield",
14  "full_name": "Sarah Longfield",
15  "birth_date": "1980-10-30",
16  "email": "[email protected]",
17  "phone_number": "+12125555555",
18  "picture_url": "www.argyle.com/logofoldername",
19  "employment_status": "active",
20  "employment_type": "full-time",
21  "job_title": "Store Manager",
22  "ssn": "522-09-1191",
23  "marital_status": "Married filing jointly",
24  "gender": "Female",
25  "original_hire_date": "2019-01-03",
26  "hire_date": "2020-04-08",
27  "termination_date": null,
28  "termination_reason": null,
29  "employer": "Whole Goods",
30  "base_pay": {
31    "amount": "58024.50",
32    "period": "annual",
33    "currency": "USD"
34  },
35  "pay_cycle": "semimonthly",
36  "platform_ids": {
37    "employee_id": "OB238HDW5",
38    "position_id": "6ELL4O7PM",
39    "platform_user_id": "JLH7B9V6O6YGN9O7"
40  },
41  "created_at": "2023-01-30T12:53:24.561594Z",
42  "updated_at": "2023-01-30T12:55:06.478699Z",
43  "metadata": {}
44}

#List all identities

get/v2/identities

Returns an array of all identity objects.

Query parameters
  • #
    accountstring (uuid)
    optional

    Filter by account ID.

  • #
    userstring (uuid)
    optional

    Filter by user ID.

  • #
    limitinteger
    optional

    Number of identity objects returned per page. Default: 10. Maximum: 200.

Example Request
1curl --request GET \
2     --url https://api.argyle.com/v2/identities?limit=2 \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'
Example Response
1[
2  {
3    "id": "0186da0b-6569-0ea0-eb50-b64e97cb29e9",
4    "account": "0186da0b-9923-0d27-4b05-6ce3b7b07b89",
5    "address": {
6      "city": "San Diego",
7      "line1": "54 N Shea Ridge",
8      "line2": null,
9      "state": "CA",
10      "country": "US",
11      "postal_code": "92092"
12    },
13    "first_name": "Joe",
14    "last_name": "Burnam",
15    "full_name": "Joe Burnam",
16    "birth_date": "1978-08-29",
17    "email": "[email protected]",
18    "phone_number": "+12123338708",
19    "picture_url": "www.argyle.com/logofoldername",
20    "employment_status": "active",
21    "employment_type": "part-time",
22    "job_title": "Hourly staff",
23    "ssn": "301-06-1225",
24    "marital_status": "Married filing jointly",
25    "gender": "Male",
26    "original_hire_date": "2022-05-18",
27    "hire_date": "2022-05-18",
28    "termination_date": null,
29    "termination_reason": null,
30    "employer": "Double Double",
31    "base_pay": {
32      "amount": "18.08",
33      "period": "hourly",
34      "currency": "USD"
35    },
36    "pay_cycle": "monthly",
37    "platform_ids": {
38      "employee_id": "32ULINA8",
39      "position_id": "67LKUKA8",
40      "platform_user_id": "332512349952"
41    },
42    "created_at": "2023-01-31T12:13:24.561594Z",
43    "updated_at": "2023-01-31T12:45:06.478699Z",
44    "metadata": {}
45  },
46  {
47    "id": "0353c142-4ab9-baa1-cb44-c8b51225877e",
48    "account": "0185a8b8-60eb-80ca-7482-5f24504573f7",
49    "address": {
50      "city": "Oklahoma City",
51      "line1": "312 Main Ave",
52      "line2": null,
53      "state": "OK",
54      "country": "US",
55      "postal_code": "73008"
56    },
57    "first_name": "Bob",
58    "last_name": "Jones",
59    "full_name": "Bob Jones",
60    "birth_date": "1983-07-02",
61    "email": "[email protected]",
62    "phone_number": "+13228675309",
63    "picture_url": "www.argyle.com/logofoldername",
64    "employment_status": "active",
65    "employment_type": "contractor",
66    "job_title": "Data analyst",
67    "ssn": "507-18-3058",
68    "marital_status": "Single",
69    "gender": "Female",
70    "original_hire_date": "2019-01-03",
71    "hire_date": "2021-04-08",
72    "termination_date": null,
73    "termination_reason": null,
74    "employer": "Half Bads",
75    "base_pay": {
76      "amount": "39.72",
77      "period": "hourly",
78      "currency": "USD"
79    },
80    "pay_cycle": "biweekly",
81    "platform_ids": {
82      "employee_id": "bd823Lk",
83      "position_id": "ab3EkU2",
84      "platform_user_id": "832355"
85    },
86    "created_at": "2023-01-30T13:53:24.561594Z",
87    "updated_at": "2023-01-30T13:55:06.478699Z",
88    "metadata": {}
89  }
90]
Updating Argyle status...
┬ę 2024 Argyle Systems Inc.argyle.com