# Retrieve the list of seed list files.

Endpoint: GET /synthetic/seed-lists
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.

  - `industry_id` (string)
    Filter seed lists by industry ID.

  - `locale` (string)
    Filter seed lists by locale.

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `items` (array)

  - `items.id` (string)
    The ID of the seed list file.
    Example: seedlist-123

  - `items.seed_file_name` (string)
    The name assigned to the seed list file.
    Example: seedlist.csv

  - `items.description` (string)
    An optional description for the seed list file.
    Example: This is a seed list of first names.

  - `items.locale` (string)
    The locale of the seed list file.
    Example: en_US

  - `items.industry_id` (string)
    The ID of the industry associated with this seed list file.
    Example: a9ec779e-fc41-d440-866e-d0144049ebd4

  - `items.row_count` (integer)
    The number of rows in the seed list file.
    Example: 1000

  - `items.preview` (array)
    A preview of the first few entries in the seed list file.
    Example: ["Alice","Bob","Charlie"]

  - `items.file_upload_id` (string)
    The ID of the uploaded file to be used as seed list.
    Example: file-123

  - `items.file_checksum` (string)
    The checksum of the seed list file.
    Example: abcdef1234567890

  - `items.account_id` (integer)
    The ID of the account who created this seed list file.
    Example: 1

  - `items.creation_date` (string)
    The date and time when the seed list was created.
    Example: 2026-01-15T10:30:00.000Z

  - `items.updated_date` (string)
    The date and time when the seed list was last updated.
    Example: 2026-01-15T10:30:00.000Z

  - `items.tags` (array)
    Tags associated with the seed list file.

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