Get user by email

Get the full detail of a user record

Securitybearer
Request
path Parameters
email
required
string
Responses
200
401

Invalid Authorization

402

You must upgrade your plan to use this feature

403

You are not allowed to perform this action

412

You must accept the Drata terms and conditions to use the API

500

Internal server error

get/users/{email}/email
Request samples 
Response samples 
application/json
{
  • "id": 1,
  • "entryId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
  • "email": "email@email.com",
  • "firstName": "Sally",
  • "lastName": "Smith",
  • "jobTitle": "CEO",
  • "avatarUrl": "https://cdn-prod.imgpilot.com/avatar.png",
  • "drataTermsAgreedAt": "2025-07-01T16:45:55.246Z",
  • "createdAt": "2025-07-01T16:45:55.246Z",
  • "updatedAt": "2025-07-01T16:45:55.246Z",
  • "roles": [
    • "ROLE",
    • "ANOTHER_ROLE"
    ],
  • "backgroundChecks": [
    • {
      • "id": 1,
      • "userId": 1,
      • "status": "OK",
      • "caseId": "abc123",
      • "caseInvitationId": "abc123",
      • "url": "https://app-stage.karmacheck.com/background_check/aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
      • "manualCheckDate": "2020-07-06",
      • "manuallyCheckUrl": "url.com",
      • "type": "CERTN",
      • "source": "DRATA",
      • "reportData": "string",
      • "user": { },
      • "outOfScopeReason": "abc123",
      • "outOfScopeAt": "2025-07-01T16:45:55.246Z",
      • "invitationEmail": "email@email.com",
      • "linkedAt": "2025-07-01T16:45:55.246Z",
      • "createdAt": "2025-07-01T16:45:55.246Z",
      • "updatedAt": "2025-07-01T16:45:55.246Z"
      }
    ],
  • "identities": [
    • {
      • "id": 1,
      • "identityId": "1a2b3c",
      • "username": "Username",
      • "connectedAt": "2025-07-01T16:45:55.246Z",
      • "disconnectedAt": "2025-07-01T16:45:55.246Z",
      • "hasMfa": true,
      • "user": { },
      • "connection": {
        • "id": "1",
        • "clientType": "GOOGLE",
        • "state": "ACTIVE",
        • "connected": false,
        • "connectedAt": "2025-07-01T16:45:55.246Z",
        • "failedAt": "2025-07-01T16:45:55.246Z",
        • "companyId": "12341234",
        • "assignmentId": "FLk12AsS",
        • "user": { },
        • "accountId": "string",
        • "clientId": "abc123",
        • "clientAlias": "My-connection-alias-1",
        • "manuallyUpdatedAt": "2025-07-01T16:45:55.246Z",
        • "aliasUpdatedAt": "2025-07-01T16:45:55.246Z",
        • "deletedAt": "2025-07-01T16:45:55.246Z",
        • "requestorId": "328d3016-71f3-4485-af20-06ce8044da18",
        • "product": { },
        • "writeAccessEnabled": false,
        • "sourcePreference": "LABEL",
        • "securityLabel": "Jira Security Label",
        • "jqlQuery": "project = IT AND type = \"Offboarding\"",
        • "authorized": true,
        • "workspaces": [],
        • "providerTypes": [
          • 5
          ],
        • "code": 10010,
        • "groupLabel": "Everyone"
        },
      • "hasIdp": true,
      • "secondaryEmail": "johndoe@test.com",
      • "firstName": "John",
      • "lastName": "Doe",
      • "startedAt": "2025-07-01T16:45:55.246Z",
      • "separatedAt": "2025-07-01T16:45:55.246Z",
      • "isContractor": true,
      • "jobTitle": "Engineer",
      • "managerId": "x00jk12-2312",
      • "managerName": "string"
      }
    ],
  • "documents": [
    • {
      • "data": [
        • {
          • "id": 1,
          • "name": "Security Training",
          • "type": "SEC_TRAINING",
          • "fileUrl": "http://localhost:5000/download/documents/1",
          • "renewalDate": "2026-10-27",
          • "createdAt": "2025-07-01T16:45:55.246Z",
          • "updatedAt": "2025-07-01T16:45:55.246Z"
          }
        ],
      • "page": 1,
      • "limit": 10,
      • "total": 100
      }
    ]
}