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

# Lista os jobs de reprocessamento (histórico por programa)

> Lista os jobs de reprocessamento da organização (histórico), com paginação por cursor. Permite filtrar por programa (`program_id`) e por status (`dry_run`, `executed`, `canceled`).



## OpenAPI

````yaml /openapi.json get /reprocess
openapi: 3.1.0
info:
  title: Repass API
  description: >-
    API pública do Repass — plataforma de gestão de afiliados: programas, links,
    tracking, atribuição, conversões, comissões, payouts, fiscal (BR),
    reprocessamento, event store e webhooks.
  version: 0.1.0
servers:
  - url: https://api.userepass.com
    description: Produção
security:
  - bearerAuth: []
  - apiKeyAuth: []
tags:
  - name: Profile
    description: Perfil do usuário autenticado.
  - name: Guide
    description: >-
      Guia de onboarding do painel: estado de tours, telas visitadas e
      preferências por usuário e organização.
  - name: Portal
    description: >-
      Portal do afiliado: sessão por identidade de afiliado (sem org), convites
      e claim.
  - name: Programs
    description: 'Programas de afiliados: configuração, atribuição, hold e tiers.'
  - name: Commission Rules
    description: Regras de comissão versionadas (imutáveis) por programa.
  - name: Affiliates
    description: 'Ciclo de vida do afiliado: cadastro, aprovação, tier, saldo.'
  - name: Terms
    description: Termos do programa, versionados.
  - name: Materials
    description: >-
      Materiais (criativos) do programa: upload pelo gestor e download pelos
      afiliados.
  - name: Links
    description: Links rastreáveis e domínios de redirecionamento.
  - name: Coupons
    description: Cupons de afiliado e sync com gateway.
  - name: Pagamentos por PIX
    description: Habilitação de pagamentos por PIX (onboarding e documentos).
  - name: Tracking
    description: Endpoints públicos de redirect e registro de cliques.
  - name: Clicks
    description: Consulta de cliques e estatísticas de link.
  - name: Conversions
    description: 'Conversões: ingestão S2S, atribuição, matching, fraude e auditoria.'
  - name: Commissions
    description: Comissões calculadas, holds, aprovação, void e clawback.
  - name: Payouts
    description: Ciclos de pagamento, prévia, execução e comprovantes.
  - name: Invoices
    description: Notas fiscais (PJ), envio e validação (BR).
  - name: Fraud
    description: Fila de revisão e decisões de fraude.
  - name: Reprocess
    description: Reprocessamento com dry-run obrigatório e relatório de impacto.
  - name: Events
    description: Histórico de eventos para auditoria e consulta.
  - name: Notifications
    description: >-
      Notificações ao operador (falhas de sincronização, payouts e afins) —
      registro in-app espelhado por e-mail aos owners/admins.
  - name: Webhooks
    description: Endpoints de webhook, entregas, retries e dead-letter.
  - name: Ingest
    description: Ingestão de eventos de cobrança (S2S e gateways).
  - name: Settings
    description: Configurações por organização (políticas e integrações).
  - name: Billing
    description: 'Plano e cobrança: contadores de uso da organização para o painel.'
  - name: Dashboard
    description: >-
      Métricas agregadas da operação (receita, top afiliados, conversões,
      comissões, novos afiliados) para a home e os relatórios do gestor.
  - name: Health
    description: Liveness do serviço.
paths:
  /reprocess:
    get:
      tags:
        - Reprocessing
      summary: Lista os jobs de reprocessamento (histórico por programa)
      description: >-
        Lista os jobs de reprocessamento da organização (histórico), com
        paginação por cursor. Permite filtrar por programa (`program_id`) e por
        status (`dry_run`, `executed`, `canceled`).
      operationId: listReprocessJobs
      parameters:
        - schema:
            default: 25
            type: integer
            minimum: 1
            maximum: 100
          in: query
          name: limit
          required: false
        - schema:
            type: string
            pattern: ^repr_[0-9A-HJKMNP-TV-Z]{26}$
          in: query
          name: starting_after
          required: false
        - schema:
            type: string
            pattern: ^repr_[0-9A-HJKMNP-TV-Z]{26}$
          in: query
          name: ending_before
          required: false
        - schema:
            type: string
            pattern: ^prog_[0-9A-HJKMNP-TV-Z]{26}$
            example: prog_01J9Z3K8N2QF4T7B9XP0WMD5RC
          in: query
          name: program_id
          required: false
          description: Filtra os jobs por programa.
        - schema:
            type: string
            enum:
              - dry_run
              - executed
              - canceled
            example: dry_run
          in: query
          name: status
          required: false
          description: Filtra por status do job (`dry_run`, `executed` ou `canceled`).
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: >-
                            Identificador único do job de reprocessamento
                            (prefixo `repr_` + ULID).
                          example: repr_01J9Z3K8N2QF4T7B9XP0WMD5RC
                        organizationId:
                          type: string
                          description: Organização dona do job.
                          example: org_01J9Z3K8N2QF4T7B9XP0WMD5RC
                        programId:
                          type: string
                          description: Programa cujas comissões foram reprocessadas.
                          example: prog_01J9Z3K8N2QF4T7B9XP0WMD5RC
                        status:
                          type: string
                          enum:
                            - dry_run
                            - executed
                            - canceled
                          description: Status atual do job.
                          example: dry_run
                        newRuleId:
                          type: string
                          description: Regra de comissão aplicada no recálculo.
                          example: cmrl_01J9Z3K8N2QF4T7B9XP0WMD5RC
                        from:
                          description: Início da janela de reprocessamento (ISO-8601).
                          example: '2026-05-01T00:00:00.000Z'
                          type: string
                          format: date-time
                        to:
                          description: Fim da janela de reprocessamento (ISO-8601).
                          example: '2026-05-31T23:59:59.000Z'
                          type: string
                          format: date-time
                        affiliateIds:
                          anyOf:
                            - type: array
                              items:
                                type: string
                                example: aff_01J9Z3K8N2QF4T7B9XP0WMD5RC
                            - type: 'null'
                          description: >-
                            Afiliados aos quais o reprocessamento foi restrito.
                            `null` quando abrange todos os afiliados do
                            programa.
                        summary:
                          type: object
                          properties:
                            conversionsAffected:
                              type: integer
                              minimum: -9007199254740991
                              maximum: 9007199254740991
                              description: >-
                                Quantidade de conversões abrangidas pela janela
                                do reprocessamento.
                              example: 42
                            commissionsRecalculated:
                              type: integer
                              minimum: -9007199254740991
                              maximum: 9007199254740991
                              description: Quantidade de comissões recalculadas in loco.
                              example: 38
                            adjustmentsPlanned:
                              type: integer
                              minimum: -9007199254740991
                              maximum: 9007199254740991
                              description: >-
                                Quantidade de comissões de ajuste a serem
                                criadas (para comissões já pagas/travadas).
                              example: 4
                            blockedCount:
                              type: integer
                              minimum: -9007199254740991
                              maximum: 9007199254740991
                              description: >-
                                Quantidade de itens que não puderam ser
                                reprocessados.
                              example: 0
                            unchangedCount:
                              type: integer
                              minimum: -9007199254740991
                              maximum: 9007199254740991
                              description: >-
                                Quantidade de comissões sem alteração de valor
                                após o recálculo.
                              example: 12
                            affiliatesImpacted:
                              type: integer
                              minimum: -9007199254740991
                              maximum: 9007199254740991
                              description: >-
                                Quantidade de afiliados distintos impactados
                                pelo reprocessamento.
                              example: 7
                            deltaTotalCents:
                              type: integer
                              minimum: -9007199254740991
                              maximum: 9007199254740991
                              description: >-
                                Variação líquida total do reprocessamento, em
                                centavos (positivo: aumento; negativo: redução).
                                Comparado ao limite que dispara a dupla
                                confirmação na execução. Ex.: 1990 = R$19,90.
                              example: 152900
                            topVariations:
                              type: array
                              items:
                                type: object
                                properties:
                                  affiliateId:
                                    type: string
                                    description: >-
                                      Afiliado com maior variação de valor no
                                      reprocessamento.
                                    example: aff_01J9Z3K8N2QF4T7B9XP0WMD5RC
                                  deltaCents:
                                    type: integer
                                    minimum: -9007199254740991
                                    maximum: 9007199254740991
                                    description: >-
                                      Variação total para o afiliado, em
                                      centavos (positivo: ganho; negativo:
                                      estorno). Ex.: 1990 = R$19,90.
                                    example: 1990
                                required:
                                  - affiliateId
                                  - deltaCents
                                additionalProperties: false
                              description: >-
                                Maiores variações de valor por afiliado (ranking
                                de impacto).
                          required:
                            - conversionsAffected
                            - commissionsRecalculated
                            - adjustmentsPlanned
                            - blockedCount
                            - unchangedCount
                            - affiliatesImpacted
                            - deltaTotalCents
                            - topVariations
                          additionalProperties: false
                          description: Relatório de impacto do reprocessamento.
                        confirmationToken:
                          type: string
                          description: >-
                            Token da dupla confirmação. Presente apenas enquanto
                            o job está em `dry_run`; usado na execução do job
                            quando o impacto excede o limite configurado nas
                            suas preferências de reprocessamento.
                          example: rcft_01J9Z3K8N2QF4T7B9XP0WMD5RC
                        confirmationRequired:
                          type: boolean
                          description: >-
                            Indica se a execução exigirá `confirmationToken` por
                            ultrapassar o limite de impacto configurado nas suas
                            preferências de reprocessamento.
                          example: true
                        createdBy:
                          type: string
                          description: Usuário que criou o job.
                          example: user_01J9Z3K8N2QF4T7B9XP0WMD5RC
                        executedAt:
                          anyOf:
                            - type: string
                              format: date-time
                            - type: 'null'
                          description: >-
                            Momento em que o job foi executado (ISO-8601).
                            `null` enquanto não executado.
                          example: '2026-06-13T12:00:00.000Z'
                        canceledAt:
                          anyOf:
                            - type: string
                              format: date-time
                            - type: 'null'
                          description: >-
                            Momento em que o job foi cancelado (ISO-8601).
                            `null` quando não cancelado.
                          example: '2026-06-13T12:00:00.000Z'
                        createdAt:
                          description: Data de criação do job (ISO-8601).
                          example: '2026-06-13T12:00:00.000Z'
                          type: string
                          format: date-time
                        updatedAt:
                          description: Data da última atualização do job (ISO-8601).
                          example: '2026-06-13T12:00:00.000Z'
                          type: string
                          format: date-time
                      required:
                        - id
                        - organizationId
                        - programId
                        - status
                        - newRuleId
                        - from
                        - to
                        - affiliateIds
                        - summary
                        - confirmationRequired
                        - createdBy
                        - executedAt
                        - canceledAt
                        - createdAt
                        - updatedAt
                      additionalProperties: false
                  hasMore:
                    type: boolean
                  nextCursor:
                    anyOf:
                      - type: string
                      - type: 'null'
                    description: Cursor da próxima página (use em starting_after).
                  previousCursor:
                    anyOf:
                      - type: string
                      - type: 'null'
                    description: Cursor da página anterior (use em ending_before).
                required:
                  - data
                  - hasMore
                  - nextCursor
                  - previousCursor
                additionalProperties: false
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Chave de API (prefixo `rstr_`) enviada como `Authorization: Bearer
        rstr_...`.
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Chave de API (prefixo `rstr_`) enviada no header `x-api-key`.

````