> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Listar Provedores > Use este endpoint para listar todos os provedores de comunicação configurados no sistema. ## OpenAPI ````yaml pt/openapi/v3-current/AM-identity.yaml get /v1/providers openapi: 3.1.0 info: title: Plugin de Identidade description: '' version: 2.4.5 servers: - url: https://identity.sandbox.lerian.net security: [] tags: - name: API de Grupos - name: API de Aplicações - name: API de Usuários - name: API de MFA - name: API de Provedores - name: API de Provedores de Aplicação paths: /v1/providers: get: tags: - API de Provedores summary: Listar Provedores description: >- Use este endpoint para listar todos os provedores de comunicação configurados no sistema. parameters: - $ref: '#/components/parameters/ProviderCategoryQueryParam' - $ref: '#/components/parameters/PageQueryParam' - $ref: '#/components/parameters/LimitQueryParam' responses: '200': description: A lista de todos os provedores configurados no sistema. content: application/json: schema: allOf: - $ref: '#/components/schemas/Pagination' - type: object properties: items: type: array items: $ref: '#/components/schemas/ProviderResponse' example: items: - id: 019c96a0-1a10-7abc-d1e2-8c9d0e1f2a3b name: sendgrid-primary category: Email type: SendGrid host: smtp.sendgrid.net port: 587 disableSsl: false createdAt: '2025-04-08T08:01:30.000Z' - id: 019c96a0-1b20-7bcd-e1f2-9d0e1f2a3b4c name: twilio-sms category: SMS type: Twilio disableSsl: false createdAt: '2025-04-07T18:57:57.312Z' page: 1 limit: 10 total: 2 headers: {} '404': description: '' content: application/json: schema: $ref: '#/components/schemas/ErrorMessage' examples: Error1007: $ref: '#/components/examples/Error1007' headers: {} '500': description: '' content: application/json: schema: $ref: '#/components/schemas/ErrorMessage' examples: Error0006: $ref: '#/components/examples/Error0006' headers: {} security: - bearer: [] components: parameters: ProviderCategoryQueryParam: name: category in: query description: Filtra os provedores por categoria de comunicação. required: true schema: type: string enum: - Email - SMS PageQueryParam: name: page in: query description: O número da página a ser recuperada. required: false schema: type: integer default: 1 minimum: 1 LimitQueryParam: name: limit in: query description: O número máximo de itens retornados por página. Não pode exceder 100. required: false schema: type: integer default: 10 minimum: 1 maximum: 100 schemas: Pagination: description: Envelope padrão de resposta paginada. type: object properties: items: type: array description: A lista de itens retornados para a página atual. items: {} page: type: integer description: O número da página atual. example: 1 limit: type: integer description: O número máximo de itens retornados por página. example: 10 total: type: integer description: O número total de itens disponíveis em todas as páginas. example: 2 ProviderResponse: description: Informações sobre um provedor de comunicação. type: object properties: id: type: string description: Identificador único do provedor. name: type: string description: Nome do provedor. category: type: string description: Categoria do provedor. enum: - Email - SMS type: type: string description: Tipo de implementação do provedor. enum: - SendGrid - Twilio subType: type: string description: Subtipo do provedor, se aplicável. method: type: string description: Método de autenticação ou de entrega. clientId: type: string description: ID do cliente ou chave de API (o segredo nunca é retornado). clientId2: type: string description: ID de cliente secundário, se aplicável. host: type: string description: Endereço de host SMTP ou da API. port: type: integer description: Porta SMTP. disableSsl: type: boolean description: Indica se SSL/TLS está desabilitado. title: type: string description: Título/assunto padrão do e-mail ou SMS. content: type: string description: Modelo de conteúdo padrão da mensagem. receiver: type: string description: Endereço do destinatário padrão para testes. regionId: type: string description: ID da região da nuvem (específico do provedor). signName: type: string description: Nome de assinatura do SMS (específico do provedor). templateCode: type: string description: Código do modelo de SMS (específico do provedor). appId: type: string description: ID da aplicação (específico do provedor). endpoint: type: string description: URL do endpoint da API do provedor. intranetEndpoint: type: string description: Endpoint de intranet para acesso por rede privada. domain: type: string description: Domínio do provedor. providerUrl: type: string description: URL específica do provedor. createdAt: type: string format: date-time description: Registro de data e hora de quando o provedor foi criado. ErrorMessage: description: A mensagem de erro da resposta. type: object properties: code: type: string description: Um identificador único e estável para o erro. title: type: string description: Um breve resumo do problema. message: type: string description: Orientação detalhada para resolver o erro. examples: Error1007: summary: Provider Not Found value: code: IDE-1007 title: Provider Not Found message: The provided provider ID does not exist in our records. Error0006: summary: Internal Server Error value: code: IDE-0006 title: Internal Server Error message: The server encountered an unexpected error. Please try again later. securitySchemes: bearer: type: http scheme: bearer description: O token de autorização no formato 'Bearer '. ````