Search project cards

curl --request GET \
  --url https://davinci-app.com/api/v2/projects/{projectId}/cards \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://davinci-app.com/api/v2/projects/{projectId}/cards', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://davinci-app.com/api/v2/projects/{projectId}/cards', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "cards": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "description": "<string>",
      "resolution": "<string>",
      "created_by_user": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "deadline": "2023-11-07T05:31:56Z",
      "is_open": true,
      "project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "effort": 1,
      "tag_ids": [
        "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      ],
      "user_ids": [
        "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      ],
      "team_ids": [
        "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      ],
      "team_status_ids": [
        "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      ],
      "sprint_ids": [
        "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      ],
      "team_statuses": [
        {
          "team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "status_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "status_name": "<string>",
          "status_color": "<string>",
          "sprint_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        }
      ],
      "team_placements": [
        {
          "team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "status_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "sprint_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        }
      ],
      "history_head_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "history_head_sequence": "<string>",
      "author_display_name": "<string>",
      "closed_at": "2023-11-07T05:31:56Z"
    }
  ],
  "meta": {
    "limit": 2,
    "hasMore": true,
    "state": "open",
    "sort": "<string>",
    "previousCursor": "<string>",
    "nextCursor": "<string>",
    "total": 1,
    "projection": "full",
    "hydrateOpen": true,
    "pageStart": 1,
    "pageEnd": 1
  },
  "filterOptions": {
    "tags": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "color": "<string>"
      }
    ],
    "teams": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>"
      }
    ],
    "assignees": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "display_name": "<string>"
      }
    ],
    "statuses": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "color": "<string>",
        "teamId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "teamName": "<string>"
      }
    ],
    "sprints": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "status": "active",
        "teamId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "teamName": "<string>"
      }
    ]
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  }
}

Cards

Search project cards

Returns a bounded flat card page plus tag, assignee, linked-team, workflow-status, and accessible active/planned sprint filter options. Cards default to open only. Values within one repeated/comma-separated filter are ORed; distinct filter dimensions are ANDed. includeNoTeam extends the team facet with cards having no placement, and includeUnassigned extends the assignee facet with cards having no user links. Deadline and effort bounds are inclusive. Within either range dimension, its include-no-value flag ORs null-valued cards with bounded non-null matches; using only the flag matches only null-valued cards. Range dimensions AND with every other facet. Invalid instants, negative/non-integer effort values, reversed ranges, and cursors issued for different ranges return canonical 400 errors: INVALID_CARD_DEADLINE_FILTER, INVALID_CARD_DEADLINE_RANGE, INVALID_CARD_EFFORT_FILTER, INVALID_CARD_EFFORT_RANGE, or INVALID_CARD_CURSOR. Results use an explicit stable sort and opaque cursor.

GET

api

projects

{projectId}

cards

Search project cards

curl --request GET \
  --url https://davinci-app.com/api/v2/projects/{projectId}/cards \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://davinci-app.com/api/v2/projects/{projectId}/cards', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://davinci-app.com/api/v2/projects/{projectId}/cards', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "cards": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "description": "<string>",
      "resolution": "<string>",
      "created_by_user": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "deadline": "2023-11-07T05:31:56Z",
      "is_open": true,
      "project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "effort": 1,
      "tag_ids": [
        "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      ],
      "user_ids": [
        "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      ],
      "team_ids": [
        "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      ],
      "team_status_ids": [
        "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      ],
      "sprint_ids": [
        "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      ],
      "team_statuses": [
        {
          "team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "status_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "status_name": "<string>",
          "status_color": "<string>",
          "sprint_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        }
      ],
      "team_placements": [
        {
          "team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "status_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "sprint_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        }
      ],
      "history_head_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "history_head_sequence": "<string>",
      "author_display_name": "<string>",
      "closed_at": "2023-11-07T05:31:56Z"
    }
  ],
  "meta": {
    "limit": 2,
    "hasMore": true,
    "state": "open",
    "sort": "<string>",
    "previousCursor": "<string>",
    "nextCursor": "<string>",
    "total": 1,
    "projection": "full",
    "hydrateOpen": true,
    "pageStart": 1,
    "pageEnd": 1
  },
  "filterOptions": {
    "tags": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "color": "<string>"
      }
    ],
    "teams": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>"
      }
    ],
    "assignees": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "display_name": "<string>"
      }
    ],
    "statuses": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "color": "<string>",
        "teamId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "teamName": "<string>"
      }
    ],
    "sprints": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "status": "active",
        "teamId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "teamName": "<string>"
      }
    ]
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  }
}

Authorizations

Authorization

string

header

default:dav_ak_live_your_token

required

Personal access token. The scopes granted at issuance determine both which operations the key may call and the ceiling on the resource permissions it can exercise. Each scope family is a ladder: projects:manage implies projects:write and projects:read; cards:manage implies cards:write and cards:read; and teams:manage implies teams:write and teams:read. These are named API capability bundles, not blanket domain roles: manage exposes only the permissions enumerated for that scope and never bypasses the acting user's current role-based access.

Path Parameters

projectId

string

required

Project id. May be compound in the form {projectId}--{branchName}.

Minimum string length: 1

Query Parameters

string

Case-insensitive substring search across card name, description, and resolution.

Maximum string length: 200

state

enum<string>

default:open

Project-global card lifecycle state.

Available options:

open,

closed,

all

tagIds

string<uuid>[]

Match cards carrying any selected project tag.

Maximum array length: 50

assigneeIds

string<uuid>[]

Match cards assigned to any selected project member.

Maximum array length: 50

includeUnassigned

boolean

default:false

OR cards with no user links into the assignee facet. This is not a sentinel assignee ID.

teamIds

string<uuid>[]

Match cards placed on any selected linked team.

Maximum array length: 50

includeNoTeam

boolean

default:false

OR cards with no team placement into the team facet. This is not a sentinel team ID.

statusIds

string<uuid>[]

Match cards whose selected-team placement uses any selected status.

Maximum array length: 50

sprintIds

string<uuid>[]

Match cards whose team placement uses any selected sprint.

Maximum array length: 50

deadlineFrom

string<date-time>

Inclusive ISO 8601 instant lower bound for non-null card deadlines.

deadlineTo

string<date-time>

Inclusive ISO 8601 instant upper bound for non-null card deadlines.

includeNoDeadline

boolean

default:false

OR cards with a null deadline into bounded deadline matches. With no deadline bounds, match only cards with no deadline.

effortMin

integer

Inclusive lower bound for non-null card effort.

Required range: x >= 0

effortMax

integer

Inclusive upper bound for non-null card effort.

Required range: x >= 0

includeNoEffort

boolean

default:false

OR cards with null effort into bounded effort matches. With no effort bounds, match only cards with no effort.

sort

enum<string>

default:created_desc

Stable card sort; card ID is the deterministic tie-breaker.

Available options:

created_asc,

created_desc,

updated_asc,

updated_desc,

deadline_asc,

deadline_desc,

effort_asc,

effort_desc,

name_asc,

name_desc

limit

integer

default:100

Maximum cards returned.

Required range: 1 <= x <= 500

cursor

string

Opaque cursor returned as meta.nextCursor or meta.previousCursor.

Maximum string length: 2048

Response

Flat project-card search page.

cards

object[]

required

Hide child attributes

cards.id

string<uuid>

required

cards.name

string

required

cards.description

string | null

required

cards.resolution

string | null

required

Optional Markdown resolution; closing or reopening the card does not clear it.

Maximum string length: 10000

cards.created_by_user

string<uuid> | null

required

cards.created_at

string<date-time> | null

required

cards.updated_at

string<date-time> | null

required

cards.deadline

string<date-time> | null

required

cards.is_open

boolean

required

cards.project_id

string<uuid>

required

cards.effort

integer | null

required

Unit-agnostic estimate, commonly interpreted as story points or hours.

Required range: x >= 0

cards.tag_ids

string<uuid>[]

required

cards.user_ids

string<uuid>[]

required

cards.team_ids

string<uuid>[]

required

cards.team_status_ids

string<uuid>[]

required

cards.sprint_ids

string<uuid>[]

required

cards.team_statuses

object[]

required

Deterministically ordered placed-team status metadata.

Hide child attributes

cards.team_statuses.team_id

string<uuid>

required

cards.team_statuses.status_id

string<uuid>

required

cards.team_statuses.status_name

string | null

required

cards.team_statuses.status_color

string | null

required

cards.team_statuses.sprint_id

string<uuid> | null

required

cards.team_placements

object[]

required

Deterministically ordered team placement filter metadata.

Hide child attributes

cards.team_placements.team_id

string<uuid>

required

cards.team_placements.status_id

string<uuid> | null

required

cards.team_placements.sprint_id

string<uuid> | null

required

cards.history_head_id

string<uuid> | null

required

Latest committed card-history row ID; null only before a card has history.

cards.history_head_sequence

string | null

required

Globally monotonic card-history sequence.

Pattern: ^\d+$

cards.author_display_name

string | null

Display name of the user who created the card, when available.

cards.closed_at

string<date-time> | null

read-only

Timestamp of the latest transition to the closed state; null while open.

Getting Started

Davinci Browser

Davinci Editor

Integrations

Modeling Guide

Developer API

Examples

Release Notes

Search project cards

Authorizations

Path Parameters

Query Parameters

Response