--- title: "Read user memberships" method: GET path: "/account/v2/users/{userUuid}/memberships" tags: ["User"] --- # Read user memberships `GET /account/v2/users/{userUuid}/memberships` ## Request - Base URL: `https://marketplace.appdirect.com/api` - URL: `https://marketplace.appdirect.com/api/account/v2/users/{userUuid}/memberships` - Auth: none declared - TypeScript: (a function with typed inputs; its response is checked against the schema) Retrieve a user's company memberships. ## Path parameters - `userUuid` string, required ## Query parameters - `status` string - `includeUserCustomAttributes` boolean - `includeCompanyCustomAttributes` boolean ## Response `200` Success - UserCompanyMembershipAccountV2, nullable: Represents a user membership to a company since a user can be a member of multiple companies - `links` Link[]: Resource links - `href` string - `rel` string - `company` CompanyAccountV2, nullable: Company information for Account V2 APIs - `links` Link[]: Resource links - `href` string - `rel` string - `uuid` string: Company ID - `name` string, nullable: Company name - `enabled` boolean: Indicates whether company is enabled - `allowLogin` boolean: Indicates whether a company's users are managed users (false) or not (true). Managed users access their products directly, not through the marketplace, therefore they cannot log in. The default is "true" - `address` CompanyAddress - `city` string, required - `country` string, required - `state` string - `street1` string, required - `street2` string - `zip` string, required - `companySize` 'SMALL' | 'MEDIUM' | 'ENTERPRISE': Company size types - `customAttributes` CustomAttributeAccountV2[]: Custom attributes - `attributeType` 'TEXT' | 'MULTISELECT' - `hint` string: Localized hint - `label` string: Localized label - `name` string: Name - `value` string: Value - `valueKeys` string[]: Value keys - `creationDate` number: Company creation date - `industry` string: Company industry sector - `salesAgent` Link, nullable - `href` string - `rel` string - `emailAddress` string: Company email address - `website` string: Company website URL - `picture` string, nullable: Company profile picture URL - `vendor` boolean: Indicates whether the company has Vendor access - `reseller` boolean: Indicates whether the company has Reseller access - `channelAdmin` boolean: Indicates whether the company has Channel Admin access - `referral` boolean: Indicates whether the company has Referral access - `externalId` string: Company external ID - `phoneNumber` string, nullable: Company phone number - `defaultRole` string: The default role newly created users receive - `countryCode` string: Company country code defined by ISO ALPHA-2 standard - `status` 'ACTIVE' | 'INACTIVE': Company status - `thirtyDaysPurchaseLimit` number: Monthly spend limit of marketplace - `thirtyDaysPurchaseRemainingAmt` number: Monthly remaining spending amount - `dailyPurchaseLimit` number: Daily spend limit of marketplace - `dailyPurchaseRemainingAmt` number: Daily remaining spending amount - `thirtyDaysPurchaseLimitExempt` boolean: Indicates if company is exempt from the marketplace default thirty day spend limit - `thirtyDaysPurchaseLimitOverrideAmt` number: Company-level override amount of marketplace default thirty day spend limit - `dailyPurchaseLimitExempt` boolean: Indicates if company is exempt from the marketplace default daily spend limit - `dailyPurchaseLimitOverrideAmt` number: Company-level override amount of marketplace default daily spend limit - `onlyAdminsCanBuy` boolean: Indicates if only selected roles in company that can make purchases or all roles in company can make purchases - `importAppsEnabled` boolean: The import apps feature is enabled for this company - `billingDayOfMonth` integer: (Optional) Use this property in company creation requests to set the billing cycle start date. The date applies to all purchases made through the specified company, and overrides the marketplace-level billing cycle date. - `mosiCustomerId` string: Microsoft customer account linked to the company - `partner` string: Partner name - `enabled` boolean: Is this membership enabled - `lastUsed` boolean: Is this company membership last used by user accessing the UI - `metadata` object - `mosiUser` MosiUser, nullable - `username` string, nullable - `position` string, nullable: User position (also referred to as "Title" in UI User Settings - `roles` string[]: Roles for this membership. One or more of the following: ROLE_CHANNEL_ADMIN (Marketplace Manager), ROLE_CHANNEL_PRODUCT_SUPPORT (Product Support), ROLE_SALES_SUPPORT (Sales Support), ROLE_RESELLER_MANAGER (Reseller Manager), ROLE_RESELLER (Reseller), ROLE_CHANNEL_SUPPORT (Customer Support), ROLE_SYS_ADMIN (Company Admin), ROLE_BILLING_ADMIN (Billing Admin), ROLE_DEVELOPER (Developer). For user roles (not associated with membership), see [UserAccountV2](#useraccountv2). - `user` UserAccountV2, nullable: User information - `links` Link[]: Resource links - `href` string - `rel` string - `activated` boolean: Is this user activated - `boostUser` BoostUser, nullable - `apsUid` string - `creationDate` number: User creation date in UNIX Epoch milliseconds - `customAttributes` CustomAttributeAccountV2[]: Custom attributes for this company - `attributeType` 'TEXT' | 'MULTISELECT' - `hint` string: Localized hint - `label` string: Localized label - `name` string: Name - `value` string: Value - `valueKeys` string[]: Value keys - `email` string: Email address - `externalId` string: External identifier of user - `firstName` string, nullable: First name - `lastName` string, nullable: Last name - `allowLogin` boolean: The user is able to log into a marketplace. By default allowLogin=true - `lastSuccessfulLogin` number: User last successful login date in UNIX Epoch milliseconds - `ldapId` string, nullable: Ldap integration - `idpUuid` string, nullable: The external identity provider's ID for the user - `locale` string: User locale in the standard ISO 639-1 language code + ISO 3166-1 country code format. For example: 'en_US', 'fr_CA', and so on. - `metadata` object - `openid` string: OpenID URL - `picture` string, nullable: Profile picture URL - `roles` string[]: User roles. All responses include ROLE_USER (end-user access). If the user has the Network Manager role, this array also includes ROLE_CORPORATE_ADMIN. For company membership roles, see [UserCompanyMembershipAccountV2](#usercompanymembershipaccountv2). - `userId` number: ID - `username` string, nullable: User name. If not provided, use the user's email address - `uuid` string: Unique identifier of the user assigned by the AppDirect platform ## Other responses - `401`: Unauthorized - `404`: User not found ## Changes - **2026-11-06** `1fc240f06971`: 2 breaking - removed the media type `*/*` for the response with the status `200` - removed the media type `*/*` for the response with the status `404` [Operation history](https://skmtc.dev/appdirect/apis/companies/changes/account/v2/users/:userUuid/memberships/get.md) --- [API](https://skmtc.dev/appdirect/apis/companies.md) - [All operations](https://skmtc.dev/appdirect/apis/companies/llms.txt) - [OpenAPI document](https://skmtc.dev/appdirect/apis/companies/revisions/1fc240f06971?raw)