> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tupana.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar solicitudes de sincronización recientes

> Lista las solicitudes de sincronización de una entidad creadas en las últimas N horas (por defecto 24), ordenadas de la más nueva a la más antigua. Paginación simple con `page` y `page_size`.



## OpenAPI

````yaml api-reference/openapi-v2.json GET /sync-requests/
openapi: 3.0.0
info:
  title: Tupana API — v2
  description: >-
    API v2 de Tupana: facturación electrónica, cesiones, recaudación, consultas,
    boleta de honorarios y nómina. Los identificadores de recursos son public
    IDs opacos con prefijo (docu_, ment_, cred_, doce_, empl_…).
  version: 2.0.0
servers:
  - url: https://api.tupana.ai/v2
    description: Producción (v2)
security:
  - apiKeyAuth: []
paths:
  /sync-requests/:
    get:
      tags:
        - Sincronización
      summary: Listar solicitudes de sincronización recientes
      description: >-
        Lista las solicitudes de sincronización de una entidad creadas en las
        últimas N horas (por defecto 24), ordenadas de la más nueva a la más
        antigua. Paginación simple con `page` y `page_size`.
      operationId: listSyncRequests_v2
      parameters:
        - name: master_entity_id
          in: query
          required: true
          description: ID de la entidad maestra. El public ID de la entidad (`ment_...`).
          schema:
            type: string
            example: ment_4829301923847
        - name: hours
          in: query
          required: false
          description: >-
            Ventana hacia atrás, en horas, sobre la fecha de creación. Por
            defecto 24.
          schema:
            type: integer
            default: 24
            example: 72
        - name: page
          in: query
          required: false
          description: Página a consultar (parte en 1).
          schema:
            type: integer
            default: 1
        - name: page_size
          in: query
          required: false
          description: Tamaño de página. Por defecto 50, máximo 200.
          schema:
            type: integer
            default: 50
            maximum: 200
      responses:
        '200':
          description: Página de solicitudes de sincronización de la entidad
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/SyncRequest'
                  meta:
                    type: object
                    properties:
                      page:
                        type: integer
                        nullable: true
                      page_size:
                        type: integer
                        nullable: true
                      total:
                        type: integer
                      total_pages:
                        type: integer
                        nullable: true
                  links:
                    type: object
                    properties:
                      next:
                        type: string
                        nullable: true
                      prev:
                        type: string
                        nullable: true
              example:
                data:
                  - id: syre_5b6c7d8e9f0a1
                    master_entity_id: ment_4829301923847
                    requested_types:
                      - ISSUED_DOCS
                      - RECEIVED_DOCS
                    status: completed
                    webhook_url: ''
                    results:
                      ISSUED_DOCS:
                        success: true
                        new_documents: 3
                      RECEIVED_DOCS:
                        success: true
                        new_documents: 0
                    completed_at: '2026-07-20T14:34:12Z'
                    created_at: '2026-07-20T14:30:00Z'
                  - id: syre_5b6c7d8e9f0a1
                    master_entity_id: ment_4829301923847
                    requested_types: []
                    status: processing
                    webhook_url: https://miapp.cl/webhooks/tupana-sync
                    results: {}
                    completed_at: null
                    created_at: '2026-07-20T11:02:44Z'
                meta:
                  page: 1
                  page_size: 50
                  total: 2
                  total_pages: null
                links:
                  next: null
                  prev: null
        '400':
          description: >-
            master_entity_id faltante o inválido, o hours/page/page_size no son
            enteros
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: hours debe ser un entero.
        '403':
          description: Sin acceso a la entidad consultada
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    example: No tienes acceso a esta entidad.
      security:
        - apiKeyAuth: []
components:
  schemas:
    SyncRequest:
      type: object
      description: Solicitud de sincronización a demanda (recurso asíncrono)
      properties:
        id:
          type: string
          description: ID de la solicitud public ID (`ment_...`).
          example: ment_4829301923847
        master_entity_id:
          type: string
          description: ID entero de la entidad sincronizada public ID (`ment_...`).
          example: ment_4829301923847
        requested_types:
          type: array
          description: >-
            Tipos de scrape pedidos. Lista vacía = todos los tipos habilitados
            para la entidad.
          items:
            type: string
            enum:
              - ISSUED_DOCS
              - RECEIVED_DOCS
              - RECEIVED_HONORARY_BILLS
              - THIRD_PARTY_HONORARY
              - EMITTED_HONORARY_BILLS
              - PURCHASE_BOOK
              - SALE_BOOK
              - BOOK_SUMMARY
          example:
            - ISSUED_DOCS
            - RECEIVED_DOCS
        status:
          type: string
          enum:
            - pending
            - processing
            - completed
            - failed
          description: >-
            Estado de la solicitud: pending (creada, en cola), processing
            (scrapes corriendo), completed (todos los tipos terminaron OK),
            failed (al menos un tipo falló).
          example: pending
        webhook_url:
          type: string
          description: >-
            URL registrada para notificar al completar. String vacío si no se
            registró webhook.
          example: https://miapp.cl/webhooks/tupana-sync
        results:
          type: object
          description: >-
            Resultado por tipo de scrape al terminar. Las claves son los
            scrape_type ejecutados y cada valor es un objeto con `success`
            (boolean) más contadores como `new_documents`, o `error` si falló.
            Objeto vacío mientras la solicitud está pending/processing.
          additionalProperties:
            type: object
          example:
            ISSUED_DOCS:
              success: true
              new_documents: 3
            RECEIVED_DOCS:
              success: true
              new_documents: 0
        completed_at:
          type: string
          format: date-time
          nullable: true
          description: >-
            Fecha/hora en que terminó de procesarse. null mientras está
            pending/processing.
          example: '2026-07-20T14:34:12Z'
        created_at:
          type: string
          format: date-time
          description: Fecha/hora de creación de la solicitud
          example: '2026-07-20T14:30:00Z'
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        API Key para autenticación. Debe proporcionarse en el header
        Authorization con el formato: 'Api-Key YOUR-API-KEY' (incluye el prefijo
        'Api-Key ' seguido de tu API key)

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.