> ## Documentation Index > Fetch the complete documentation index at: https://docs.waycore.com/llms.txt > Use this file to discover all available pages before exploring further. # List Institutions > GET /v1/institutions List or search supported institutions for public connection creation. ## OpenAPI ````yaml /openapi.json get /v1/institutions openapi: 3.1.0 info: title: Waycore Bank Connections API description: >- Developer-first API for direct bank connections, accounts, and transactions. Design goals: - Flat records with minimal nesting. - Clear, bank-centric naming. - One canonical endpoint per resource. - Sparse fieldsets via `fields=`. - Historical browsing via `GET /transactions`. - Incremental ETL via `GET /transactions/sync`. - Discover supported institutions via `GET /institutions`. - Model downstream client businesses via `/entities` and explicit `entityId` ownership. Authentication: - Opaque API keys passed as `Authorization: Bearer `. - Key format: `way___`. - Keys are organization-bound, environment-bound (`live` or `test`), scope-carrying, and expiring. - Managed via the Waycore Console. version: 0.5.0 servers: - url: https://api.waycore.com security: [] paths: /v1/institutions: get: tags: - institutions summary: List Institutions description: |- GET /v1/institutions List or search supported institutions for public connection creation. operationId: list_institutions_v1_institutions_get parameters: - name: cursor in: query required: false schema: anyOf: - type: string - type: 'null' title: Cursor description: Pagination cursor from a previous response. description: Pagination cursor from a previous response. - name: limit in: query required: false schema: type: integer maximum: 500 minimum: 1 title: Limit description: Maximum number of items to return. default: 100 description: Maximum number of items to return. - name: query in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Search institutions by name, identifier, portal URL, or portal domain. title: Query description: >- Search institutions by name, identifier, portal URL, or portal domain. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/InstitutionsListResponse' type: object additionalProperties: true title: Response List Institutions V1 Institutions Get '400': description: >- Bad Request. `type` may be `invalid_request` for malformed query parameters or validation failures, or `invalid_cursor` when a list cursor is malformed or does not match the supplied query. content: application/json: schema: $ref: '#/components/schemas/PublicErrorResponse' '401': content: application/json: schema: $ref: '#/components/schemas/PublicErrorResponse' description: Unauthorized '403': content: application/json: schema: $ref: '#/components/schemas/PublicErrorResponse' description: Forbidden '429': headers: Retry-After: description: >- Number of seconds to wait before retrying, when rate limiting provides a specific backoff. schema: type: string content: application/json: schema: $ref: '#/components/schemas/PublicErrorResponse' description: Too Many Requests '500': content: application/json: schema: $ref: '#/components/schemas/PublicErrorResponse' description: Internal Server Error security: - apiKeyBearer: - connections:read components: schemas: InstitutionsListResponse: properties: data: items: $ref: '#/components/schemas/Institution' type: array title: Data pagination: $ref: '#/components/schemas/app__institutions__public__models__Pagination' meta: $ref: '#/components/schemas/app__institutions__public__models__Meta' type: object required: - data - pagination - meta title: InstitutionsListResponse PublicErrorResponse: properties: type: title: Type type: string message: type: string title: Message requestId: anyOf: - type: string - type: 'null' title: Requestid details: anyOf: - additionalProperties: true type: object - type: 'null' title: Details type: object required: - type - message title: PublicErrorResponse Institution: properties: institutionId: type: string title: Institutionid description: Stable, immutable identifier for the institution. name: type: string title: Name description: Institution display name. canonicalPortalUrl: type: string title: Canonicalportalurl description: >- Waycore's default HTTPS portal URL used when creating a connection by institution ID. additionalPortalUrls: items: type: string type: array title: Additionalportalurls description: >- Additional HTTPS portal URLs that can be supplied for this institution, when known. setupGuideUrl: type: string title: Setupguideurl description: >- URL to the Waycore documentation page with setup instructions for this institution. status: $ref: '#/components/schemas/InstitutionStatus' description: >- Whether this institution is fully supported (`live`) or coming soon (`pending`). alternativeNames: items: type: string type: array title: Alternativenames description: Alternative names for this institution used for search matching. logoUrl: anyOf: - type: string - type: 'null' title: Logourl description: Public-facing URL to the institution's logo, when available. type: object required: - institutionId - name - canonicalPortalUrl - additionalPortalUrls - setupGuideUrl - status - alternativeNames title: Institution app__institutions__public__models__Pagination: properties: hasMore: type: boolean title: Hasmore nextCursor: anyOf: - type: string - type: 'null' title: Nextcursor type: object required: - hasMore title: Pagination app__institutions__public__models__Meta: properties: requestId: type: string title: Requestid type: object required: - requestId title: Meta InstitutionStatus: type: string enum: - live - pending title: InstitutionStatus securitySchemes: apiKeyBearer: type: http scheme: bearer bearerFormat: way___ description: >- Opaque API key passed as `Authorization: Bearer `. Keys are organization-bound, environment-bound (`live` or `test`), scope-carrying, and expiring. Create and manage keys via the console. ````