---
title: "Get an Identity Federation app"
method: GET
path: "/api/v1/identity-federation"
tags: ["Identity Federation"]
---

# Get an Identity Federation app

`GET /api/v1/identity-federation`

## Query parameters

- `id` string, required
- `tenant` string
- `product` string

## Response `200`

Success

- IdentityFederationResponse
  - `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

---

[API](https://skmtc.net/ory/apis/enterprise-sso-directory-sync.md) · [All operations](https://skmtc.net/ory/apis/enterprise-sso-directory-sync/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ory/enterprise-sso-directory-sync/versions/d92c991ace28/schema)