---
title: "Listar propostas da negociação"
method: GET
path: "/deals/{deal_id}/proposals"
tags: ["crm-v2-proposals"]
---

# Listar propostas da negociação

`GET /deals/{deal_id}/proposals`

Lista as propostas comerciais de uma negociação.

## Filtro

Propriedades disponíveis para filtro usando [RDQL](crm-v2-rdql-filtering).

| Propriedade | Tipo | Descrição |
| :--- | :--- | :--- |
| `status` | `String` | Filtra por status da proposta (`active` ou `inactive`). |
| `token` | `String` | Filtra pelo token público da proposta. |
| `approval_status` | `String` | Filtra por status de aprovação (`pending` ou `approved`). |
| `created_at` | `DateTime` | Filtra pela data de criação. |

## Ordenação

Propriedades disponíveis para [ordenação](crm-v2-introduction#ordenação).

* `status`
* `created_at`

## Path parameters

- `deal_id` string, required

## Query parameters

- `filter` string
- `sort` object
- `page` object
  - `number` integer — Número da página.
  - `size` integer — Tamanho da página.

## Response `200`

OK

- object
  - `data` object[] — Lista de recursos relacionados.
    - `id` string — Identificador único da proposta.
    - `status` 'active' | 'inactive' — Status da proposta. Valores: `active`, `inactive`.
    - `approval_status` 'pending' | 'approved' — Status de aprovação. Valores: `pending`, `approved`.
    - `approved_at` string, date-time — Data em que a proposta foi aprovada.
    - `token` string — Token público de acesso à proposta (compartilhamento).
    - `total` number, float — Valor total da proposta (alinhado ao total da negociação no momento da criação).
    - `sections` ProposalSection[] — Seções persistidas da proposta.
      - `id` string — Identificador da seção, quando persistido.
      - `slug` string — Slug da seção no modelo.
      - `type` 'html' | 'products_list' — Tipo da seção.
      - `value` string — Conteúdo da seção (ex. HTML para tipo `html`; sanitizado no servidor quando aplicável).
      - `order` integer — Ordem de exibição da seção.
      - `lock` boolean — Indica se a seção está bloqueada para edição.
      - `properties` ProposalSectionProperties — Propriedades da seção. Para `html`, use `layout` com espaçamento vertical. Para `products_list`, use `columns` (lista de colunas) e, opcionalmente, `layout`.
        - `layout` ProposalSectionLayoutProperties — Configuração de layout vertical da seção.
          - `padding_top` integer — Espaçamento superior da seção, em pixels.
          - `padding_bottom` integer — Espaçamento inferior da seção, em pixels.
        - `columns` ProposalSectionProductsListColumn[] — Colunas da tabela de produtos (apenas para seções `products_list`).
          - `entity` string, required — Entidade de origem do campo (`product` ou `deal_product`).
          - `field_type` string, required — Tipo do campo (`default` ou `custom`).
          - `identifier` string, required — Identificador do campo na entidade.
    - `deal_id` string — ID da negociação associada.
    - `proposal_template_id` string — ID do modelo de proposta utilizado na criação.
    - `created_by_id` string — ID do usuário que criou a proposta.
    - `created_at` string, date-time — Data de criação da proposta.
    - `updated_at` string, date-time — Data de atualização da proposta.
  - `links` object — Links de navegação da paginação.
    - `first` string, uri — Link para a primeira página.
    - `prev` string, uri — Link para a página anterior.
    - `self` string, uri — Link para a página atual.
    - `next` string, uri — Link para a próxima página.
    - `last` string, uri — Link para a última página.

## Other responses

- `400` — A requisição está malformada e não consegue ser processada.
- `401` — O token da API está ausente ou inválido.
- `403` — O token não tem permissão para acessar o recurso solicitado.
- `404` — O recurso solicitado não existe.
- `429` — O limite de requisições foi excedido.
- `500` — Internal Server Error

---

[API](https://skmtc.net/rdstation/apis/webhook-service.md) · [All operations](https://skmtc.net/rdstation/apis/webhook-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rdstation/webhook-service/revisions/3867c21388e8/schema)