Skip to main content

List Data Products

List assembled data products with cursor-based pagination and status filters (draft, ready, published, archived) to track every dataset in your workspace.

Data products are the final assembled output datasets produced by the Talonic pipeline. Each data product represents a structured, validated, and optionally resolved collection of records ready for downstream consumption. Data products are created from completed runs via the API or the platform UI.

Use this endpoint to list all data products in your workspace. Results are returned in reverse chronological order by default and support cursor-based pagination. You can filter by status (draft, ready, published, or archived) for lifecycle management.

GET/v1/data-products

Query parameters

statusstringFilter by product status: draft, ready, published, or archived.
limitintegerMaximum number of items to return (1-100). Default: 20
cursorstringOpaque pagination cursor from a previous response.
orderstringSort order by creation date (asc | desc). Default: desc

Response

Response fields

dataarrayArray of data product objects.
data[].idstringData product UUID.
data[].namestringHuman-readable product name.
data[].descriptionstring | nullOptional description of the data product.
data[].schema_idstringUUID of the user schema that defines the output columns.
data[].run_idstringUUID of the source job run that produced the data.
data[].statusstringProduct status: draft, ready, published, or archived.
data[].created_atstringISO 8601 creation timestamp.
data[].updated_atstringISO 8601 last update timestamp.
pagination.has_morebooleanWhether more pages exist beyond this one.
pagination.next_cursorstring | nullCursor for the next page, or null if no more results.

curl

Response

{
  "data": [
    {
      "id": "d1a2b3c4-e5f6-7890-abcd-ef1234567890",
      "name": "Q4 Invoice Extract",
      "description": "Structured invoice data from Q4 batch",
      "schema_id": "s1a2b3c4-e5f6-7890-abcd-ef1234567890",
      "run_id": "r1a2b3c4-e5f6-7890-abcd-ef1234567890",
      "status": "published",
      "created_at": "2024-11-01T14:20:00.000Z",
      "updated_at": "2024-11-01T14:25:30.000Z"
    }
  ],
  "pagination": {
    "has_more": false,
    "next_cursor": null
  }
}

Errors

Error responses

401unauthorizedMissing or invalid API key.
429rate_limitedToo many requests. Retry after the period indicated in the Retry-After header.