---
title: "Get a Fact"
method: GET
path: "/api/v1/entities/workspaces/{workspaceId}/facts/{objectId}"
tags: ["Facts"]
---

# Get a Fact

`GET /api/v1/entities/workspaces/{workspaceId}/facts/{objectId}`

## Request

- Base URL: `https://www.gooddata.ai`
- URL: `https://www.gooddata.ai/api/v1/entities/workspaces/{workspaceId}/facts/{objectId}`
- Auth: none declared

## Path parameters

- `workspaceId` string, required
- `objectId` string, required

## Query parameters

- `filter` string
- `include` string[]
- `metaInclude` string[]: Included meta objects

## Headers

- `X-GDC-VALIDATE-RELATIONS` boolean

## Response `200`

Request successfully processed

- JsonApiFactOutDocument
  - `data` JsonApiFactOut, required: JSON:API representation of fact entity.
    - `attributes` object
      - `areRelationsValid` boolean
      - `description` string
      - `isHidden` boolean
      - `isNullable` boolean
      - `nullValue` string
      - `sourceColumn` string
      - `sourceColumnDataType` 'INT' | 'STRING' | 'DATE' | 'NUMERIC' | 'TIMESTAMP' | 'TIMESTAMP_TZ' | 'BOOLEAN' | 'HLL'
      - `tags` string[]
      - `title` string
    - `id` string, required: API identifier of an object
    - `meta` object
      - `origin` object
        - `originId` string, required: defines id of the workspace where the entity comes from
        - `originType` 'NATIVE' | 'PARENT', required: defines type of the origin of the entity
      - `permissions` string[]: List of valid permissions for a logged-in user.
    - `relationships` object
      - `dataset` object
        - `data` JsonApiDatasetToOneLinkage, required: The \"type\" and \"id\" to non-empty members.
          - `id` string, required
          - `type` 'dataset', required
    - `type` 'fact', required: Object type
  - `included` JsonApiDatasetOutWithLinks[]: Included resources
    - `attributes` object, required
      - `areRelationsValid` boolean
      - `dataSourceTableId` string
      - `dataSourceTablePath` string[]: Path to database table.
      - `description` string
      - `grain` object[]
        - `id` string, required
        - `type` 'attribute' | 'date', required
      - `precedence` integer
      - `referenceProperties` object[]
        - `identifier` DatasetReferenceIdentifier, required
          - `id` string, required
          - `type` 'dataset', required
        - `multivalue` boolean, required
        - `sourceColumnDataTypes` string[]
        - `sourceColumns` string[]
        - `sources` ReferenceSourceColumn[]
          - `column` string
          - `dataType` 'INT' | 'STRING' | 'DATE' | 'NUMERIC' | 'TIMESTAMP' | 'TIMESTAMP_TZ' | 'BOOLEAN' | 'HLL'
          - `isNullable` boolean
          - `nullValue` string
          - `target` DatasetGrain, required
            - `id` string, required
            - `type` 'attribute' | 'date', required
      - `sql` object
        - `dataSourceId` string, required
        - `statement` string, required
      - `tags` string[]
      - `title` string
      - `type` 'NORMAL' | 'DATE' | 'AUXILIARY', required
      - `workspaceDataFilterColumns` object[]
        - `dataType` 'INT' | 'STRING' | 'DATE' | 'NUMERIC' | 'TIMESTAMP' | 'TIMESTAMP_TZ' | 'BOOLEAN' | 'HLL', required
        - `name` string, required
      - `workspaceDataFilterReferences` object[]
        - `filterColumn` string, required
        - `filterColumnDataType` 'INT' | 'STRING' | 'DATE' | 'NUMERIC' | 'TIMESTAMP' | 'TIMESTAMP_TZ' | 'BOOLEAN' | 'HLL', required
        - `filterId` DatasetWorkspaceDataFilterIdentifier, required: Identifier of a workspace data filter.
          - `id` string, required: Workspace Data Filters ID.
          - `type` 'workspaceDataFilter', required: Filter type.
    - `id` string, required: API identifier of an object
    - `meta` object
      - `origin` object
        - `originId` string, required: defines id of the workspace where the entity comes from
        - `originType` 'NATIVE' | 'PARENT', required: defines type of the origin of the entity
    - `relationships` object
      - `aggregatedFacts` object
        - `data` JsonApiAggregatedFactLinkage[], required: References to other resource objects in a to-many (\"relationship\"). Relationships can be specified by including a member in a resource's links object.
          - `id` string, required
          - `type` 'aggregatedFact', required
      - `attributes` object
        - `data` JsonApiAttributeLinkage[], required: References to other resource objects in a to-many (\"relationship\"). Relationships can be specified by including a member in a resource's links object.
          - `id` string, required
          - `type` 'attribute', required
      - `facts` object
        - `data` JsonApiFactLinkage[], required: References to other resource objects in a to-many (\"relationship\"). Relationships can be specified by including a member in a resource's links object.
          - `id` string, required
          - `type` 'fact', required
      - `references` object
        - `data` JsonApiDatasetLinkage[], required: References to other resource objects in a to-many (\"relationship\"). Relationships can be specified by including a member in a resource's links object.
          - `id` string, required
          - `type` 'dataset', required
      - `workspaceDataFilters` object
        - `data` JsonApiWorkspaceDataFilterLinkage[], required: References to other resource objects in a to-many (\"relationship\"). Relationships can be specified by including a member in a resource's links object.
          - `id` string, required
          - `type` 'workspaceDataFilter', required
    - `type` 'dataset', required: Object type
    - `links` ObjectLinks
      - `self` string, uri, required: A string containing the link's URL.
  - `links` ObjectLinks
    - `self` string, uri, required: A string containing the link's URL.
  - `meta` object
    - `restricted` RestrictedObject[]: References withheld from `included` because the caller may not view them. Their `relationships` entries are kept, so a client can render a placeholder instead of treating the reference as missing. Empty when the caller may view every reference in the payload; absent entirely when no object-level permissions apply to the request.
      - `id` string, required: Object identifier, unique within one workspace hierarchy.
      - `type` 'analyticalDashboard' | 'attribute' | 'attributeHierarchy' | 'computedAttribute' | 'fact' | 'label' | 'metric' | 'userDataFilter' | 'visualizationObject', required: JSON:API type of the restricted object. Matches the `type` of its entry in the resource's `relationships`.

---

[API](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api.md) - [All operations](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api/revisions/c728ef303bfb?raw)