---
title: "Retrieve specific user"
url: "https://earlyaccess.developers.bynder.com/apis/users-1/versions/81ec58a1-c748-4616-b383-861ec1c98a2d/paths/api-v4-users-id/get"
---

> Full API specification: https://earlyaccess.developers.bynder.com/apis/users-1/versions/81ec58a1-c748-4616-b383-861ec1c98a2d.md

# Retrieve specific user

`GET` `/api/v4/users/{id}`

## Path parameters

- `id` (string, required) - The id or username of the user you’d like to retrieve.

## Responses

- `200` - Successful response

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Users
  version: 1.0.0
servers:
  - url: https://{your-bynder-domain}/
paths:
  /api/v4/users/{id}:
    get:
      parameters:
        - description: The id or username of the user you’d like to retrieve.
          in: path
          name: id
          required: true
          schema:
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                properties:
                  active:
                    type: boolean
                  address:
                    type: string
                  cellphoneNumber:
                    type: string
                  city:
                    type: string
                  companyName:
                    type: string
                  costCenter:
                    type: string
                  country:
                    type: string
                  county:
                    type: string
                  department:
                    type: string
                  departmentCode:
                    type: string
                  email:
                    type: string
                  employeeNumber:
                    type: string
                  firstname:
                    type: string
                  gender:
                    type: string
                  groups:
                    items:
                      properties:
                        id:
                          type: string
                        name:
                          type: string
                      type: object
                    type: array
                  id:
                    type: string
                  infix:
                    type: string
                  isSSOOnly:
                    type: boolean
                  job:
                    type: string
                  language:
                    type: string
                  lastLogin:
                    format: date-time
                    type: string
                  lastname:
                    type: string
                  legalEntity:
                    type: string
                  persisted:
                    type: boolean
                  phoneNumber:
                    type: string
                  postalCode:
                    type: string
                  profileId:
                    type: string
                  state:
                    type: string
                  terms:
                    type: string
                  timeZone:
                    type: string
                  username:
                    type: string
                type: object
          description: Successful response
      security:
        - permanentToken:
            - USERMANAGEMENT
        - OAuth2:
            - USERMANAGEMENT
      summary: Retrieve specific user
      tags:
        - Users ID
security:
  - permanentToken:
      - USERMANAGEMENT
  - OAuth2:
      - USERMANAGEMENT
components:
  securitySchemes:
    permanentToken:
      in: header
      name: Authorization
      type: apiKey
    OAuth2:
      flows:
        authorizationCode:
          authorizationUrl: https://{your-auth-url}
          scopes:
            USERMANAGEMENT: Grants permission to manage users
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
        clientCredentials:
          scopes:
            USERMANAGEMENT: Grants permission to manage users
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
      type: oauth2
```