# Retrieve the list of timeflows.

Endpoint: GET /timeflows
Version: 3.21.0
Security: ApiKeyAuth

## Security:

  - `ApiKeyAuth` (unknown)
    apiKey in header Authorization

## Query parameters:

  - `limit` (integer)
    Maximum number of objects to return per query. The value must be between 1 and 1000. Default is 100.

  - `cursor` (string)
    Cursor to fetch the next or previous page of results. The value of this property must be extracted from the 'prev_cursor' or 'next_cursor' property of a PaginatedResponseMetadata which is contained in the response of list and search API endpoints.

  - `sort` (string)
    The field to sort results by. A property name with a prepended '-' signifies descending order.

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `items` (array)

  - `items.id` (string)
    The Timeflow ID.
    Example: timeflow-123

  - `items.engine_id` (string)
    The ID of the engine the timeflow belongs to.
    Example: 1

  - `items.namespace` (string)
    Alternate namespace for this object, for replicated and restored timeflows.
    Example: NAMESPACE-1

  - `items.namespace_id` (string)
    The namespace id of this timeflows.
    Example: 1-NAMESPACE-1

  - `items.namespace_name` (string)
    The namespace name of this timeflows.
    Example: test-engine-1

  - `items.is_replica` (boolean)
    Is this a replicated object.
    Example: true

  - `items.name` (string)
    The timeflow's name.
    Example: DB_PROVISION@2023-01-25T09:00:30

  - `items.dataset_id` (string)
    The ID of the timeflow's dSource or VDB.
    Example: dataset-123

  - `items.creation_type` (string)
    The source action that created the timeflow.
    Enum: "INITIAL", "INDETERMINATE", "REFRESH", "ROLLBACK", "TEMPORARY", "TRANSFORMATION", "V2P", "PDB_PLUG", "ORACLE_LIVE_SOURCE_RESYNC", "SOURCE_CONTINUITY"

  - `items.parent_snapshot_id` (string)
    The ID of the timeflow's parent snapshot.
    Example: snapshot-123

  - `items.parent_point_location` (string)
    The location on the parent timeflow from which this timeflow was provisioned. This will not be present for timeflows derived from linked sources.
    Example: 1178883

  - `items.parent_point_timestamp` (string)
    The timestamp on the parent timeflow from which this timeflow was provisioned. This will not be present for timeflows derived from linked sources.
    Example: 2021-05-01T08:51:34.148Z

  - `items.parent_point_timeflow_id` (string)
    A reference to the parent timeflow from which this timeflow was provisioned. This will not be present for timeflows derived from linked sources.
    Example: timeflow-123

  - `items.parent_vdb_id` (string)
    The ID of the parent VDB. This is mutually exclusive with parent_dsource_id.
    Example: dataset-123

  - `items.parent_dsource_id` (string)
    The ID of the parent dSource. This is mutually exclusive with parent_vdb_id.
    Example: dataset-123

  - `items.source_vdb_id` (string)
    The ID of the source VDB. This is mutually exclusive with source_dsource_id.
    Example: dataset-123

  - `items.source_dsource_id` (string)
    The ID of the source dSource. This is mutually exclusive with source_vdb_id.
    Example: dataset-123

  - `items.source_data_timestamp` (string)
    The timestamp on the root ancestor timeflow from which this timeflow originated. This logical time acts as reference to the origin source data.
    Example: 2021-05-01T08:51:34.148Z

  - `items.oracle_incarnation_id` (string)
    Oracle-specific incarnation identifier for this timeflow.
    Example: 123

  - `items.oracle_cdb_timeflow_id` (string)
    A reference to the mirror CDB timeflow if this is a timeflow for a PDB.
    Example: cdb-123

  - `items.oracle_tde_uuid` (string)
    The unique identifier for timeflow-specific TDE objects that reside outside of Delphix storage.
    Example: tde-indentifier

  - `items.mssql_database_guid` (string)
    MSSQL-specific recovery branch identifier for this timeflow.
    Example: DATABASE-1

  - `items.is_active` (boolean)
    Whether this timeflow is currently active or not.
    Example: false

  - `items.creation_timestamp` (string)
    The time when the timeflow was created.
    Example: 2021-05-01T08:51:34.000Z

  - `items.activation_timestamp` (string)
    The time when this timeflow became active.
    Example: 2021-05-01T08:51:34.000Z

  - `items.tags` (array)

  - `items.tags.key` (string, required)
    Key of the tag
    Example: key-1

  - `items.tags.value` (string, required)
    Value of the tag
    Example: value-1

  - `response_metadata` (object)

  - `response_metadata.prev_cursor` (string)
    Pointer to the previous page of results. Use this value as a cursor query parameter in a subsequent request, along with limit, to navigate through the collection by virtual page.

  - `response_metadata.next_cursor` (string)
    Pointer to the next page of results. Use this value as a cursor query parameter in a subsequent request, along with limit, to navigate through the collection by virtual page.

  - `response_metadata.total` (integer)
    The total number of results. This value may not be provided.

