> ## 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. # Iniciar una extracción de conexión > Utilice este endpoint para crear una solicitud de extracción para una conexión descubierta y enviarla a Fetcher para el tenant autenticado. ## OpenAPI ````yaml es/openapi/v3-current/matcher.yaml post /v1/discovery/connections/{connectionId}/extractions openapi: 3.1.0 info: title: Matcher APIs description: >- Referencia completa de la API para el motor de conciliación Matcher, que proporciona conciliación automatizada de transacciones entre Midaz Ledger y sistemas externos. version: 4.1.0 license: name: Lerian Studio General License servers: - url: https://matcher.sandbox.lerian.net security: [] paths: /v1/discovery/connections/{connectionId}/extractions: post: tags: - Discovery summary: Iniciar una extracción de conexión description: >- Utilice este endpoint para crear una solicitud de extracción para una conexión descubierta y enviarla a Fetcher para el tenant autenticado. operationId: startDiscoveryExtraction parameters: - description: A unique identifier for tracing the request across services. in: header name: X-Request-Id schema: type: string - description: The unique identifier of the connection. in: path name: connectionId required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/StartExtractionRequest' description: Carga útil de la solicitud de extracción required: true responses: '201': description: Solicitud de extracción creada content: application/json: schema: $ref: '#/components/schemas/ExtractionRequestResponse' '400': description: Solicitud no válida content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: La solicitud no tiene credenciales de autenticación válidas. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: No tiene permiso para acceder a este recurso. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Conexión no encontrada content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Ocurrió un error inesperado en el servidor. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '503': description: El servicio Fetcher no está disponible content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - BearerAuth: [] components: schemas: StartExtractionRequest: description: >- Payload de solicitud para iniciar una extracción de datos desde una conexión descubierta properties: tables: description: >- Tablas de las que se extraerán datos, indexadas por nombre de tabla; se requiere al menos una entrada additionalProperties: $ref: '#/components/schemas/ExtractionTableRequest' minProperties: 1 type: object startDate: description: Inicio del rango de fechas a extraer (RFC 3339) type: string endDate: description: Fin del rango de fechas a extraer (RFC 3339) type: string filters: $ref: '#/components/schemas/ExtractionFilters' required: - tables type: object ExtractionRequestResponse: description: Una solicitud de extracción enviada a Fetcher properties: id: description: Identificador interno de la solicitud de extracción type: string connectionId: description: Conexión a la que se envió esta extracción type: string status: description: Estado actual del ciclo de vida de la extracción type: string ingestionJobId: description: Identificador de trabajo devuelto por Fetcher type: string startDate: description: Inicio del rango de fechas extraído type: string endDate: description: Fin del rango de fechas extraído type: string tables: description: Estado de extracción por tabla additionalProperties: $ref: '#/components/schemas/ExtractionTableResponse' type: object filters: $ref: '#/components/schemas/ExtractionFilters' errorMessage: description: Detalles del error si la extracción falló type: string createdAt: description: Marca de tiempo en que se solicitó la extracción type: string updatedAt: description: Marca de tiempo de la última actualización de estado type: string type: object ErrorResponse: description: Respuesta de error estándar devuelta por todos los endpoints de la API type: object required: - code - title - message properties: code: type: string description: Código de error de aplicación estable. example: MTCH-0001 title: type: string description: Título de error legible por humanos. example: Bad Request message: type: string description: Mensaje de error legible con detalles. example: context not found error: type: string description: >- Obsoleto. Mensaje de error para compatibilidad con versiones anteriores. deprecated: true details: description: Contexto de error adicional como pares clave-valor additionalProperties: {} type: object ExtractionTableRequest: description: >- Selección de columnas para una tabla individual en una solicitud de extracción properties: columns: description: >- Proyección explícita de columnas opcional; cuando está vacía o se omite, se extraen todas las columnas items: type: string type: array type: object ExtractionFilters: description: Filtros opcionales a nivel de fila para una extracción properties: equals: description: >- Pares clave-valor en los que todos los campos especificados deben ser iguales a los valores indicados additionalProperties: type: string type: object type: object ExtractionTableResponse: description: Estado de extracción de una tabla individual properties: columns: description: Columnas incluidas en la extracción items: type: string type: array type: object securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: 'Autenticación con token Bearer (formato: "Bearer {token}")' ````