Get selected fields for a batch of cards (cross-board)

GET

/cards/info/batch

const url = 'https://projects.work.optidata.cloud/api/cards/info/batch?ids%5B%5D=1';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://projects.work.optidata.cloud/api/cards/info/batch?ids%5B%5D=1' \
  --header 'Authorization: Bearer <token>'

Returns lightweight info for cards by id across all boards the caller is a member of (inaccessible ids are silently omitted). By default returns id, title and number; use options[fields][] to choose fields and options[with][] to embed the parent board ({id, name, icon}) or column ({id, name}).

Authorizations

bearerAuth

Parameters

Query Parameters

ids[]

required

Array<integer>

Card ids to fetch.

options[fields][]

Array<string>

Allowed values: title number column_id status due_date archived_at completed_at

Fields to include (id is always included).

options[with][]

Array<string>

Allowed values: board column

Relations to embed.

Responses

200

Requested cards (accessible ones only).

application/json

object

cards

Array<object>

Partial card — contains id plus the requested fields/relations.

object

Example

{
  "cards": [
    {
      "id": 9001,
      "title": "Draft homepage copy",
      "number": 1,
      "board_id": 42,
      "board": {
        "id": 42,
        "name": "Website Redesign",
        "icon": "🎨"
      }
    }
  ]
}

401

Missing, invalid or expired bearer passport.

application/json

object

error

string

Example

{
  "error": "JWT passport exception: Missing bearer token in request"
}

403

The authenticated user lacks the required board permission.

application/json

object

message

string

Example

{
  "message": "This action is unauthorized."
}

422

Validation failed.

application/json

object

message

First validation error message.

string

errors

Map of field name → list of error messages.

object

key

additional properties

Array<string>

Example

{
  "message": "The name field is required.",
  "errors": {
    "name": [
      "The name field is required."
    ]
  }
}