---
title: "Get fact definitions"
method: GET
path: "/context/1/facts"
tags: ["customer-engagement", "context", "facts"]
---

# Get fact definitions

`GET /context/1/facts`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/context/1/facts`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic

Returns a paginated list of fact definitions for the calling account. Supports sorting via the `orderBy` and `direction` query parameters.

## Query parameters

- `page` integer: Zero-based page index. Defaults to 0.
- `size` integer: Page size. Must be between 1 and 100. Defaults to 20.
- `orderBy` 'NAME' | 'DESCRIPTION' | 'VALUE_TYPE' | 'CREATED_AT' | 'UPDATED_AT': Field to sort by. Allowed values: `NAME`, `DESCRIPTION`, `VALUE_TYPE`, `CREATED_AT`, `UPDATED_AT`. Defaults to `CREATED_AT`.
- `direction` 'ASC' | 'DESC': Sort direction. Allowed values: `ASC`, `DESC`. Defaults to `DESC`.

## Response `200`

OK - a page of fact definitions

- 284df221d4ea79ba964b452422482b56ed35030dc947e42a2c1842f66361972cFactPageApiResponse: A page of fact definitions with paging metadata.
  - `results` 284df221d4ea79ba964b452422482b56ed35030dc947e42a2c1842f66361972cFactApiResponse[], required: Fact definitions on this page.
    - `id` string, uuid, required: Surrogate identifier of this fact definition.
    - `name` string, required: Fact name, unique within the account.
    - `description` string, required: Human-readable description of the fact.
    - `valueType` 'STRING' | 'NUMBER' | 'BOOLEAN' | 'DATE', required: Supported value types for a fact definition.
    - `createdAt` string, date-time, required: Timestamp (UTC, ISO-8601) when the fact definition was created.
    - `updatedAt` string, date-time, required: Timestamp (UTC, ISO-8601) when the fact definition was last updated.
  - `paging` 284df221d4ea79ba964b452422482b56ed35030dc947e42a2c1842f66361972cPageInfo, required: Paging metadata describing the position of this page within the full result set.
    - `page` integer, required: Requested page number.
    - `size` integer, required: Requested page size.
    - `totalPages` integer, required: The total number of pages of the results matching the requested parameters.
    - `totalResults` integer, required: The total number of the results matching the requested parameters.

## Other responses

- `400`: Bad request - a query parameter is invalid (e.g. `orderBy`, `direction`, `page`, or `size`)
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)