Get Membership

get/v1/memberships/{membership_id}

Fetches a single membership by id with its included workspace and person. Read-only; no side effects. 404 when not found.

Requires a bearer token: Authorization: Bearer <token>.

Path parameters

NameTypeRequiredDescription
membership_idstring <uuid>YesPublic UUID of the membership.e.g. 3d4e5f60-7182-493a-a4b5-c6d7e8f9a0b1

Request

cURL
curl -X GET https://api.wellapp.ai/v1/memberships/{membership_id} \
  -H "Authorization: Bearer $WELL_API_TOKEN"

Responses

200 — The membership with included resources.

{
  "data": {
    "type": "membership",
    "id": "3d4e5f60-7182-493a-a4b5-c6d7e8f9a0b1",
    "attributes": {
      "membership_role": "member",
      "status": "pending",
      "firebase_id": null,
      "invite_token": "5f3a9c2e-1b4d-4e6f-8a90-12c3d4e5f607",
      "is_default": false,
      "created_at": "2026-02-01T10:00:00.000Z",
      "updated_at": "2026-02-01T10:00:00.000Z"
    },
    "relationships": {
      "workspace": {
        "data": {
          "type": "workspace",
          "id": "8f6b2c10-4a1e-4d2b-9c3a-1f0e7a5b6c21"
        }
      },
      "person": {
        "data": {
          "type": "people",
          "id": "d5e6f7a8-9b0c-41d2-83e4-f5a6b7c8d9e0"
        }
      },
      "parent_workspace": {
        "data": null
      },
      "invited_by": {
        "data": {
          "type": "people",
          "id": "c4d5e6f7-8a9b-40c1-92d3-e4f5a6b7c8d9"
        }
      }
    }
  },
  "included": [
    {
      "type": "workspace",
      "id": "8f6b2c10-4a1e-4d2b-9c3a-1f0e7a5b6c21",
      "attributes": {
        "name": "Foldspace AI",
        "description": "Production finance workspace for the Foldspace team.",
        "avatar_image": null,
        "avatar_color": "#5B8DEF",
        "external_workspace_id": null,
        "trusted": false,
        "auto_extract_enabled": true,
        "stage": "active",
        "timezone": "America/Los_Angeles",
        "parent_workspace_id": null,
        "created_at": "2026-01-12T09:29:00.000Z",
        "updated_at": "2026-05-21T07:45:00.000Z"
      },
      "relationships": {
        "person": {
          "data": {
            "type": "people",
            "id": "00000000-0000-4000-8000-000000000001"
          }
        },
        "invited_by": {
          "data": {
            "type": "people",
            "id": "00000000-0000-4000-8000-000000000001"
          }
        }
      }
    }
  ]
}

401 — Unauthorized

{
  "code": "UNAUTHORIZED",
  "status": 401,
  "title": "Unauthorized",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}

403 — Forbidden

{
  "code": "FORBIDDEN",
  "status": 403,
  "title": "Forbidden",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}

404 — Not Found

{
  "code": "NOT_FOUND",
  "status": 404,
  "title": "Not Found",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}