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

# Listar cards de CRM

> Lista os cards de uma etapa do funil de CRM com filtro por contato e paginação.



## OpenAPI

````yaml https://api.jurichat.com/docs/client/openapi.json get /funnel-column-card/
openapi: 3.1.0
info:
  title: JuriChat API — Documentação para Integradores
  description: ''
  version: 1.0.0
servers:
  - url: https://api.jurichat.com
    description: Production server
security:
  - apiKeyAuth: []
tags: []
paths:
  /funnel-column-card/:
    get:
      tags:
        - CRM
      summary: Listar cards de CRM
      description: >-
        Lista os cards de uma etapa do funil de CRM com filtro por contato e
        paginação.
      parameters:
        - schema:
            type: string
            pattern: ^[cC][^\s-]{8,}$
          in: query
          name: columnId
          required: true
          description: ID da etapa do funil. Retorna os cards posicionados nessa etapa.
        - schema:
            type: number
            minimum: 1
          in: query
          name: page
          required: false
          description: Número da página (começa em 1). Enviar junto com `limit`.
        - schema:
            type: number
            minimum: 1
            maximum: 100
          in: query
          name: limit
          required: false
          description: 'Quantidade de cards por página. Máximo: 100.'
        - schema:
            type: string
          in: query
          name: search
          required: false
          description: Filtra por nome ou e-mail do contato vinculado ao card.
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: ID do card.
                        channel:
                          type: string
                          nullable: true
                          description: Canal de origem do lead. Null se não informado.
                        columnId:
                          type: string
                          description: ID da etapa do funil onde o card está posicionado.
                        user:
                          type: object
                          properties:
                            id:
                              type: string
                              pattern: ^[cC][^\s-]{8,}$
                              description: ID do usuário responsável.
                            name:
                              type: string
                              nullable: true
                              description: Nome do usuário. Null se não definido.
                            imageUrl:
                              type: string
                              nullable: true
                              description: URL de avatar do usuário. Null se não definido.
                            role:
                              type: string
                              nullable: true
                              description: Papel do usuário. Null se não definido.
                            email:
                              type: string
                              nullable: true
                              description: E-mail do usuário. Null se não definido.
                            document:
                              type: string
                              nullable: true
                              description: Documento do usuário. Null se não informado.
                          required:
                            - id
                            - name
                            - imageUrl
                            - role
                            - email
                            - document
                          additionalProperties: false
                          description: Usuário responsável pelo card.
                        person:
                          type: object
                          properties:
                            id:
                              type: string
                              pattern: ^[cC][^\s-]{8,}$
                              description: ID do contato.
                            name:
                              type: string
                              nullable: true
                              description: Nome do contato. Null se não informado.
                            email:
                              type: string
                              nullable: true
                              description: E-mail do contato. Null se não informado.
                            phone:
                              type: string
                              nullable: true
                              description: Telefone do contato. Null se não informado.
                            imageUrl:
                              type: string
                              nullable: true
                              description: URL de avatar do contato. Null se não definido.
                            createdAt:
                              type: string
                              format: date-time
                              description: Data e hora de criação do contato.
                            updatedAt:
                              type: string
                              format: date-time
                              description: Data e hora da última atualização do contato.
                          required:
                            - id
                            - name
                            - email
                            - phone
                            - imageUrl
                            - createdAt
                            - updatedAt
                          additionalProperties: false
                          description: Contato vinculado ao card.
                        customFields:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                                description: ID do campo personalizado.
                              name:
                                type: string
                                description: Nome do campo personalizado.
                              type:
                                type: string
                                description: Tipo do campo (texto, data, seleção etc.).
                              options:
                                nullable: true
                                description: Opções do campo. Null para campos sem seleção.
                              value:
                                description: Valor preenchido no campo.
                            required:
                              - id
                              - name
                              - type
                            additionalProperties: false
                          description: Campos personalizados do card com seus valores.
                        tags:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                                description: ID da tag.
                              name:
                                type: string
                                description: Nome da tag.
                              color:
                                type: string
                                description: 'Cor da tag (ex.: código hexadecimal).'
                            required:
                              - id
                              - name
                              - color
                            additionalProperties: false
                          description: Tags associadas ao card.
                        createdAt:
                          type: string
                          format: date-time
                          description: Data e hora de criação do card.
                        updatedAt:
                          type: string
                          format: date-time
                          description: Data e hora da última atualização do card.
                      required:
                        - id
                        - channel
                        - columnId
                        - user
                        - person
                        - customFields
                        - tags
                        - createdAt
                        - updatedAt
                      additionalProperties: false
                    description: Cards da página atual.
                  totalResults:
                    type: number
                    description: Total de registros encontrados.
                  totalPages:
                    type: number
                    description: Total de páginas para a quantidade solicitada.
                required:
                  - data
                  - totalResults
                  - totalPages
                additionalProperties: false
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  statusCode:
                    type: number
                  details: {}
                required:
                  - message
                  - statusCode
                additionalProperties: false
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  statusCode:
                    type: number
                  details: {}
                required:
                  - message
                  - statusCode
                additionalProperties: false
      security:
        - apiKeyAuth: []
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-jurichat-api-key
      description: >-
        Chave de API do escritório (criada no painel). Envie o valor no header
        x-jurichat-api-key.

````