API Explorer 891 endpoints

Get Organisation Members

GET /obp/v7.0.0/management/organisations/ORGANISATION_ID/members

OBPv7.0.0-getOrganisationMembers Roles: CanGetOrganisationAtOneBank(per bank) Organisation

Get the members of an Organisation, with their member_role. The Role is checked at the Organisation's bank_id. An application can use this to give the members access of its own, for example Roles in a space.

An Organisation is a company or team that uses the APIs, for example a fintech, and owns Consumers. Its members are admins or members. Members may act for the Organisation's Consumers without a Role: read them, their usage, Scopes and API Product Subscriptions, and subscribe them. Admins also change the Organisation and its members, and move Consumers into or out of it.

Its bank_id is the space that administers it, and staff Roles for Organisations are held there. An Organisation you create for yourself is at SYS. Only staff with CanCreateOrganisationAtOneBank at a bank create one there. The bank_id is not a legal relationship with that bank, which is what a Customer is. An Organisation is not a Tenant either: a Tenant is a customer of the operator of this instance.

Authentication is Required.

User Authentication is Required. The User must be logged in. The Application must also be authenticated.

URL Parameters:

ORGANISATION_ID: 8ca8a7e4-6d02-48e3-a029-0b2bf89de9f0

JSON response body fields (8)
created_at
created_at
created_by_user_id
member_role
member_role
members
members
organisation_id
8ca8a7e4-6d02-48e3-a029-0b2bf89de9f0
provider
ETHEREUM
user_id
9ca9a7e4-6d02-40e3-a129-0b2bf89de9b1
username
felixsmith
Example success response
{
  "members": [
    {
      "organisation_id": "8ca8a7e4-6d02-48e3-a029-0b2bf89de9f0",
      "user_id": "9ca9a7e4-6d02-40e3-a129-0b2bf89de9b1",
      "username": "susan.uk.29@example.com",
      "provider": "https://oidc.example.com",
      "member_role": "member",
      "created_by_user_id": "9ca9a7e4-6d02-40e3-a129-0b2bf89de9b1",
      "created_at": "1100-01-01T00:00:00Z"
    }
  ]
}
Possible errors (4)
  • OBP-20001: User not logged in. Authentication is required!
  • OBP-20006: User is missing one or more roles:
  • OBP-30630: Organisation not found. Please specify the ORGANISATION_ID of an Organisation you belong to.
  • OBP-50000: Unknown Error.
Implemented by OBPv7.0.0 getOrganisationMembers