account | DynamicAccount | Yes | - | Select the X Ads account whose cards should be listed. |
card_types | array of string or SelectableOption | No | - | Scope to specific card types: IMAGE_WEBSITE, VIDEO_WEBSITE, IMAGE_APP, VIDEO_APP, the CAROUSEL variants, and the MIXED_MEDIA variants. |
card_ids | string or array of string | No | - | Scope to specific card IDs (list or comma-separated string, up to 200). |
card_uris | string or array of string | No | - | Scope to specific card URIs (list or comma-separated string, up to 200). |
q | string | No | - | Scope cards by name (case-insensitive prefix match, up to 80 characters). |
sort_by | string | No | - | Sort by a supported attribute, e.g. ‘created_at-desc’ or ‘updated_at-asc’. |
include_legacy_cards | boolean | No | False | Include legacy website and app cards created via the old per-type endpoints. |
with_deleted | boolean | No | False | Include deleted cards. |
filters | array of FilterItem | No | - | Additional filters applied to the returned cards. The available fields to filter by are: - id: Filter by card ID - name: Filter by card name - card_type: Filter by card type Filters are combined using AND logic. If you want to use OR logic, use relevant operators like REGEXP_MATCH or IN_LIST. |
limit | integer | No | 100 | Maximum number of cards to return. Default: 100. |
