---
descriptions:
  list_users_for_resource:
    resource_id: The ID of the resource.
    permission_slug: >-
      The permission slug to filter by. Only users with this permission on the
      resource are returned.
    assignment: >-
      Filter by assignment type. Use "direct" for direct assignments only, or
      "indirect" to include inherited assignments.
    limit: 'Maximum number of records to return (default 10, max 100).'
    before: Cursor for pagination (before).
    after: Cursor for pagination (after).
    order: Sort order (asc or desc).
    data: Array of organization memberships that have access to the resource.
reference:
  curl:
    - key: list_users_for_resource
      id: list_users_for_resource
      url: /reference/fga/access-check/list-memberships
      title: '/authorization/resources/:resource_id/organization_memberships'
      type: GET
      parameters:
        - key: resource_id
          type: string
          description: (list_users_for_resource.resource_id)
        - key: permission_slug
          type: string
          description: (list_users_for_resource.permission_slug)
        - key: assignment
          type: '"direct" | "indirect"'
          optional: true
          description: (list_users_for_resource.assignment)
        - key: limit
          type: number
          optional: true
          description: (list_users_for_resource.limit)
        - key: before
          type: string
          optional: true
          description: (list_users_for_resource.before)
        - key: after
          type: string
          optional: true
          description: (list_users_for_resource.after)
        - key: order
          type: '"asc" | "desc"'
          optional: true
          description: (list_users_for_resource.order)
      returns:
        - key: anonymous
          type: object
          unwrap: true
          properties:
            - key: data
              type: array
              description: (list_users_for_resource.data)
            - key: list_metadata
              type: object
              properties:
                - key: before
                  type: string | null
                - key: after
                  type: string | null
  js:
    - key: listMembershipsForResource
      id: list_users_for_resource
      url: /reference/fga/access-check/list-memberships
      title: authorization.listMembershipsForResource()
      parameters:
        - key: options
          type: object
          unwrap: true
          properties:
            - key: resourceId
              type: string
              description: (list_users_for_resource.resource_id)
            - key: permissionSlug
              type: string
              description: (list_users_for_resource.permission_slug)
            - key: assignment
              type: '"direct" | "indirect"'
              optional: true
              description: (list_users_for_resource.assignment)
            - key: limit
              type: number
              optional: true
              description: (list_users_for_resource.limit)
            - key: before
              type: string
              optional: true
              description: (list_users_for_resource.before)
            - key: after
              type: string
              optional: true
              description: (list_users_for_resource.after)
            - key: order
              type: '"asc" | "desc"'
              optional: true
              description: (list_users_for_resource.order)
      returns:
        - key: anonymous
          type: object
          unwrap: true
          properties:
            - key: data
              type: 'OrganizationMembership[]'
              description: (list_users_for_resource.data)
            - key: listMetadata
              type: ListMetadata
originalPath: >-
  .tmp-workos-clone/packages/docs/content/reference/fga/access-check/list-memberships.mdx
---

## List memberships for a resource

Returns all organization memberships that have a specific permission on a resource. This is useful for answering "Who can access this resource?"

You can filter by assignment type to distinguish between direct assignments (role assigned directly on the resource) and indirect assignments (permission inherited from a parent resource).

<CodeBlock referenceId="list_users_for_resource">
  <CodeBlockTab title="Request" file="list-memberships-for-resource-request" />
  <CodeBlockTab
    title="Response"
    file="list-memberships-for-resource-response"
  />
</CodeBlock>