Retrieve card list
GET
https://example.flowfast.io/api/latest/cardsGet Card list filtered by query parameters. The result of the request is displayed page by page (see details in the constraints of the parameters).
⚠️ Starting late August, /api/column and column schemas will only use card_hide_after_days. The months_to_hide_cards attribute is deprecated and will be removed — update your code to use card_hide_after_days only.
| Name | Value |
|---|---|
| Content-Type | application/json |
| Name | Type | Constraints | Description |
|---|---|---|---|
| created_before | string | Created before search filter (format: ISO 8601) | |
| created_after | string | Created after search filter (format: ISO 8601) | |
| updated_before | string | Updated before search filter (format: ISO 8601) | |
| updated_after | string | Updated after search filter (format: ISO 8601) | |
| first_moved_in_progress_after | string | First moved in progress after date search filter (format: ISO 8601) | |
| first_moved_in_progress_before | string | First moved in progress before date search filter (format: ISO 8601) | |
| last_moved_to_done_at_after | string | Last time moved to done column after date search filter (format: ISO 8601) | |
| last_moved_to_done_at_before | string | Last time moved to done column before date search filter (format: ISO 8601) | |
| due_date_after | string | Due date is set to date after search filter (format: ISO 8601) | |
| due_date_before | string | Due date is set to date before search filter (format: ISO 8601) | |
| query | string | Card contains text search filter | |
| tag | string | Tag search filter | |
| tag_ids | string | Search by tag ids filter, comma separated | |
| type_ids | string | Search by type ids filter, comma separated | |
| exclude_board_ids | string | Exclude board ids filter, comma separated | |
| exclude_lane_ids | string | Exclude lane ids filter, comma separated | |
| exclude_column_ids | string | Exclude columns ids filter, comma separated | |
| column_ids | string | Search by column ids filter, comma separated | |
| member_ids | string | Search by member ids filter, comma separated | |
| owner_ids | string | Search by owner ids filter, comma separated | |
| responsible_ids | string | Search by responsible ids filter, comma separated | |
| states | string | Search by states filter, comma separated. 1-queued, 2-inProgress, 3-done | |
| external_id | string | Search by external id filter | |
| additional_card_fields | string | Get additional card fields, comma separated. Possible list of fields: 'description' | |
| search_fields | string | Fields to search by | |
| space_id | integer | Filter by space id | |
| limit | integer | Default: 100 Max: 100 | Maximum amount of cards in response |
| offset | integer | Number of records to skip | |
| order_space_id | integer | Order by space id | |
| board_id | integer | Filter by board id | |
| column_id | integer | Filter by column id | |
| lane_id | integer | Filter by lane id | |
| condition | integer | Filter by condition: 1 - on board, 2 - archived | |
| type_id | integer | Filter by type id | |
| responsible_id | integer | Filter by responsible id | |
| owner_id | integer | Filter by owner id | |
| archived | boolean | Archived flag | |
| asap | boolean | ASAP marker | |
| overdue | boolean | Filter by completed on time | |
| done_on_time | boolean | Filter by done on time | |
| with_due_date | boolean | Filter by due date is set | |
| filterBETA | string | Filter by and/or conditions encoded in the base64 format Schema example: | |
| order_by | string | Fields by which sorting is performed. Сomma separated | |
| order_direction | string | Sorting direction "asc" or "desc". Сomma separated. The sequence corresponds to the sequence of fields of the parameter "order_by" | |
| is_request | boolean | Search requests | |
| exclude_owner_ids | string | Exclude owner ids filter, comma separated | |
| exclude_card_ids | string | Exclude card ids filter, comma separated | |
| organizations_ids | string | Search by organizations filter, comma separated | |
| broken_api | boolean | Backward compatibility flag for user-type custom properties. true (default until 2026-04-01): returns user UID strings. false: returns user integer IDs. Recommended: use broken_api=false for new integrations. |
Responses
| Description | Response type | Example |
|---|---|---|
| Success | Array of objects |
| Name | Type | Description |
|---|---|---|
| updated | string | Last update timestamp |
| created | string | Create date |
| archived | boolean | Card archived flag |
| id | integer | Card id |
| title | string | Card title |
| description | null | string | Card description. Present only if query parameter 'additional_card_fields' in the request contains 'description' field option |
| asap | boolean | Card asap flag |
| due_date | null | string | Card deadline |
| sort_order | number | Position |
| fifo_order | integer | Number of card in the cell when fifo rule applied to cards column |
| state | enum | 1-queued, 2-inProgresss, 3-done |
| condition | enum | 1 - live, 2 - archived |
| expires_later | boolean | Fixed deadline or not. Date dependant flag in terms of Kanban |
| parents_count | integer | Card parents count |
| children_count | integer | Card children count |
| children_done | integer | Card children done count |
| has_blocked_children | boolean | Flag indicating that card has blocked children |
| goals_total | integer | Card goals count |
| goals_done | integer | Number of card done goals |
| time_spent_sum | integer | Amount of time spent(in minutes) |
| time_blocked_sum | integer | Amount of blocked time(in minutes) |
| children_number_properties_sum | null | object | Sum according to numerical data of child cards |
| calculated_planned_start | null | string | Calculated planned start |
| calculated_planned_end | null | string | Calculated planned end |
| parent_checklist_ids | null | array | Array of card parent checklist ids |
| parents_ids | null | array | Array of card parent ids |
| children_ids | null | array | Array of card children ids |
| blocking_card | boolean | Is card blocking another card |
| blocked | boolean | Is card blocked |
| size | null | number | Numerical part of size |
| size_unit | null | string | Text part of size |
| size_text | null | string | Size. Example of acceptable values: '1', '23.45', '.5', 'S', '3 M', 'L', 'XL', etc... |
| due_date_time_present | boolean | Flag indicating that deadline is specified up to hours and minutes |
| board_id | integer | Board id |
| column_id | integer | Column id |
| lane_id | integer | Lane id |
| owner_id | integer | Card owner id |
| type_id | integer | Card type id |
| version | integer | Card version |
| updater_id | integer | User id who last updated card |
| completed_on_time | null | boolean | Flag indicating that card completed on time when due date present |
| completed_at | null | string | Date when card moved to done type column |
| last_moved_at | null | string | Date when card last moved |
| lane_changed_at | null | string | Date when card changed lane |
| column_changed_at | null | string | Date when card changed column |
| first_moved_to_in_progress_at | null | string | Date when card first moved to inProgress type column |
| last_moved_to_done_at | null | string | Date when card last moved to done type column |
| sprint_id | integer | Sprint id |
| external_id | null | string | External id |
| service_id | integer | Service id |
| comments_total | integer | Total card comments |
| comment_last_added_at | null | string | Date when last comment added |
| properties | null | object | Card custom properties. Format: id_{propertyId}:value |
| planned_start | null | string | Card timeline planned start |
| planned_end | null | string | Card timeline planned end |
| counters_recalculated_at | string | Date of recalculating counters |
| sd_new_comment | boolean | Has unseen service desk request author comments |
| public | boolean | Is card public |
| share_settings | null | object | Public share settings |
| share_id | null | string | Public share id |
| external_user_emails | null | string | External users emails |
| description_filled | boolean | Flag indicating that card has description |
| estimate_workload | number | Estimate_workload |
| owner | object | Card owner info |
| type | object | Card type info |
| board | object | Card board info |
| members | array | Card members |
| column | object | Card column |
| lane | object | Card lane info |
| children | array of objects | Card childrens |
| parents | array | Card parents |
| path_data | object | Card path info (space, board, column, lane, etc) |
| source | enum | null | app, api, email, telegram, slack, webhook, import, schedule, automation |
| Description | Response type | Example |
|---|---|---|
| Invalid token | String |
A schema has not been defined for this response code.
| Description | Response type | Example |
|---|---|---|
| Forbidden | Response body does not exist |
A schema has not been defined for this response code.
FlowFast
If you have any questions or need help with integration feel free to write us at support@flowfast.io
1 curl --request GET \
2 --url 'https://example.flowfast.io/api/latest/cards' \
3 --header 'Accept: application/json' \
4 --header 'Content-Type: application/json'
5 Response
ClickTry It!to start a request and see the response here!