---
title: "Get Identity Federation apps by product"
method: GET
path: "/api/v1/identity-federation/product"
tags: ["Identity Federation"]
---

# Get Identity Federation apps by product

`GET /api/v1/identity-federation/product`

## Request

- Base URL: `http://localhost:5225`
- URL: `http://localhost:5225/api/v1/identity-federation/product`
- Auth: API key in header `Authorization`

## Query parameters

- `product` string, required
- `pageOffset` string
- `pageLimit` string
- `pageToken` string

## Response `200`

Success

- object
  - `data` IdentityFederationApp[]
    - `tenant` string: Tenant
    - `product` string: Product
    - `name` string: Name
    - `acsUrl` string: ACS URL
    - `entityId` string: Entity ID
    - `logoUrl` string: Logo URL
    - `faviconUrl` string: Favicon URL
    - `primaryColor` string: Primary color
    - `tenants` string[]: Mapping of tenants whose connections will be grouped under this Identity Federation app
    - `mappings` AttributeMapping[]: Mapping of attributes from the IdP to SP
      - `key` string: SP attribute
      - `value` string: IdP attribute
    - `type` string[]: If creating an OIDC app, this should be set to 'oidc' otherwise it defaults to 'saml'
    - `redirectUrl` string[]: If creating an OIDC app, provide the redirect URL
    - `samlAudienceOverride` string: Override the SAML Audience on a per app basis
    - `includeOidcTokensInAssertion` boolean: Include OIDC tokens in the SAML assertion
    - `ttlInMinutes` number: Time-to-live in minutes for the SAML assertion, does not apply to OIDC flows
    - `id` string, required: App ID
  - `error` IdentityFederationError
    - `message` string
  - `pageToken` string: token for pagination

## Changes

- **2026-02-03** `04750dcfd487`: 1 info
  - added the optional property `data/items/allOf[#/components/schemas/IdentityFederationAppCreate]/includeOidcTokensInAssertion` to the response with the `200` status
- **2026-01-18** `b0303bb023ff`: 1 info
  - added the optional property `data/items/allOf[#/components/schemas/IdentityFederationAppCreate]/ttlInMinutes` to the response with the `200` status
- **2025-06-12** `0b40e4fcf469`: 1 breaking, 2 info
  - the `data/items/allOf[#/components/schemas/IdentityFederationAppCreate]/mappings/items/` response's property type changed from `string` to `object` for status `200`
  - added the optional property `data/items/allOf[#/components/schemas/IdentityFederationAppCreate]/mappings/items/key` to the response with the `200` status
  - added the optional property `data/items/allOf[#/components/schemas/IdentityFederationAppCreate]/mappings/items/value` to the response with the `200` status
- **2025-06-10** `8164fb8aa9f5`: 1 info
  - added the optional property `data/items/allOf[#/components/schemas/IdentityFederationAppCreate]/samlAudienceOverride` to the response with the `200` status
- …earlier changes not shown

[Operation history](https://skmtc.dev/ory/apis/enterprise-sso-directory-sync/changes/api/v1/identity-federation/product/get.md)

---

[API](https://skmtc.dev/ory/apis/enterprise-sso-directory-sync.md) - [All operations](https://skmtc.dev/ory/apis/enterprise-sso-directory-sync/llms.txt) - [OpenAPI document](https://skmtc.dev/ory/apis/enterprise-sso-directory-sync/revisions/d92c991ace28?raw)