> ## Documentation Index > Fetch the complete documentation index at: https://docs.synci.io/llms.txt > Use this file to discover all available pages before exploring further. # Get supported institution > Get a supported institution. Use the institution IDs when creating new financial connections. ## OpenAPI ````yaml /openapi/v1.json get /finance/institutions/{institutionId} openapi: 3.2.0 info: title: Synci version: '1.0' description: >- Synci is a platform for integrating financial accounts with your favorite apps. servers: - url: https://api.synci.io/api/v1 security: - oauth2: [] - http: [] tags: - name: Finance kind: nav - name: Connections parent: Finance - name: Accounts parent: Finance - name: Transactions parent: Finance - name: Institutions parent: Finance - name: Destinations kind: nav - name: YNAB parent: Destinations - name: Lunch Money parent: Destinations - name: Google Sheets parent: Destinations - name: SimpleFIN parent: Destinations - name: Notion parent: Destinations - name: Account kind: nav - name: Webhooks parent: Account - name: User parent: Account - name: rule-engine summary: Rules kind: nav - name: Rules parent: rule-engine - name: Rule Logs parent: rule-engine - name: Transfers kind: nav - name: Transfer Links parent: Transfers - name: Transfer Logs parent: Transfers paths: /finance/institutions/{institutionId}: get: tags: - Institutions summary: Get supported institution description: >- Get a supported institution. Use the institution IDs when creating new financial connections. operationId: financial.institutions.show parameters: - name: institutionId in: path required: true description: The institution ID schema: type: integer responses: '200': description: '`InstitutionResource`' content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/InstitutionResource' required: - data '401': $ref: '#/components/responses/AuthenticationException' '404': $ref: '#/components/responses/ModelNotFoundException' components: schemas: InstitutionResource: type: object properties: id: type: string integrator: type: string description: The integrator used to connect to this institution. region: type: string description: >- Residency region connections to this institution are stored in (`eu`, `us`). country: type: string description: ISO 3166-1 alpha-2 country code. name: type: string description: Name of the institution. bic: type: string description: Institution Identifier Code (BIC/SWIFT code). external_id: type: string description: The ID of the institution as provided by the integrator. logo: type: string description: URL to the institution's logo, as provided by the integrator. supported: type: string description: >- Whether the institution is supported. Will be true in most cases, but might be false if the integrator stops supporting an institution. supports_pending_transactions: type: string description: Whether the institution supports pending transactions. supports_card_accounts: type: string description: Whether the institution supports card accounts. max_historical_days: type: string description: >- The maximum number of days of historical data this institution can provide. `null` where the provider imposes no such limit and fetches whatever the bank holds, which is the case for every US institution. Do not read null as zero. max_access_valid_for_days: type: string description: >- Also known as consent lifetime. The maximum number of days access to this institution may be valid for. For most European institutions this ranges from 90 to 180 days. `null` where access does not expire on a schedule and no periodic re-consent is required, which is the case for every US institution: those connections break only when the bank breaks them. supported_products: type: string description: >- The kinds of data this institution can serve, e.g. `["ACCOUNTS", "TRANSACTIONS", "INVESTMENTS"]`. `null` means the provider does not report it, NOT that the institution serves nothing: treat it as no information rather than as a negative. Only US institutions report it today. category: type: - string - 'null' description: The category of the financial institution. updated_at: type: string description: The date and time when the institution was last updated. required: - id - integrator - region - country - name - bic - external_id - logo - supported - supports_pending_transactions - supports_card_accounts - max_historical_days - max_access_valid_for_days - supported_products - category - updated_at title: InstitutionResource responses: AuthenticationException: description: Unauthenticated content: application/json: schema: type: object properties: message: type: string description: Error overview. required: - message ModelNotFoundException: description: Not found content: application/json: schema: type: object properties: message: type: string description: Error overview. required: - message securitySchemes: oauth2: type: oauth2 flows: authorizationCode: authorizationUrl: https://api.synci.io/oauth/authorize tokenUrl: https://api.synci.io/oauth/token scopes: profile:read: View your name, email, and profile details accounts:read: View your connected financial accounts and balances accounts:write: >- Update, sync, and remove your financial accounts, and change their settings transactions:read: View your transactions transactions:write: Create, update, and delete your transactions sensitive:read: >- See sensitive identifiers like account numbers and account holder names transfer-links:read: View your transfer links and their transfer history transfer-links:write: Create, update, and delete transfer links, and undo transfers rules:read: View your rules and rule activity rules:write: Create, update, and delete rules, and undo rule actions webhooks:read: View your webhook endpoints webhooks:write: >- Create, update, and delete webhook endpoints, and rotate their secrets destinations:read: View your connected destinations destinations:write: Connect, update, and remove destinations financial-connections:read: View your connected institutions financial-connections:write: Manage your connected institutions http: type: http description: Bearer token (personal access token or OAuth access token) scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.