---
title: "GET /deals/{id}"
method: GET
path: "/deals/{id}"
tags: ["deals"]
---

# GET /deals/{id}

`GET /deals/{id}`

Get an specific deal by ID.

## Path parameters

- `id` integer, required

## Query parameters

- `withCustomFields` boolean

## Response `200`

OK

- object
  - `data` DealEntity
    - `id` integer — Deal ID.
    - `parentDealId` integer — Parent deal ID.
    - `accountId` integer — Account ID.
    - `organization` object — Related organization info.
      - `id` string — Organization ID.
      - `name` string — Display name (Nome fantasia).
      - `email` string — Contact email.
    - `person` object — Related person info.
      - `id` integer — Person ID.
      - `name` string — Person name.
      - `email` string, email — Email address.
    - `author` object — User that created this deal.
      - `accountId` integer — Account ID.
      - `id` integer — User ID.
      - `name` string — User name.
    - `dealStage` object — Stage that this deal is currently in.
      - `id` integer — Deal stage ID.
      - `name` string — Deal stage name.
      - `sequence` integer — Sequence number.
      - `funnel` object — Related funnel info.
        - `id` integer — Funnel ID.
        - `name` string — Funnel name.
    - `dealStatus` object — Status that this deal is in.
      - `id` 1 | 2 | 3 — Deal status ID.
      - `name` 'Em andamento' | 'Ganho' | 'Perdido' — Deal status name
    - `lossReason` object — Deal's loss reason information.
      - `id` integer — Loss reason ID.
      - `name` string — Loss reason name.
      - `description` string — Specific description of this deal's loss reason.
    - `owner` object — User that currently owns this deal.
      - `accountId` integer — Account ID.
      - `id` integer — User ID.
      - `name` string — User name.
    - `title` string — Deal title.
    - `description` string — Deal description.
    - `startTime` unknown
    - `endTime` unknown
    - `wonAt` unknown
    - `lostAt` unknown
    - `createdAt` unknown
    - `updatedAt` unknown
    - `ranking` 0 | 1 | 2 | 3 | 4 | 5 — Numeric ranking.
    - `value` number, float — Monetary value.
    - `products` ProductEntity[] — Associated products.
      - `id` integer — Product ID.
      - `name` string — Product name.
      - `code` string — Product code.
      - `categoryId` integer — Product category id.
      - `price` number, double — Product price.
      - `active` boolean — Product active.
      - `createdAt` unknown
    - `products_entities` EntityProductEntity[] — Associated products with deal-specific pricing details.
      - `id` integer — Product ID.
      - `createdAt` unknown
      - `unitValue` number, double — Product creation date.
      - `quantity` number, double — Product creation date.
      - `discount` number, double — Product creation date.
      - `totalValue` number, double — Product creation date.
    - `allowedUsers` LeanUserEntity[] — Users allowed to view this deal.
      - `accountId` integer — Account ID.
      - `id` integer — User ID.
      - `name` string — User name.
    - `_email` string — Email address to which you can send a copy of emails to register them as tasks in this deal. Visit [this article]( https://ajuda.agendor.com.br/pt-BR/funcionalidades/como-gravar-e-mails-nos-historicos-do-agendor ) for more information.
    - `customFields` object — Custom fields.
    - `frozen` boolean — Whether this deal is currently frozen.
    - `freezing` object — Freeze details, present only when the deal is frozen; null otherwise.
      - `frozenAt` unknown
      - `unfreezeAt` unknown
      - `description` string — Reason description provided when freezing the deal.
      - `reason` string — Name of the freeze reason.
    - `_webUrl` string — Web platform URL.

---

[API](https://skmtc.net/agendor/apis/agendor-api.md) · [All operations](https://skmtc.net/agendor/apis/agendor-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/agendor/agendor-api/versions/0d4d34ee9ad4/schema)