This endpoint returns AI Cards published or received by your tenant, so you can track their status alongside the AI Systems they document.

List AI Cards

Returns a paginated list of AI Cards in your tenant.

Request:

GET /api/public/aicards

Authentication:

Bearer token. See Authentication & Generating Credentials.

Required Permission

Api_AiCards_Read

Query Parameters

Parameter	Type	Value
`limit`	integer	Results per page. Maximum 200.
`cursor`	string	Sync cursor. Omit on the first call to begin from the beginning. Pass `nextCursor` from the previous response on subsequent calls.
`updatedAfter`	ISO 8601 timestamp	Return only records updated at or after this timestamp. Use to recover a lost cursor or reset to a known point in time.

Response Fields

Field	Type	Rules
`aiCardId`	GUID	Unique identifier for the AI Card.
`name`	string	Card name.
`status`	string	Publication lifecycle: `Draft` or `Published`.
`validationStatus`	string	Outcome of Cranium’s content validation: `Pending` or `Validated`. Independent of `status`; check both if you are gating on card readiness.
`aiSystemId`	GUID	The AI System this card belongs to. Matches `aiSystemId` on `GET /api/public/aisystems`.
`aiSystemName`	string or null	Name of the associated AI System, denormalized for convenience.
`createdAt`	ISO 8601 timestamp	When the card was created.
`updatedAt`	ISO 8601 timestamp	When the card was last modified. `null` if it has never been modified since creation; treat `updatedAt ?? createdAt` as the effective last-changed time.

Sample Response

json

{
  "data": [
    {
      "aiCardId": "c4f12a8b-6d3e-4f5a-9b7c-1d2e3f4a5b6c",
      "name": "Fraud Detection Platform - AI Card",
      "status": "Published",
      "validationStatus": "Validated",
      "aiSystemId": "a2d78b6f-9c4c-4a7d-d16f-4e1d8c9b0f20",
      "aiSystemName": "Fraud Detection Platform",
      "createdAt": "2026-01-10T08:00:00Z",
      "updatedAt": "2026-06-01T20:11:09Z"
    },
    {
      "aiCardId": "d5a23b9c-7e4f-4a6b-ac8d-2e3f4a5b6c7d",
      "name": "Customer Support Assistant - AI Card",
      "status": "Draft",
      "validationStatus": "Pending",
      "aiSystemId": "b3e89c7a-0d5d-4b8e-e27a-5f2e9d0a1f31",
      "aiSystemName": "Customer Support Assistant",
      "createdAt": "2026-05-20T12:14:00Z",
      "updatedAt": null
    }
  ],
  "pagination": {
    "limit": 100,
    "nextCursor": "eyJ1cGRhdGVkQXQiOiIyMDI2LTA1LTIwVDEyOjE0OjAwWiIsImlkIjoiZDVhMjNiOWMifQ==",
    "hasMore": false
  },
  "error": null,
  "meta": {
    "requestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "timestamp": "2026-08-13T10:45:00Z"
  }
}

The card body is not exposed by this endpoint. It returns identity and status metadata only; there is no field carrying the card's questionnaire answers or attachments. hasMore: false with a non-null nextCursor is the normal end-of-feed state. Store the cursor and replay it on your next poll to pick up changes incrementally.

Error Responses

400 VALIDATION_FAILED: the cursor is invalid, or cursor and updatedAfter were supplied together.
401 UNAUTHORIZED: the request is missing a token, or the token lacks Api_AiCards_Read.
500 INTERNAL_ERROR: an unexpected server error.

Did this answer your question?