# Retrieve the list of synthetic data application

Endpoint: GET /synthetic/applications
Version: 3.30.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 a descending order.

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `items` (array)

  - `items.id` (string)
    The id of the synthetic data application.

  - `items.name` (string)
    The name of this Application. This value must be unique among all synthetic data applications.

  - `items.description` (string)
    An optional description for this synthetic data application.

  - `items.locale` (object)
    The locale information for synthetic data generator.
    Example: {"id":"550e8400-e29b-41d4-a716-446655440000","language_code":"en","language_name":"English","country_code":"US","country_name":"United States","locale":"en_US"}

  - `items.locale.id` (string, required)
    The id of the locale.
    Example: 550e8400-e29b-41d4-a716-446655440000

  - `items.locale.language_code` (string)
    The language code for this locale.
    Example: en

  - `items.locale.language_name` (string)
    The name of the language for this locale.
    Example: English

  - `items.locale.country_code` (string)
    The country code for this locale.
    Example: US

  - `items.locale.country_name` (string)
    The name of the country for this locale.
    Example: United States

  - `items.locale.locale` (string, required)
    The locale identifier (e.g., en_US).
    Example: en_US

  - `items.industry` (object)
    The industry information for synthetic data generator.
    Example: {"id":"550e8400-e29b-41d4-a716-446655440001","name":"Healthcare","description":"Healthcare industry for medical data generation."}

  - `items.industry.id` (string, required)
    The id of the industry.
    Example: 550e8400-e29b-41d4-a716-446655440001

  - `items.industry.name` (string, required)
    The name of the industry.
    Example: Healthcare

  - `items.industry.description` (string)
    An optional description for this industry.
    Example: Healthcare industry for medical data generation.

  - `items.sync_status` (string)
    The status of the synthetic application and dataset.
    Enum: "SETUP_REQUIRED", "DISCOVERING", "ACTIVE", "ASSIGNING_GENERATORS_LLM", "ASSIGNING_GENERATORS_DEEP_SEARCH", "ASSIGNING_GENERATORS_DATA_BASED", "ERROR", "CANCELLING"

  - `items.reference_connector_count` (integer)
    The count of reference connectors associated with this synthetic data application.

  - `items.target_connector_count` (integer)
    The count of target connectors associated with this synthetic data application.

  - `items.connector_count` (integer)
    The count of connectors associated with this synthetic data application.

  - `items.usable_connector_count` (integer)
    The count of connectors associated with this synthetic data application whose connector_sync_status is ACTIVE. Used by the Create Dataset wizard to determine which applications have at least one usable connector for table selection.

  - `items.structure_count` (integer)
    The count of structures associated with this synthetic data application.

  - `items.dataset_count` (integer)
    The count of datasets associated with this synthetic data application.

  - `items.account_id` (integer)
    The ID of the account who created this synthetic data application.

  - `items.creation_date` (string)
    The date this synthetic data application was created.

  - `items.updated_date` (string)
    The date this synthetic data application was updated.

  - `items.tags` (array)
    The tags of this synthetic data application.

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

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

  - `items.sync_progress_percent` (integer)
    Application sync progress from 0 to 100. Populated only while a sync is currently
running; null when no sync has ever been triggered or when the most recent sync
has completed (success or failure).

  - `items.sync_start_time` (string)
    When the current sync started. Populated only while a sync is currently running;
null otherwise.

  - `items.sync_estimated_remaining_seconds` (integer)
    Estimated remaining time, in seconds. Populated only while a sync is currently
running AND progress is greater than 0%; null otherwise. Clients are expected to
format this for display.

  - `items.discovery_support_level` (string)
    How deep discovery should go for the application. METADATA_ONLY uses schema/metadata and name-based rules only; LIGHT_DATA_SAMPLING adds a bounded sample of row data; DEEP_DATA_SAMPLING additionally performs deep sampling. DEEP_DATA_SAMPLING is reserved for a future release and is rejected on both create and update.
    Enum: "METADATA_ONLY", "LIGHT_DATA_SAMPLING", "DEEP_DATA_SAMPLING"

  - `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.

