---
title: "Get Foundational Data"
method: GET
path: "/api/v2/ats/foundational-data/{externalId}"
tags: ["Foundational Data"]
---

# Get Foundational Data

`GET /api/v2/ats/foundational-data/{externalId}`

Given an external id, it returns Foundational Data object

## Path parameters

- `externalId` string, required

## Query parameters

- `exclude` string
- `keyList` string

## Headers

- `Authorization` string, required

## Response `200`

OK

- 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

---

[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)