---
title: "Returns a single user for the supplied company"
method: GET
path: "/companies/{identifier}/users/{email}"
tags: ["companies"]
---

# Returns a single user for the supplied company

`GET /companies/{identifier}/users/{email}`

Requires the privilege [`COMPANY_USERS_READ`](https://www.gremlin.com/docs/user-management/access-control/#privileges)

## Path parameters

- `identifier` string, required
- `email` string, required

## Response `default`

default response

- CompanyUserInfo
  - `state` 'ACTIVE' | 'IDLE' | 'REVOKED' | 'INVITED'
  - `roles` string[]
  - `teams` Info[]
    - `createdAt` string, date-time
    - `identifier` string
    - `name` string
    - `companyId` string
    - `updatedAt` string, date-time
    - `secretSetAt` string, date-time
    - `secretSetBy` string
    - `certificateSetAt` string, date-time
    - `certificateSetBy` string
    - `oldCertificateSetAt` string, date-time
    - `oldCertificateSetBy` string
    - `certificateExpiresOn` string, date-time
    - `oldCertificateExpiresOn` string, date-time
    - `certificateExpirationImminent` boolean
    - `oldCertificateExpirationImminent` boolean
    - `production` boolean
    - `prefs` Prefs — Prefs for team
      - `autoAddUsers` boolean
      - `domain` string
      - `testRunRestrictionWindows` TestRunRestrictionWindow[]
        - `dayOfWeek` 'M' | 'T' | 'W' | 'Th' | 'F' | 'S' | 'Su', required
        - `windowsForDay` ScheduleWindow[], required
          - `start` string, required — Time in HH:mm format (24-hour)
          - `end` string, required — Time in HH:mm format (24-hour)
    - `defaultTeamRole` string
    - `anyCertificateExpirationImminent` boolean
  - `active` boolean

## Other responses

- `401` — Authorization header missing or malformed. Please provide proper credentials in the authorization header.
- `403` — User requires privilege: COMPANY_USERS_READ

---

[API](https://skmtc.net/gremlin/apis/gremlin-api.md) · [All operations](https://skmtc.net/gremlin/apis/gremlin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gremlin/gremlin-api/revisions/15299c29037f/schema)