---
title: "Get all cards"
method: GET
path: "/crm/extensions/cards-dev/2026-03/{appId}"
tags: ["Basic"]
---

# Get all cards

`GET /crm/extensions/cards-dev/2026-03/{appId}`

Returns a list of cards for a given app.

## Path parameters

- `appId` integer, required

## Response `200`

successful operation

- CrmExtensionsCardsDevPublicCardListResponse
  - `results` CrmExtensionsCardsDevPublicCardResponse[], required — A list of card responses
    - `actions` CrmExtensionsCardsDevCardActions, required
      - `baseUrls` string[], required — A list of URL prefixes that will be accepted for card action URLs. If your data fetch response includes an action URL that doesn't begin with one of these values, it will result in an error and the card will not be displayed.
    - `auditHistory` CrmExtensionsCardsDevCardAuditResponse[], required — A list of actions performed on the card, including creation, deletion, and updates.
      - `actionType` 'CREATE' | 'DELETE' | 'UPDATE', required — The type of action performed, with possible values: CREATE, DELETE, UPDATE.
      - `applicationId` integer, required — The ID of the application associated with the card.
      - `authSource` 'APP' | 'EXTERNAL' | 'INTERNAL', required — The source of authentication for the action, with possible values: APP, EXTERNAL, INTERNAL.
      - `changedAt` integer, required — The timestamp indicating when the change occurred.
      - `initiatingUserId` integer, required — The ID of the user who initiated the action.
      - `objectTypeId` integer, required — The ID of the card.
    - `createdAt` string, date-time — The date and time when the card was created.
    - `display` CrmExtensionsCardsDevCardDisplayBody, required
      - `properties` CrmExtensionsCardsDevCardDisplayProperty[], required — Card display properties. These will will be rendered as "label : value" pairs in the card UI. See the [example card](#) in the overview docs for more details.
        - `dataType` 'BOOLEAN' | 'CURRENCY' | 'DATE' | 'DATETIME' | 'EMAIL' | 'LINK' | 'NUMERIC' | 'STATUS' | 'STRING', required — Type of data represented by this property.
        - `label` string, required — The label for this property as you'd like it displayed to users.
        - `name` string, required — An internal identifier for this property. This value must be unique TODO.
        - `options` CrmExtensionsCardsDevDisplayOption[], required — An array of available options that can be displayed. Only used in when `dataType` is `STATUS`.
          - `label` string, required — The text that will be displayed to users for this option.
          - `name` string, required — JSON-friendly unique name for option.
          - `type` 'DANGER' | 'DEFAULT' | 'INFO' | 'SUCCESS' | 'WARNING', required — The type of status.
    - `fetch` CrmExtensionsCardsDevPublicCardFetchBody, required
      - `objectTypes` CrmExtensionsCardsDevCardObjectTypeBody[], required — An array of CRM object types where this card should be displayed. HubSpot will call your target URL whenever a user visits a record page of the types defined here.
        - `name` 'companies' | 'contacts' | 'deals' | 'marketing_events' | 'tickets', required — A CRM object type where this card should be displayed.
        - `propertiesToSend` string[], required — An array of properties that should be sent to this card's target URL when the data fetch request is made. Must be valid properties for the corresponding CRM object type.
      - `targetUrl` string, required — URL to a service endpoint that will respond with details for this card. HubSpot will call this endpoint each time a user visits a CRM record page where this card should be displayed.
    - `id` string, required — The unique id of the card.
    - `title` string, required — The top-level title for this card. Displayed to users in the CRM UI.
    - `updatedAt` string, date-time — The date and time when the card was last updated.

## Other responses

- `default` — An error occurred.

---

[API](https://skmtc.net/hubspot/apis/hubspot-api-specification.md) · [All operations](https://skmtc.net/hubspot/apis/hubspot-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hubspot/hubspot-api-specification/versions/f9c7181056c5/schema)