> ## Documentation Index > Fetch the complete documentation index at: https://docs.ziala.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Listar valores de campos > Lista os valores dos campos personalizados dos contatos em formato longo: uma linha por contato e campo. As definições dos campos estão em `/v1/fields`. ## OpenAPI ````yaml https://api.ziala.com.br/v1/openapi.json get /v1/contact_fields openapi: 3.0.0 info: title: API de dados da Ziala description: >- Leitura dos dados da sua conta (contatos, campos, conversas com origem de anúncio, mudanças de etapa e exclusões) para painéis e plataformas de dados. version: '1' contact: name: Suporte Ziala url: https://ziala.com.br email: contato@ziala.com.br servers: - url: https://api.ziala.com.br security: [] tags: - name: Conta description: A conta e os limites da chave. - name: Contatos description: Contatos e os valores dos campos personalizados. - name: Conversas description: Conversas, com origem e métricas. - name: Funis description: Etapas dos funis e o histórico de mudanças de etapa. - name: Campos description: Definições dos campos personalizados. - name: Exclusões description: Registros apagados, para replicar a exclusão. paths: /v1/contact_fields: get: tags: - Contatos summary: Listar valores de campos description: >- Lista os valores dos campos personalizados dos contatos em formato longo: uma linha por contato e campo. As definições dos campos estão em `/v1/fields`. operationId: listContactFields parameters: - name: updated_since required: false in: query schema: type: string description: >- Retorna só registros criados ou alterados a partir deste instante: data e hora ISO 8601 com fuso, ou só a data (`AAAA-MM-DD`, meia-noite UTC). A busca recua 5 minutos para cobrir diferenças de relógio, então grave pela chave primária (`contact_id` + `field_key`). - name: cursor required: false in: query schema: type: string description: Valor de `next_cursor` da página anterior. - name: limit required: false in: query schema: type: integer minimum: 1 maximum: 200 default: 100 description: Itens por página. responses: '200': headers: RateLimit-Limit: description: Requisições permitidas por minuto para a chave. schema: type: integer RateLimit-Remaining: description: Requisições restantes no minuto. schema: type: integer RateLimit-Reset: description: Segundos até o minuto reiniciar. schema: type: integer description: Página de valores. content: application/json: schema: type: object required: - data - next_cursor - has_more - sync_watermark properties: data: type: array items: type: object required: - contact_id - field_key - value - updated_at properties: contact_id: type: string nullable: false description: Identificador do contato. example: 3f6c2a9e-8b1d-4c7e-9a52-1e0d6b7f4a10 field_key: type: string nullable: false description: Chave do campo. Definições em `/v1/fields`. example: segmento value: oneOf: - type: string - type: number - type: boolean nullable: true description: >- Valor do campo: texto, número ou booleano. Listas e objetos vêm serializados como texto JSON. example: Varejo updated_at: type: string format: date-time nullable: false description: Data da última alteração. example: '2026-10-13T14:31:02.000Z' next_cursor: type: string nullable: true example: >- eyJ0IjoiM2Y2YzJhOWUiLCJ0cyI6IjIwMjYtMTEtMDNUMTQ6MzE6MDIuMDAwWiJ9 description: >- Cursor da próxima página, para enviar em `cursor`. `null` na última página. has_more: type: boolean example: true description: '`true` se há mais páginas.' sync_watermark: type: string format: date-time example: '2026-10-13T14:29:00.000Z' description: >- Instante até o qual esta leitura está completa, igual em todas as páginas. Envie como `updated_since` na próxima sincronização. '400': description: Parâmetro inválido, ou cursor alterado ou de outra conta. content: application/problem+json: schema: type: object required: - type - title - status - detail - request_id properties: type: type: string example: about:blank description: Sempre `about:blank`. title: type: string example: Requisição inválida description: Resumo do erro, fixo por status. status: type: integer example: 400 description: Status HTTP. detail: type: string example: limit deve ser um número inteiro de 1 a 200. description: Explicação desta ocorrência. request_id: type: string example: req-3f2a description: Identificador da requisição, para o suporte. '401': description: Chave ausente, inválida ou revogada. content: application/problem+json: schema: type: object required: - type - title - status - detail - request_id properties: type: type: string example: about:blank description: Sempre `about:blank`. title: type: string example: Requisição inválida description: Resumo do erro, fixo por status. status: type: integer example: 400 description: Status HTTP. detail: type: string example: limit deve ser um número inteiro de 1 a 200. description: Explicação desta ocorrência. request_id: type: string example: req-3f2a description: Identificador da requisição, para o suporte. '403': description: API de dados desligada na conta, ou plano sem acesso. content: application/problem+json: schema: type: object required: - type - title - status - detail - request_id properties: type: type: string example: about:blank description: Sempre `about:blank`. title: type: string example: Requisição inválida description: Resumo do erro, fixo por status. status: type: integer example: 400 description: Status HTTP. detail: type: string example: limit deve ser um número inteiro de 1 a 200. description: Explicação desta ocorrência. request_id: type: string example: req-3f2a description: Identificador da requisição, para o suporte. '429': description: >- Limite de requisições atingido (por minuto, por dia ou simultâneas). Aguarde o `Retry-After`. headers: Retry-After: description: Segundos a aguardar antes de repetir a requisição. schema: type: integer RateLimit-Limit: description: Requisições permitidas por minuto para a chave. schema: type: integer RateLimit-Remaining: description: Requisições restantes no minuto. schema: type: integer RateLimit-Reset: description: Segundos até o minuto reiniciar. schema: type: integer content: application/problem+json: schema: type: object required: - type - title - status - detail - request_id properties: type: type: string example: about:blank description: Sempre `about:blank`. title: type: string example: Requisição inválida description: Resumo do erro, fixo por status. status: type: integer example: 400 description: Status HTTP. detail: type: string example: limit deve ser um número inteiro de 1 a 200. description: Explicação desta ocorrência. request_id: type: string example: req-3f2a description: Identificador da requisição, para o suporte. '500': description: Erro inesperado. Repita com espera crescente. content: application/problem+json: schema: type: object required: - type - title - status - detail - request_id properties: type: type: string example: about:blank description: Sempre `about:blank`. title: type: string example: Requisição inválida description: Resumo do erro, fixo por status. status: type: integer example: 400 description: Status HTTP. detail: type: string example: limit deve ser um número inteiro de 1 a 200. description: Explicação desta ocorrência. request_id: type: string example: req-3f2a description: Identificador da requisição, para o suporte. '503': description: Serviço temporariamente indisponível. Aguarde o `Retry-After`. headers: Retry-After: description: Segundos a aguardar antes de repetir a requisição. schema: type: integer RateLimit-Limit: description: Requisições permitidas por minuto para a chave. schema: type: integer RateLimit-Remaining: description: Requisições restantes no minuto. schema: type: integer RateLimit-Reset: description: Segundos até o minuto reiniciar. schema: type: integer content: application/problem+json: schema: type: object required: - type - title - status - detail - request_id properties: type: type: string example: about:blank description: Sempre `about:blank`. title: type: string example: Requisição inválida description: Resumo do erro, fixo por status. status: type: integer example: 400 description: Status HTTP. detail: type: string example: limit deve ser um número inteiro de 1 a 200. description: Explicação desta ocorrência. request_id: type: string example: req-3f2a description: Identificador da requisição, para o suporte. security: - bearer: [] components: securitySchemes: bearer: scheme: bearer bearerFormat: zk_live_… type: http description: Chave da API da conta, no formato `zk_live_…`. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.