GoodMemGoodMem
ReferenceAPIREST APIUsers

List a human user's enrollments

GET /v1/users/{userId}/enrollments: Returns one newest-first page containing pending, expired, consumed, and revoked enrollment metadata.

Returns one newest-first page containing pending, expired, consumed, and revoked enrollment metadata. MANAGE_USER_ENROLLMENT with ANY or EXACT authority on the target user is required. The page never contains raw credentials.

GET
/v1/users/{userId}/enrollments
x-api-key<token>

In: header

Path Parameters

userIdstring

Human-user UUID

Query Parameters

maxResults?integer

Page size; defaults to 50 and must be between 1 and 1000

Default50
Formatint32
nextToken?string

Opaque continuation token

Header Parameters

GoodMem-Timeout-Ms?integer

Optional waiting budget in milliseconds, measured from REST servlet ingress and shared across all internal gRPC calls. Supply one decimal integer from 1 to 86400000. Omission adds no deadline. Existing shorter deadlines still apply. Expiry returns HTTP 504 before streaming starts; after streaming starts, no successful completion event is sent. Use SSE or opt into GoodMem-Stream-Terminal for an explicit terminal outcome. Retrieval work is cooperatively cancelled. An accepted mutation may still commit after timeout or disconnect; a failed response does not imply rollback.

Formatint64
Range1 <= value <= 86400000

Response Body

curl -X GET "https://your-goodmem-server.example.com/v1/users/70e025f6-76ca-4cbe-b8fc-7dab8e84590a/enrollments?maxResults=50&nextToken=string" \  -H "GoodMem-Timeout-Ms: 30000"
{
  "enrollments": [
    {
      "enrollmentId": "0198b9f4-c42f-7ae3-8c56-44d827ea03bd",
      "userId": "70e025f6-76ca-4cbe-b8fc-7dab8e84590a",
      "credentialPrefix": "gme_mzxw6y",
      "status": "PENDING",
      "expiresAt": 1786752000000,
      "consumedApiKeyId": "550e8400-e29b-41d4-a716-446655440000",
      "createdAt": 1786665600000,
      "consumedAt": 1786669200000,
      "revokedAt": 1786669200000,
      "createdById": "b3303d0a-1a4a-493f-b9bf-38e37153b5a2",
      "revokedById": "b3303d0a-1a4a-493f-b9bf-38e37153b5a2"
    }
  ],
  "nextToken": "string"
}
Empty
Empty
Empty
Empty
Empty
Empty
Empty
Empty