> ## Documentation Index > Fetch the complete documentation index at: https://docs.fastpaybrasil.com/llms.txt > Use this file to discover all available pages before exploring further. # List submerchant legal representatives > Lista os representantes/sócios da subconta — o **principal primeiro** (`isPrimary: true`) e depois os sócios adicionais. Com `include=documents`, inclui os documentos de pessoa de cada sócio (`idFront`, `idBack`, `selfie`). Chave ausente em `documents` = documento **não enviado**. As `url` são **assinadas e expiram em 1 hora** — não as armazene; consulte novamente quando precisar. Retorna `404` quando a subconta não pertence ao master autenticado. ## OpenAPI ````yaml /api-reference/openapi.yaml get /v1/submerchants/{merchantId}/legal-representatives openapi: 3.0.0 info: title: FastPay API version: 1.0.0 description: >- API for creating and managing payment charges. ## Authentication This API uses **Basic Authentication** for direct API access, such as creating charges. Use your API key as the username and an empty string as password. The header should be formatted as: `Authorization: Basic {base64(apiKey:)}`. For example: ``` Authorization: Basic YWxleG91dG9uOiIi ``` ## Webhooks FastPay sends webhooks to notify your application about charge status changes in real-time. Webhooks are sent via HTTP POST requests to your configured webhook endpoints. ### Webhook Events The following webhook events are available for charges: - `charge.created` - Sent when a new charge is created - `charge.pending` - Sent when a charge is pending payment - `charge.paid` - Sent when a charge is successfully paid - `charge.updated` - Sent when a charge is updated ### Webhook Payload Structure All webhook payloads follow this structure: ```json { "id": "webhook_event_id", "event": "charge.paid", "data": { // Complete charge object } } ``` ### Webhook Delivery - Webhooks are sent via HTTP POST requests - Content-Type: `application/json` - Retry logic is implemented for failed deliveries - Webhook events are stored in the database for audit purposes - Delivery logs are maintained for debugging and monitoring ### Webhook Security - Webhooks are sent to pre-configured endpoints - Endpoints can be enabled/disabled per merchant - Event filtering is supported (only receive specific events) - Failed deliveries are retried with exponential backoff servers: - url: https://api-global.fastpaybrasil.com description: Produção e Sandbox (diferenciados pela API key) security: [] paths: /v1/submerchants/{merchantId}/legal-representatives: get: tags: - FastConnect summary: List submerchant legal representatives description: >- Lista os representantes/sócios da subconta — o **principal primeiro** (`isPrimary: true`) e depois os sócios adicionais. Com `include=documents`, inclui os documentos de pessoa de cada sócio (`idFront`, `idBack`, `selfie`). Chave ausente em `documents` = documento **não enviado**. As `url` são **assinadas e expiram em 1 hora** — não as armazene; consulte novamente quando precisar. Retorna `404` quando a subconta não pertence ao master autenticado. parameters: - name: merchantId in: path required: true description: Id da subconta. schema: type: string example: 2vorkDcXyvzifL63YX09S9VqcnI - name: include in: query required: false description: Use `documents` para incluir os documentos de cada sócio. schema: type: string enum: - documents example: documents responses: '200': description: Lista de representantes content: application/json: schema: type: object properties: data: type: array items: type: object properties: id: type: string example: 2vorkEaaaBbbCccDddEeeFffGgg fullName: type: string example: Ana Principal idNumber: type: string nullable: true example: '12345678900' email: type: string example: ana@example.com isPrimary: type: boolean description: '`true` apenas no representante legal da empresa' example: true documents: type: object description: >- Presente somente com `include=documents`. Chave ausente = documento não enviado. properties: idFront: $ref: '#/components/schemas/RepresentativeDocument' idBack: $ref: '#/components/schemas/RepresentativeDocument' selfie: $ref: '#/components/schemas/RepresentativeDocument' '401': description: Unauthorized - invalid credentials content: application/json: schema: type: object properties: statusCode: type: integer example: 401 message: type: string example: Unauthorized '404': description: Subconta não encontrada (não pertence ao master autenticado) content: application/json: schema: type: object properties: statusCode: type: integer example: 404 message: type: string example: Subconta não encontrada security: - basic: [] components: schemas: RepresentativeDocument: type: object properties: id: type: string description: Identificador do documento example: 2vorkEdddEeeFffGggHhhIiiJjj url: type: string description: >- URL **assinada** para visualizar o arquivo — expira em **1 hora**; não armazene. example: https://storage.fastpaybrasil.com/documents/abc123?signature=... status: type: string enum: - approved - rejected - pending description: Status de análise do documento example: pending rejectionReason: type: string nullable: true description: Motivo da rejeição (quando `status = rejected`) example: null createdAt: type: string format: date-time description: Data de envio example: '2026-08-05T14:30:00.000Z' securitySchemes: basic: type: http scheme: basic description: |- HTTP Basic authentication. Use your secret key as the username and an empty string as password. The API key should be base64 encoded in the format 'username:' when sending the Authorization header. ````