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

# Exportar deals

> Exporta os deals do seu workspace, página a página, com contato, dono, status e título.

Exporta os deals do seu workspace, paginados por cursor.

* **Carga completa (pontual):** chame sem `updated_since` para trazer todos os deals.
* **Incremental:** informe `updated_since` (ISO 8601) para trazer apenas o que mudou desde então.

Pagine passando o `next_cursor` da resposta como `cursor` na chamada seguinte, até ele voltar `null`. Grave as linhas com **upsert por `id`** — a mesma linha pode reaparecer entre pulls (semântica CDC).

O significado de cada campo retornado está detalhado na seção **Response** abaixo.


## OpenAPI

````yaml GET /v1/export/deals
openapi: 3.1.0
info:
  title: Morada Data Export API
  version: 1.0.0
  description: >-
    Exportação incremental das conversas, mensagens, contatos e deals do seu
    workspace na Morada.ai, além de relatórios operacionais em nível de linha e
    analytics agregado (componentes aditivos) que reproduzem os dashboards da
    plataforma.
servers:
  - url: https://data-api.morada.ai
    description: Produção
security:
  - workspaceApiKey: []
tags:
  - name: Exportação
    description: Exportação incremental de entidades do workspace.
  - name: Relatórios
    description: >-
      Relatórios operacionais em nível de linha, com janela de tempo
      obrigatória.
  - name: Analytics
    description: >-
      Agregações aditivas prontas para BI, reproduzindo os dashboards da
      plataforma.
paths:
  /v1/export/deals:
    get:
      tags:
        - export
      summary: Exportar deals
      description: >-
        Exporta os deals do seu workspace, página a página, com contato, dono,
        status e título.
      parameters:
        - in: query
          name: updated_since
          required: false
          description: >-
            Timestamp ISO 8601. Marca-d'água incremental: retorna apenas o que
            mudou desde então. Omita para uma exportação completa.
          schema:
            type: string
            format: date-time
        - in: query
          name: cursor
          required: false
          description: >-
            Cursor opaco de paginação, conforme retornado em `next_cursor` na
            página anterior.
          schema:
            type: string
        - in: query
          name: limit
          required: false
          description: >-
            Máximo de linhas por página (1 a 1000, padrão 100). Valores fora do
            intervalo são ajustados, não rejeitados.
          schema:
            type: integer
            default: 100
            minimum: 1
            maximum: 1000
      responses:
        '200':
          description: Página de dados.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    description: Linhas desta página.
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Id estável da linha; faça upsert por esta chave.
                        workspace_id:
                          type: string
                          description: Seu workspace (partner).
                        cursor_at:
                          type: string
                          format: date-time
                          description: >-
                            Marca de mudança usada na paginação; avance
                            `updated_since` para o maior valor visto.
                        person_id:
                          type:
                            - string
                            - 'null'
                          description: Contato a que o deal pertence.
                        agent_id:
                          type:
                            - integer
                            - 'null'
                          description: Agente que originou o deal.
                        owner_id:
                          type:
                            - string
                            - 'null'
                          description: Usuário dono do deal.
                        status:
                          type:
                            - string
                            - 'null'
                          description: Status do deal.
                        title:
                          type:
                            - string
                            - 'null'
                          description: Título do deal.
                        props:
                          type: object
                          additionalProperties: true
                          description: Atributos extras do deal.
                      required:
                        - id
                        - workspace_id
                        - cursor_at
                  next_cursor:
                    type:
                      - string
                      - 'null'
                    description: >-
                      Cursor da próxima página; `null` quando não há mais
                      páginas.
                  count:
                    type: integer
                    description: Número de linhas nesta página.
                required:
                  - data
                  - next_cursor
                  - count
        '400':
          description: '`cursor` ou `updated_since` inválido.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Erro'
        '401':
          description: Chave de acesso ausente ou inválida.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Erro'
        '404':
          description: Entidade desconhecida em `{entity}`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Erro'
components:
  schemas:
    Erro:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          description: Descrição do erro.
  securitySchemes:
    workspaceApiKey:
      type: http
      scheme: bearer
      description: >-
        Workspace API key no formato `mk_...`, gerada na plataforma em
        **Integrações → Configurar API**.

````