> ## 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.

# Obtener un job de extracción de datos

> Devuelve un job de extracción de datos por su identificador.



## OpenAPI

````yaml es/openapi/v3-current/connections.yaml get /v1/fetcher/{id}
openapi: 3.1.0
info:
  contact:
    email: contact@lerian.studio
    name: Lerian
    url: https://github.com/LerianStudio/fetcher/discussions
  description: Documentación de la API del componente Fetcher Manager
  license:
    identifier: Elastic-2.0
    name: Elastic License 2.0 (Source Available)
  title: API de Fetcher Manager
  version: 1.0.0
servers: []
security:
  - BearerAuth: []
tags:
  - description: >-
      Operaciones del ciclo de vida y del esquema de las conexiones de base de
      datos.
    name: Connections
  - description: Operaciones heredadas de asignación de conexiones y migración.
    name: Migration
  - description: Operaciones de creación y estado de jobs de extracción de datos.
    name: Fetcher
paths:
  /v1/fetcher/{id}:
    get:
      tags:
        - Fetcher
      summary: Obtener un job de extracción de datos
      description: Devuelve un job de extracción de datos por su identificador.
      operationId: get-fetcher-job
      parameters:
        - description: Identificador del recurso.
          in: path
          name: id
          required: true
          schema:
            description: Identificador del recurso.
            examples:
              - 2f1f35f4-4f50-44f3-a8ab-2772d395f0c2
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobResponse'
          description: OK
        '400':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Solicitud incorrecta
        '401':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: No autorizado
        '403':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Prohibido
        '404':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: No encontrado
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Entidad no procesable
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Error interno del servidor
components:
  schemas:
    JobResponse:
      additionalProperties: false
      properties:
        completedAt:
          description: >-
            Fecha y hora UTC en la que el job de extracción alcanzó un estado
            terminal.
          examples:
            - '2026-07-13T12:05:00Z'
          format: date-time
          type: string
        createdAt:
          description: Fecha y hora UTC de creación del job de extracción.
          examples:
            - '2026-07-13T12:00:00Z'
          format: date-time
          type: string
        filters:
          additionalProperties:
            additionalProperties:
              additionalProperties:
                $ref: '#/components/schemas/FilterCondition'
              type: object
            type: object
          description: Condiciones de filtro aplicadas a la extracción.
          examples:
            - ledger:
                transactions:
                  status:
                    eq:
                      - approved
          type: object
        id:
          description: Identificador único del job de extracción.
          examples:
            - 01980a89-21f0-7d7e-a109-564b5c6f53ac
          type: string
        mappedFields:
          additionalProperties:
            additionalProperties:
              items:
                type: string
              type:
                - array
                - 'null'
            type: object
          description: >-
            Campos solicitados para la extracción, agrupados por fuente de datos
            y tabla.
          examples:
            - ledger:
                transactions:
                  - id
                  - amount
          type: object
        metadata:
          additionalProperties: {}
          description: >-
            Metadatos públicos definidos por quien realiza la llamada y
            almacenados con el job de extracción.
          examples:
            - correlationId: settlement-2026-07-13
              source: payments
          type: object
        requestHash:
          description: >-
            Hash SHA-256 que se usa para detectar solicitudes duplicadas
            idempotentes.
          examples:
            - d7a8fbb307d7809469ca9abcb0082e4f8d5651e46d3cdb762d02d0bf37c9e592
          type: string
        resultHmac:
          description: Código HMAC que se usa para verificar la integridad del resultado.
          examples:
            - 9dc118e1d4efdcf0f45bb646c38c2a02e9c20b0fc2c75c1a9be0fae200bd9f93
          type: string
        resultPath:
          description: Ruta de almacenamiento del resultado de extracción generado.
          examples:
            - >-
              s3://fetcher-results/jobs/01980a89-21f0-7d7e-a109-564b5c6f53ac.json
          type: string
        status:
          description: Estado actual de procesamiento del job de extracción.
          examples:
            - completed
          type: string
      required:
        - id
        - mappedFields
        - status
        - createdAt
      type: object
    Detail:
      additionalProperties: false
      properties:
        code:
          description: >-
            Código de error de dominio estable y legible por máquina, limitado
            al servicio emisor (formato <SERVICE>-NNNN).
          examples:
            - ERR-0001
          type: string
        detail:
          description: >-
            Explicación legible para humanos específica de esta instancia del
            problema.
          examples:
            - La propiedad foo es obligatoria, pero no está presente.
          type: string
        errors:
          description: Lista opcional de detalles individuales de los errores
          items:
            $ref: '#/components/schemas/ErrorDetail'
          type:
            - array
            - 'null'
        instance:
          description: Referencia URI que identifica la instancia específica del problema.
          examples:
            - https://example.com/error-log/abc123
          format: uri
          type: string
        status:
          description: Código de estado HTTP
          examples:
            - 400
          format: int64
          type: integer
        title:
          description: >-
            Resumen breve y legible para humanos del tipo de problema. Este
            valor no debe cambiar entre distintas instancias del error.
          examples:
            - Solicitud incorrecta
          type: string
        type:
          default: about:blank
          description: Referencia URI a documentación legible para humanos sobre el error.
          examples:
            - https://example.com/errors/example
          format: uri
          type: string
      type: object
    FilterCondition:
      additionalProperties: false
      properties:
        between:
          description: Límites inferior y superior inclusivos del campo.
          examples:
            - - 100
              - 1000
          items: {}
          type:
            - array
            - 'null'
        eq:
          description: Valores a los que puede ser igual el campo.
          examples:
            - - active
              - pending
          items: {}
          type:
            - array
            - 'null'
        gt:
          description: Valor único que el campo debe superar.
          examples:
            - - 100
          items: {}
          type:
            - array
            - 'null'
        gte:
          description: Valor único que el campo debe igualar o superar.
          examples:
            - - '2025-06-01'
          items: {}
          type:
            - array
            - 'null'
        in:
          description: Valores con los que puede coincidir el campo.
          examples:
            - - active
              - pending
              - suspended
          items: {}
          type:
            - array
            - 'null'
        like:
          description: Patrón LIKE único con el que debe coincidir el campo.
          examples:
            - - '%active%'
          items: {}
          type:
            - array
            - 'null'
        lt:
          description: Valor único respecto del cual el campo debe ser menor.
          examples:
            - - 1000
          items: {}
          type:
            - array
            - 'null'
        lte:
          description: Valor único respecto del cual el campo debe ser menor o igual.
          examples:
            - - '2025-06-30'
          items: {}
          type:
            - array
            - 'null'
        ne:
          description: Valor único al que el campo no debe ser igual.
          examples:
            - - active
          items: {}
          type:
            - array
            - 'null'
        nin:
          description: Valores con los que el campo no debe coincidir.
          examples:
            - - deleted
              - archived
          items: {}
          type:
            - array
            - 'null'
      type: object
    ErrorDetail:
      additionalProperties: false
      properties:
        location:
          description: >-
            Ubicación donde se produjo el error, por ejemplo,
            'body.items[3].tags' o 'path.thing-id'
          type: string
        message:
          description: Texto del mensaje de error
          type: string
        value:
          description: Valor en la ubicación indicada
      type: object
  securitySchemes:
    BearerAuth:
      bearerFormat: JWT
      description: Token JWT de tipo bearer emitido por el proveedor de identidad.
      scheme: bearer
      type: http

````