Skip to main content
This flow can be executed using a human or a machine user.For machine users:
  • Send a valid Authorization header with of type Bearer TOKEN_VALUE where TOKEN_VALUE is the a JWT returned in the response from Machine User Token flow
For human users:
  • Send a valid Authorization header with of type Bearer TOKEN_VALUE where TOKEN_VALUE is the token returned in the response from Sign up or Sign in flow
In case your app supports cookie, you can enable request cookies as our API Automatically sets a cookie named session-token which is forwarded with each request to our api.
To retrieve organization details, you need to make a GET request to the following endpoint along with the organization ID:
This endpoint is accessible to
  • Machine Users
  • Organization Owner
  • Organization User Manager
curl --request GET \
  --url https://dev-iam.razi.ai/v1/authorization/organizations/__ORGID__ \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'X-App-Name: '

​
Query Parameters

1

includeMetadata (optional, boolean, default: false)

A boolean value to return metadata associated with the organization. To get the metadata in response, set this parameter to true.
We will return maximum 30 metadata items in the response. It is expected that no more than 30 metadata items will be stored per organization.
Example: ?includeMetadata=true
2

includeMembers (optional, boolean, default: false)

A boolean value to return organization members associated with the organization, for example Admin, Managers. To get the member details in response, set this parameter to true.Example: ?includeMembers=true
Upon successful request, you will receive a paginated response similar to the below: 
{
  "state": "Active",
  "name": "Example Org",
  "metadata": {
    "total": "20",
    "orgMetadataList": [
      {
        "key": "exampleKey",
        "value": "exampleValue"
      }
    ]
  },
  "members": {
    "orgAdmin": [
      {
        "userId": "1131314",
        "email": "[email protected]",
        "firstName": "Example",
        "lastName": "User",
        "displayName": "Example User"
      }
    ],
    "orgUserManager": [
      {
        "userId": "1131314",
        "email": "[email protected]",
        "firstName": "Example",
        "lastName": "User",
        "displayName": "Example User"
      }
    ]
  }
}
Link to Playground