# Get users

```
GET 
/users
```

Retrieve a list of your organization's Core API Users, ordered by creation time.

## Request[​](#request "Direct link to request")

## Responses[​](#responses "Direct link to Responses")

* 200

A paginated list of Users.

## Operation spec

```json
{
  "method": "get",
  "path": "/users",
  "operationId": "get-users",
  "parameters": [
    {
      "name": "cursor",
      "description": "The cursor you received in the next_cursor field to fetch the next page.",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "limit",
      "description": "The amount of objects to retrieve, between 1 and 100.",
      "in": "query",
      "required": false,
      "schema": {
        "type": "integer",
        "minimum": 1,
        "maximum": 100,
        "example": 10
      }
    },
    {
      "name": "order",
      "description": "This flag is used to get results sorted in ascending or descending order.",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string",
        "enum": [
          "ASC",
          "DESC"
        ],
        "example": "DESC",
        "default": "ASC"
      }
    },
    {
      "name": "activated",
      "description": "Optional filter for activated/deactivated users.",
      "in": "query",
      "required": false,
      "schema": {
        "type": "boolean"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "A paginated list of Users.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "description": "The user object.",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid",
                      "description": "A unique identifier.",
                      "example": "98FCE1EF-DBCA-41EF-8BC7-4D1621AC07C6",
                      "title": "uuid"
                    },
                    "activated": {
                      "type": "boolean",
                      "description": "Always true unless you explicitly [deactivate](/2026-04-24/server/deactivate-copilot-user) the user."
                    },
                    "external_id": {
                      "type": "string",
                      "description": "A unique identifier for the user from another system which is given to Nabla.",
                      "nullable": true,
                      "maxLength": 256
                    },
                    "metadata": {
                      "type": "object",
                      "description": "You can use this parameter to attach key-value data to the object. You can specify up to 50 keys, with key names up to 40 characters long, all values must be of type string and up to 500 characters long.\n\nYou should **not** use this to store Protected Health Information (PHI) or any patient-related data.",
                      "nullable": true,
                      "additionalProperties": {
                        "type": "string",
                        "maxLength": 500
                      },
                      "maxProperties": 50,
                      "title": "metadata"
                    },
                    "created_at": {
                      "type": "string",
                      "format": "date-time",
                      "description": "The creation date of this object, in ISO 8601 format.",
                      "example": "2022-03-10T19:16:23.456Z",
                      "title": "created_at"
                    },
                    "specialty": {
                      "type": "string",
                      "description": "The medical specialty of the provider.",
                      "nullable": true,
                      "enum": [
                        "ADDICTION_MEDICINE",
                        "PAIN_MEDICINE",
                        "ALLERGY_AND_IMMUNOLOGY",
                        "ANESTHESIOLOGY",
                        "ONCOLOGY",
                        "CARDIOLOGY",
                        "SURGERY",
                        "DERMATOLOGY",
                        "DIABETOLOGY",
                        "ENDOCRINOLOGY",
                        "GENETICS",
                        "GERIATRICS",
                        "GYNECOLOGY",
                        "HEMATOLOGY",
                        "HEPATOLOGY",
                        "GASTROENTEROLOGY",
                        "SPORTS_MEDICINE",
                        "OCCUPATIONAL_MEDICINE",
                        "GENERAL_MEDICINE",
                        "FORENSIC_MEDICINE",
                        "PHYSICAL_MEDICINE_AND_REHABILITATION",
                        "NEPHROLOGY",
                        "NEUROLOGY",
                        "NUTRITION",
                        "DIETETICS",
                        "OPHTHALMOLOGY",
                        "ENT",
                        "PEDIATRICS",
                        "PULMONOLOGY",
                        "PSYCHIATRY",
                        "RHEUMATOLOGY",
                        "RADIOLOGY",
                        "IMMUNOLOGY",
                        "INFECTIOUS_DISEASE",
                        "SEXUAL_MEDICINE",
                        "TOXICOLOGY",
                        "UROLOGY",
                        "MIDWIFE",
                        "EMERGENCY_MEDICINE",
                        "NURSE",
                        "PSYCHOLOGY",
                        "PSYCHOTHERAPY",
                        "INTERNAL_MEDICINE",
                        "FAMILY_MEDICINE",
                        "DENTIST",
                        "VETERINARIAN",
                        "PHYSIOTHERAPY",
                        "CHIROPRACTIC",
                        "OSTEOPATHIC_MEDICINE",
                        "ORTHOPEDICS",
                        "OTHER",
                        "LACTATION_CONSULTANT",
                        "PODIATRY",
                        "GENERAL_PRACTICE",
                        "HOSPITAL_MEDICINE",
                        "BEHAVIORAL_HEALTH",
                        "MENTAL_HEALTH",
                        "SUBSTANCE_USE_DISORDER",
                        "VASCULAR_MEDICINE",
                        "LIFESTYLE_MEDICINE",
                        "PREVENTIVE_MEDICINE",
                        "PUBLIC_HEALTH",
                        "ADOLESCENT_MEDICINE",
                        "WOUND_CARE",
                        "NEUROSURGERY",
                        "PLASTIC_SURGERY",
                        "PALLIATIVE_CARE",
                        "TRANSPLANT_MEDICINE",
                        "OBESITY_MEDICINE",
                        "CASE_MANAGEMENT",
                        "CARE_MANAGEMENT",
                        "CARE_COORDINATION",
                        "SOCIAL_WORK",
                        "PATHOLOGY",
                        "RADIATION_ONCOLOGY",
                        "SLEEP_MEDICINE",
                        "AUDIOLOGY",
                        "REPRODUCTIVE_ENDOCRINOLOGY",
                        "PHARMACIST",
                        "OCCUPATIONAL_THERAPY",
                        "SPEECH_LANGUAGE_PATHOLOGY"
                      ],
                      "example": "GENERAL_PRACTICE",
                      "title": "specialty_kind"
                    }
                  },
                  "required": [
                    "id",
                    "activated",
                    "created_at"
                  ],
                  "title": "user"
                }
              },
              "has_more": {
                "type": "boolean",
                "example": true
              },
              "next_cursor": {
                "type": "string",
                "nullable": true,
                "description": "An opaque cursor to fetch the next page of the collection.",
                "title": "next_cursor"
              }
            },
            "required": [
              "data",
              "has_more"
            ]
          }
        }
      }
    }
  }
}
```