---
updatedAt: 2026-09-21T10:35:22.000Z
agentTools:
  projectIndex: https://developers.marq.com/llms.txt
---

# List users

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "scim",
    "version": "1"
  },
  "servers": [
    {
      "url": "https://users.app.marq.com/scim/v2/press"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "oauth2",
        "flows": {
          "clientCredentials": {
            "tokenUrl": "https://example.com/oauth2/token",
            "scopes": {}
          }
        }
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/users": {
      "get": {
        "summary": "List users",
        "description": "",
        "operationId": "list-users",
        "parameters": [
          {
            "name": "startIndex",
            "in": "query",
            "description": "Index of the first user in the list to return (1 indexed).",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          },
          {
            "name": "count",
            "in": "query",
            "description": "Quantity of users to return from this request.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "filter",
            "in": "query",
            "description": "See SCIM specification and optimization details below:  The only operator currently supported is `eq` We strongly recommend filtering only on the following optimized attributes whenever possible: `email`, `emails.value`, `workemail`, `username`, `displayname`",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"schemas\": [\n        \"urn:ietf:params:scim:api:messages:2.0:ListResponse\"\n    ],\n    \"totalResults\": 3,\n    \"startIndex\": 1,\n    \"itemsPerPage\": 100,\n    \"Resources\": [\n        {\n            \"urn:lucidchart:schemas:1.0:User\": {\n                \"canEdit\": true,\n                \"addOns\": []\n            },\n            \"displayName\": \"mary.smith@mossdemo.com\",\n            \"roles\": [\n                \"Campaigns User\"\n            ],\n            \"canEdit\": true,\n            \"active\": true,\n            \"userName\": \"mary.smith@mossdemo.com\",\n            \"urn:ietf:params:scim:schemas:extension:lucidpress:1.0:UserFields\": {\n                \"website\": \"https://www.marq.com\",\n                \"profileImage\": \"https://images.app.marq.com/images/1f9acd02-bb0b-4ab1-8d07-61e42295a677?product=press\",\n                \"Disclaimer\": \"All information provided is deemed reliable but is not guaranteed and should be independently verified.\",\n                \"logo\": \"https://images.app.marq.com/images/4f14a0ca-480a-497c-80f4-a1f6b838a623?product=press\",\n                \"Facebook URL\": \"https://www.facebook.com/marqhq/\",\n                \"address\": \"972 Birchwood Road, San Diego, California, 22434\",\n                \"Twitter URL\": \"https://twitter.com/marq_hq\",\n                \"title\": \"Office Manager\",\n                \"workPhone\": \"(419) 575-3829\",\n                \"Role Description\": \"Key Client Contact: Day-to-day project management & issue resolution\",\n                \"LinkedIn URL\": \"https://www.linkedin.com/company/marqhq/\",\n                \"fullName\": \"Mary Smith\",\n                \"Instagram URL\": \"https://www.instagram.com/buildonmarq/\",\n                \"company\": \"Smith & Johnson Office\",\n                \"cellPhone\": \"(419) 575-1538\"\n            },\n            \"emails\": [\n                {\n                    \"value\": \"mary.smith@mossdemo.com\",\n                    \"primary\": true\n                }\n            ],\n            \"urn:ietf:params:scim:schemas:extension:lucidchart:1.0:User\": {\n                \"canEdit\": true,\n                \"addOns\": []\n            },\n            \"meta\": {\n                \"resourceType\": \"User\",\n                \"created\": \"2024-04-11T05:12:01Z\",\n                \"lastModified\": \"2024-10-07T19:36:08Z\",\n                \"version\": \"W/\\\"1728329768000\\\"\",\n                \"location\": \"https://users.app.marq.com/scim/v2/press/Users/lucid-164182487\"\n            },\n            \"urn:ietf:params:scim:schemas:extension:marq:1.0:User\": {\n                \"billingCode\": null,\n                \"hasLicense\": true,\n                \"officeIdAtPrintVendor\": null,\n                \"userIdAtPrintVendor\": null,\n                \"primaryGroup\": null\n            },\n            \"schemas\": [\n                \"urn:ietf:params:scim:schemas:core:2.0:User\",\n                \"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User\",\n                \"urn:lucidchart:schemas:1.0:User\",\n                \"urn:ietf:params:scim:schemas:extension:lucidchart:1.0:User\",\n                \"urn:ietf:params:scim:schemas:extension:lucid:1.0:User\",\n                \"urn:ietf:params:scim:schemas:extension:lucid:2.0:User\",\n                \"urn:ietf:params:scim:schemas:extension:marq:1.0:User\"\n            ],\n            \"name\": {\n                \"formatted\": \"Mary Smith\",\n                \"givenName\": \"Mary\",\n                \"familyName\": \"Smith\"\n            },\n            \"urn:ietf:params:scim:schemas:extension:lucid:1.0:User\": {\n                \"billingCode\": null,\n                \"productLicenses\": {\n                    \"Marq\": true\n                },\n                \"officeIdAtPrintVendor\": null,\n                \"userIdAtPrintVendor\": null,\n                \"primaryGroup\": null\n            },\n            \"urn:ietf:params:scim:schemas:extension:lucid:2.0:User\": {\n                \"billingCode\": null,\n                \"userIdAtPrintVendor\": null,\n                \"officeIdAtPrintVendor\": null,\n                \"primaryGroup\": null,\n                \"productLicenses\": {\n                    \"Marq\": true\n                }\n            },\n            \"id\": \"lucid-164182487\"\n        },\n        {\n            \"urn:lucidchart:schemas:1.0:User\": {\n                \"canEdit\": true,\n                \"addOns\": []\n            },\n            \"displayName\": \"patricia.johnson@mossdemo.com\",\n            \"roles\": [],\n            \"canEdit\": true,\n            \"active\": true,\n            \"userName\": \"patricia.johnson@mossdemo.com\",\n            \"urn:ietf:params:scim:schemas:extension:lucidpress:1.0:UserFields\": {\n                \"website\": \"https://www.marq.com\",\n                \"disclaimer\": \"All information provided is deemed reliable but is not guaranteed and should be independently verified.\",\n                \"profileImage\": \"https://images.app.marq.com/images/b1e32ffb-fa62-4bc1-97a2-0848c0e1f030?product=press\",\n                \"Facebook URL\": \"https://www.facebook.com/marqhq/\",\n                \"address\": \"7876 Prince Street, Dallas, Texas, 75001\",\n                \"Twitter URL\": \"https://twitter.com/marq_hq\",\n                \"title\": \"Sales Manager\",\n                \"workPhone\": \"(530) 958-6808\",\n                \"Role Description\": \"Key Client Contact: Day-to-day project management & issue resolution\",\n                \"LinkedIn URL\": \"https://www.linkedin.com/company/marqhq/\",\n                \"fullName\": \"Patricia Johnson\",\n                \"Instagram URL\": \"https://www.instagram.com/buildonmarq/\",\n                \"company\": \"Johnson & Williams Office}\",\n                \"cellPhone\": \"(530) 958-3579\"\n            },\n            \"emails\": [\n                {\n                    \"value\": \"patricia.johnson@mossdemo.com\",\n                    \"primary\": true\n                }\n            ],\n            \"urn:ietf:params:scim:schemas:extension:lucidchart:1.0:User\": {\n                \"canEdit\": true,\n                \"addOns\": []\n            },\n            \"meta\": {\n                \"resourceType\": \"User\",\n                \"created\": \"2024-04-11T05:26:51Z\",\n                \"lastModified\": \"2024-04-11T05:58:08Z\",\n                \"version\": \"W/\\\"1712815088000\\\"\",\n                \"location\": \"https://users.app.marq.com/scim/v2/press/Users/lucid-164182491\"\n            },\n            \"urn:ietf:params:scim:schemas:extension:marq:1.0:User\": {\n                \"billingCode\": null,\n                \"hasLicense\": true,\n                \"officeIdAtPrintVendor\": null,\n                \"userIdAtPrintVendor\": null,\n                \"primaryGroup\": null\n            },\n            \"schemas\": [\n                \"urn:ietf:params:scim:schemas:core:2.0:User\",\n                \"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User\",\n                \"urn:lucidchart:schemas:1.0:User\",\n                \"urn:ietf:params:scim:schemas:extension:lucidchart:1.0:User\",\n                \"urn:ietf:params:scim:schemas:extension:lucid:1.0:User\",\n                \"urn:ietf:params:scim:schemas:extension:lucid:2.0:User\",\n                \"urn:ietf:params:scim:schemas:extension:marq:1.0:User\"\n            ],\n            \"name\": {\n                \"formatted\": \"Patricia Johnson\",\n                \"givenName\": \"Patricia\",\n                \"familyName\": \"Johnson\"\n            },\n            \"urn:ietf:params:scim:schemas:extension:lucid:1.0:User\": {\n                \"billingCode\": null,\n                \"productLicenses\": {\n                    \"Marq\": true\n                },\n                \"officeIdAtPrintVendor\": null,\n                \"userIdAtPrintVendor\": null,\n                \"primaryGroup\": null\n            },\n            \"urn:ietf:params:scim:schemas:extension:lucid:2.0:User\": {\n                \"billingCode\": null,\n                \"userIdAtPrintVendor\": null,\n                \"officeIdAtPrintVendor\": null,\n                \"primaryGroup\": null,\n                \"productLicenses\": {\n                    \"Marq\": true\n                }\n            },\n            \"id\": \"lucid-164182491\"\n        },\n        {\n            \"urn:lucidchart:schemas:1.0:User\": {\n                \"canEdit\": true,\n                \"addOns\": []\n            },\n            \"displayName\": \"james@YMCA.com\",\n            \"roles\": [],\n            \"canEdit\": true,\n            \"active\": true,\n            \"userName\": \"james@YMCA.com\",\n            \"urn:ietf:params:scim:schemas:extension:lucidpress:1.0:UserFields\": {\n                \"website\": \"https://www.marq.com\",\n                \"disclaimer\": \"All information provided is deemed reliable but is not guaranteed and should be independently verified.\",\n                \"profileImage\": \"https://images.app.marq.com/images/df9bdac1-fce8-4906-8ac6-7e5bb92e7b96?product=press\",\n                \"Facebook URL\": \"https://www.facebook.com/marqhq/\",\n                \"address\": \"599 Peachtree St., Orlando, Florida, 32789\",\n                \"Twitter URL\": \"https://twitter.com/marq_hq\",\n                \"title\": \"Account Executive\",\n                \"workPhone\": \"(252) 835-7154\",\n                \"Role Description\": \"Lead Consultant: Team and client lead for strategic and technical direction, and ongoing client relations manager\",\n                \"LinkedIn URL\": \"https://www.linkedin.com/company/marqhq/\",\n                \"fullName\": \"James Williams\",\n                \"Instagram URL\": \"https://www.instagram.com/buildonmarq/\",\n                \"company\": \"Williams & Brown Office}\",\n                \"cellPhone\": \"(252) 835-2779\"\n            },\n            \"emails\": [\n                {\n                    \"value\": \"james@YMCA.com\",\n                    \"primary\": true\n                }\n            ],\n            \"urn:ietf:params:scim:schemas:extension:lucidchart:1.0:User\": {\n                \"canEdit\": true,\n                \"addOns\": []\n            },\n            \"meta\": {\n                \"resourceType\": \"User\",\n                \"created\": \"2024-04-11T05:25:51Z\",\n                \"lastModified\": \"2024-05-30T16:21:36Z\",\n                \"version\": \"W/\\\"1717086096000\\\"\",\n                \"location\": \"https://users.app.marq.com/scim/v2/press/Users/lucid-164182492\"\n            },\n            \"urn:ietf:params:scim:schemas:extension:marq:1.0:User\": {\n                \"billingCode\": null,\n                \"hasLicense\": true,\n                \"officeIdAtPrintVendor\": null,\n                \"userIdAtPrintVendor\": null,\n                \"primaryGroup\": null\n            },\n            \"schemas\": [\n                \"urn:ietf:params:scim:schemas:core:2.0:User\",\n                \"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User\",\n                \"urn:lucidchart:schemas:1.0:User\",\n                \"urn:ietf:params:scim:schemas:extension:lucidchart:1.0:User\",\n                \"urn:ietf:params:scim:schemas:extension:lucid:1.0:User\",\n                \"urn:ietf:params:scim:schemas:extension:lucid:2.0:User\",\n                \"urn:ietf:params:scim:schemas:extension:marq:1.0:User\"\n            ],\n            \"name\": {\n                \"formatted\": \"James Williams\",\n                \"givenName\": \"James\",\n                \"familyName\": \"Williams\"\n            },\n            \"urn:ietf:params:scim:schemas:extension:lucid:1.0:User\": {\n                \"billingCode\": null,\n                \"productLicenses\": {\n                    \"Marq\": true\n                },\n                \"officeIdAtPrintVendor\": null,\n                \"userIdAtPrintVendor\": null,\n                \"primaryGroup\": null\n            },\n            \"urn:ietf:params:scim:schemas:extension:lucid:2.0:User\": {\n                \"billingCode\": null,\n                \"userIdAtPrintVendor\": null,\n                \"officeIdAtPrintVendor\": null,\n                \"primaryGroup\": null,\n                \"productLicenses\": {\n                    \"Marq\": true\n                }\n            },\n            \"id\": \"lucid-164182492\"\n        }\n    ]\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "schemas": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "example": "urn:ietf:params:scim:api:messages:2.0:ListResponse"
                      }
                    },
                    "totalResults": {
                      "type": "integer",
                      "example": 3,
                      "default": 0
                    },
                    "startIndex": {
                      "type": "integer",
                      "example": 1,
                      "default": 0
                    },
                    "itemsPerPage": {
                      "type": "integer",
                      "example": 100,
                      "default": 0
                    },
                    "Resources": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "urn:lucidchart:schemas:1.0:User": {
                            "type": "object",
                            "properties": {
                              "canEdit": {
                                "type": "boolean",
                                "example": true,
                                "default": true
                              },
                              "addOns": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {}
                                }
                              }
                            }
                          },
                          "displayName": {
                            "type": "string",
                            "example": "mary.smith@mossdemo.com"
                          },
                          "roles": {
                            "type": "array",
                            "items": {
                              "type": "string",
                              "example": "Campaigns User"
                            }
                          },
                          "canEdit": {
                            "type": "boolean",
                            "example": true,
                            "default": true
                          },
                          "active": {
                            "type": "boolean",
                            "example": true,
                            "default": true
                          },
                          "userName": {
                            "type": "string",
                            "example": "mary.smith@mossdemo.com"
                          },
                          "urn:ietf:params:scim:schemas:extension:lucidpress:1.0:UserFields": {
                            "type": "object",
                            "properties": {
                              "website": {
                                "type": "string",
                                "example": "https://www.marq.com"
                              },
                              "profileImage": {
                                "type": "string",
                                "example": "https://images.app.marq.com/images/1f9acd02-bb0b-4ab1-8d07-61e42295a677?product=press"
                              },
                              "Disclaimer": {
                                "type": "string",
                                "example": "All information provided is deemed reliable but is not guaranteed and should be independently verified."
                              },
                              "logo": {
                                "type": "string",
                                "example": "https://images.app.marq.com/images/4f14a0ca-480a-497c-80f4-a1f6b838a623?product=press"
                              },
                              "Facebook URL": {
                                "type": "string",
                                "example": "https://www.facebook.com/marqhq/"
                              },
                              "address": {
                                "type": "string",
                                "example": "972 Birchwood Road, San Diego, California, 22434"
                              },
                              "Twitter URL": {
                                "type": "string",
                                "example": "https://twitter.com/marq_hq"
                              },
                              "title": {
                                "type": "string",
                                "example": "Office Manager"
                              },
                              "workPhone": {
                                "type": "string",
                                "example": "(419) 575-3829"
                              },
                              "Role Description": {
                                "type": "string",
                                "example": "Key Client Contact: Day-to-day project management & issue resolution"
                              },
                              "LinkedIn URL": {
                                "type": "string",
                                "example": "https://www.linkedin.com/company/marqhq/"
                              },
                              "fullName": {
                                "type": "string",
                                "example": "Mary Smith"
                              },
                              "Instagram URL": {
                                "type": "string",
                                "example": "https://www.instagram.com/buildonmarq/"
                              },
                              "company": {
                                "type": "string",
                                "example": "Smith & Johnson Office"
                              },
                              "cellPhone": {
                                "type": "string",
                                "example": "(419) 575-1538"
                              }
                            }
                          },
                          "emails": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "value": {
                                  "type": "string",
                                  "example": "mary.smith@mossdemo.com"
                                },
                                "primary": {
                                  "type": "boolean",
                                  "example": true,
                                  "default": true
                                }
                              }
                            }
                          },
                          "urn:ietf:params:scim:schemas:extension:lucidchart:1.0:User": {
                            "type": "object",
                            "properties": {
                              "canEdit": {
                                "type": "boolean",
                                "example": true,
                                "default": true
                              },
                              "addOns": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {}
                                }
                              }
                            }
                          },
                          "meta": {
                            "type": "object",
                            "properties": {
                              "resourceType": {
                                "type": "string",
                                "example": "User"
                              },
                              "created": {
                                "type": "string",
                                "example": "2024-04-11T05:12:01Z"
                              },
                              "lastModified": {
                                "type": "string",
                                "example": "2024-10-07T19:36:08Z"
                              },
                              "version": {
                                "type": "string",
                                "example": "W/\"1728329768000\""
                              },
                              "location": {
                                "type": "string",
                                "example": "https://users.app.marq.com/scim/v2/press/Users/lucid-164182487"
                              }
                            }
                          },
                          "urn:ietf:params:scim:schemas:extension:marq:1.0:User": {
                            "type": "object",
                            "properties": {
                              "billingCode": {},
                              "hasLicense": {
                                "type": "boolean",
                                "example": true,
                                "default": true
                              },
                              "officeIdAtPrintVendor": {},
                              "userIdAtPrintVendor": {},
                              "primaryGroup": {}
                            }
                          },
                          "schemas": {
                            "type": "array",
                            "items": {
                              "type": "string",
                              "example": "urn:ietf:params:scim:schemas:core:2.0:User"
                            }
                          },
                          "name": {
                            "type": "object",
                            "properties": {
                              "formatted": {
                                "type": "string",
                                "example": "Mary Smith"
                              },
                              "givenName": {
                                "type": "string",
                                "example": "Mary"
                              },
                              "familyName": {
                                "type": "string",
                                "example": "Smith"
                              }
                            }
                          },
                          "urn:ietf:params:scim:schemas:extension:lucid:1.0:User": {
                            "type": "object",
                            "properties": {
                              "billingCode": {},
                              "productLicenses": {
                                "type": "object",
                                "properties": {
                                  "Marq": {
                                    "type": "boolean",
                                    "example": true,
                                    "default": true
                                  }
                                }
                              },
                              "officeIdAtPrintVendor": {},
                              "userIdAtPrintVendor": {},
                              "primaryGroup": {}
                            }
                          },
                          "urn:ietf:params:scim:schemas:extension:lucid:2.0:User": {
                            "type": "object",
                            "properties": {
                              "billingCode": {},
                              "userIdAtPrintVendor": {},
                              "officeIdAtPrintVendor": {},
                              "primaryGroup": {},
                              "productLicenses": {
                                "type": "object",
                                "properties": {
                                  "Marq": {
                                    "type": "boolean",
                                    "example": true,
                                    "default": true
                                  }
                                }
                              }
                            }
                          },
                          "id": {
                            "type": "string",
                            "example": "lucid-164182487"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```