Directory API: Memberships

Retrieves one specific membership

get

Authorizations

BearerCookie

BearerstringRequired

Path parameters

membershipstring · uuidRequired

Responses

200

OK

application/jsontext/json

get

/api/directory/memberships/{membership}

HTTPcURLJavaScriptPython

GET /v2/e01/api/directory/memberships/{membership} HTTP/1.1
Host: 
Bearer: YOUR_API_KEY
Accept: */*

200

OK

{
  "groupIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "membershipIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "modifiedBy": "123e4567-e89b-12d3-a456-426614174000",
  "organizationIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "userIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "membershipFunction": "text",
  "membershipEffective": "2026-01-22T18:25:04.295Z",
  "membershipExpiry": "2026-01-22T18:25:04.295Z",
  "modified": "2026-01-22T18:25:04.295Z"
}

Checks for the existence of one specific membership

head

Authorizations

BearerCookie

BearerstringRequired

Path parameters

membershipstring · uuidRequired

Responses

200

OK

application/jsontext/json

Responseboolean

head

/api/directory/memberships/{membership}

HTTPcURLJavaScriptPython

HEAD /v2/e01/api/directory/memberships/{membership} HTTP/1.1
Host: 
Bearer: YOUR_API_KEY
Accept: */*

200

OK

true

Collects the list of memberships that match specific criteria

post

Authorizations

BearerCookie

BearerstringRequired

Body

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

identifierstring · uuid | nullableOptional

groupIdentifierstring · uuid | nullableOptional

modifiedBystring · uuid | nullableOptional

organizationIdentifierstring · uuid | nullableOptional

userIdentifierstring · uuid | nullableOptional

accountScopestring | nullableOptional

membershipFunctionstring | nullableOptional

membershipEffectivestring · date-time | nullableOptional

membershipExpirystring · date-time | nullableOptional

modifiedstring · date-time | nullableOptional

Responses

200

OK

application/jsontext/json

post

/api/directory/memberships/collect

HTTPcURLJavaScriptPython

POST /v2/e01/api/directory/memberships/collect HTTP/1.1
Host: 
Bearer: YOUR_API_KEY
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 852

{
  "identifier": "123e4567-e89b-12d3-a456-426614174000",
  "origin": {
    "when": "2026-01-22T18:25:04.295Z",
    "organization": "123e4567-e89b-12d3-a456-426614174000",
    "user": "123e4567-e89b-12d3-a456-426614174000",
    "proxy": "123e4567-e89b-12d3-a456-426614174000",
    "description": "text",
    "reason": "text",
    "source": "text"
  },
  "filter": {
    "page": 1,
    "pageSize": 1,
    "sort": "text",
    "excludes": "text",
    "includes": "text",
    "format": "text"
  },
  "texts": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "groupIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "modifiedBy": "123e4567-e89b-12d3-a456-426614174000",
  "organizationIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "userIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "accountScope": "text",
  "membershipFunction": "text",
  "membershipEffective": "2026-01-22T18:25:04.295Z",
  "membershipExpiry": "2026-01-22T18:25:04.295Z",
  "modified": "2026-01-22T18:25:04.295Z"
}

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

200

OK

[
  {
    "groupIdentifier": "123e4567-e89b-12d3-a456-426614174000",
    "membershipIdentifier": "123e4567-e89b-12d3-a456-426614174000",
    "modifiedBy": "123e4567-e89b-12d3-a456-426614174000",
    "organizationIdentifier": "123e4567-e89b-12d3-a456-426614174000",
    "userIdentifier": "123e4567-e89b-12d3-a456-426614174000",
    "membershipFunction": "text",
    "membershipEffective": "2026-01-22T18:25:04.295Z",
    "membershipExpiry": "2026-01-22T18:25:04.295Z",
    "modified": "2026-01-22T18:25:04.295Z"
  }
]

Counts the memberships that match specific criteria

post

Authorizations

BearerCookie

BearerstringRequired

Body

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

identifierstring · uuid | nullableOptional

groupIdentifierstring · uuid | nullableOptional

modifiedBystring · uuid | nullableOptional

organizationIdentifierstring · uuid | nullableOptional

userIdentifierstring · uuid | nullableOptional

accountScopestring | nullableOptional

membershipFunctionstring | nullableOptional

membershipEffectivestring · date-time | nullableOptional

membershipExpirystring · date-time | nullableOptional

modifiedstring · date-time | nullableOptional

Responses

200

OK

application/jsontext/json

post

/api/directory/memberships/count

HTTPcURLJavaScriptPython

POST /v2/e01/api/directory/memberships/count HTTP/1.1
Host: 
Bearer: YOUR_API_KEY
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 852

{
  "identifier": "123e4567-e89b-12d3-a456-426614174000",
  "origin": {
    "when": "2026-01-22T18:25:04.295Z",
    "organization": "123e4567-e89b-12d3-a456-426614174000",
    "user": "123e4567-e89b-12d3-a456-426614174000",
    "proxy": "123e4567-e89b-12d3-a456-426614174000",
    "description": "text",
    "reason": "text",
    "source": "text"
  },
  "filter": {
    "page": 1,
    "pageSize": 1,
    "sort": "text",
    "excludes": "text",
    "includes": "text",
    "format": "text"
  },
  "texts": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "groupIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "modifiedBy": "123e4567-e89b-12d3-a456-426614174000",
  "organizationIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "userIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "accountScope": "text",
  "membershipFunction": "text",
  "membershipEffective": "2026-01-22T18:25:04.295Z",
  "membershipExpiry": "2026-01-22T18:25:04.295Z",
  "modified": "2026-01-22T18:25:04.295Z"
}

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

200

OK

{
  "count": 1,
  "summary": "text"
}

Downloads the list of memberships that match specific criteria

post

Authorizations

BearerCookie

BearerstringRequired

Body

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

identifierstring · uuid | nullableOptional

groupIdentifierstring · uuid | nullableOptional

modifiedBystring · uuid | nullableOptional

organizationIdentifierstring · uuid | nullableOptional

userIdentifierstring · uuid | nullableOptional

accountScopestring | nullableOptional

membershipFunctionstring | nullableOptional

membershipEffectivestring · date-time | nullableOptional

membershipExpirystring · date-time | nullableOptional

modifiedstring · date-time | nullableOptional

Responses

200

OK

No content

post

/api/directory/memberships/download

HTTPcURLJavaScriptPython

POST /v2/e01/api/directory/memberships/download HTTP/1.1
Host: 
Bearer: YOUR_API_KEY
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 852

{
  "identifier": "123e4567-e89b-12d3-a456-426614174000",
  "origin": {
    "when": "2026-01-22T18:25:04.295Z",
    "organization": "123e4567-e89b-12d3-a456-426614174000",
    "user": "123e4567-e89b-12d3-a456-426614174000",
    "proxy": "123e4567-e89b-12d3-a456-426614174000",
    "description": "text",
    "reason": "text",
    "source": "text"
  },
  "filter": {
    "page": 1,
    "pageSize": 1,
    "sort": "text",
    "excludes": "text",
    "includes": "text",
    "format": "text"
  },
  "texts": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "groupIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "modifiedBy": "123e4567-e89b-12d3-a456-426614174000",
  "organizationIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "userIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "accountScope": "text",
  "membershipFunction": "text",
  "membershipEffective": "2026-01-22T18:25:04.295Z",
  "membershipExpiry": "2026-01-22T18:25:04.295Z",
  "modified": "2026-01-22T18:25:04.295Z"
}

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

200

OK

No content

Searches for the list of memberships that match specific criteria

post

Authorizations

BearerCookie

BearerstringRequired

Body

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

identifierstring · uuid | nullableOptional

groupIdentifierstring · uuid | nullableOptional

modifiedBystring · uuid | nullableOptional

organizationIdentifierstring · uuid | nullableOptional

userIdentifierstring · uuid | nullableOptional

accountScopestring | nullableOptional

membershipFunctionstring | nullableOptional

membershipEffectivestring · date-time | nullableOptional

membershipExpirystring · date-time | nullableOptional

modifiedstring · date-time | nullableOptional

Responses

200

OK

application/jsontext/json

post

/api/directory/memberships/search

HTTPcURLJavaScriptPython

POST /v2/e01/api/directory/memberships/search HTTP/1.1
Host: 
Bearer: YOUR_API_KEY
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 852

{
  "identifier": "123e4567-e89b-12d3-a456-426614174000",
  "origin": {
    "when": "2026-01-22T18:25:04.295Z",
    "organization": "123e4567-e89b-12d3-a456-426614174000",
    "user": "123e4567-e89b-12d3-a456-426614174000",
    "proxy": "123e4567-e89b-12d3-a456-426614174000",
    "description": "text",
    "reason": "text",
    "source": "text"
  },
  "filter": {
    "page": 1,
    "pageSize": 1,
    "sort": "text",
    "excludes": "text",
    "includes": "text",
    "format": "text"
  },
  "texts": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "groupIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "modifiedBy": "123e4567-e89b-12d3-a456-426614174000",
  "organizationIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "userIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "accountScope": "text",
  "membershipFunction": "text",
  "membershipEffective": "2026-01-22T18:25:04.295Z",
  "membershipExpiry": "2026-01-22T18:25:04.295Z",
  "modified": "2026-01-22T18:25:04.295Z"
}

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

200

OK

[
  {
    "membershipIdentifier": "123e4567-e89b-12d3-a456-426614174000"
  }
]