Tasks

List tasks linked to an entity

List the tasks of any project linked to a Factuarea entity (entity_type + entity_id); archived tasks are included and flagged.

  • An entity that does not exist or belongs to another company returns an empty list.
  • Cursor-paginated: pass next_cursor as starting_after; has_more tells if there are more.
get/companies/{company}/tasks/linked

Request

  • Base URL: https://api.factuarea.com/v1
  • URL: https://api.factuarea.com/v1/companies/{company}/tasks/linked
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Path parameters

companystring uuid required

Public identifier (UUID v7) of the company. Get it from GET /v1/me (data.scope[].id).

Query parameters

entity_type'invoice' | 'quote' | 'proforma' | 'delivery_note' | 'purchase_invoice' | 'recurring_invoice' | 'contact' | 'product' | 'employee' required

Type of the Factuarea entity the tasks are linked to: invoice, quote, proforma, delivery_note, purchase_invoice, recurring_invoice, contact, product or employee.

entity_idstring uuid required

UUID of the entity. An entity that does not exist or belongs to another company returns an empty list, never an error.

limitinteger

Number of tasks to return. Integer between 1 and 100. Defaults to 25.

starting_afterstring uuid

Cursor for forward pagination: the id of the last task of the previous page (the next_cursor you received). An id that is not in this list returns 422 invalid_param_value.

Headers

Factuarea-Versionstring date
Example:2026-06-01

Pin the API version (YYYY-MM-DD, Stripe-style date versioning) for this request; omit to use the key's pinned version, or the latest if none. Unsupported version → 400 unsupported_api_version; malformed → 400 parameter_invalid_format. The effective version is echoed in the Factuarea-Version response header. See the Versioning guide.

Response

has_moreboolean required

true when there are more objects after this page.

next_cursorstring nullable required

Value to pass as starting_after to get the next page (the id of the last object), or null when has_more is false.

Example response

{
  "data": [
    {
      "id": "0193a4f2-8f53-7d44-8e85-7a9b1c3d5f12",
      "object": "task",
      "key": "DEV-12",
      "title": "Integrar la pasarela de pago en el checkout",
      "status": "active",
      "column_id": "0193a4f2-7d31-7b22-8c63-5e7f9a1b3d02",
      "project_id": "0193a4f2-7c20-7a11-8b52-4d6e8f0a2c01",
      "assignee_id": "0193a4f2-6b1c-7d3e-8a41-2c5e7f9a1b01",
      "due_on": "2026-10-06",
      "link_id": "0193a4f2-dea8-7c99-8d3a-2f4a6b8c0e01"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.