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

# Listar respostas da publicação

> Lista, com [paginação](https://docs.olie.ai/api-reference/general/pagination), as respostas recebidas pela publicação, com o valor de cada campo e o projeto criado a partir da resposta, quando houver. Só entram respostas do formulário atualmente publicado.



## OpenAPI

````yaml /api-reference/openapi.json get /api/management/form-publications/{form_publication}/responses
openapi: 3.0.0
info:
  title: Olie API
  version: 1.0.0
  description: >
    # Introdução 👋


    Olá! Esta é a documentação oficial da API da [olie.ai](https://olie.ai/).
    Aqui você encontra as referências e exemplos de uso dos nossos endpoints.


    Para uma visão completa, recomendamos fortemente que você leia a
    [documentação oficial](https://docs.olie.ai/api-reference/introduction). Lá
    estão detalhados tópicos essenciais como
    [autenticação](https://docs.olie.ai/api-reference/introduction/authentication),
    [estrutura de
    respostas](https://docs.olie.ai/api-reference/general/response-structure),
    [paginação](https://docs.olie.ai/api-reference/general/pagination) e outros
    guias de integração.


    No Postman, esta coleção foca nas informações específicas de cada requisição
    (endpoints, parâmetros e exemplos), servindo como apoio rápido para testes e
    desenvolvimento.
servers:
  - url: https://api.olie.ai
security:
  - BearerAuth: []
paths:
  /api/management/form-publications/{form_publication}/responses:
    parameters:
      - name: form_publication
        in: path
        required: true
        description: ID (UUID) da publicação de formulário.
        schema:
          type: string
          example: ''
        example: ''
    get:
      tags:
        - form-publications
        - responses
      summary: Listar respostas da publicação
      description: >-
        Lista, com
        [paginação](https://docs.olie.ai/api-reference/general/pagination), as
        respostas recebidas pela publicação, com o valor de cada campo e o
        projeto criado a partir da resposta, quando houver. Só entram respostas
        do formulário atualmente publicado.
      operationId: obterRespostasDeUmaPublicaODeFormulRio
      parameters:
        - name: page
          in: query
          description: 'Página a retornar. Padrão: 1.'
          schema:
            type: string
          example: ''
        - name: perPage
          in: query
          description: 'Itens por página. Padrão: 30; máximo: 100.'
          schema:
            type: string
          example: ''
      responses:
        '200':
          description: Sucesso
          content:
            application/json:
              schema:
                type: object
                description: Respostas da publicação, paginadas.
                properties:
                  responses:
                    type: array
                    description: Respostas recebidas, uma por envio do formulário.
                    items:
                      type: object
                      description: Resposta recebida.
                      properties:
                        id:
                          type: string
                          description: ID da resposta.
                          format: uuid
                        form_publication_id:
                          type: string
                          description: ID da publicação que recebeu a resposta.
                          format: uuid
                        form_id:
                          type: integer
                          description: ID do formulário respondido.
                        frame_id:
                          type: string
                          description: ID da conta dona da resposta.
                          format: uuid
                        created_at:
                          type: string
                          description: Data do envio.
                          format: date-time
                        updated_at:
                          type: string
                          description: Data da última alteração.
                          format: date-time
                        deleted_at:
                          type: string
                          description: Data de exclusão. Nulo quando ativa.
                          format: date-time
                          nullable: true
                        project_id:
                          type: string
                          description: >-
                            ID do projeto criado a partir da resposta. Nulo
                            quando a publicação não cria projeto.
                          format: uuid
                          nullable: true
                        answered_by:
                          type: string
                          description: >-
                            ID do usuário que respondeu. Nulo em respostas de
                            link público.
                          format: uuid
                          nullable: true
                        form_answers:
                          type: array
                          description: Valores respondidos em cada campo.
                          items:
                            type: object
                            description: Resposta de um campo.
                            properties:
                              id:
                                type: integer
                                description: ID do campo respondido.
                              label:
                                type: string
                                description: Rótulo do campo.
                              answer:
                                description: >-
                                  Valor respondido, no formato do tipo do campo
                                  (telefone normalizado em E.164).
                                nullable: true
                                anyOf:
                                  - type: string
                                  - type: number
                                  - type: boolean
                                  - type: array
                                    items: {}
                                  - type: object
                              model:
                                type: string
                                description: >-
                                  Onde a resposta está gravada. Sempre
                                  FormPublicationResponse.
                              answered_by:
                                type: string
                                description: >-
                                  ID do usuário que respondeu. Nulo em respostas
                                  de link público.
                                format: uuid
                                nullable: true
                              updated_at:
                                type: string
                                description: Data da última alteração da resposta.
                                format: date-time
                        project:
                          type: object
                          description: >-
                            Projeto criado a partir da resposta. Nulo quando não
                            houve criação.
                          nullable: true
                  meta:
                    type: object
                    description: Metadados de paginação.
                    properties:
                      current_page:
                        type: integer
                        description: Página atual.
                      from:
                        type: integer
                        description: Posição do primeiro item da página.
                        nullable: true
                      last_page:
                        type: integer
                        description: Última página disponível.
                      per_page:
                        type: integer
                        description: Itens por página.
                      to:
                        type: integer
                        description: Posição do último item da página.
                        nullable: true
                      total:
                        type: integer
                        description: Total de respostas.
                  response:
                    type: boolean
                    description: >-
                      Indicador de sucesso da requisição. Sempre true nas
                      respostas bem-sucedidas.
              example:
                responses:
                  - id: 01a0cb23-1552-717d-9e9a-5ace17d75b48
                    form_publication_id: 01a0cb22-5af9-7290-a243-736378cb5350
                    form_id: 70
                    frame_id: 01a0252b-d865-71af-a0a2-d4e168d1ffe5
                    created_at: '2026-09-22T22:01:09.000000Z'
                    updated_at: '2026-09-22T22:01:09.000000Z'
                    deleted_at: null
                    project_id: null
                    answered_by: null
                    form_answers:
                      - id: 115
                        label: Nome completo
                        answer: Ana Souza
                        model: FormPublicationResponse
                        answered_by: null
                        updated_at: '2026-09-22T22:01:09.000000Z'
                      - id: 116
                        label: E-mail
                        answer: ana.souza@exemplo.com.br
                        model: FormPublicationResponse
                        answered_by: null
                        updated_at: '2026-09-22T22:01:09.000000Z'
                      - id: 117
                        label: Telefone
                        answer: '+5511999998888'
                        model: FormPublicationResponse
                        answered_by: null
                        updated_at: '2026-09-22T22:01:09.000000Z'
                      - id: 118
                        label: Como conheceu o evento
                        answer: Indicação
                        model: FormPublicationResponse
                        answered_by: null
                        updated_at: '2026-09-22T22:01:09.000000Z'
                    project: null
                meta:
                  current_page: 1
                  from: 1
                  last_page: 1
                  per_page: 30
                  to: 1
                  total: 1
                response: true
        '404':
          description: Não encontrado
          content:
            application/json:
              schema:
                type: object
                description: Resposta de erro.
                properties:
                  response:
                    type: boolean
                    description: Indicador de sucesso da requisição. Sempre false em erros.
                  message:
                    type: string
                    description: >-
                      Código do erro para tratamento no cliente:
                      form_publication_model_not_found (publicação inexistente
                      ou de outra conta).
                  error:
                    type: string
                    description: Descrição legível do erro.
              example:
                response: false
                message: form_publication_model_not_found
                error: No query results for model [App\Models\FormPublication].
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````