---
title: "Get an organization membership or invitation by ID"
method: GET
path: "/organization-roles/{id}"
tags: ["Organization Roles"]
---

# Get an organization membership or invitation by ID

`GET /organization-roles/{id}`

## Request

- Base URL: `https://api.purplegrain.com/api/v1`
- URL: `https://api.purplegrain.com/api/v1/organization-roles/{id}`
- Auth: none declared

Retrieve one organization membership or invitation using its role record ID. Returns the permission, membership status, invitation details and timestamps; include can expand the organization and user. The caller may read their own membership, or another member's role when they can manage the organization and their assistant grant permits write access. This lookup does not accept an invitation, change permissions or send a notification.

## Path parameters

- `id` string, required

## Query parameters

- `include` string

## Response `200`

Successful. When the `include` query parameter is used, the response may contain an `included` array (JSON:API) or inlined related resources (application/json).

- OrganizationRolesShowResponseAttributes
  - `data` OrganizationRoleModelAttributes: Organization role in attributes-adapter shape (Accept application/json); fields at top level.
    - `id` string
    - `type` string
    - `status` 'pending' | 'accepted' | 'declined'
    - `permission` 'owner' | 'admin' | 'manager' | 'contractor' | 'viewer'
    - `invited_email` string, nullable
    - `invited_mobile` string, nullable
    - `invited` boolean
    - `inviter_name` string: Display name of the inviter (the organization owner).
    - `updated_at` string, date-time
    - `created_at` string, date-time
    - `organization` object: Inlined when include=organization
    - `user` object: Inlined when include=user

## Other responses

- `404`: Not Found

---

[API](https://skmtc.dev/purplegrain/apis/purple-grain-api.md) · [All operations](https://skmtc.dev/purplegrain/apis/purple-grain-api/llms.txt) · [OpenAPI document](https://skmtc.dev/purplegrain/apis/purple-grain-api/revisions/29c5c990d66e?raw)