API Terms of Use

Before you start using the API, we have a few guidelines that we'd like to tell you about. We encourage you to read the full API Terms of Use, but here are the bullet points:

  • ID.me users own their data.
  • ID.me is a user-centric, permissions based platform that requires explicit permission for each transmission of information from a user to a partner brand through ID.me.
  • You may not sell ID.me user data to third party sites.
  • You cannot replicate the core user experience of ID.me

Endpoints
Choose API Version:
V3 V2

Protected REST endpoints can be access by making HTTP requests with the access token for a given user. The ID.me server will validate the access token to ensure it has not expired and that its scope covers the requested resource.


After receiving a successful verification response from the API, you should apply business logic to unlock the benefit you are offering to the end user. From a user experience perspective, it is recommended that you store the verified status in the user's session to keep the experience consistent in case the page is refreshed, the back button is pressed, etc. By hiding or disabling the button that inititiates the API call, you can prevent duplicate calls being made.


If you're writing an AJAX application, require a JSONP response, and would like to wrap our response with a callback, all you have to do is specify a callback parameter with the API call.


URI Type
https://api.id.me/api/public/v3/attributes.json?access_token=ACCESS_TOKEN
https://api.id.me/api/public/v2/attributes.json?access_token=ACCESS_TOKEN
 JSON
https://api.id.me/api/public/v3/attributes.json?access_token=ACCESS_TOKEN&callback=callbackFunction
https://api.id.me/api/public/v2/attributes.json?access_token=ACCESS_TOKEN&callback=callbackFunction
 JSONP

HTTP Method

GET

Response Content Type

application/json

Response
Choose API Version:
V3 V2

The response from ID.me's REST API attributes endpoint is returned in JSON format.

Example

{
  "attributes": [
    {
      "handle": "fname",
      "name": "First Name",
      "value": "Danial"
    },
    {
      "handle": "lname",
      "name": "Last Name",
      "value": "Treutel"
    },
    {
      "handle": "email",
      "name": "Email",
      "value": "danial.treutel@id.me"
    },
    {
      "handle": "uuid",
      "name": "Unique Identifier",
      "value": "d733a89e2e634f04ac2fe66c97f71612"
    },
    {
      "handle": "zip",
      "name": "Zip Code",
      "value": "76862-3657"
    },
    {
      "handle": "military_branch",
      "name": "Military Branch",
      "value": "Coast Guard"
    },
    {
      "handle": "military_service_component",
      "name": "Military Service Component",
      "value": "active"
    },
    {
      "handle": "military_service_started",
      "name": "Military Service Started",
      "value": "2020-04-11"
    },
    {
      "handle": "military_service_ended",
      "name": "Military Service Ended",
      "value": "2000-04-11"
    }
  ],
  "status": [
    {
      "group": "military",
      "subgroups": [
        "Service Member"
      ],
      "verified": true
    }
  ]
}
{
  "id": "d733a89e2e634f04ac2fe66c97f71612",
  "verified": true,
  "affiliation": "Service Member",
  "fname": "Buddy",
  "lname": "Conn",
  "email": "test.user@id.me",
  "zip": "08635-4553",
  "military_branch": "Navy",
  "military_service_component": "active",
  "military_service_started": "2020-04-11",
  "military_service_ended": "2000-04-11"
}
{
  "attributes": [
    {
      "handle": "fname",
      "name": "First Name",
      "value": "Becky"
    },
    {
      "handle": "lname",
      "name": "Last Name",
      "value": "Von"
    },
    {
      "handle": "email",
      "name": "Email",
      "value": "becky.von@id.me"
    },
    {
      "handle": "uuid",
      "name": "Unique Identifier",
      "value": "d733a89e2e634f04ac2fe66c97f71612"
    },
    {
      "handle": "zip",
      "name": "Zip Code",
      "value": "96676-6077"
    },
    {
      "handle": "military_branch",
      "name": "Military Branch",
      "value": "Marine Corps"
    },
    {
      "handle": "military_service_component",
      "name": "Military Service Component",
      "value": "natguard"
    },
    {
      "handle": "military_service_started",
      "name": "Military Service Started",
      "value": "2020-04-11"
    },
    {
      "handle": "military_service_ended",
      "name": "Military Service Ended",
      "value": "2016-04-11"
    }
  ],
  "status": [
    {
      "group": "military",
      "subgroups": [
        "Veteran"
      ],
      "verified": true
    }
  ]
}
{
  "id": "d733a89e2e634f04ac2fe66c97f71612",
  "verified": true,
  "affiliation": "Veteran",
  "fname": "Taylor",
  "lname": "Skiles",
  "email": "test.user@id.me",
  "zip": "34983",
  "military_branch": "Navy",
  "military_service_component": "active",
  "military_service_started": "2020-04-11",
  "military_service_ended": "2016-04-11"
}
{
  "attributes": [
    {
      "handle": "fname",
      "name": "First Name",
      "value": "Georgianne"
    },
    {
      "handle": "lname",
      "name": "Last Name",
      "value": "Christiansen"
    },
    {
      "handle": "email",
      "name": "Email",
      "value": "georgianne.christiansen@id.me"
    },
    {
      "handle": "uuid",
      "name": "Unique Identifier",
      "value": "d733a89e2e634f04ac2fe66c97f71612"
    },
    {
      "handle": "zip",
      "name": "Zip Code",
      "value": "73007"
    },
    {
      "handle": "military_branch",
      "name": "Military Branch",
      "value": "NOAA Corps"
    },
    {
      "handle": "military_service_component",
      "name": "Military Service Component",
      "value": "natguard"
    },
    {
      "handle": "military_service_started",
      "name": "Military Service Started",
      "value": "2020-04-11"
    },
    {
      "handle": "military_service_ended",
      "name": "Military Service Ended",
      "value": "2000-04-11"
    }
  ],
  "status": [
    {
      "group": "military",
      "subgroups": [
        "Retiree"
      ],
      "verified": true
    }
  ]
}
{
  "id": "d733a89e2e634f04ac2fe66c97f71612",
  "verified": true,
  "affiliation": "Retiree",
  "fname": "Jeremiah",
  "lname": "Hayes",
  "email": "test.user@id.me",
  "zip": "00287",
  "military_branch": "Space Force",
  "military_service_component": "active",
  "military_service_started": "2020-04-11",
  "military_service_ended": "2000-04-11"
}
{
  "attributes": [
    {
      "handle": "fname",
      "name": "First Name",
      "value": "Lilla"
    },
    {
      "handle": "lname",
      "name": "Last Name",
      "value": "Hamill"
    },
    {
      "handle": "email",
      "name": "Email",
      "value": "lilla.hamill@id.me"
    },
    {
      "handle": "uuid",
      "name": "Unique Identifier",
      "value": "d733a89e2e634f04ac2fe66c97f71612"
    },
    {
      "handle": "zip",
      "name": "Zip Code",
      "value": "17819-6261"
    },
    {
      "handle": "military_member_branch",
      "name": "Military Member Branch",
      "value": "Air Force"
    },
    {
      "handle": "military_member_service_component",
      "name": "Military Member Service Component",
      "value": "reserve"
    },
    {
      "handle": "military_member_service_started",
      "name": "Military Member Service Started",
      "value": "2020-04-11"
    },
    {
      "handle": "military_member_service_ended",
      "name": "Military Member Service Ended",
      "value": "2000-04-11"
    }
  ],
  "status": [
    {
      "group": "military",
      "subgroups": [
        "Military Spouse"
      ],
      "verified": true
    }
  ]
}
{
  "id": "d733a89e2e634f04ac2fe66c97f71612",
  "verified": true,
  "affiliation": "Military Spouse",
  "fname": "Bulah",
  "lname": "Tremblay",
  "email": "test.user@id.me",
  "zip": "40841-0048",
  "military_branch": "Space Force",
  "military_service_component": "reserve",
  "military_service_started": "2020-04-11",
  "military_service_ended": "2000-04-11"
}
{
  "attributes": [
    {
      "handle": "fname",
      "name": "First Name",
      "value": "Edwin"
    },
    {
      "handle": "lname",
      "name": "Last Name",
      "value": "Stark"
    },
    {
      "handle": "email",
      "name": "Email",
      "value": "edwin.stark@id.me"
    },
    {
      "handle": "uuid",
      "name": "Unique Identifier",
      "value": "d733a89e2e634f04ac2fe66c97f71612"
    },
    {
      "handle": "zip",
      "name": "Zip Code",
      "value": "43431"
    },
    {
      "handle": "military_member_branch",
      "name": "Military Member Branch",
      "value": "Navy"
    },
    {
      "handle": "military_member_service_component",
      "name": "Military Member Service Component",
      "value": "active"
    },
    {
      "handle": "military_member_service_started",
      "name": "Military Member Service Started",
      "value": "2020-04-11"
    },
    {
      "handle": "military_member_service_ended",
      "name": "Military Member Service Ended",
      "value": "2000-04-11"
    }
  ],
  "status": [
    {
      "group": "military",
      "subgroups": [
        "Military Family"
      ],
      "verified": true
    }
  ]
}
{
  "id": "d733a89e2e634f04ac2fe66c97f71612",
  "verified": true,
  "affiliation": "Military Family",
  "fname": "Efrain",
  "lname": "Thompson",
  "email": "test.user@id.me",
  "zip": "81284",
  "military_branch": "Army",
  "military_service_component": "reserve",
  "military_service_started": "2020-04-11",
  "military_service_ended": "2000-04-11"
}
{
  "attributes": [
    {
      "handle": "fname",
      "name": "First Name",
      "value": "Teofila"
    },
    {
      "handle": "lname",
      "name": "Last Name",
      "value": "Considine"
    },
    {
      "handle": "email",
      "name": "Email",
      "value": "teofila.considine@id.me"
    },
    {
      "handle": "uuid",
      "name": "Unique Identifier",
      "value": "d733a89e2e634f04ac2fe66c97f71612"
    },
    {
      "handle": "zip",
      "name": "Zip Code",
      "value": "60153"
    },
    {
      "handle": "canada_military_branch",
      "name": "Canadian Military Branch",
      "value": "Canadian Forces Health Services Group"
    }
  ],
  "status": [
    {
      "group": "military_canada",
      "subgroups": [
        "Service Member for Canada"
      ],
      "verified": true
    }
  ]
}
{
  "id": "d733a89e2e634f04ac2fe66c97f71612",
  "verified": true,
  "affiliation": "Service Member for Canada",
  "fname": "Deon",
  "lname": "Gibson",
  "email": "test.user@id.me",
  "zip": "00286",
  "canada_military_branch": "Canadian Special Operations Forces Command"
}
{
  "attributes": [
    {
      "handle": "fname",
      "name": "First Name",
      "value": "Jeffrey"
    },
    {
      "handle": "lname",
      "name": "Last Name",
      "value": "Lueilwitz"
    },
    {
      "handle": "email",
      "name": "Email",
      "value": "jeffrey.lueilwitz@id.me"
    },
    {
      "handle": "uuid",
      "name": "Unique Identifier",
      "value": "d733a89e2e634f04ac2fe66c97f71612"
    },
    {
      "handle": "zip",
      "name": "Zip Code",
      "value": "20443"
    },
    {
      "handle": "canada_military_branch",
      "name": "Canadian Military Branch",
      "value": "Royal Canadian Navy"
    }
  ],
  "status": [
    {
      "group": "military_canada",
      "subgroups": [
        "Veteran for Canada"
      ],
      "verified": true
    }
  ]
}
{
  "id": "d733a89e2e634f04ac2fe66c97f71612",
  "verified": true,
  "affiliation": "Veteran for Canada",
  "fname": "Elanor",
  "lname": "Daniel",
  "email": "test.user@id.me",
  "zip": "45385",
  "canada_military_branch": "Primary Reserve"
}
{
  "attributes": [
    {
      "handle": "fname",
      "name": "First Name",
      "value": "Bryant"
    },
    {
      "handle": "lname",
      "name": "Last Name",
      "value": "Kuhn"
    },
    {
      "handle": "email",
      "name": "Email",
      "value": "bryant.kuhn@id.me"
    },
    {
      "handle": "uuid",
      "name": "Unique Identifier",
      "value": "d733a89e2e634f04ac2fe66c97f71612"
    },
    {
      "handle": "zip",
      "name": "Zip Code",
      "value": "10713"
    },
    {
      "handle": "canada_military_branch",
      "name": "Canadian Military Branch",
      "value": "Canadian Special Operations Forces Command"
    }
  ],
  "status": [
    {
      "group": "military_canada",
      "subgroups": [
        "Retiree for Canada"
      ],
      "verified": true
    }
  ]
}
{
  "id": "d733a89e2e634f04ac2fe66c97f71612",
  "verified": true,
  "affiliation": "Retiree for Canada",
  "fname": "Vaughn",
  "lname": "Gutmann",
  "email": "test.user@id.me",
  "zip": "74760",
  "canada_military_branch": "Canadian Coast Guard"
}
{
  "attributes": [
    {
      "handle": "fname",
      "name": "First Name",
      "value": "Kraig"
    },
    {
      "handle": "lname",
      "name": "Last Name",
      "value": "Gorczany"
    },
    {
      "handle": "email",
      "name": "Email",
      "value": "kraig.gorczany@id.me"
    },
    {
      "handle": "uuid",
      "name": "Unique Identifier",
      "value": "d733a89e2e634f04ac2fe66c97f71612"
    },
    {
      "handle": "zip",
      "name": "Zip Code",
      "value": "64979"
    },
    {
      "handle": "canada_military_branch",
      "name": "Canadian Military Branch",
      "value": "Canadian Special Operations Forces Command"
    }
  ],
  "status": [
    {
      "group": "military_canada",
      "subgroups": [
        "CAF Dependent"
      ],
      "verified": true
    }
  ]
}
{
  "id": "d733a89e2e634f04ac2fe66c97f71612",
  "verified": true,
  "affiliation": "CAF Dependent",
  "fname": "Claudia",
  "lname": "Stoltenberg",
  "email": "test.user@id.me",
  "zip": "48749",
  "canada_military_branch": "Royal Canadian Air Force"
}
{
  "attributes": [
    {
      "handle": "fname",
      "name": "First Name",
      "value": "Leonard"
    },
    {
      "handle": "lname",
      "name": "Last Name",
      "value": "Hagenes"
    },
    {
      "handle": "email",
      "name": "Email",
      "value": "leonard.hagenes@id.me"
    },
    {
      "handle": "uuid",
      "name": "Unique Identifier",
      "value": "d733a89e2e634f04ac2fe66c97f71612"
    },
    {
      "handle": "zip",
      "name": "Zip Code",
      "value": "01005-2331"
    },
    {
      "handle": "government_department",
      "name": "Government Department",
      "value": "Department of the Treasury"
    }
  ],
  "status": [
    {
      "group": "government",
      "subgroups": [
        "Federal"
      ],
      "verified": true
    }
  ]
}
{
  "id": "d733a89e2e634f04ac2fe66c97f71612",
  "verified": true,
  "affiliation": "Federal",
  "fname": "Earline",
  "lname": "Reinger",
  "email": "test.user@id.me",
  "zip": "31268-6184",
  "government_department": "Department of the Treasury"
}
{
  "attributes": [
    {
      "handle": "fname",
      "name": "First Name",
      "value": "Jeffry"
    },
    {
      "handle": "lname",
      "name": "Last Name",
      "value": "O'Kon"
    },
    {
      "handle": "email",
      "name": "Email",
      "value": "jeffry.o'kon@id.me"
    },
    {
      "handle": "uuid",
      "name": "Unique Identifier",
      "value": "d733a89e2e634f04ac2fe66c97f71612"
    },
    {
      "handle": "zip",
      "name": "Zip Code",
      "value": "72804-1852"
    },
    {
      "handle": "government_department",
      "name": "Government Department",
      "value": "Department of the Treasury"
    }
  ],
  "status": [
    {
      "group": "government",
      "subgroups": [
        "State"
      ],
      "verified": true
    }
  ]
}
{
  "id": "d733a89e2e634f04ac2fe66c97f71612",
  "verified": true,
  "affiliation": "State",
  "fname": "Sadye",
  "lname": "Stracke",
  "email": "test.user@id.me",
  "zip": "98390-8084",
  "government_department": "Department of the Treasury"
}
{
  "attributes": [
    {
      "handle": "fname",
      "name": "First Name",
      "value": "Rona"
    },
    {
      "handle": "lname",
      "name": "Last Name",
      "value": "Stark"
    },
    {
      "handle": "email",
      "name": "Email",
      "value": "rona.stark@id.me"
    },
    {
      "handle": "uuid",
      "name": "Unique Identifier",
      "value": "d733a89e2e634f04ac2fe66c97f71612"
    },
    {
      "handle": "zip",
      "name": "Zip Code",
      "value": "77016"
    },
    {
      "handle": "government_department",
      "name": "Government Department",
      "value": "Department of the Treasury"
    }
  ],
  "status": [
    {
      "group": "government",
      "subgroups": [
        "Local"
      ],
      "verified": true
    }
  ]
}
{
  "id": "d733a89e2e634f04ac2fe66c97f71612",
  "verified": true,
  "affiliation": "Local",
  "fname": "Julio",
  "lname": "Grimes",
  "email": "test.user@id.me",
  "zip": "18180-1885",
  "government_department": "Department of the Treasury"
}
{
  "attributes": [
    {
      "handle": "fname",
      "name": "First Name",
      "value": "Maynard"
    },
    {
      "handle": "lname",
      "name": "Last Name",
      "value": "Lemke"
    },
    {
      "handle": "email",
      "name": "Email",
      "value": "maynard.lemke@id.me"
    },
    {
      "handle": "uuid",
      "name": "Unique Identifier",
      "value": "d733a89e2e634f04ac2fe66c97f71612"
    },
    {
      "handle": "zip",
      "name": "Zip Code",
      "value": "57965"
    },
    {
      "handle": "registry_status",
      "name": "Registry Status",
      "value": "Valid"
    },
    {
      "handle": "registry_expiration",
      "name": "Registry Expiration",
      "value": "2022-04-11"
    }
  ],
  "status": [
    {
      "group": "responder",
      "subgroups": [
        "EMT"
      ],
      "verified": true
    }
  ]
}
{
  "id": "d733a89e2e634f04ac2fe66c97f71612",
  "verified": true,
  "affiliation": "EMT",
  "fname": "Earleen",
  "lname": "Leuschke",
  "email": "test.user@id.me",
  "zip": "69670",
  "registry_status": "Valid",
  "registry_expiration": "2022-04-11"
}
{
  "attributes": [
    {
      "handle": "fname",
      "name": "First Name",
      "value": "Senaida"
    },
    {
      "handle": "lname",
      "name": "Last Name",
      "value": "Hand"
    },
    {
      "handle": "email",
      "name": "Email",
      "value": "senaida.hand@id.me"
    },
    {
      "handle": "uuid",
      "name": "Unique Identifier",
      "value": "d733a89e2e634f04ac2fe66c97f71612"
    },
    {
      "handle": "zip",
      "name": "Zip Code",
      "value": "06959-5617"
    },
    {
      "handle": "agency",
      "name": "Agency",
      "value": "Henderson FD - KY"
    }
  ],
  "status": [
    {
      "group": "responder",
      "subgroups": [
        "Firefighter"
      ],
      "verified": true
    }
  ]
}
{
  "id": "d733a89e2e634f04ac2fe66c97f71612",
  "verified": true,
  "affiliation": "Firefighter",
  "fname": "Raymonde",
  "lname": "Brakus",
  "email": "test.user@id.me",
  "zip": "03993",
  "agency": "Henderson FD - KY"
}
{
  "attributes": [
    {
      "handle": "fname",
      "name": "First Name",
      "value": "Antonietta"
    },
    {
      "handle": "lname",
      "name": "Last Name",
      "value": "Roob"
    },
    {
      "handle": "email",
      "name": "Email",
      "value": "antonietta.roob@id.me"
    },
    {
      "handle": "uuid",
      "name": "Unique Identifier",
      "value": "d733a89e2e634f04ac2fe66c97f71612"
    },
    {
      "handle": "zip",
      "name": "Zip Code",
      "value": "20086-9514"
    },
    {
      "handle": "student_school_name",
      "name": "Student School Name",
      "value": "Kemmer Academy"
    },
    {
      "handle": "student_anticipated_graduation_date",
      "name": "Student Anticipated Graduation Date",
      "value": "2022-04-11"
    },
    {
      "handle": "student_enrollment_status",
      "name": "Student Enrollment Status",
      "value": "Y"
    },
    {
      "handle": "student_school_type",
      "name": "Student School Type",
      "value": "4 YR/GRAD"
    }
  ],
  "status": [
    {
      "group": "student",
      "subgroups": [
        null
      ],
      "verified": true
    }
  ]
}
{
  "id": "d733a89e2e634f04ac2fe66c97f71612",
  "verified": true,
  "affiliation": null,
  "fname": "Lulu",
  "lname": "Swift",
  "email": "test.user@id.me",
  "zip": "48616-1152",
  "student_anticipated_graduation_date": "2020-04-11",
  "student_school_name": "Southern Hegmann Institute",
  "student_enrollment_status": "Y",
  "student_school_type": "2 YR"
}
{
  "attributes": [
    {
      "handle": "fname",
      "name": "First Name",
      "value": "Nicolette"
    },
    {
      "handle": "lname",
      "name": "Last Name",
      "value": "Fritsch"
    },
    {
      "handle": "email",
      "name": "Email",
      "value": "nicolette.fritsch@id.me"
    },
    {
      "handle": "uuid",
      "name": "Unique Identifier",
      "value": "d733a89e2e634f04ac2fe66c97f71612"
    },
    {
      "handle": "zip",
      "name": "Zip Code",
      "value": "19753"
    },
    {
      "handle": "alumni_school_name",
      "name": "Alumni School Name",
      "value": "Southern Feest University"
    },
    {
      "handle": "alumni_graduation_date",
      "name": "Alumni Graduation Date",
      "value": "2020-04-11"
    }
  ],
  "status": [
    {
      "group": "alumni",
      "subgroups": [
        null
      ],
      "verified": true
    }
  ]
}
{
  "id": "d733a89e2e634f04ac2fe66c97f71612",
  "verified": true,
  "affiliation": null,
  "fname": "Raphael",
  "lname": "Beer",
  "email": "test.user@id.me",
  "zip": "26167",
  "alumni_graduation_date": "2020-04-11",
  "alumni_school_name": "Senger University"
}
{
  "attributes": [
    {
      "handle": "fname",
      "name": "First Name",
      "value": "Angelique"
    },
    {
      "handle": "lname",
      "name": "Last Name",
      "value": "Stroman"
    },
    {
      "handle": "email",
      "name": "Email",
      "value": "angelique.stroman@id.me"
    },
    {
      "handle": "uuid",
      "name": "Unique Identifier",
      "value": "d733a89e2e634f04ac2fe66c97f71612"
    },
    {
      "handle": "zip",
      "name": "Zip Code",
      "value": "68643-7959"
    },
    {
      "handle": "teacher_school",
      "name": "Teacher School",
      "value": "Thomas Jefferson High School"
    },
    {
      "handle": "teacher_district",
      "name": "Teacher District",
      "value": "Fairfax County"
    },
    {
      "handle": "teacher_state",
      "name": "Teacher State",
      "value": "VA"
    }
  ],
  "status": [
    {
      "group": "teacher",
      "subgroups": [
        "Classroom Teacher"
      ],
      "verified": true
    }
  ]
}
{
  "id": "d733a89e2e634f04ac2fe66c97f71612",
  "verified": true,
  "affiliation": "Classroom Teacher",
  "fname": "Lindsay",
  "lname": "Koss",
  "email": "test.user@id.me",
  "zip": "97354",
  "teacher_school": "Thomas Jefferson High School",
  "teacher_district": "Fairfax County",
  "teacher_state": "VA"
}
{
  "attributes": [
    {
      "handle": "fname",
      "name": "First Name",
      "value": "Chastity"
    },
    {
      "handle": "lname",
      "name": "Last Name",
      "value": "Rosenbaum"
    },
    {
      "handle": "email",
      "name": "Email",
      "value": "chastity.rosenbaum@id.me"
    },
    {
      "handle": "uuid",
      "name": "Unique Identifier",
      "value": "d733a89e2e634f04ac2fe66c97f71612"
    },
    {
      "handle": "zip",
      "name": "Zip Code",
      "value": "16734-5641"
    },
    {
      "handle": "teacher_school",
      "name": "Teacher School",
      "value": "Thomas Jefferson High School"
    },
    {
      "handle": "teacher_district",
      "name": "Teacher District",
      "value": "Fairfax County"
    },
    {
      "handle": "teacher_state",
      "name": "Teacher State",
      "value": "VA"
    }
  ],
  "status": [
    {
      "group": "teacher",
      "subgroups": [
        "Adminstrator"
      ],
      "verified": true
    }
  ]
}
{
  "id": "d733a89e2e634f04ac2fe66c97f71612",
  "verified": true,
  "affiliation": "Adminstrator",
  "fname": "Gerard",
  "lname": "Koss",
  "email": "test.user@id.me",
  "zip": "42386",
  "teacher_school": "Thomas Jefferson High School",
  "teacher_district": "Fairfax County",
  "teacher_state": "VA"
}
{
  "attributes": [
    {
      "handle": "fname",
      "name": "First Name",
      "value": "Margaret"
    },
    {
      "handle": "lname",
      "name": "Last Name",
      "value": "Berge"
    },
    {
      "handle": "email",
      "name": "Email",
      "value": "margaret.berge@id.me"
    },
    {
      "handle": "uuid",
      "name": "Unique Identifier",
      "value": "d733a89e2e634f04ac2fe66c97f71612"
    },
    {
      "handle": "zip",
      "name": "Zip Code",
      "value": "89831-8609"
    },
    {
      "handle": "teacher_school",
      "name": "Teacher School",
      "value": "Thomas Jefferson High School"
    },
    {
      "handle": "teacher_district",
      "name": "Teacher District",
      "value": "Fairfax County"
    },
    {
      "handle": "teacher_state",
      "name": "Teacher State",
      "value": "VA"
    }
  ],
  "status": [
    {
      "group": "teacher",
      "subgroups": [
        "Assistant Principal"
      ],
      "verified": true
    }
  ]
}
{
  "id": "d733a89e2e634f04ac2fe66c97f71612",
  "verified": true,
  "affiliation": "Assistant Principal",
  "fname": "Loren",
  "lname": "Aufderhar",
  "email": "test.user@id.me",
  "zip": "06876-1658",
  "teacher_school": "Thomas Jefferson High School",
  "teacher_district": "Fairfax County",
  "teacher_state": "VA"
}
{
  "attributes": [
    {
      "handle": "fname",
      "name": "First Name",
      "value": "Brendan"
    },
    {
      "handle": "lname",
      "name": "Last Name",
      "value": "Ebert"
    },
    {
      "handle": "email",
      "name": "Email",
      "value": "brendan.ebert@id.me"
    },
    {
      "handle": "uuid",
      "name": "Unique Identifier",
      "value": "d733a89e2e634f04ac2fe66c97f71612"
    },
    {
      "handle": "zip",
      "name": "Zip Code",
      "value": "15205"
    },
    {
      "handle": "teacher_school",
      "name": "Teacher School",
      "value": "Thomas Jefferson High School"
    },
    {
      "handle": "teacher_district",
      "name": "Teacher District",
      "value": "Fairfax County"
    },
    {
      "handle": "teacher_state",
      "name": "Teacher State",
      "value": "VA"
    }
  ],
  "status": [
    {
      "group": "teacher",
      "subgroups": [
        "Principal"
      ],
      "verified": true
    }
  ]
}
{
  "id": "d733a89e2e634f04ac2fe66c97f71612",
  "verified": true,
  "affiliation": "Principal",
  "fname": "Mana",
  "lname": "Emmerich",
  "email": "test.user@id.me",
  "zip": "85481-0525",
  "teacher_school": "Thomas Jefferson High School",
  "teacher_district": "Fairfax County",
  "teacher_state": "VA"
}
{
  "attributes": [
    {
      "handle": "fname",
      "name": "First Name",
      "value": "Madeleine"
    },
    {
      "handle": "lname",
      "name": "Last Name",
      "value": "Lockman"
    },
    {
      "handle": "email",
      "name": "Email",
      "value": "madeleine.lockman@id.me"
    },
    {
      "handle": "uuid",
      "name": "Unique Identifier",
      "value": "d733a89e2e634f04ac2fe66c97f71612"
    },
    {
      "handle": "zip",
      "name": "Zip Code",
      "value": "00522"
    }
  ],
  "status": [
    {
      "group": "responder",
      "subgroups": [
        "Police Officer"
      ],
      "verified": true
    }
  ]
}
{
  "id": "d733a89e2e634f04ac2fe66c97f71612",
  "verified": true,
  "affiliation": "Police Officer",
  "fname": "Theodore",
  "lname": "Kreiger",
  "email": "test.user@id.me",
  "zip": "97029-3007"
}
{
  "attributes": [
    {
      "handle": "fname",
      "name": "First Name",
      "value": "Irvin"
    },
    {
      "handle": "lname",
      "name": "Last Name",
      "value": "Bernhard"
    },
    {
      "handle": "email",
      "name": "Email",
      "value": "irvin.bernhard@id.me"
    },
    {
      "handle": "uuid",
      "name": "Unique Identifier",
      "value": "d733a89e2e634f04ac2fe66c97f71612"
    },
    {
      "handle": "zip",
      "name": "Zip Code",
      "value": "55867-7707"
    }
  ],
  "status": [
    {
      "group": "responder",
      "subgroups": [
        "911 Dispatcher"
      ],
      "verified": true
    }
  ]
}
{
  "id": "d733a89e2e634f04ac2fe66c97f71612",
  "verified": true,
  "affiliation": "911 Dispatcher",
  "fname": "Eugene",
  "lname": "Hilll",
  "email": "test.user@id.me",
  "zip": "73954"
}
{
  "attributes": [
    {
      "handle": "fname",
      "name": "First Name",
      "value": "Serena"
    },
    {
      "handle": "lname",
      "name": "Last Name",
      "value": "Wolf"
    },
    {
      "handle": "email",
      "name": "Email",
      "value": "serena.wolf@id.me"
    },
    {
      "handle": "uuid",
      "name": "Unique Identifier",
      "value": "d733a89e2e634f04ac2fe66c97f71612"
    },
    {
      "handle": "zip",
      "name": "Zip Code",
      "value": "93543"
    }
  ],
  "status": [
    {
      "group": "responder_canada",
      "subgroups": [
        "EMT for Canada"
      ],
      "verified": true
    }
  ]
}
{
  "id": "d733a89e2e634f04ac2fe66c97f71612",
  "verified": true,
  "affiliation": "EMT for Canada",
  "fname": "Dylan",
  "lname": "Marvin",
  "email": "test.user@id.me",
  "zip": "63311-2331"
}
{
  "attributes": [
    {
      "handle": "fname",
      "name": "First Name",
      "value": "Mendy"
    },
    {
      "handle": "lname",
      "name": "Last Name",
      "value": "Nader"
    },
    {
      "handle": "email",
      "name": "Email",
      "value": "mendy.nader@id.me"
    },
    {
      "handle": "uuid",
      "name": "Unique Identifier",
      "value": "d733a89e2e634f04ac2fe66c97f71612"
    },
    {
      "handle": "zip",
      "name": "Zip Code",
      "value": "73635-4391"
    }
  ],
  "status": [
    {
      "group": "responder_canada",
      "subgroups": [
        "Police Officer for Canada"
      ],
      "verified": true
    }
  ]
}
{
  "id": "d733a89e2e634f04ac2fe66c97f71612",
  "verified": true,
  "affiliation": "Police Officer for Canada",
  "fname": "Josphine",
  "lname": "Abernathy",
  "email": "test.user@id.me",
  "zip": "40196-7174"
}
{
  "attributes": [
    {
      "handle": "fname",
      "name": "First Name",
      "value": "Zack"
    },
    {
      "handle": "lname",
      "name": "Last Name",
      "value": "Ebert"
    },
    {
      "handle": "email",
      "name": "Email",
      "value": "zack.ebert@id.me"
    },
    {
      "handle": "uuid",
      "name": "Unique Identifier",
      "value": "d733a89e2e634f04ac2fe66c97f71612"
    },
    {
      "handle": "zip",
      "name": "Zip Code",
      "value": "70871"
    }
  ],
  "status": [
    {
      "group": "responder_canada",
      "subgroups": [
        "Firefighter for Canada"
      ],
      "verified": true
    }
  ]
}
{
  "id": "d733a89e2e634f04ac2fe66c97f71612",
  "verified": true,
  "affiliation": "Firefighter for Canada",
  "fname": "Evelynn",
  "lname": "Jones",
  "email": "test.user@id.me",
  "zip": "46998"
}
{
  "attributes": [
    {
      "handle": "fname",
      "name": "First Name",
      "value": "Madlyn"
    },
    {
      "handle": "lname",
      "name": "Last Name",
      "value": "Jacobson"
    },
    {
      "handle": "email",
      "name": "Email",
      "value": "madlyn.jacobson@id.me"
    },
    {
      "handle": "uuid",
      "name": "Unique Identifier",
      "value": "d733a89e2e634f04ac2fe66c97f71612"
    },
    {
      "handle": "zip",
      "name": "Zip Code",
      "value": "73732-0825"
    }
  ],
  "status": [
    {
      "group": "employee",
      "subgroups": [
        "ID.me"
      ],
      "verified": true
    }
  ]
}
{
  "id": "d733a89e2e634f04ac2fe66c97f71612",
  "verified": true,
  "affiliation": "ID.me",
  "fname": "Royce",
  "lname": "Beatty",
  "email": "test.user@id.me",
  "zip": "76870-4814"
}
{
  "attributes": [
    {
      "handle": "fname",
      "name": "First Name",
      "value": "Octavia"
    },
    {
      "handle": "lname",
      "name": "Last Name",
      "value": "Funk"
    },
    {
      "handle": "email",
      "name": "Email",
      "value": "octavia.funk@id.me"
    },
    {
      "handle": "uuid",
      "name": "Unique Identifier",
      "value": "d733a89e2e634f04ac2fe66c97f71612"
    },
    {
      "handle": "zip",
      "name": "Zip Code",
      "value": "56015-0310"
    }
  ],
  "status": [
    {
      "group": "nurse",
      "subgroups": [
        "Registered Nurse"
      ],
      "verified": true
    }
  ]
}
{
  "id": "d733a89e2e634f04ac2fe66c97f71612",
  "verified": true,
  "affiliation": "Registered Nurse",
  "fname": "Jefferson",
  "lname": "Wuckert",
  "email": "test.user@id.me",
  "zip": "71908"
}
{
  "attributes": [
    {
      "handle": "fname",
      "name": "First Name",
      "value": "Loura"
    },
    {
      "handle": "lname",
      "name": "Last Name",
      "value": "Cronin"
    },
    {
      "handle": "email",
      "name": "Email",
      "value": "loura.cronin@id.me"
    },
    {
      "handle": "uuid",
      "name": "Unique Identifier",
      "value": "d733a89e2e634f04ac2fe66c97f71612"
    },
    {
      "handle": "zip",
      "name": "Zip Code",
      "value": "75582-9782"
    }
  ],
  "status": [
    {
      "group": "identity",
      "subgroups": [
        null
      ],
      "verified": true
    },
    {
      "group": "medical",
      "subgroups": [
        null
      ],
      "verified": true
    }
  ]
}
{
  "id": "d733a89e2e634f04ac2fe66c97f71612",
  "verified": true,
  "affiliation": null,
  "fname": "Mittie",
  "lname": "Hammes",
  "email": "test.user@id.me",
  "zip": "83006-7091"
}

Values

The JSON response contains the verification status and attributes for the user. The specific attributes returned depend on your application configuration and needs.

The JSON response contains the verification attributes for the user. The specific attributes returned depend on your application configuration and needs.


Attributes
Handle Name Value Description
uuid

Unique Identifier

ID randomly generated and unique to user
fname

First Name

First name set by user
lname

Last Name

Last name set by user
email

Email

Unique email set by user
zip

Zip Code

Zip code set by user

These are typical response values. The data passed back depends on your application configuration.
Status
Attributes
Parameter Description and Value Range
uuid

User unique identifier
fname

First name set by user
lname

Last name set by user
email

Unique email set by user
zip

Zip code set by user
group

Military Verification - military

Government Employee Verification - government

First Responder Verification - responder

Student Verification - student

Alumni Verification - alumni

Teacher Verification - teacher

Employee Verification - employee

Nurse Verification - nurse

Medical Verification - medical

subgroups affiliation

Military Verification - Service Member Veteran Retiree Military Spouse Military Family Service Member for Canada Veteran for Canada Retiree for Canada CAF Dependent

Government Employee Verification - Federal State Local

First Responder Verification - EMT Firefighter Police Officer 911 Dispatcher EMT for Canada Police Officer for Canada Firefighter for Canada

Teacher Verification - Classroom Teacher Adminstrator Assistant Principal Principal

Employee Verification - ID.me

Nurse Verification - Registered Nurse

verified

true or false

These are typical response values. The data passed back depends on your application configuration.
Transactions

Transactional data can be passed back in the JSON response as well. If you are interested in learning more about the value of transactional data and how to add this data to the JSON response, please contact us.

Best Practices

Creating a session

Once you have retreived the user’s attributes it is recommended that you store them in the user’s session to keep the experience consistent in case the page is refreshed, the back button is pressed, etc.

Storing User Attribtues

Storing key attributes about the user is vital to a seamless group affiliation verification experience. It is recommended to store these attributes in a seperate table within your database with some relation to the user record.


Key Attributes

Handle Name Description
uuid Unique Identifer Unique identifier that is randomly generated and unique to user.
email E-Mail Unique email set by the user.
fname First Name First name set by user.
lname Last Name Last name set by user.
Waves