> ## Documentation Index > Fetch the complete documentation index at: https://docs.barndoor.ai/llms.txt > Use this file to discover all available pages before exploring further. # List Applications > List applications with pagination. ## OpenAPI ````yaml /api-reference/openapi.yaml get /api/registry/v1/agents openapi: 3.1.0 info: title: Barndoor.ai Public API description: Unified public API specification for Barndoor.ai platform version: 2.18.0 servers: - url: https://{host} description: Barndoor public API variables: host: default: platform.barndoor.ai description: >- The host serving your Barndoor deployment. Defaults to production; override it for another environment or a dedicated deployment. security: - ApiKey: [] - OAuth2: - openid - profile - email tags: - name: dlp x-group: Data Control Center - name: identity x-group: Identity - name: llm-gateway x-group: LLM Gateway - name: notification x-group: Notifications - name: policy x-group: Policies - name: registry x-group: MCP Gateway - name: system-management x-group: Log Exports paths: /api/registry/v1/agents: get: tags: - registry summary: List Applications description: List applications with pagination. operationId: list_agents parameters: - name: search in: query required: false schema: anyOf: - type: string - type: 'null' description: Search applications by name or description title: Search description: Search applications by name or description - name: agent_type in: query required: false schema: anyOf: - $ref: '#/components/schemas/AgentType' - type: 'null' description: Filter by agent type title: Agent Type description: Filter by agent type - name: page in: query required: false schema: type: integer minimum: 1 description: Page number (1-based) default: 1 title: Page description: Page number (1-based) - name: limit in: query required: false schema: type: integer maximum: 100 minimum: 1 description: Number of items per page (max 100) default: 10 title: Limit description: Number of items per page (max 100) responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PaginationResponse_ApplicationResponse_' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: AgentType: type: string enum: - internal - external title: AgentType description: Agent type classification for applications. PaginationResponse_ApplicationResponse_: properties: data: items: $ref: '#/components/schemas/ApplicationResponse' type: array title: Data description: Array of items for current page pagination: $ref: '#/components/schemas/PaginationMeta' description: Pagination metadata type: object required: - data - pagination title: PaginationResponse[ApplicationResponse] HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ApplicationResponse: properties: id: type: string format: uuid title: Id created_at: type: string format: date-time title: Created At updated_at: type: string format: date-time title: Updated At organization_id: type: string format: uuid title: Organization Id application_directory_id: type: string format: uuid title: Application Directory Id write_confirmations_required: type: boolean title: Write Confirmations Required default: true llm_gateway_enabled: type: boolean title: Llm Gateway Enabled default: false application_directory: $ref: '#/components/schemas/ApplicationDirectoryBase' deleted_at: anyOf: - type: string format: date-time - type: 'null' title: Deleted At agent_type: $ref: '#/components/schemas/AgentType' description: Determine agent type based on application directory properties. readOnly: true type: object required: - id - created_at - updated_at - organization_id - application_directory_id - write_confirmations_required - llm_gateway_enabled - application_directory - deleted_at - agent_type title: ApplicationResponse PaginationMeta: properties: page: type: integer title: Page description: Current page number limit: type: integer title: Limit description: Items per page total: type: integer title: Total description: Total number of items pages: type: integer title: Pages description: Total number of pages previous_page: anyOf: - type: integer - type: 'null' title: Previous Page description: Previous page number (null if first page) next_page: anyOf: - type: integer - type: 'null' title: Next Page description: Next page number (null if last page) type: object required: - page - limit - total - pages - previous_page - next_page title: PaginationMeta description: Pagination metadata. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError ApplicationDirectoryBase: properties: id: type: string format: uuid title: Id created_at: type: string format: date-time title: Created At updated_at: type: string format: date-time title: Updated At name: type: string title: Name description: anyOf: - type: string - type: 'null' title: Description owner_name: anyOf: - type: string - type: 'null' title: Owner Name description: Responsible team or person that manages the agent. owner_contact: anyOf: - type: string - type: 'null' title: Owner Contact description: Contact information (email, Slack, etc.) for the agent owner. organization_id: type: string format: uuid title: Organization Id external_id: anyOf: - type: string - type: 'null' title: External Id public: type: boolean title: Public app_type: anyOf: - $ref: '#/components/schemas/AppType' - type: 'null' description: >- OAuth application type. Source of truth for the agent's app type; projected onto provider-specific fields (Auth0 ``app_type``, Keycloak ``serviceAccountsEnabled``). dcr: type: boolean title: Dcr post_login_success: type: boolean title: Post Login Success callbacks: anyOf: - type: array items: type: string - type: 'null' title: Callbacks description: OAuth callback URLs stored in alphanumeric ascending order cimd_url: anyOf: - type: string - type: 'null' title: Cimd Url description: >- Canonicalized OAuth Client ID Metadata Document URL for clients registered via the CIMD flow. NULL for non-CIMD clients. type: object required: - id - created_at - updated_at - name - description - owner_name - owner_contact - organization_id - external_id - public - app_type - dcr - post_login_success - callbacks - cimd_url title: ApplicationDirectoryBase AppType: type: string enum: - regular_web - spa - native - non_interactive title: AppType description: |- Supported OAuth application types. Values mirror Auth0's ``app_type`` field; the same values are used internally for Keycloak (which has no native ``app_type`` concept). securitySchemes: ApiKey: type: http scheme: bearer description: >- A Barndoor API key, sent as `Authorization: Bearer `. Keys are prefixed `bdai_` and are opaque — do not attempt to decode one. Interchangeable with an OAuth 2.0 access token. OAuth2: type: oauth2 x-issuer: https://auth.barndoor.ai/realms/barndoor description: >- An OAuth 2.0 access token from Barndoor's identity provider, sent as `Authorization: Bearer `. Public clients must use PKCE. Interchangeable with an API key. flows: authorizationCode: authorizationUrl: >- https://auth.barndoor.ai/realms/barndoor/protocol/openid-connect/auth tokenUrl: >- https://auth.barndoor.ai/realms/barndoor/protocol/openid-connect/token scopes: openid: Issue an OIDC ID token identifying the caller. profile: Read the caller's basic profile claims. email: Read the caller's email address. offline_access: Issue a refresh token. Optional — no operation requires it. clientCredentials: tokenUrl: >- https://auth.barndoor.ai/realms/barndoor/protocol/openid-connect/token scopes: openid: Issue an OIDC ID token identifying the caller. profile: Read the caller's basic profile claims. email: Read the caller's email address. offline_access: Issue a refresh token. Optional — no operation requires it. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.