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

# Listar processos retornados

> Lista paginada (até 100 por página) dos processos materializados por uma busca find concluída. Requer request_id de uma busca com status completed.



## OpenAPI

````yaml openapi/miner.yaml GET /responses
openapi: 3.0.3
info:
  title: Judit Miner API — Requests, responses & tribunals
  description: >
    OpenAPI description for miner API routes that manage lawsuit search
    **requests**

    (count, create, status), paginated **responses** (lawsuit results), and the

    **tribunals** reference list (ids used in request filters).


    - `company_id` and `user_id` are **not** sent by the client on `POST
    /requests/create`;
      the server fills them from the authenticated session.
    - On `POST /requests/count`, the server merges `company_id` and `user_id`
    from context
      first; clients should send only filter fields (see request body schema).
    - Request and response bodies use **JSON**. Date-time fields are ISO 8601
    strings.

    - Count/create bodies are validated with a **strict** object (unknown keys
    are rejected).


    Authentication and `miner_enabled` behavior are enforced by
    `@judit-io/server`

    (e.g. JWT / gateway); this spec requires an API key provided in the
    `api-key` header.
  version: 1.0.0
servers:
  - url: https://miner.production.judit.io
    description: Production server
security:
  - ApiKeyAuth: []
tags:
  - name: Requests
    description: Create and inspect lawsuit search requests
  - name: Responses
    description: Paginated lawsuit results for a completed find request
  - name: Tribunals
    description: Reference data for tribunal identifiers used in filters
paths:
  /responses:
    get:
      tags:
        - Responses
      summary: List lawsuit responses for a completed find request
      description: >
        Returns a paginated list of **full lawsuit** objects for the given
        `request_id`,

        scoped to the authenticated company.


        Preconditions enforced by the API:

        - Request must exist (**404** `REQUEST_NOT_FOUND`).

        - Request status must be **completed** (**422**
        `REQUEST_NOT_COMPLETED`).

        - Request type must be **find** (**422** `INVALID_REQUEST_TYPE`).


        `request_id` may be supplied in the query string; the implementation
        also

        reads `request_id` from the body if your client sends one (non-standard
        for GET).
      operationId: getResponses
      parameters:
        - name: request_id
          in: query
          required: true
          schema:
            type: integer
            format: int64
            minimum: 1
        - name: page
          in: query
          required: false
          description: Page number (default 1)
          schema:
            type: integer
            minimum: 1
            default: 1
        - name: page_size
          in: query
          required: false
          description: Page size (default 10, max 100)
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 10
      responses:
        '200':
          description: Paginated lawsuits linked to the request’s responses
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FindManyResponsesSuccess'
        '400':
          $ref: '#/components/responses/BadRequest'
        '404':
          description: Request not found for company
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorPayload'
        '422':
          description: Business rule violation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorPayload'
components:
  schemas:
    FindManyResponsesSuccess:
      type: object
      required:
        - data
        - page
        - page_size
        - total
        - total_pages
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/LawsuitRepositoryOutput'
        page:
          type: integer
          minimum: 1
        page_size:
          type: integer
          minimum: 1
        total:
          type: integer
          minimum: 0
        total_pages:
          type: integer
          minimum: 0
    ErrorPayload:
      type: object
      description: >
        Shape depends on `@judit-io/server` error serialization; typically
        includes

        machine-readable codes or message lists. Treat as opaque unless you
        confirm

        against your gateway.
      additionalProperties: true
      properties:
        errors:
          type: array
          items:
            type: string
    LawsuitRepositoryOutput:
      type: object
      description: >
        Full lawsuit graph returned by the lawsuit repository with
        `load_full_lawsuit: true`

        (parties, lawyers, steps, courts, metadata, etc.), omitting internal
        crawler fields.

        This schema is intentionally open; see `Lawsuit` /
        `LawsuitRepositoryOutput` in

        `@judit-io/miner-shared` and `@judit-io/entities` for the canonical
        shape.
      additionalProperties: true
      properties:
        lawsuit_id:
          type: integer
        tribunal_id:
          type: integer
        base:
          type: number
        kind:
          $ref: '#/components/schemas/LawsuitKind'
        code:
          type: string
        instance:
          type: integer
        name:
          type: string
        amount:
          type: number
        is_enriched:
          type: boolean
        favorites:
          type: object
          additionalProperties:
            type: boolean
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
    LawsuitKind:
      type: string
      enum:
        - judgement-bond
        - sentence-execution
  responses:
    BadRequest:
      description: Validation failed (Zod); `errors` is a list of human-readable messages.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorPayload'
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: api-key
      description: >-
        Replace with the actual API key requirement for your Miner API
        deployment.

````