---
title: "List your org's scope-membership grants"
method: GET
path: "/me/scope-memberships"
tags: ["scope-membership"]
---

# List your org's scope-membership grants

`GET /me/scope-memberships`

## Request

- Base URL: `https://api.getmetacognition.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getmetacognition.com/me/scope-memberships`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/metacognition/apis/tex-api/docs/me/scope-memberships/get.ts> (a function with typed inputs; its response is checked against the schema)

List the explicit grants in your organization, optionally filtered by user and/or scope. Implicit user:/org: scopes are not rows and are not listed.

## Query parameters

- `user_id` string, nullable
- `scope_id` string, nullable

## Response `200`

Successful Response

- ScopeMembershipListResponse
  - `memberships` ScopeMembershipResponse[], required
    - `id` integer, required
    - `org_id` string, required
    - `user_id` string, required
    - `scope_id` string, required
    - `role` string, required
    - `created_at` string, date-time, required
  - `total` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/metacognition/apis/tex-api.md) - [All operations](https://skmtc.dev/metacognition/apis/tex-api/llms.txt) - [OpenAPI document](https://skmtc.dev/metacognition/apis/tex-api/revisions/3bef47e50f2e?raw)