---
title: "List Foundational Data"
method: GET
path: "/api/v2/ats/foundational-data"
tags: ["Foundational Data"]
---

# List Foundational Data

`GET /api/v2/ats/foundational-data`

Search foundational data using query parameters and get the complete foundational data objects

## Query parameters

- `start` integer
- `limit` integer
- `filterQuery` string
- `query` string
- `exclude` string
- `keyList` string

## Headers

- `Authorization` string, required

## Response `200`

OK

- object
  - `data` FoundationalDataResponseSchema[]
    - `externalId` string, nullable — External ID of the foundational data
    - `status` string, nullable — Status of the foundational data
    - `createdAt` integer, nullable — Created timestamp
    - `parents` ParentOrgUnitSchema[], nullable — List of parent org units
      - `externalId` string, nullable — External ID; null or omitted signals a root node in the given view
      - `viewId` string, required — View ID
    - `type` string, nullable — Type of the foundational data
    - `updatedAt` integer, nullable — Updated timestamp
    - `users` FoundationalDataUserSchema[], nullable — List of users
      - `role` string, required — User role
      - `email` string, required — User email
    - `attributes` FoundationalDataAttributeSchema[], nullable — List of attributes
      - `value` string, nullable — Attribute value
      - `attributeId` string, required — Attribute ID
    - `description` string, nullable — Description of the foundational data
    - `title` string, nullable — Title of the foundational data
  - `meta` MetaSchema
    - `totalCount` integer, nullable
    - `pageTotalCount` integer, nullable
    - `pageStartIndex` integer, nullable

---

[API](https://skmtc.net/eightfold/apis/api-server-v2-service-service.md) · [All operations](https://skmtc.net/eightfold/apis/api-server-v2-service-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eightfold/api-server-v2-service-service/versions/0fb26f4e41bf/schema)