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

Response Fields

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.