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.

GET
/v1/users/{userId}/enrollments

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.

Authorization

ApiKeyAuth
headerx-api-key<token>

Path Parameters

userId*string

Human-user UUID

Query Parameters

maxResults?integer

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

Formatint32
Default50
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

Enrollment page returned

application/json
  1. response

One stable page of a human user's enrollment history.

enrollments*array<>

OUTPUT_ONLY; enrollments ordered newest first.

nextToken?|

OUTPUT_ONLY; opaque continuation token, absent after the final page.

Example Request
curl -X GET 'https://your-goodmem-server.example.com/v1/users/70e025f6-76ca-4cbe-b8fc-7dab8e84590a/enrollments' \  -H 'GoodMem-Timeout-Ms: 30000'
Example Response
{  "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"}