> ## Documentation Index
> Fetch the complete documentation index at: https://docs.versori.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Member

> GetMember returns a member for the given Organisation.



## OpenAPI

````yaml /openapi/organisations-api-v1.yaml get /organisations/{organisation_id}/members/{member_id}
openapi: 3.1.0
info:
  title: Organisations API
  description: >-
    The Organisations API provides users the ability to manage their
    organisations.
  version: v1
servers:
  - url: https://platform.versori.com/api/organisations/v1
    description: Production server
  - url: http://localhost:8081/v1
    description: Localhost
security: []
tags:
  - name: organisations
    description: >
      Organisations is the root-level entity for the Versori platform. All
      resources are scoped under an Organisation,

      each Organisation has an owner and can have multiple members.
  - name: signing-keys
    description: >
      Signing keys are used to sign JWTs which can be used to authenticate
      requests to the Versori platform.
paths:
  /organisations/{organisation_id}/members/{member_id}:
    parameters:
      - $ref: '#/components/parameters/organisation_id'
      - $ref: '#/components/parameters/member_id'
    get:
      summary: Get Member
      description: GetMember returns a member for the given Organisation.
      operationId: GetMember
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Member'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  parameters:
    organisation_id:
      name: organisation_id
      in: path
      x-go-name: OrganisationID
      required: true
      schema:
        type: string
    member_id:
      name: member_id
      in: path
      x-go-name: MemberID
      required: true
      schema:
        type: string
  schemas:
    Member:
      description: Member is an identity who is a member of an Organisation.
      type: object
      properties:
        id:
          description: >-
            ID is the unique identifier for the Member, if a user is a member of
            multiple Organisations they will have multiple Member objects.
          type: string
          format: uuid
          x-go-name: ID
          x-go-type: uuid.UUID
          x-go-type-import:
            path: github.com/google/uuid
        identityType:
          type: string
          enum:
            - user
            - service_account
        identityId:
          description: IdentityID references the Versori User.
          type: string
          x-go-name: IdentityID
        name:
          description: >-
            Name is either the User's name or ServiceAccount's name. If name is
            not populated this will default to the email address.
          type: string
        email:
          description: >-
            Email is the email address of the Member. For service accounts this
            is the service account name with the suffix
            `@sa.ORG_SLUG.versori.com`.
          type: string
        picture:
          type: string
          format: url
        roleBindings:
          description: RoleBindings are the list of roles bindings granted to this Member.
          type: array
          items:
            $ref: '#/components/schemas/RoleBinding'
      required:
        - id
        - identityType
        - identityId
        - name
        - email
        - picture
        - roleBindings
    Error:
      type: object
      properties:
        code:
          type: string
          description: Code is a machine-readable error code.
        message:
          type: string
          description: Message is a human-readable error message.
        cause:
          type: string
          x-go-type-skip-optional-pointer: true
      required:
        - code
        - message
    RoleBinding:
      description: RoleBinding contains a role and the resource it is bound to.
      type: object
      properties:
        role:
          $ref: '#/components/schemas/Role'
        resource:
          $ref: '#/components/schemas/ResourceReference'
    Role:
      description: >-
        Role encompasses a set of permissions which can be granted to a Member
        or Group. Roles are currently predefined but may support custom roles in
        the future.
      type: object
      properties:
        id:
          type: string
          format: ulid
          x-go-name: ID
          x-go-type: ulid.ULID
          x-go-type-import:
            path: versori.dev/vergo/ulid
        name:
          description: >-
            Name is the user-defined name for the role. It must be unique within
            the scope of an Organisation.
          type: string
        permissions:
          type: array
          items:
            $ref: '#/components/schemas/Permission'
        scopes:
          description: >-
            Scope defines which resources the role can be bound to, i.e.
            "organisation", "switchboard" etc. Resources are hierarchical,
            meaning that if a role is bound to an Organisation, it will be
            inherited by all resources owned by that organisation, whereas if it
            is bound to an individual child resource such as a Switchboard
            board, it will only apply to that board.
          type: array
          items:
            type: string
            enum:
              - organisation
              - switchboard
              - connection
              - hub
    ResourceReference:
      description: >-
        ResourceReference is an abstract overview of a resource in the Versori
        platform.
      type: object
      properties:
        resourceType:
          type: string
          enum:
            - organisation
            - switchboard
            - connection
            - hub
        resourceId:
          type: string
        name:
          type: string
    Permission:
      description: >-
        Permission grants granular access to a resource. Permissions are
        predefined by Versori and cannot be customised.
      type: object
      properties:
        id:
          description: >-
            ID is a human-readable identifier for the permission, i.e.
            switchboard.publish
          type: string
          enum:
            - organisation.read
            - organisation.edit
            - organisation.delete
            - organisation.members.read
            - organisation.members.invite
            - organisation.members.edit
            - organisation.members.delete
            - organisation.manage_billing
            - organisation.manage_subscription
            - switchboard.create
            - switchboard.read
            - switchboard.edit
            - switchboard.publish
            - switchboard.delete
            - connection.create
            - connection.read
            - connection.edit
            - connection.delete
            - hub.create
            - hub.read
            - hub.edit
            - hub.delete
            - hub.integration.create
            - hub.integration.read
            - hub.integration.edit
            - hub.integration.publish
            - hub.integration.delete
            - hub.user.create
            - hub.user.read
            - hub.user.edit
            - hub.user.delete
        description:
          description: >-
            Description is a human-readable description of what the permission
            grants
          type: string

````