API Documentation

API Endpoint

Deals

Deals

This endpoint contains both budgets and deals. When creating a new record, a budget or deal will be created based on the budget attribute in the request. If the request does not contain the budget attribute or has budget: false the new record will be a deal. If the request has budget: true the new record will be a budget.

For more details on how to work with custom fields please refer to Working with custom fields guide.

Supported filter params

  • id

  • number

  • responsible_id (array)

  • creator_id (array)

  • company_id (array)

  • status_id (array)

  • stage_status_id (array) (1: open, 2: won, 3: lost)

  • contract_id (array)

  • recurring

  • project_id (array)

  • tags

  • query

  • won_date (automatically set date when won or overridden manually)

  • lost_date (automatically set date when lost or overridden manually)

  • won_at (automatically set date when won)

  • lost_at (automatically set date when lost)

  • needs_invoicing

  • type (1: deal, 2: budget)

  • deal_type_id (1: internal, 2: client) (deals can only be “client” type, while budgets can be both)

  • project_type (1: internal project, 2: client project)

  • budget_status (1: open, 2: closed)

  • subsidiary_id (array)

  • pipeline_id (array)

  • custom_fields[id] (where id is the identifier of your custom field; for dropdown and multiselect custom fields, use array filter)

  • time_approval (boolean)

Supported sort params

  • billable_time

  • budget_total

  • budget_used

  • budget_warning

  • budgeted_time

  • client_access

  • closed_at

  • company.name

  • cost

  • created_at

  • date

  • deal_status

  • end_date

  • estimated_time

  • expense

  • invoiced

  • last_activity_at

  • name

  • number

  • pending_invoicing

  • probability

  • profit

  • profit_margin

  • project.name

  • purchase_order_number

  • responsible.name

  • creator.name

  • revenue

  • stage_status

  • services_revenue

  • suffix

  • time_approval

  • total_budgeted_time

  • worked_time

Filter operations are supported on this endpoint.

GET /api/v2/deals
Requestsreturns deals

GET  /api/v2/deals

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": [
    {
      "id": "181",
      "type": "deals",
      "attributes": {
        "name": "test name",
        "date": "2026-04-01",
        "end_date": null,
        "number": "1",
        "deal_number": "1",
        "suffix": null,
        "time_approval": true,
        "expense_approval": true,
        "client_access": false,
        "deal_type_id": 2,
        "budget": false,
        "sales_status_updated_at": "2026-04-01T06:05:00.000+02:00",
        "tag_list": [],
        "origin_deal_id": null,
        "profit_margin": 0,
        "profit_margin_normalized": 0,
        "profit_margin_default": 0,
        "email_key": "ec64971fdd1f409d6bd71383599ba940",
        "purchase_order_number": "123",
        "custom_fields": null,
        "position": 1,
        "service_type_restricted_tracking": false,
        "tracking_type_id": 1,
        "editor_config": {},
        "discount": null,
        "man_day_minutes": 480,
        "rounding_interval_id": null,
        "rounding_method_id": 1,
        "validate_expense_when_closing": false,
        "revenue_distribution_type": null,
        "color_id": null,
        "connection_status": "none",
        "revenue_distribution_method": null,
        "retainer_interval": null,
        "retainer_interval_count": 1,
        "deal_value": "0.0",
        "deal_value_source": "from_services",
        "deal_value_total": 0,
        "deal_value_total_default": 0,
        "deal_value_total_normalized": 0,
        "billable_time": 0,
        "budget_warning": null,
        "estimated_time": 0,
        "budgeted_time": 0,
        "worked_time": 0,
        "time_to_close": null,
        "days_since_created": 0,
        "days_since_last_activity": 0,
        "days_in_current_stage": 0,
        "probability": 50,
        "previous_probability": null,
        "note_interpolated": null,
        "proposal_note_interpolated": null,
        "footer_interpolated": null,
        "proposal_footer_interpolated": null,
        "todo_count": 0,
        "todo_due_date": null,
        "note": null,
        "proposal_note": null,
        "lost_comment": null,
        "closed_at": null,
        "delivered_on": null,
        "last_activity_at": "2026-04-01T06:05:20.000+02:00",
        "deleted_at": null,
        "created_at": "2026-04-01T06:05:20.964+02:00",
        "sales_closed_at": null,
        "exchange_rate": "1.25",
        "exchange_date": "2026-04-01",
        "sales_closed_on": null,
        "sample_data": false,
        "external_id": null,
        "external_sync": false,
        "manual_invoicing_status_id": 1,
        "footer": null,
        "proposal_footer": null,
        "access_to_deal": true,
        "currency": "EUR",
        "currency_default": "USD",
        "currency_normalized": "EUR",
        "revenue": 0,
        "revenue_default": 0,
        "revenue_normalized": 0,
        "services_revenue": 0,
        "services_revenue_default": 0,
        "services_revenue_normalized": 0,
        "budget_total": 0,
        "budget_total_default": 0,
        "budget_total_normalized": 0,
        "budget_used": 0,
        "budget_used_default": 0,
        "budget_used_normalized": 0,
        "projected_revenue": 0,
        "projected_revenue_default": 0,
        "projected_revenue_normalized": 0,
        "cost": 0,
        "cost_default": 0,
        "cost_normalized": 0,
        "profit": 0,
        "profit_default": 0,
        "profit_normalized": 0,
        "invoiced": 0,
        "invoiced_default": 0,
        "invoiced_normalized": 0,
        "pending_invoicing": 0,
        "pending_invoicing_default": 0,
        "pending_invoicing_normalized": 0,
        "manually_invoiced": 0,
        "manually_invoiced_default": 0,
        "manually_invoiced_normalized": 0,
        "draft_invoiced": 0,
        "draft_invoiced_default": 0,
        "draft_invoiced_normalized": 0,
        "amount_credited": 0,
        "amount_credited_default": 0,
        "amount_credited_normalized": 0,
        "expense": 0,
        "expense_default": 0,
        "expense_normalized": 0
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "366"
          }
        },
        "creator": {
          "meta": {
            "included": false
          }
        },
        "company": {
          "meta": {
            "included": false
          }
        },
        "document_type": {
          "meta": {
            "included": false
          }
        },
        "proposal_document_type": {
          "meta": {
            "included": false
          }
        },
        "responsible": {
          "meta": {
            "included": false
          }
        },
        "deal_status": {
          "meta": {
            "included": false
          }
        },
        "project": {
          "meta": {
            "included": false
          }
        },
        "lost_reason": {
          "meta": {
            "included": false
          }
        },
        "contract": {
          "meta": {
            "included": false
          }
        },
        "contact": {
          "meta": {
            "included": false
          }
        },
        "subsidiary": {
          "meta": {
            "included": false
          }
        },
        "template": {
          "meta": {
            "included": false
          }
        },
        "tax_rate": {
          "meta": {
            "included": false
          }
        },
        "pipeline": {
          "meta": {
            "included": false
          }
        },
        "origin_deal": {
          "meta": {
            "included": false
          }
        },
        "designated_approver": {
          "meta": {
            "included": false
          }
        },
        "approval_policy_assignment": {
          "meta": {
            "included": false
          }
        },
        "next_todo": {
          "meta": {
            "included": false
          }
        },
        "expense_approval_workflow": {
          "meta": {
            "included": false
          }
        },
        "time_approval_workflow": {
          "meta": {
            "included": false
          }
        },
        "invoice_template": {
          "meta": {
            "included": false
          }
        },
        "automatic_invoicing_rule": {
          "meta": {
            "included": false
          }
        },
        "primary_contact": {
          "meta": {
            "included": false
          }
        },
        "custom_field_people": {
          "meta": {
            "included": false
          }
        },
        "custom_field_attachments": {
          "meta": {
            "included": false
          }
        }
      }
    }
  ],
  "links": {
    "first": "http://api-test.productive.io/api/v2/deals?page%5Bnumber%5D=1&page%5Bsize%5D=30",
    "last": "http://api-test.productive.io/api/v2/deals?page%5Bnumber%5D=1&page%5Bsize%5D=30"
  },
  "meta": {
    "current_page": 1,
    "total_pages": 1,
    "total_count": 1,
    "page_size": 30,
    "max_page_size": 200
  }
}

Get deals
GET/api/v2/deals

GET /api/v2/deals/1
Requestsreturns deal

GET  /api/v2/deals/182

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "182",
    "type": "deals",
    "attributes": {
      "name": "test name",
      "date": "2026-04-01",
      "end_date": null,
      "number": "1",
      "deal_number": "1",
      "suffix": null,
      "time_approval": true,
      "expense_approval": true,
      "client_access": false,
      "deal_type_id": 2,
      "budget": false,
      "sales_status_updated_at": "2026-04-01T06:05:00.000+02:00",
      "tag_list": [],
      "origin_deal_id": null,
      "profit_margin": 0,
      "profit_margin_normalized": 0,
      "profit_margin_default": 0,
      "email_key": "e4a87e6836234358a2d967183618ff26",
      "purchase_order_number": "123",
      "custom_fields": null,
      "position": 1,
      "service_type_restricted_tracking": false,
      "tracking_type_id": 1,
      "editor_config": {},
      "discount": null,
      "man_day_minutes": 480,
      "rounding_interval_id": null,
      "rounding_method_id": 1,
      "validate_expense_when_closing": false,
      "revenue_distribution_type": null,
      "color_id": null,
      "connection_status": "none",
      "revenue_distribution_method": null,
      "retainer_interval": null,
      "retainer_interval_count": 1,
      "deal_value": "0.0",
      "deal_value_source": "from_services",
      "deal_value_total": 0,
      "deal_value_total_default": 0,
      "deal_value_total_normalized": 0,
      "billable_time": 0,
      "budget_warning": null,
      "estimated_time": 0,
      "budgeted_time": 0,
      "worked_time": 0,
      "time_to_close": null,
      "days_since_created": 0,
      "days_since_last_activity": 0,
      "days_in_current_stage": 0,
      "probability": 50,
      "previous_probability": null,
      "note_interpolated": null,
      "proposal_note_interpolated": null,
      "footer_interpolated": null,
      "proposal_footer_interpolated": null,
      "todo_count": 0,
      "todo_due_date": null,
      "note": null,
      "proposal_note": null,
      "lost_comment": null,
      "closed_at": null,
      "delivered_on": null,
      "last_activity_at": "2026-04-01T06:05:21.000+02:00",
      "deleted_at": null,
      "created_at": "2026-04-01T06:05:21.081+02:00",
      "sales_closed_at": null,
      "exchange_rate": "1.25",
      "exchange_date": "2026-04-01",
      "sales_closed_on": null,
      "sample_data": false,
      "external_id": null,
      "external_sync": false,
      "manual_invoicing_status_id": 1,
      "footer": null,
      "proposal_footer": null,
      "access_to_deal": true,
      "currency": "EUR",
      "currency_default": "USD",
      "currency_normalized": "EUR",
      "revenue": 0,
      "revenue_default": 0,
      "revenue_normalized": 0,
      "services_revenue": 0,
      "services_revenue_default": 0,
      "services_revenue_normalized": 0,
      "budget_total": 0,
      "budget_total_default": 0,
      "budget_total_normalized": 0,
      "budget_used": 0,
      "budget_used_default": 0,
      "budget_used_normalized": 0,
      "projected_revenue": 0,
      "projected_revenue_default": 0,
      "projected_revenue_normalized": 0,
      "cost": 0,
      "cost_default": 0,
      "cost_normalized": 0,
      "profit": 0,
      "profit_default": 0,
      "profit_normalized": 0,
      "invoiced": 0,
      "invoiced_default": 0,
      "invoiced_normalized": 0,
      "pending_invoicing": 0,
      "pending_invoicing_default": 0,
      "pending_invoicing_normalized": 0,
      "manually_invoiced": 0,
      "manually_invoiced_default": 0,
      "manually_invoiced_normalized": 0,
      "draft_invoiced": 0,
      "draft_invoiced_default": 0,
      "draft_invoiced_normalized": 0,
      "amount_credited": 0,
      "amount_credited_default": 0,
      "amount_credited_normalized": 0,
      "expense": 0,
      "expense_default": 0,
      "expense_normalized": 0
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "367"
        }
      },
      "creator": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "document_type": {
        "meta": {
          "included": false
        }
      },
      "proposal_document_type": {
        "meta": {
          "included": false
        }
      },
      "responsible": {
        "meta": {
          "included": false
        }
      },
      "deal_status": {
        "meta": {
          "included": false
        }
      },
      "project": {
        "meta": {
          "included": false
        }
      },
      "lost_reason": {
        "meta": {
          "included": false
        }
      },
      "contract": {
        "meta": {
          "included": false
        }
      },
      "contact": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "template": {
        "meta": {
          "included": false
        }
      },
      "tax_rate": {
        "meta": {
          "included": false
        }
      },
      "pipeline": {
        "meta": {
          "included": false
        }
      },
      "origin_deal": {
        "meta": {
          "included": false
        }
      },
      "designated_approver": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "next_todo": {
        "meta": {
          "included": false
        }
      },
      "expense_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "time_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "invoice_template": {
        "meta": {
          "included": false
        }
      },
      "automatic_invoicing_rule": {
        "meta": {
          "included": false
        }
      },
      "primary_contact": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

Gets a deal
GET/api/v2/deals/{id}

URI Parameters
HideShow
id
number (required) Example: 1

deal id

POST /api/v2/deals
Requestscreates dealreturns errorreturns errorcreates retainer dealcreates budget

POST  /api/v2/deals

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "deals",
    "attributes": {
      "name": "test name",
      "date": "2026-04-01",
      "deal_type_id": 2,
      "deal_status_id": 1972,
      "probability": 50,
      "currency": "EUR",
      "budget": false,
      "purchase_order_number": "234"
    },
    "relationships": {
      "company": {
        "data": {
          "type": "companies",
          "id": "770"
        }
      },
      "responsible": {
        "data": {
          "type": "people",
          "id": "1028"
        }
      },
      "subsidiary": {
        "data": {
          "type": "subsidiaries",
          "id": "201"
        }
      },
      "document_type": {
        "data": {
          "type": "document-types",
          "id": "195"
        }
      }
    }
  }
}
Responses201
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "186",
    "type": "deals",
    "attributes": {
      "name": "test name",
      "date": "2026-04-01",
      "end_date": null,
      "number": "2",
      "deal_number": "2",
      "suffix": null,
      "time_approval": false,
      "expense_approval": false,
      "client_access": false,
      "deal_type_id": 2,
      "budget": false,
      "sales_status_updated_at": "2026-04-01T06:05:21.000+02:00",
      "tag_list": [],
      "origin_deal_id": null,
      "profit_margin": 0,
      "profit_margin_normalized": 0,
      "profit_margin_default": 0,
      "email_key": "4744aa9a960e3e68f92671cca086a7f7",
      "purchase_order_number": "234",
      "custom_fields": null,
      "position": 1,
      "service_type_restricted_tracking": false,
      "tracking_type_id": 1,
      "editor_config": null,
      "discount": null,
      "man_day_minutes": 480,
      "rounding_interval_id": null,
      "rounding_method_id": 1,
      "validate_expense_when_closing": false,
      "revenue_distribution_type": "even",
      "color_id": null,
      "connection_status": "none",
      "revenue_distribution_method": null,
      "retainer_interval": null,
      "retainer_interval_count": 1,
      "deal_value": "0.0",
      "deal_value_source": "from_services",
      "deal_value_total": 0,
      "deal_value_total_default": 0,
      "deal_value_total_normalized": 0,
      "billable_time": 0,
      "budget_warning": null,
      "estimated_time": 0,
      "budgeted_time": 0,
      "worked_time": 0,
      "time_to_close": null,
      "days_since_created": 0,
      "days_since_last_activity": 0,
      "days_in_current_stage": 0,
      "probability": 50,
      "previous_probability": null,
      "note_interpolated": null,
      "proposal_note_interpolated": null,
      "footer_interpolated": null,
      "proposal_footer_interpolated": null,
      "todo_count": 0,
      "todo_due_date": null,
      "note": null,
      "proposal_note": null,
      "lost_comment": null,
      "closed_at": null,
      "delivered_on": null,
      "last_activity_at": "2026-04-01T06:05:21.000+02:00",
      "deleted_at": null,
      "created_at": "2026-04-01T06:05:21.894+02:00",
      "sales_closed_at": null,
      "exchange_rate": "1.25",
      "exchange_date": "2026-04-01",
      "sales_closed_on": null,
      "sample_data": false,
      "external_id": null,
      "external_sync": false,
      "manual_invoicing_status_id": 1,
      "footer": null,
      "proposal_footer": null,
      "access_to_deal": true,
      "currency": "EUR",
      "currency_default": "USD",
      "currency_normalized": "EUR",
      "revenue": 0,
      "revenue_default": 0,
      "revenue_normalized": 0,
      "services_revenue": 0,
      "services_revenue_default": 0,
      "services_revenue_normalized": 0,
      "budget_total": 0,
      "budget_total_default": 0,
      "budget_total_normalized": 0,
      "budget_used": 0,
      "budget_used_default": 0,
      "budget_used_normalized": 0,
      "projected_revenue": 0,
      "projected_revenue_default": 0,
      "projected_revenue_normalized": 0,
      "cost": 0,
      "cost_default": 0,
      "cost_normalized": 0,
      "profit": 0,
      "profit_default": 0,
      "profit_normalized": 0,
      "invoiced": 0,
      "invoiced_default": 0,
      "invoiced_normalized": 0,
      "pending_invoicing": 0,
      "pending_invoicing_default": 0,
      "pending_invoicing_normalized": 0,
      "manually_invoiced": 0,
      "manually_invoiced_default": 0,
      "manually_invoiced_normalized": 0,
      "draft_invoiced": 0,
      "draft_invoiced_default": 0,
      "draft_invoiced_normalized": 0,
      "amount_credited": 0,
      "amount_credited_default": 0,
      "amount_credited_normalized": 0,
      "expense": 0,
      "expense_default": 0,
      "expense_normalized": 0
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "370"
        }
      },
      "creator": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "document_type": {
        "meta": {
          "included": false
        }
      },
      "proposal_document_type": {
        "meta": {
          "included": false
        }
      },
      "responsible": {
        "meta": {
          "included": false
        }
      },
      "deal_status": {
        "meta": {
          "included": false
        }
      },
      "project": {
        "meta": {
          "included": false
        }
      },
      "lost_reason": {
        "meta": {
          "included": false
        }
      },
      "contract": {
        "meta": {
          "included": false
        }
      },
      "contact": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "template": {
        "meta": {
          "included": false
        }
      },
      "tax_rate": {
        "meta": {
          "included": false
        }
      },
      "pipeline": {
        "meta": {
          "included": false
        }
      },
      "origin_deal": {
        "meta": {
          "included": false
        }
      },
      "designated_approver": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "next_todo": {
        "meta": {
          "included": false
        }
      },
      "expense_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "time_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "invoice_template": {
        "meta": {
          "included": false
        }
      },
      "automatic_invoicing_rule": {
        "meta": {
          "included": false
        }
      },
      "primary_contact": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

POST  /api/v2/deals

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "deals",
    "attributes": {
      "name": ""
    }
  }
}
Responses422
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "errors": [
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "can't be blank",
      "meta": {},
      "source": {
        "pointer": "data/attributes/name"
      }
    },
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "can't be blank",
      "meta": {},
      "source": {
        "pointer": "data/attributes/responsible"
      }
    },
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "can't be blank",
      "meta": {
        "unless": "internal?"
      },
      "source": {
        "pointer": "data/attributes/company"
      }
    },
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "can't be blank",
      "meta": {},
      "source": {
        "pointer": "data/attributes/deal_type_id"
      }
    },
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "is not included in the list",
      "meta": {
        "value": null
      },
      "source": {
        "pointer": "data/attributes/deal_type_id"
      }
    },
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "can't be blank",
      "meta": {
        "if": "sales_pipeline?"
      },
      "source": {
        "pointer": "data/attributes/probability"
      }
    },
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "is not a number",
      "meta": {
        "if": "sales_pipeline?",
        "value": null
      },
      "source": {
        "pointer": "data/attributes/probability"
      }
    },
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "can't be blank",
      "meta": {
        "if": "financials_required?"
      },
      "source": {
        "pointer": "data/attributes/currency"
      }
    },
    {
      "status": "422",
      "code": "currency_invalid",
      "title": "Invalid Attribute",
      "detail": "is not a valid currency",
      "meta": {},
      "source": {
        "pointer": "data/attributes/currency"
      }
    },
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "can't be blank",
      "meta": {
        "if": "sales_pipeline?"
      },
      "source": {
        "pointer": "data/attributes/deal_status"
      }
    },
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "can't be blank",
      "meta": {},
      "source": {
        "pointer": "data/attributes/date"
      }
    },
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "is not a date",
      "meta": {
        "allow_nil": false
      },
      "source": {
        "pointer": "data/attributes/date"
      }
    }
  ]
}

POST  /api/v2/deals

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "deals",
    "attributes": {
      "name": "test name",
      "date": "",
      "deal_type_id": 2,
      "deal_status_id": 2002,
      "probability": 50,
      "currency": "EUR"
    },
    "relationships": {
      "company": {
        "data": {
          "type": "companies",
          "id": "780"
        }
      },
      "responsible": {
        "data": {
          "type": "people",
          "id": "1042"
        }
      },
      "subsidiary": {
        "data": {
          "type": "subsidiaries",
          "id": "215"
        }
      },
      "document_type": {
        "data": {
          "type": "document-types",
          "id": "204"
        }
      }
    }
  }
}
Responses422
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "errors": [
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "can't be blank",
      "meta": {},
      "source": {
        "pointer": "data/attributes/date"
      }
    },
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "is not a date",
      "meta": {
        "allow_nil": false
      },
      "source": {
        "pointer": "data/attributes/date"
      }
    }
  ]
}

POST  /api/v2/deals

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "deals",
    "attributes": {
      "name": "test name",
      "date": "2026-04-01",
      "deal_type_id": 2,
      "deal_status_id": 2040,
      "probability": 50,
      "currency": "EUR",
      "budget": false,
      "retainer_interval": "month",
      "retainer_interval_count": 6
    },
    "relationships": {
      "company": {
        "data": {
          "type": "companies",
          "id": "793"
        }
      },
      "responsible": {
        "data": {
          "type": "people",
          "id": "1060"
        }
      },
      "subsidiary": {
        "data": {
          "type": "subsidiaries",
          "id": "231"
        }
      },
      "document_type": {
        "data": {
          "type": "document-types",
          "id": "213"
        }
      }
    }
  }
}
Responses201
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "204",
    "type": "deals",
    "attributes": {
      "name": "test name",
      "date": "2026-04-01",
      "end_date": null,
      "number": "2",
      "deal_number": "2",
      "suffix": null,
      "time_approval": false,
      "expense_approval": false,
      "client_access": false,
      "deal_type_id": 2,
      "budget": false,
      "sales_status_updated_at": "2026-04-01T06:05:24.000+02:00",
      "tag_list": [],
      "origin_deal_id": null,
      "profit_margin": 0,
      "profit_margin_normalized": 0,
      "profit_margin_default": 0,
      "email_key": "120c2568229c0ec037a4a4da553ccd51",
      "purchase_order_number": null,
      "custom_fields": null,
      "position": 1,
      "service_type_restricted_tracking": false,
      "tracking_type_id": 1,
      "editor_config": null,
      "discount": null,
      "man_day_minutes": 480,
      "rounding_interval_id": null,
      "rounding_method_id": 1,
      "validate_expense_when_closing": false,
      "revenue_distribution_type": "even",
      "color_id": null,
      "connection_status": "none",
      "revenue_distribution_method": null,
      "retainer_interval": "month",
      "retainer_interval_count": 6,
      "deal_value": "0.0",
      "deal_value_source": "from_services",
      "retainer_deal_value_type": null,
      "deal_value_total": 0,
      "deal_value_total_default": 0,
      "deal_value_total_normalized": 0,
      "deal_value_per_period": 0,
      "deal_value_per_period_default": 0,
      "deal_value_per_period_normalized": 0,
      "billable_time": 0,
      "budget_warning": null,
      "estimated_time": 0,
      "budgeted_time": 0,
      "worked_time": 0,
      "time_to_close": null,
      "days_since_created": 0,
      "days_since_last_activity": 0,
      "days_in_current_stage": 0,
      "probability": 50,
      "previous_probability": null,
      "note_interpolated": null,
      "proposal_note_interpolated": null,
      "footer_interpolated": null,
      "proposal_footer_interpolated": null,
      "todo_count": 0,
      "todo_due_date": null,
      "note": null,
      "proposal_note": null,
      "lost_comment": null,
      "closed_at": null,
      "delivered_on": null,
      "last_activity_at": "2026-04-01T06:05:24.000+02:00",
      "deleted_at": null,
      "created_at": "2026-04-01T06:05:24.673+02:00",
      "sales_closed_at": null,
      "exchange_rate": "1.25",
      "exchange_date": "2026-04-01",
      "sales_closed_on": null,
      "sample_data": false,
      "external_id": null,
      "external_sync": false,
      "manual_invoicing_status_id": 1,
      "footer": null,
      "proposal_footer": null,
      "access_to_deal": true,
      "currency": "EUR",
      "currency_default": "USD",
      "currency_normalized": "EUR",
      "revenue": 0,
      "revenue_default": 0,
      "revenue_normalized": 0,
      "services_revenue": 0,
      "services_revenue_default": 0,
      "services_revenue_normalized": 0,
      "budget_total": 0,
      "budget_total_default": 0,
      "budget_total_normalized": 0,
      "budget_used": 0,
      "budget_used_default": 0,
      "budget_used_normalized": 0,
      "projected_revenue": 0,
      "projected_revenue_default": 0,
      "projected_revenue_normalized": 0,
      "cost": 0,
      "cost_default": 0,
      "cost_normalized": 0,
      "profit": 0,
      "profit_default": 0,
      "profit_normalized": 0,
      "invoiced": 0,
      "invoiced_default": 0,
      "invoiced_normalized": 0,
      "pending_invoicing": 0,
      "pending_invoicing_default": 0,
      "pending_invoicing_normalized": 0,
      "manually_invoiced": 0,
      "manually_invoiced_default": 0,
      "manually_invoiced_normalized": 0,
      "draft_invoiced": 0,
      "draft_invoiced_default": 0,
      "draft_invoiced_normalized": 0,
      "amount_credited": 0,
      "amount_credited_default": 0,
      "amount_credited_normalized": 0,
      "expense": 0,
      "expense_default": 0,
      "expense_normalized": 0
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "381"
        }
      },
      "creator": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "document_type": {
        "meta": {
          "included": false
        }
      },
      "proposal_document_type": {
        "meta": {
          "included": false
        }
      },
      "responsible": {
        "meta": {
          "included": false
        }
      },
      "deal_status": {
        "meta": {
          "included": false
        }
      },
      "project": {
        "meta": {
          "included": false
        }
      },
      "lost_reason": {
        "meta": {
          "included": false
        }
      },
      "contract": {
        "meta": {
          "included": false
        }
      },
      "contact": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "template": {
        "meta": {
          "included": false
        }
      },
      "tax_rate": {
        "meta": {
          "included": false
        }
      },
      "pipeline": {
        "meta": {
          "included": false
        }
      },
      "origin_deal": {
        "meta": {
          "included": false
        }
      },
      "designated_approver": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "next_todo": {
        "meta": {
          "included": false
        }
      },
      "expense_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "time_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "invoice_template": {
        "meta": {
          "included": false
        }
      },
      "automatic_invoicing_rule": {
        "meta": {
          "included": false
        }
      },
      "primary_contact": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

POST  /api/v2/deals

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "deals",
    "attributes": {
      "name": "test name",
      "budget": true,
      "date": "2026-04-01",
      "deal_type_id": 2,
      "currency": "EUR"
    },
    "relationships": {
      "company": {
        "data": {
          "type": "companies",
          "id": "796"
        }
      },
      "responsible": {
        "data": {
          "type": "people",
          "id": "1063"
        }
      },
      "project": {
        "data": {
          "type": "projects",
          "id": "156"
        }
      },
      "subsidiary": {
        "data": {
          "type": "subsidiaries",
          "id": "234"
        }
      },
      "document_type": {
        "data": {
          "type": "document-types",
          "id": "215"
        }
      }
    }
  }
}
Responses201
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "206",
    "type": "deals",
    "attributes": {
      "name": "test name",
      "date": "2026-04-01",
      "end_date": null,
      "number": "1",
      "deal_number": "1",
      "suffix": null,
      "time_approval": false,
      "expense_approval": false,
      "client_access": false,
      "deal_type_id": 2,
      "budget": true,
      "sales_status_updated_at": null,
      "tag_list": [],
      "origin_deal_id": null,
      "profit_margin": 0,
      "profit_margin_normalized": 0,
      "profit_margin_default": 0,
      "email_key": "c4e0ff6d733f74faecb0a111286939af",
      "purchase_order_number": null,
      "custom_fields": null,
      "position": 1,
      "service_type_restricted_tracking": false,
      "tracking_type_id": 1,
      "editor_config": null,
      "discount": null,
      "man_day_minutes": 480,
      "rounding_interval_id": null,
      "rounding_method_id": 1,
      "validate_expense_when_closing": false,
      "revenue_distribution_type": "default",
      "color_id": null,
      "connection_status": "none",
      "revenue_distribution_method": null,
      "retainer_interval": null,
      "retainer_interval_count": 1,
      "deal_value": "0.0",
      "deal_value_source": null,
      "deal_value_total": 0,
      "deal_value_total_default": 0,
      "deal_value_total_normalized": 0,
      "billable_time": 0,
      "budget_warning": null,
      "estimated_time": 0,
      "budgeted_time": 0,
      "worked_time": 0,
      "time_to_close": null,
      "days_since_created": 0,
      "days_since_last_activity": 0,
      "days_in_current_stage": null,
      "probability": 100,
      "previous_probability": null,
      "note_interpolated": null,
      "proposal_note_interpolated": null,
      "footer_interpolated": null,
      "proposal_footer_interpolated": null,
      "todo_count": 0,
      "todo_due_date": null,
      "note": null,
      "proposal_note": null,
      "lost_comment": null,
      "closed_at": null,
      "delivered_on": null,
      "last_activity_at": "2026-04-01T06:05:25.000+02:00",
      "deleted_at": null,
      "created_at": "2026-04-01T06:05:25.020+02:00",
      "sales_closed_at": null,
      "exchange_rate": "1.25",
      "exchange_date": "2026-04-01",
      "sales_closed_on": null,
      "sample_data": false,
      "external_id": null,
      "external_sync": false,
      "manual_invoicing_status_id": 1,
      "footer": null,
      "proposal_footer": null,
      "access_to_deal": true,
      "currency": "EUR",
      "currency_default": "USD",
      "currency_normalized": "EUR",
      "revenue": 0,
      "revenue_default": 0,
      "revenue_normalized": 0,
      "services_revenue": 0,
      "services_revenue_default": 0,
      "services_revenue_normalized": 0,
      "budget_total": 0,
      "budget_total_default": 0,
      "budget_total_normalized": 0,
      "budget_used": 0,
      "budget_used_default": 0,
      "budget_used_normalized": 0,
      "projected_revenue": 0,
      "projected_revenue_default": 0,
      "projected_revenue_normalized": 0,
      "cost": 0,
      "cost_default": 0,
      "cost_normalized": 0,
      "profit": 0,
      "profit_default": 0,
      "profit_normalized": 0,
      "invoiced": 0,
      "invoiced_default": 0,
      "invoiced_normalized": 0,
      "pending_invoicing": 0,
      "pending_invoicing_default": 0,
      "pending_invoicing_normalized": 0,
      "manually_invoiced": 0,
      "manually_invoiced_default": 0,
      "manually_invoiced_normalized": 0,
      "draft_invoiced": 0,
      "draft_invoiced_default": 0,
      "draft_invoiced_normalized": 0,
      "amount_credited": 0,
      "amount_credited_default": 0,
      "amount_credited_normalized": 0,
      "expense": 0,
      "expense_default": 0,
      "expense_normalized": 0
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "382"
        }
      },
      "creator": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "document_type": {
        "meta": {
          "included": false
        }
      },
      "proposal_document_type": {
        "meta": {
          "included": false
        }
      },
      "responsible": {
        "meta": {
          "included": false
        }
      },
      "deal_status": {
        "meta": {
          "included": false
        }
      },
      "project": {
        "meta": {
          "included": false
        }
      },
      "lost_reason": {
        "meta": {
          "included": false
        }
      },
      "contract": {
        "meta": {
          "included": false
        }
      },
      "contact": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "template": {
        "meta": {
          "included": false
        }
      },
      "tax_rate": {
        "meta": {
          "included": false
        }
      },
      "pipeline": {
        "meta": {
          "included": false
        }
      },
      "origin_deal": {
        "meta": {
          "included": false
        }
      },
      "designated_approver": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "next_todo": {
        "meta": {
          "included": false
        }
      },
      "expense_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "time_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "invoice_template": {
        "meta": {
          "included": false
        }
      },
      "automatic_invoicing_rule": {
        "meta": {
          "included": false
        }
      },
      "primary_contact": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

Create a deal
POST/api/v2/deals

URI Parameters
HideShow
name
string (required) Example: Name

name

date
date (required) Example: 2018-01-01

date

responsible_id: `1` (number, required) - responsible_id
string (required) 
company_id: `1` (number, required) - company_id
string (required) 
deal_type_id
number (required) Example: 2

deal type

probability
number (required) Example: 100

probability

currency
currency (required) Example: EUR

currency

deal_status
number (required) Example: 1

deal pipeline stage (only for sales deals)

budget
boolean (optional) Example: false

determines if budget or sales deal

project_id
number (optional) Example: 1

project

PATCH /api/v2/deals/1
Requestsupdates dealupdates budgetreturns errorreturns errorassigns project to deal with same clientdoes not assign project to deal with different clientupdates probability to 100updates probability to 0updates deal probabilitydoes not update deal's probabilityupdates deal's probabilityupdates deal's probabilityupdates deal's probabilityupdates deal and breaks syncupdates deal and does not break sync

PATCH  /api/v2/deals/209

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "deals",
    "attributes": {
      "name": "new name",
      "tracking_type_id": 3,
      "purchase_order_number": "456"
    },
    "relationships": {
      "responsible": {
        "data": {
          "type": "people",
          "id": "1071"
        }
      },
      "subscribers": {
        "data": [
          {
            "type": "people",
            "id": "1072"
          },
          {
            "type": "people",
            "id": "1073"
          }
        ]
      }
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "209",
    "type": "deals",
    "attributes": {
      "name": "new name",
      "date": "2026-04-01",
      "end_date": null,
      "number": "1",
      "deal_number": "1",
      "suffix": null,
      "time_approval": true,
      "expense_approval": true,
      "client_access": false,
      "deal_type_id": 2,
      "budget": false,
      "sales_status_updated_at": "2026-04-01T06:05:00.000+02:00",
      "tag_list": [],
      "origin_deal_id": null,
      "profit_margin": 0,
      "profit_margin_normalized": 0,
      "profit_margin_default": 0,
      "email_key": "27e3609bdf3b0836c6371bbb07b64bca",
      "purchase_order_number": "456",
      "custom_fields": null,
      "position": 1,
      "service_type_restricted_tracking": false,
      "tracking_type_id": 3,
      "editor_config": {},
      "discount": null,
      "man_day_minutes": 480,
      "rounding_interval_id": null,
      "rounding_method_id": 1,
      "validate_expense_when_closing": false,
      "revenue_distribution_type": "even",
      "color_id": null,
      "connection_status": "none",
      "revenue_distribution_method": null,
      "retainer_interval": null,
      "retainer_interval_count": 1,
      "deal_value": "0.0",
      "deal_value_source": "from_services",
      "deal_value_total": 0,
      "deal_value_total_default": 0,
      "deal_value_total_normalized": 0,
      "billable_time": 0,
      "budget_warning": null,
      "estimated_time": 0,
      "budgeted_time": 0,
      "worked_time": 0,
      "time_to_close": null,
      "days_since_created": 0,
      "days_since_last_activity": 0,
      "days_in_current_stage": 0,
      "probability": 50,
      "previous_probability": null,
      "note_interpolated": null,
      "proposal_note_interpolated": null,
      "footer_interpolated": null,
      "proposal_footer_interpolated": null,
      "todo_count": 0,
      "todo_due_date": null,
      "note": null,
      "proposal_note": null,
      "lost_comment": null,
      "closed_at": null,
      "delivered_on": null,
      "last_activity_at": "2026-04-01T06:05:25.000+02:00",
      "deleted_at": null,
      "created_at": "2026-04-01T06:05:25.775+02:00",
      "sales_closed_at": null,
      "exchange_rate": "1.25",
      "exchange_date": "2026-04-01",
      "sales_closed_on": null,
      "sample_data": false,
      "external_id": null,
      "external_sync": false,
      "manual_invoicing_status_id": 1,
      "footer": null,
      "proposal_footer": null,
      "access_to_deal": true,
      "currency": "EUR",
      "currency_default": "USD",
      "currency_normalized": "EUR",
      "revenue": 0,
      "revenue_default": 0,
      "revenue_normalized": 0,
      "services_revenue": 0,
      "services_revenue_default": 0,
      "services_revenue_normalized": 0,
      "budget_total": 0,
      "budget_total_default": 0,
      "budget_total_normalized": 0,
      "budget_used": 0,
      "budget_used_default": 0,
      "budget_used_normalized": 0,
      "projected_revenue": 0,
      "projected_revenue_default": 0,
      "projected_revenue_normalized": 0,
      "cost": 0,
      "cost_default": 0,
      "cost_normalized": 0,
      "profit": 0,
      "profit_default": 0,
      "profit_normalized": 0,
      "invoiced": 0,
      "invoiced_default": 0,
      "invoiced_normalized": 0,
      "pending_invoicing": 0,
      "pending_invoicing_default": 0,
      "pending_invoicing_normalized": 0,
      "manually_invoiced": 0,
      "manually_invoiced_default": 0,
      "manually_invoiced_normalized": 0,
      "draft_invoiced": 0,
      "draft_invoiced_default": 0,
      "draft_invoiced_normalized": 0,
      "amount_credited": 0,
      "amount_credited_default": 0,
      "amount_credited_normalized": 0,
      "expense": 0,
      "expense_default": 0,
      "expense_normalized": 0
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "384"
        }
      },
      "creator": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "document_type": {
        "meta": {
          "included": false
        }
      },
      "proposal_document_type": {
        "meta": {
          "included": false
        }
      },
      "responsible": {
        "meta": {
          "included": false
        }
      },
      "deal_status": {
        "meta": {
          "included": false
        }
      },
      "project": {
        "meta": {
          "included": false
        }
      },
      "lost_reason": {
        "meta": {
          "included": false
        }
      },
      "contract": {
        "meta": {
          "included": false
        }
      },
      "contact": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "template": {
        "meta": {
          "included": false
        }
      },
      "tax_rate": {
        "meta": {
          "included": false
        }
      },
      "pipeline": {
        "meta": {
          "included": false
        }
      },
      "origin_deal": {
        "meta": {
          "included": false
        }
      },
      "designated_approver": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "next_todo": {
        "meta": {
          "included": false
        }
      },
      "expense_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "time_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "invoice_template": {
        "meta": {
          "included": false
        }
      },
      "automatic_invoicing_rule": {
        "meta": {
          "included": false
        }
      },
      "primary_contact": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/deals/215

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "deals",
    "attributes": {
      "delivered_on": "2026-04-05"
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "215",
    "type": "deals",
    "attributes": {
      "name": "test name",
      "date": "2026-04-01",
      "end_date": null,
      "number": "1",
      "deal_number": "1",
      "suffix": null,
      "time_approval": true,
      "expense_approval": true,
      "client_access": false,
      "deal_type_id": 2,
      "budget": true,
      "sales_status_updated_at": "2026-04-01T06:05:00.000+02:00",
      "tag_list": [],
      "origin_deal_id": null,
      "profit_margin": 0,
      "profit_margin_normalized": 0,
      "profit_margin_default": 0,
      "email_key": "0ed8d2453d88b6b885550c3768084a2e",
      "purchase_order_number": null,
      "custom_fields": null,
      "position": 1,
      "service_type_restricted_tracking": false,
      "tracking_type_id": 1,
      "editor_config": {},
      "discount": null,
      "man_day_minutes": 480,
      "rounding_interval_id": null,
      "rounding_method_id": 1,
      "validate_expense_when_closing": false,
      "revenue_distribution_type": "default",
      "color_id": null,
      "connection_status": "none",
      "revenue_distribution_method": null,
      "retainer_interval": null,
      "retainer_interval_count": 1,
      "deal_value": "0.0",
      "deal_value_source": null,
      "deal_value_total": 0,
      "deal_value_total_default": 0,
      "deal_value_total_normalized": 0,
      "billable_time": 0,
      "budget_warning": null,
      "estimated_time": 0,
      "budgeted_time": 0,
      "worked_time": 0,
      "time_to_close": null,
      "days_since_created": 0,
      "days_since_last_activity": 0,
      "days_in_current_stage": 0,
      "probability": 100,
      "previous_probability": null,
      "note_interpolated": null,
      "proposal_note_interpolated": null,
      "footer_interpolated": null,
      "proposal_footer_interpolated": null,
      "todo_count": 0,
      "todo_due_date": null,
      "note": null,
      "proposal_note": null,
      "lost_comment": null,
      "closed_at": "2026-04-01T06:05:27.000+02:00",
      "delivered_on": "2026-04-05",
      "last_activity_at": "2026-04-01T06:05:27.000+02:00",
      "deleted_at": null,
      "created_at": "2026-04-01T06:05:27.594+02:00",
      "sales_closed_at": null,
      "exchange_rate": "1.25",
      "exchange_date": "2026-04-01",
      "sales_closed_on": null,
      "sample_data": false,
      "external_id": null,
      "external_sync": false,
      "manual_invoicing_status_id": 1,
      "footer": null,
      "proposal_footer": null,
      "access_to_deal": true,
      "currency": "EUR",
      "currency_default": "USD",
      "currency_normalized": "EUR",
      "revenue": 0,
      "revenue_default": 0,
      "revenue_normalized": 0,
      "services_revenue": 0,
      "services_revenue_default": 0,
      "services_revenue_normalized": 0,
      "budget_total": 0,
      "budget_total_default": 0,
      "budget_total_normalized": 0,
      "budget_used": 0,
      "budget_used_default": 0,
      "budget_used_normalized": 0,
      "projected_revenue": 0,
      "projected_revenue_default": 0,
      "projected_revenue_normalized": 0,
      "cost": 0,
      "cost_default": 0,
      "cost_normalized": 0,
      "profit": 0,
      "profit_default": 0,
      "profit_normalized": 0,
      "invoiced": 0,
      "invoiced_default": 0,
      "invoiced_normalized": 0,
      "pending_invoicing": 0,
      "pending_invoicing_default": 0,
      "pending_invoicing_normalized": 0,
      "manually_invoiced": 0,
      "manually_invoiced_default": 0,
      "manually_invoiced_normalized": 0,
      "draft_invoiced": 0,
      "draft_invoiced_default": 0,
      "draft_invoiced_normalized": 0,
      "amount_credited": 0,
      "amount_credited_default": 0,
      "amount_credited_normalized": 0,
      "expense": 0,
      "expense_default": 0,
      "expense_normalized": 0
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "388"
        }
      },
      "creator": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "document_type": {
        "meta": {
          "included": false
        }
      },
      "proposal_document_type": {
        "meta": {
          "included": false
        }
      },
      "responsible": {
        "meta": {
          "included": false
        }
      },
      "deal_status": {
        "meta": {
          "included": false
        }
      },
      "project": {
        "meta": {
          "included": false
        }
      },
      "lost_reason": {
        "meta": {
          "included": false
        }
      },
      "contract": {
        "meta": {
          "included": false
        }
      },
      "contact": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "template": {
        "meta": {
          "included": false
        }
      },
      "tax_rate": {
        "meta": {
          "included": false
        }
      },
      "pipeline": {
        "meta": {
          "included": false
        }
      },
      "origin_deal": {
        "meta": {
          "included": false
        }
      },
      "designated_approver": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "next_todo": {
        "meta": {
          "included": false
        }
      },
      "expense_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "time_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "invoice_template": {
        "meta": {
          "included": false
        }
      },
      "automatic_invoicing_rule": {
        "meta": {
          "included": false
        }
      },
      "primary_contact": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/deals/216

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "deals",
    "attributes": {
      "name": ""
    }
  }
}
Responses422
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "errors": [
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "can't be blank",
      "meta": {},
      "source": {
        "pointer": "data/attributes/name"
      }
    }
  ]
}

PATCH  /api/v2/deals/218

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "deals",
    "attributes": {
      "delivered_on": "2026-04-05"
    }
  }
}
Responses422
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "errors": [
    {
      "status": "422",
      "code": "delivery_date_requires_closed_budget",
      "title": "Invalid Attribute",
      "detail": "delivery date can be set only for closed budgets",
      "meta": {},
      "source": {
        "pointer": "data/attributes/delivered_on"
      }
    }
  ]
}

PATCH  /api/v2/deals/219

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "deals",
    "attributes": {},
    "relationships": {
      "project": {
        "data": {
          "type": "projects",
          "id": "161"
        }
      }
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "219",
    "type": "deals",
    "attributes": {
      "name": "test name",
      "date": "2026-04-01",
      "end_date": null,
      "number": "1",
      "deal_number": "1",
      "suffix": null,
      "time_approval": true,
      "expense_approval": true,
      "client_access": false,
      "deal_type_id": 2,
      "budget": false,
      "sales_status_updated_at": "2026-04-01T06:05:00.000+02:00",
      "tag_list": [],
      "origin_deal_id": null,
      "profit_margin": 0,
      "profit_margin_normalized": 0,
      "profit_margin_default": 0,
      "email_key": "b6cab27193fa43bd33dbec01c103ef4a",
      "purchase_order_number": null,
      "custom_fields": null,
      "position": 1,
      "service_type_restricted_tracking": false,
      "tracking_type_id": 1,
      "editor_config": {},
      "discount": null,
      "man_day_minutes": 480,
      "rounding_interval_id": null,
      "rounding_method_id": 1,
      "validate_expense_when_closing": false,
      "revenue_distribution_type": "even",
      "color_id": null,
      "connection_status": "none",
      "revenue_distribution_method": null,
      "retainer_interval": null,
      "retainer_interval_count": 1,
      "deal_value": "0.0",
      "deal_value_source": "from_services",
      "deal_value_total": 0,
      "deal_value_total_default": 0,
      "deal_value_total_normalized": 0,
      "billable_time": 0,
      "budget_warning": null,
      "estimated_time": 0,
      "budgeted_time": 0,
      "worked_time": 0,
      "time_to_close": null,
      "days_since_created": 0,
      "days_since_last_activity": 0,
      "days_in_current_stage": 0,
      "probability": 50,
      "previous_probability": null,
      "note_interpolated": null,
      "proposal_note_interpolated": null,
      "footer_interpolated": null,
      "proposal_footer_interpolated": null,
      "todo_count": 0,
      "todo_due_date": null,
      "note": null,
      "proposal_note": null,
      "lost_comment": null,
      "closed_at": null,
      "delivered_on": null,
      "last_activity_at": "2026-04-01T06:05:28.000+02:00",
      "deleted_at": null,
      "created_at": "2026-04-01T06:05:28.553+02:00",
      "sales_closed_at": null,
      "exchange_rate": "1.25",
      "exchange_date": "2026-04-01",
      "sales_closed_on": null,
      "sample_data": false,
      "external_id": null,
      "external_sync": false,
      "manual_invoicing_status_id": 1,
      "footer": null,
      "proposal_footer": null,
      "access_to_deal": true,
      "currency": "EUR",
      "currency_default": "USD",
      "currency_normalized": "EUR",
      "revenue": 0,
      "revenue_default": 0,
      "revenue_normalized": 0,
      "services_revenue": 0,
      "services_revenue_default": 0,
      "services_revenue_normalized": 0,
      "budget_total": 0,
      "budget_total_default": 0,
      "budget_total_normalized": 0,
      "budget_used": 0,
      "budget_used_default": 0,
      "budget_used_normalized": 0,
      "projected_revenue": 0,
      "projected_revenue_default": 0,
      "projected_revenue_normalized": 0,
      "cost": 0,
      "cost_default": 0,
      "cost_normalized": 0,
      "profit": 0,
      "profit_default": 0,
      "profit_normalized": 0,
      "invoiced": 0,
      "invoiced_default": 0,
      "invoiced_normalized": 0,
      "pending_invoicing": 0,
      "pending_invoicing_default": 0,
      "pending_invoicing_normalized": 0,
      "manually_invoiced": 0,
      "manually_invoiced_default": 0,
      "manually_invoiced_normalized": 0,
      "draft_invoiced": 0,
      "draft_invoiced_default": 0,
      "draft_invoiced_normalized": 0,
      "amount_credited": 0,
      "amount_credited_default": 0,
      "amount_credited_normalized": 0,
      "expense": 0,
      "expense_default": 0,
      "expense_normalized": 0
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "391"
        }
      },
      "creator": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "document_type": {
        "meta": {
          "included": false
        }
      },
      "proposal_document_type": {
        "meta": {
          "included": false
        }
      },
      "responsible": {
        "meta": {
          "included": false
        }
      },
      "deal_status": {
        "meta": {
          "included": false
        }
      },
      "project": {
        "meta": {
          "included": false
        }
      },
      "lost_reason": {
        "meta": {
          "included": false
        }
      },
      "contract": {
        "meta": {
          "included": false
        }
      },
      "contact": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "template": {
        "meta": {
          "included": false
        }
      },
      "tax_rate": {
        "meta": {
          "included": false
        }
      },
      "pipeline": {
        "meta": {
          "included": false
        }
      },
      "origin_deal": {
        "meta": {
          "included": false
        }
      },
      "designated_approver": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "next_todo": {
        "meta": {
          "included": false
        }
      },
      "expense_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "time_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "invoice_template": {
        "meta": {
          "included": false
        }
      },
      "automatic_invoicing_rule": {
        "meta": {
          "included": false
        }
      },
      "primary_contact": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/deals/220

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "deals",
    "attributes": {},
    "relationships": {
      "project": {
        "data": {
          "type": "projects",
          "id": "163"
        }
      }
    }
  }
}
Responses422
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "errors": [
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "attribute is invalid",
      "meta": {},
      "source": {
        "pointer": "data/attributes/project"
      }
    }
  ]
}

PATCH  /api/v2/deals/221

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "deals",
    "attributes": {
      "deal_status_id": "2114"
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "221",
    "type": "deals",
    "attributes": {
      "name": "test name",
      "date": "2026-04-01",
      "end_date": null,
      "number": "1",
      "deal_number": "1",
      "suffix": null,
      "time_approval": true,
      "expense_approval": true,
      "client_access": false,
      "deal_type_id": 2,
      "budget": false,
      "sales_status_updated_at": "2026-04-01T06:05:29.000+02:00",
      "tag_list": [],
      "origin_deal_id": null,
      "profit_margin": 0,
      "profit_margin_normalized": 0,
      "profit_margin_default": 0,
      "email_key": "e330d6efd5c71c719d7476dc69514071",
      "purchase_order_number": null,
      "custom_fields": null,
      "position": 1,
      "service_type_restricted_tracking": false,
      "tracking_type_id": 1,
      "editor_config": {},
      "discount": null,
      "man_day_minutes": 480,
      "rounding_interval_id": null,
      "rounding_method_id": 1,
      "validate_expense_when_closing": false,
      "revenue_distribution_type": "even",
      "color_id": null,
      "connection_status": "none",
      "revenue_distribution_method": null,
      "retainer_interval": null,
      "retainer_interval_count": 1,
      "deal_value": "0.0",
      "deal_value_source": "from_services",
      "deal_value_total": 0,
      "deal_value_total_default": 0,
      "deal_value_total_normalized": 0,
      "billable_time": 0,
      "budget_warning": null,
      "estimated_time": 0,
      "budgeted_time": 0,
      "worked_time": 0,
      "time_to_close": 0,
      "days_since_created": 0,
      "days_since_last_activity": 0,
      "days_in_current_stage": 0,
      "probability": 100,
      "previous_probability": 50,
      "note_interpolated": null,
      "proposal_note_interpolated": null,
      "footer_interpolated": null,
      "proposal_footer_interpolated": null,
      "todo_count": 0,
      "todo_due_date": null,
      "note": null,
      "proposal_note": null,
      "lost_comment": null,
      "closed_at": null,
      "delivered_on": null,
      "last_activity_at": "2026-04-01T06:05:29.000+02:00",
      "deleted_at": null,
      "created_at": "2026-04-01T06:05:29.333+02:00",
      "sales_closed_at": "2026-04-01T06:05:29.000+02:00",
      "exchange_rate": "1.25",
      "exchange_date": "2026-04-01",
      "sales_closed_on": "2026-04-01",
      "sample_data": false,
      "external_id": null,
      "external_sync": false,
      "manual_invoicing_status_id": 1,
      "footer": null,
      "proposal_footer": null,
      "access_to_deal": true,
      "currency": "EUR",
      "currency_default": "USD",
      "currency_normalized": "EUR",
      "revenue": 0,
      "revenue_default": 0,
      "revenue_normalized": 0,
      "services_revenue": 0,
      "services_revenue_default": 0,
      "services_revenue_normalized": 0,
      "budget_total": 0,
      "budget_total_default": 0,
      "budget_total_normalized": 0,
      "budget_used": 0,
      "budget_used_default": 0,
      "budget_used_normalized": 0,
      "projected_revenue": 0,
      "projected_revenue_default": 0,
      "projected_revenue_normalized": 0,
      "cost": 0,
      "cost_default": 0,
      "cost_normalized": 0,
      "profit": 0,
      "profit_default": 0,
      "profit_normalized": 0,
      "invoiced": 0,
      "invoiced_default": 0,
      "invoiced_normalized": 0,
      "pending_invoicing": 0,
      "pending_invoicing_default": 0,
      "pending_invoicing_normalized": 0,
      "manually_invoiced": 0,
      "manually_invoiced_default": 0,
      "manually_invoiced_normalized": 0,
      "draft_invoiced": 0,
      "draft_invoiced_default": 0,
      "draft_invoiced_normalized": 0,
      "amount_credited": 0,
      "amount_credited_default": 0,
      "amount_credited_normalized": 0,
      "expense": 0,
      "expense_default": 0,
      "expense_normalized": 0
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "393"
        }
      },
      "creator": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "document_type": {
        "meta": {
          "included": false
        }
      },
      "proposal_document_type": {
        "meta": {
          "included": false
        }
      },
      "responsible": {
        "meta": {
          "included": false
        }
      },
      "deal_status": {
        "meta": {
          "included": false
        }
      },
      "project": {
        "meta": {
          "included": false
        }
      },
      "lost_reason": {
        "meta": {
          "included": false
        }
      },
      "contract": {
        "meta": {
          "included": false
        }
      },
      "contact": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "template": {
        "meta": {
          "included": false
        }
      },
      "tax_rate": {
        "meta": {
          "included": false
        }
      },
      "pipeline": {
        "meta": {
          "included": false
        }
      },
      "origin_deal": {
        "meta": {
          "included": false
        }
      },
      "designated_approver": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "next_todo": {
        "meta": {
          "included": false
        }
      },
      "expense_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "time_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "invoice_template": {
        "meta": {
          "included": false
        }
      },
      "automatic_invoicing_rule": {
        "meta": {
          "included": false
        }
      },
      "primary_contact": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/deals/222

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "deals",
    "attributes": {
      "deal_status_id": "2121"
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "222",
    "type": "deals",
    "attributes": {
      "name": "test name",
      "date": "2026-04-01",
      "end_date": null,
      "number": "1",
      "deal_number": "1",
      "suffix": null,
      "time_approval": true,
      "expense_approval": true,
      "client_access": false,
      "deal_type_id": 2,
      "budget": false,
      "sales_status_updated_at": "2026-04-01T06:05:29.000+02:00",
      "tag_list": [],
      "origin_deal_id": null,
      "profit_margin": 0,
      "profit_margin_normalized": 0,
      "profit_margin_default": 0,
      "email_key": "284b75258f08210668903412da0eb03a",
      "purchase_order_number": null,
      "custom_fields": null,
      "position": 1,
      "service_type_restricted_tracking": false,
      "tracking_type_id": 1,
      "editor_config": {},
      "discount": null,
      "man_day_minutes": 480,
      "rounding_interval_id": null,
      "rounding_method_id": 1,
      "validate_expense_when_closing": false,
      "revenue_distribution_type": "even",
      "color_id": null,
      "connection_status": "none",
      "revenue_distribution_method": null,
      "retainer_interval": null,
      "retainer_interval_count": 1,
      "deal_value": "0.0",
      "deal_value_source": "from_services",
      "deal_value_total": 0,
      "deal_value_total_default": 0,
      "deal_value_total_normalized": 0,
      "billable_time": 0,
      "budget_warning": null,
      "estimated_time": 0,
      "budgeted_time": 0,
      "worked_time": 0,
      "time_to_close": 0,
      "days_since_created": 0,
      "days_since_last_activity": 0,
      "days_in_current_stage": 0,
      "probability": 0,
      "previous_probability": 50,
      "note_interpolated": null,
      "proposal_note_interpolated": null,
      "footer_interpolated": null,
      "proposal_footer_interpolated": null,
      "todo_count": 0,
      "todo_due_date": null,
      "note": null,
      "proposal_note": null,
      "lost_comment": null,
      "closed_at": null,
      "delivered_on": null,
      "last_activity_at": "2026-04-01T06:05:29.000+02:00",
      "deleted_at": null,
      "created_at": "2026-04-01T06:05:29.529+02:00",
      "sales_closed_at": "2026-04-01T06:05:29.000+02:00",
      "exchange_rate": "1.25",
      "exchange_date": "2026-04-01",
      "sales_closed_on": "2026-04-01",
      "sample_data": false,
      "external_id": null,
      "external_sync": false,
      "manual_invoicing_status_id": 1,
      "footer": null,
      "proposal_footer": null,
      "access_to_deal": true,
      "currency": "EUR",
      "currency_default": "USD",
      "currency_normalized": "EUR",
      "revenue": 0,
      "revenue_default": 0,
      "revenue_normalized": 0,
      "services_revenue": 0,
      "services_revenue_default": 0,
      "services_revenue_normalized": 0,
      "budget_total": 0,
      "budget_total_default": 0,
      "budget_total_normalized": 0,
      "budget_used": 0,
      "budget_used_default": 0,
      "budget_used_normalized": 0,
      "projected_revenue": 0,
      "projected_revenue_default": 0,
      "projected_revenue_normalized": 0,
      "cost": 0,
      "cost_default": 0,
      "cost_normalized": 0,
      "profit": 0,
      "profit_default": 0,
      "profit_normalized": 0,
      "invoiced": 0,
      "invoiced_default": 0,
      "invoiced_normalized": 0,
      "pending_invoicing": 0,
      "pending_invoicing_default": 0,
      "pending_invoicing_normalized": 0,
      "manually_invoiced": 0,
      "manually_invoiced_default": 0,
      "manually_invoiced_normalized": 0,
      "draft_invoiced": 0,
      "draft_invoiced_default": 0,
      "draft_invoiced_normalized": 0,
      "amount_credited": 0,
      "amount_credited_default": 0,
      "amount_credited_normalized": 0,
      "expense": 0,
      "expense_default": 0,
      "expense_normalized": 0
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "394"
        }
      },
      "creator": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "document_type": {
        "meta": {
          "included": false
        }
      },
      "proposal_document_type": {
        "meta": {
          "included": false
        }
      },
      "responsible": {
        "meta": {
          "included": false
        }
      },
      "deal_status": {
        "meta": {
          "included": false
        }
      },
      "project": {
        "meta": {
          "included": false
        }
      },
      "lost_reason": {
        "meta": {
          "included": false
        }
      },
      "contract": {
        "meta": {
          "included": false
        }
      },
      "contact": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "template": {
        "meta": {
          "included": false
        }
      },
      "tax_rate": {
        "meta": {
          "included": false
        }
      },
      "pipeline": {
        "meta": {
          "included": false
        }
      },
      "origin_deal": {
        "meta": {
          "included": false
        }
      },
      "designated_approver": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "next_todo": {
        "meta": {
          "included": false
        }
      },
      "expense_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "time_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "invoice_template": {
        "meta": {
          "included": false
        }
      },
      "automatic_invoicing_rule": {
        "meta": {
          "included": false
        }
      },
      "primary_contact": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/deals/225

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "deals",
    "attributes": {
      "deal_status_id": "2142"
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "225",
    "type": "deals",
    "attributes": {
      "name": "test name",
      "date": "2026-04-01",
      "end_date": null,
      "number": "1",
      "deal_number": "1",
      "suffix": null,
      "time_approval": true,
      "expense_approval": true,
      "client_access": false,
      "deal_type_id": 2,
      "budget": false,
      "sales_status_updated_at": "2026-04-01T06:05:30.000+02:00",
      "tag_list": [],
      "origin_deal_id": null,
      "profit_margin": 0,
      "profit_margin_normalized": 0,
      "profit_margin_default": 0,
      "email_key": "7680fd767479f062b663a9f2a0d39c34",
      "purchase_order_number": null,
      "custom_fields": null,
      "position": 1,
      "service_type_restricted_tracking": false,
      "tracking_type_id": 1,
      "editor_config": {},
      "discount": null,
      "man_day_minutes": 480,
      "rounding_interval_id": null,
      "rounding_method_id": 1,
      "validate_expense_when_closing": false,
      "revenue_distribution_type": "even",
      "color_id": null,
      "connection_status": "none",
      "revenue_distribution_method": null,
      "retainer_interval": null,
      "retainer_interval_count": 1,
      "deal_value": "0.0",
      "deal_value_source": "from_services",
      "deal_value_total": 0,
      "deal_value_total_default": 0,
      "deal_value_total_normalized": 0,
      "billable_time": 0,
      "budget_warning": null,
      "estimated_time": 0,
      "budgeted_time": 0,
      "worked_time": 0,
      "time_to_close": null,
      "days_since_created": 0,
      "days_since_last_activity": 0,
      "days_in_current_stage": 0,
      "probability": 30,
      "previous_probability": 50,
      "note_interpolated": null,
      "proposal_note_interpolated": null,
      "footer_interpolated": null,
      "proposal_footer_interpolated": null,
      "todo_count": 0,
      "todo_due_date": null,
      "note": null,
      "proposal_note": null,
      "lost_comment": null,
      "closed_at": null,
      "delivered_on": null,
      "last_activity_at": "2026-04-01T06:05:30.000+02:00",
      "deleted_at": null,
      "created_at": "2026-04-01T06:05:30.136+02:00",
      "sales_closed_at": null,
      "exchange_rate": "1.25",
      "exchange_date": "2026-04-01",
      "sales_closed_on": null,
      "sample_data": false,
      "external_id": null,
      "external_sync": false,
      "manual_invoicing_status_id": 1,
      "footer": null,
      "proposal_footer": null,
      "access_to_deal": true,
      "currency": "EUR",
      "currency_default": "USD",
      "currency_normalized": "EUR",
      "revenue": 0,
      "revenue_default": 0,
      "revenue_normalized": 0,
      "services_revenue": 0,
      "services_revenue_default": 0,
      "services_revenue_normalized": 0,
      "budget_total": 0,
      "budget_total_default": 0,
      "budget_total_normalized": 0,
      "budget_used": 0,
      "budget_used_default": 0,
      "budget_used_normalized": 0,
      "projected_revenue": 0,
      "projected_revenue_default": 0,
      "projected_revenue_normalized": 0,
      "cost": 0,
      "cost_default": 0,
      "cost_normalized": 0,
      "profit": 0,
      "profit_default": 0,
      "profit_normalized": 0,
      "invoiced": 0,
      "invoiced_default": 0,
      "invoiced_normalized": 0,
      "pending_invoicing": 0,
      "pending_invoicing_default": 0,
      "pending_invoicing_normalized": 0,
      "manually_invoiced": 0,
      "manually_invoiced_default": 0,
      "manually_invoiced_normalized": 0,
      "draft_invoiced": 0,
      "draft_invoiced_default": 0,
      "draft_invoiced_normalized": 0,
      "amount_credited": 0,
      "amount_credited_default": 0,
      "amount_credited_normalized": 0,
      "expense": 0,
      "expense_default": 0,
      "expense_normalized": 0
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "397"
        }
      },
      "creator": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "document_type": {
        "meta": {
          "included": false
        }
      },
      "proposal_document_type": {
        "meta": {
          "included": false
        }
      },
      "responsible": {
        "meta": {
          "included": false
        }
      },
      "deal_status": {
        "meta": {
          "included": false
        }
      },
      "project": {
        "meta": {
          "included": false
        }
      },
      "lost_reason": {
        "meta": {
          "included": false
        }
      },
      "contract": {
        "meta": {
          "included": false
        }
      },
      "contact": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "template": {
        "meta": {
          "included": false
        }
      },
      "tax_rate": {
        "meta": {
          "included": false
        }
      },
      "pipeline": {
        "meta": {
          "included": false
        }
      },
      "origin_deal": {
        "meta": {
          "included": false
        }
      },
      "designated_approver": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "next_todo": {
        "meta": {
          "included": false
        }
      },
      "expense_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "time_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "invoice_template": {
        "meta": {
          "included": false
        }
      },
      "automatic_invoicing_rule": {
        "meta": {
          "included": false
        }
      },
      "primary_contact": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/deals/226

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "deals",
    "attributes": {
      "deal_status_id": "2149"
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "226",
    "type": "deals",
    "attributes": {
      "name": "test name",
      "date": "2026-04-01",
      "end_date": null,
      "number": "1",
      "deal_number": "1",
      "suffix": null,
      "time_approval": true,
      "expense_approval": true,
      "client_access": false,
      "deal_type_id": 2,
      "budget": false,
      "sales_status_updated_at": "2026-04-01T06:05:30.000+02:00",
      "tag_list": [],
      "origin_deal_id": null,
      "profit_margin": 0,
      "profit_margin_normalized": 0,
      "profit_margin_default": 0,
      "email_key": "e16efb9f63ade6c0b7ef8efa2b0c82da",
      "purchase_order_number": null,
      "custom_fields": null,
      "position": 1,
      "service_type_restricted_tracking": false,
      "tracking_type_id": 1,
      "editor_config": {},
      "discount": null,
      "man_day_minutes": 480,
      "rounding_interval_id": null,
      "rounding_method_id": 1,
      "validate_expense_when_closing": false,
      "revenue_distribution_type": "even",
      "color_id": null,
      "connection_status": "none",
      "revenue_distribution_method": null,
      "retainer_interval": null,
      "retainer_interval_count": 1,
      "deal_value": "0.0",
      "deal_value_source": "from_services",
      "deal_value_total": 0,
      "deal_value_total_default": 0,
      "deal_value_total_normalized": 0,
      "billable_time": 0,
      "budget_warning": null,
      "estimated_time": 0,
      "budgeted_time": 0,
      "worked_time": 0,
      "time_to_close": null,
      "days_since_created": 0,
      "days_since_last_activity": 0,
      "days_in_current_stage": 0,
      "probability": 50,
      "previous_probability": null,
      "note_interpolated": null,
      "proposal_note_interpolated": null,
      "footer_interpolated": null,
      "proposal_footer_interpolated": null,
      "todo_count": 0,
      "todo_due_date": null,
      "note": null,
      "proposal_note": null,
      "lost_comment": null,
      "closed_at": null,
      "delivered_on": null,
      "last_activity_at": "2026-04-01T06:05:30.000+02:00",
      "deleted_at": null,
      "created_at": "2026-04-01T06:05:30.329+02:00",
      "sales_closed_at": null,
      "exchange_rate": "1.25",
      "exchange_date": "2026-04-01",
      "sales_closed_on": null,
      "sample_data": false,
      "external_id": null,
      "external_sync": false,
      "manual_invoicing_status_id": 1,
      "footer": null,
      "proposal_footer": null,
      "access_to_deal": true,
      "currency": "EUR",
      "currency_default": "USD",
      "currency_normalized": "EUR",
      "revenue": 0,
      "revenue_default": 0,
      "revenue_normalized": 0,
      "services_revenue": 0,
      "services_revenue_default": 0,
      "services_revenue_normalized": 0,
      "budget_total": 0,
      "budget_total_default": 0,
      "budget_total_normalized": 0,
      "budget_used": 0,
      "budget_used_default": 0,
      "budget_used_normalized": 0,
      "projected_revenue": 0,
      "projected_revenue_default": 0,
      "projected_revenue_normalized": 0,
      "cost": 0,
      "cost_default": 0,
      "cost_normalized": 0,
      "profit": 0,
      "profit_default": 0,
      "profit_normalized": 0,
      "invoiced": 0,
      "invoiced_default": 0,
      "invoiced_normalized": 0,
      "pending_invoicing": 0,
      "pending_invoicing_default": 0,
      "pending_invoicing_normalized": 0,
      "manually_invoiced": 0,
      "manually_invoiced_default": 0,
      "manually_invoiced_normalized": 0,
      "draft_invoiced": 0,
      "draft_invoiced_default": 0,
      "draft_invoiced_normalized": 0,
      "amount_credited": 0,
      "amount_credited_default": 0,
      "amount_credited_normalized": 0,
      "expense": 0,
      "expense_default": 0,
      "expense_normalized": 0
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "398"
        }
      },
      "creator": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "document_type": {
        "meta": {
          "included": false
        }
      },
      "proposal_document_type": {
        "meta": {
          "included": false
        }
      },
      "responsible": {
        "meta": {
          "included": false
        }
      },
      "deal_status": {
        "meta": {
          "included": false
        }
      },
      "project": {
        "meta": {
          "included": false
        }
      },
      "lost_reason": {
        "meta": {
          "included": false
        }
      },
      "contract": {
        "meta": {
          "included": false
        }
      },
      "contact": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "template": {
        "meta": {
          "included": false
        }
      },
      "tax_rate": {
        "meta": {
          "included": false
        }
      },
      "pipeline": {
        "meta": {
          "included": false
        }
      },
      "origin_deal": {
        "meta": {
          "included": false
        }
      },
      "designated_approver": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "next_todo": {
        "meta": {
          "included": false
        }
      },
      "expense_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "time_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "invoice_template": {
        "meta": {
          "included": false
        }
      },
      "automatic_invoicing_rule": {
        "meta": {
          "included": false
        }
      },
      "primary_contact": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/deals/227

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "deals",
    "attributes": {
      "probability": 90
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "227",
    "type": "deals",
    "attributes": {
      "name": "test name",
      "date": "2026-04-01",
      "end_date": null,
      "number": "1",
      "deal_number": "1",
      "suffix": null,
      "time_approval": true,
      "expense_approval": true,
      "client_access": false,
      "deal_type_id": 2,
      "budget": false,
      "sales_status_updated_at": "2026-04-01T06:05:00.000+02:00",
      "tag_list": [],
      "origin_deal_id": null,
      "profit_margin": 0,
      "profit_margin_normalized": 0,
      "profit_margin_default": 0,
      "email_key": "ec78fe1db7083f36d20ed9b905343822",
      "purchase_order_number": null,
      "custom_fields": null,
      "position": 1,
      "service_type_restricted_tracking": false,
      "tracking_type_id": 1,
      "editor_config": {},
      "discount": null,
      "man_day_minutes": 480,
      "rounding_interval_id": null,
      "rounding_method_id": 1,
      "validate_expense_when_closing": false,
      "revenue_distribution_type": "even",
      "color_id": null,
      "connection_status": "none",
      "revenue_distribution_method": null,
      "retainer_interval": null,
      "retainer_interval_count": 1,
      "deal_value": "0.0",
      "deal_value_source": "from_services",
      "deal_value_total": 0,
      "deal_value_total_default": 0,
      "deal_value_total_normalized": 0,
      "billable_time": 0,
      "budget_warning": null,
      "estimated_time": 0,
      "budgeted_time": 0,
      "worked_time": 0,
      "time_to_close": null,
      "days_since_created": 0,
      "days_since_last_activity": 0,
      "days_in_current_stage": 0,
      "probability": 90,
      "previous_probability": 50,
      "note_interpolated": null,
      "proposal_note_interpolated": null,
      "footer_interpolated": null,
      "proposal_footer_interpolated": null,
      "todo_count": 0,
      "todo_due_date": null,
      "note": null,
      "proposal_note": null,
      "lost_comment": null,
      "closed_at": null,
      "delivered_on": null,
      "last_activity_at": "2026-04-01T06:05:30.000+02:00",
      "deleted_at": null,
      "created_at": "2026-04-01T06:05:30.534+02:00",
      "sales_closed_at": null,
      "exchange_rate": "1.25",
      "exchange_date": "2026-04-01",
      "sales_closed_on": null,
      "sample_data": false,
      "external_id": null,
      "external_sync": false,
      "manual_invoicing_status_id": 1,
      "footer": null,
      "proposal_footer": null,
      "access_to_deal": true,
      "currency": "EUR",
      "currency_default": "USD",
      "currency_normalized": "EUR",
      "revenue": 0,
      "revenue_default": 0,
      "revenue_normalized": 0,
      "services_revenue": 0,
      "services_revenue_default": 0,
      "services_revenue_normalized": 0,
      "budget_total": 0,
      "budget_total_default": 0,
      "budget_total_normalized": 0,
      "budget_used": 0,
      "budget_used_default": 0,
      "budget_used_normalized": 0,
      "projected_revenue": 0,
      "projected_revenue_default": 0,
      "projected_revenue_normalized": 0,
      "cost": 0,
      "cost_default": 0,
      "cost_normalized": 0,
      "profit": 0,
      "profit_default": 0,
      "profit_normalized": 0,
      "invoiced": 0,
      "invoiced_default": 0,
      "invoiced_normalized": 0,
      "pending_invoicing": 0,
      "pending_invoicing_default": 0,
      "pending_invoicing_normalized": 0,
      "manually_invoiced": 0,
      "manually_invoiced_default": 0,
      "manually_invoiced_normalized": 0,
      "draft_invoiced": 0,
      "draft_invoiced_default": 0,
      "draft_invoiced_normalized": 0,
      "amount_credited": 0,
      "amount_credited_default": 0,
      "amount_credited_normalized": 0,
      "expense": 0,
      "expense_default": 0,
      "expense_normalized": 0
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "399"
        }
      },
      "creator": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "document_type": {
        "meta": {
          "included": false
        }
      },
      "proposal_document_type": {
        "meta": {
          "included": false
        }
      },
      "responsible": {
        "meta": {
          "included": false
        }
      },
      "deal_status": {
        "meta": {
          "included": false
        }
      },
      "project": {
        "meta": {
          "included": false
        }
      },
      "lost_reason": {
        "meta": {
          "included": false
        }
      },
      "contract": {
        "meta": {
          "included": false
        }
      },
      "contact": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "template": {
        "meta": {
          "included": false
        }
      },
      "tax_rate": {
        "meta": {
          "included": false
        }
      },
      "pipeline": {
        "meta": {
          "included": false
        }
      },
      "origin_deal": {
        "meta": {
          "included": false
        }
      },
      "designated_approver": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "next_todo": {
        "meta": {
          "included": false
        }
      },
      "expense_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "time_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "invoice_template": {
        "meta": {
          "included": false
        }
      },
      "automatic_invoicing_rule": {
        "meta": {
          "included": false
        }
      },
      "primary_contact": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/deals/228

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "deals",
    "attributes": {
      "probability": 90
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "228",
    "type": "deals",
    "attributes": {
      "name": "test name",
      "date": "2026-04-01",
      "end_date": null,
      "number": "1",
      "deal_number": "1",
      "suffix": null,
      "time_approval": true,
      "expense_approval": true,
      "client_access": false,
      "deal_type_id": 2,
      "budget": false,
      "sales_status_updated_at": "2026-04-01T06:05:00.000+02:00",
      "tag_list": [],
      "origin_deal_id": null,
      "profit_margin": 0,
      "profit_margin_normalized": 0,
      "profit_margin_default": 0,
      "email_key": "debc1e44829a61455e98d0c94e9234a1",
      "purchase_order_number": null,
      "custom_fields": null,
      "position": 1,
      "service_type_restricted_tracking": false,
      "tracking_type_id": 1,
      "editor_config": {},
      "discount": null,
      "man_day_minutes": 480,
      "rounding_interval_id": null,
      "rounding_method_id": 1,
      "validate_expense_when_closing": false,
      "revenue_distribution_type": "even",
      "color_id": null,
      "connection_status": "none",
      "revenue_distribution_method": null,
      "retainer_interval": null,
      "retainer_interval_count": 1,
      "deal_value": "0.0",
      "deal_value_source": "from_services",
      "deal_value_total": 0,
      "deal_value_total_default": 0,
      "deal_value_total_normalized": 0,
      "billable_time": 0,
      "budget_warning": null,
      "estimated_time": 0,
      "budgeted_time": 0,
      "worked_time": 0,
      "time_to_close": null,
      "days_since_created": 0,
      "days_since_last_activity": 0,
      "days_in_current_stage": 0,
      "probability": 90,
      "previous_probability": 30,
      "note_interpolated": null,
      "proposal_note_interpolated": null,
      "footer_interpolated": null,
      "proposal_footer_interpolated": null,
      "todo_count": 0,
      "todo_due_date": null,
      "note": null,
      "proposal_note": null,
      "lost_comment": null,
      "closed_at": null,
      "delivered_on": null,
      "last_activity_at": "2026-04-01T06:05:30.000+02:00",
      "deleted_at": null,
      "created_at": "2026-04-01T06:05:30.740+02:00",
      "sales_closed_at": null,
      "exchange_rate": "1.25",
      "exchange_date": "2026-04-01",
      "sales_closed_on": null,
      "sample_data": false,
      "external_id": null,
      "external_sync": false,
      "manual_invoicing_status_id": 1,
      "footer": null,
      "proposal_footer": null,
      "access_to_deal": true,
      "currency": "EUR",
      "currency_default": "USD",
      "currency_normalized": "EUR",
      "revenue": 0,
      "revenue_default": 0,
      "revenue_normalized": 0,
      "services_revenue": 0,
      "services_revenue_default": 0,
      "services_revenue_normalized": 0,
      "budget_total": 0,
      "budget_total_default": 0,
      "budget_total_normalized": 0,
      "budget_used": 0,
      "budget_used_default": 0,
      "budget_used_normalized": 0,
      "projected_revenue": 0,
      "projected_revenue_default": 0,
      "projected_revenue_normalized": 0,
      "cost": 0,
      "cost_default": 0,
      "cost_normalized": 0,
      "profit": 0,
      "profit_default": 0,
      "profit_normalized": 0,
      "invoiced": 0,
      "invoiced_default": 0,
      "invoiced_normalized": 0,
      "pending_invoicing": 0,
      "pending_invoicing_default": 0,
      "pending_invoicing_normalized": 0,
      "manually_invoiced": 0,
      "manually_invoiced_default": 0,
      "manually_invoiced_normalized": 0,
      "draft_invoiced": 0,
      "draft_invoiced_default": 0,
      "draft_invoiced_normalized": 0,
      "amount_credited": 0,
      "amount_credited_default": 0,
      "amount_credited_normalized": 0,
      "expense": 0,
      "expense_default": 0,
      "expense_normalized": 0
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "400"
        }
      },
      "creator": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "document_type": {
        "meta": {
          "included": false
        }
      },
      "proposal_document_type": {
        "meta": {
          "included": false
        }
      },
      "responsible": {
        "meta": {
          "included": false
        }
      },
      "deal_status": {
        "meta": {
          "included": false
        }
      },
      "project": {
        "meta": {
          "included": false
        }
      },
      "lost_reason": {
        "meta": {
          "included": false
        }
      },
      "contract": {
        "meta": {
          "included": false
        }
      },
      "contact": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "template": {
        "meta": {
          "included": false
        }
      },
      "tax_rate": {
        "meta": {
          "included": false
        }
      },
      "pipeline": {
        "meta": {
          "included": false
        }
      },
      "origin_deal": {
        "meta": {
          "included": false
        }
      },
      "designated_approver": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "next_todo": {
        "meta": {
          "included": false
        }
      },
      "expense_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "time_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "invoice_template": {
        "meta": {
          "included": false
        }
      },
      "automatic_invoicing_rule": {
        "meta": {
          "included": false
        }
      },
      "primary_contact": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/deals/229

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "deals",
    "attributes": {
      "probability": 90
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "229",
    "type": "deals",
    "attributes": {
      "name": "test name",
      "date": "2026-04-01",
      "end_date": null,
      "number": "1",
      "deal_number": "1",
      "suffix": null,
      "time_approval": true,
      "expense_approval": true,
      "client_access": false,
      "deal_type_id": 2,
      "budget": false,
      "sales_status_updated_at": "2026-04-01T06:05:00.000+02:00",
      "tag_list": [],
      "origin_deal_id": null,
      "profit_margin": 0,
      "profit_margin_normalized": 0,
      "profit_margin_default": 0,
      "email_key": "288694381e4961d85ea2b7251a1d1443",
      "purchase_order_number": null,
      "custom_fields": null,
      "position": 1,
      "service_type_restricted_tracking": false,
      "tracking_type_id": 1,
      "editor_config": {},
      "discount": null,
      "man_day_minutes": 480,
      "rounding_interval_id": null,
      "rounding_method_id": 1,
      "validate_expense_when_closing": false,
      "revenue_distribution_type": "even",
      "color_id": null,
      "connection_status": "none",
      "revenue_distribution_method": null,
      "retainer_interval": null,
      "retainer_interval_count": 1,
      "deal_value": "0.0",
      "deal_value_source": "from_services",
      "deal_value_total": 0,
      "deal_value_total_default": 0,
      "deal_value_total_normalized": 0,
      "billable_time": 0,
      "budget_warning": null,
      "estimated_time": 0,
      "budgeted_time": 0,
      "worked_time": 0,
      "time_to_close": null,
      "days_since_created": 0,
      "days_since_last_activity": 0,
      "days_in_current_stage": 0,
      "probability": 90,
      "previous_probability": 50,
      "note_interpolated": null,
      "proposal_note_interpolated": null,
      "footer_interpolated": null,
      "proposal_footer_interpolated": null,
      "todo_count": 0,
      "todo_due_date": null,
      "note": null,
      "proposal_note": null,
      "lost_comment": null,
      "closed_at": null,
      "delivered_on": null,
      "last_activity_at": "2026-04-01T06:05:30.000+02:00",
      "deleted_at": null,
      "created_at": "2026-04-01T06:05:30.935+02:00",
      "sales_closed_at": null,
      "exchange_rate": "1.25",
      "exchange_date": "2026-04-01",
      "sales_closed_on": null,
      "sample_data": false,
      "external_id": null,
      "external_sync": false,
      "manual_invoicing_status_id": 1,
      "footer": null,
      "proposal_footer": null,
      "access_to_deal": true,
      "currency": "EUR",
      "currency_default": "USD",
      "currency_normalized": "EUR",
      "revenue": 0,
      "revenue_default": 0,
      "revenue_normalized": 0,
      "services_revenue": 0,
      "services_revenue_default": 0,
      "services_revenue_normalized": 0,
      "budget_total": 0,
      "budget_total_default": 0,
      "budget_total_normalized": 0,
      "budget_used": 0,
      "budget_used_default": 0,
      "budget_used_normalized": 0,
      "projected_revenue": 0,
      "projected_revenue_default": 0,
      "projected_revenue_normalized": 0,
      "cost": 0,
      "cost_default": 0,
      "cost_normalized": 0,
      "profit": 0,
      "profit_default": 0,
      "profit_normalized": 0,
      "invoiced": 0,
      "invoiced_default": 0,
      "invoiced_normalized": 0,
      "pending_invoicing": 0,
      "pending_invoicing_default": 0,
      "pending_invoicing_normalized": 0,
      "manually_invoiced": 0,
      "manually_invoiced_default": 0,
      "manually_invoiced_normalized": 0,
      "draft_invoiced": 0,
      "draft_invoiced_default": 0,
      "draft_invoiced_normalized": 0,
      "amount_credited": 0,
      "amount_credited_default": 0,
      "amount_credited_normalized": 0,
      "expense": 0,
      "expense_default": 0,
      "expense_normalized": 0
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "401"
        }
      },
      "creator": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "document_type": {
        "meta": {
          "included": false
        }
      },
      "proposal_document_type": {
        "meta": {
          "included": false
        }
      },
      "responsible": {
        "meta": {
          "included": false
        }
      },
      "deal_status": {
        "meta": {
          "included": false
        }
      },
      "project": {
        "meta": {
          "included": false
        }
      },
      "lost_reason": {
        "meta": {
          "included": false
        }
      },
      "contract": {
        "meta": {
          "included": false
        }
      },
      "contact": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "template": {
        "meta": {
          "included": false
        }
      },
      "tax_rate": {
        "meta": {
          "included": false
        }
      },
      "pipeline": {
        "meta": {
          "included": false
        }
      },
      "origin_deal": {
        "meta": {
          "included": false
        }
      },
      "designated_approver": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "next_todo": {
        "meta": {
          "included": false
        }
      },
      "expense_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "time_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "invoice_template": {
        "meta": {
          "included": false
        }
      },
      "automatic_invoicing_rule": {
        "meta": {
          "included": false
        }
      },
      "primary_contact": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/deals/230

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "deals",
    "attributes": {
      "probability": 90
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "230",
    "type": "deals",
    "attributes": {
      "name": "test name",
      "date": "2026-04-01",
      "end_date": null,
      "number": "1",
      "deal_number": "1",
      "suffix": null,
      "time_approval": true,
      "expense_approval": true,
      "client_access": false,
      "deal_type_id": 2,
      "budget": false,
      "sales_status_updated_at": "2026-04-01T06:05:00.000+02:00",
      "tag_list": [],
      "origin_deal_id": null,
      "profit_margin": 0,
      "profit_margin_normalized": 0,
      "profit_margin_default": 0,
      "email_key": "6ec0ff447d10ad65c7c3dbb80d6c55ee",
      "purchase_order_number": null,
      "custom_fields": null,
      "position": 1,
      "service_type_restricted_tracking": false,
      "tracking_type_id": 1,
      "editor_config": {},
      "discount": null,
      "man_day_minutes": 480,
      "rounding_interval_id": null,
      "rounding_method_id": 1,
      "validate_expense_when_closing": false,
      "revenue_distribution_type": "even",
      "color_id": null,
      "connection_status": "none",
      "revenue_distribution_method": null,
      "retainer_interval": null,
      "retainer_interval_count": 1,
      "deal_value": "0.0",
      "deal_value_source": "from_services",
      "deal_value_total": 0,
      "deal_value_total_default": 0,
      "deal_value_total_normalized": 0,
      "billable_time": 0,
      "budget_warning": null,
      "estimated_time": 0,
      "budgeted_time": 0,
      "worked_time": 0,
      "time_to_close": null,
      "days_since_created": 0,
      "days_since_last_activity": 0,
      "days_in_current_stage": 0,
      "probability": 90,
      "previous_probability": 50,
      "note_interpolated": null,
      "proposal_note_interpolated": null,
      "footer_interpolated": null,
      "proposal_footer_interpolated": null,
      "todo_count": 0,
      "todo_due_date": null,
      "note": null,
      "proposal_note": null,
      "lost_comment": null,
      "closed_at": null,
      "delivered_on": null,
      "last_activity_at": "2026-04-01T06:05:31.000+02:00",
      "deleted_at": null,
      "created_at": "2026-04-01T06:05:31.118+02:00",
      "sales_closed_at": null,
      "exchange_rate": "1.25",
      "exchange_date": "2026-04-01",
      "sales_closed_on": null,
      "sample_data": false,
      "external_id": "123",
      "external_sync": false,
      "manual_invoicing_status_id": 1,
      "footer": null,
      "proposal_footer": null,
      "access_to_deal": true,
      "currency": "EUR",
      "currency_default": "USD",
      "currency_normalized": "EUR",
      "revenue": 0,
      "revenue_default": 0,
      "revenue_normalized": 0,
      "services_revenue": 0,
      "services_revenue_default": 0,
      "services_revenue_normalized": 0,
      "budget_total": 0,
      "budget_total_default": 0,
      "budget_total_normalized": 0,
      "budget_used": 0,
      "budget_used_default": 0,
      "budget_used_normalized": 0,
      "projected_revenue": 0,
      "projected_revenue_default": 0,
      "projected_revenue_normalized": 0,
      "cost": 0,
      "cost_default": 0,
      "cost_normalized": 0,
      "profit": 0,
      "profit_default": 0,
      "profit_normalized": 0,
      "invoiced": 0,
      "invoiced_default": 0,
      "invoiced_normalized": 0,
      "pending_invoicing": 0,
      "pending_invoicing_default": 0,
      "pending_invoicing_normalized": 0,
      "manually_invoiced": 0,
      "manually_invoiced_default": 0,
      "manually_invoiced_normalized": 0,
      "draft_invoiced": 0,
      "draft_invoiced_default": 0,
      "draft_invoiced_normalized": 0,
      "amount_credited": 0,
      "amount_credited_default": 0,
      "amount_credited_normalized": 0,
      "expense": 0,
      "expense_default": 0,
      "expense_normalized": 0
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "402"
        }
      },
      "creator": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "document_type": {
        "meta": {
          "included": false
        }
      },
      "proposal_document_type": {
        "meta": {
          "included": false
        }
      },
      "responsible": {
        "meta": {
          "included": false
        }
      },
      "deal_status": {
        "meta": {
          "included": false
        }
      },
      "project": {
        "meta": {
          "included": false
        }
      },
      "lost_reason": {
        "meta": {
          "included": false
        }
      },
      "contract": {
        "meta": {
          "included": false
        }
      },
      "contact": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "template": {
        "meta": {
          "included": false
        }
      },
      "tax_rate": {
        "meta": {
          "included": false
        }
      },
      "pipeline": {
        "meta": {
          "included": false
        }
      },
      "origin_deal": {
        "meta": {
          "included": false
        }
      },
      "designated_approver": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "next_todo": {
        "meta": {
          "included": false
        }
      },
      "expense_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "time_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "invoice_template": {
        "meta": {
          "included": false
        }
      },
      "automatic_invoicing_rule": {
        "meta": {
          "included": false
        }
      },
      "primary_contact": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/deals/231

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "deals",
    "attributes": {
      "note": "Meh"
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "231",
    "type": "deals",
    "attributes": {
      "name": "test name",
      "date": "2026-04-01",
      "end_date": null,
      "number": "1",
      "deal_number": "1",
      "suffix": null,
      "time_approval": true,
      "expense_approval": true,
      "client_access": false,
      "deal_type_id": 2,
      "budget": false,
      "sales_status_updated_at": "2026-04-01T06:05:00.000+02:00",
      "tag_list": [],
      "origin_deal_id": null,
      "profit_margin": 0,
      "profit_margin_normalized": 0,
      "profit_margin_default": 0,
      "email_key": "ae17ec77f2f093e14dd2fd304eade344",
      "purchase_order_number": null,
      "custom_fields": null,
      "position": 1,
      "service_type_restricted_tracking": false,
      "tracking_type_id": 1,
      "editor_config": {},
      "discount": null,
      "man_day_minutes": 480,
      "rounding_interval_id": null,
      "rounding_method_id": 1,
      "validate_expense_when_closing": false,
      "revenue_distribution_type": "even",
      "color_id": null,
      "connection_status": "none",
      "revenue_distribution_method": null,
      "retainer_interval": null,
      "retainer_interval_count": 1,
      "deal_value": "0.0",
      "deal_value_source": "from_services",
      "deal_value_total": 0,
      "deal_value_total_default": 0,
      "deal_value_total_normalized": 0,
      "billable_time": 0,
      "budget_warning": null,
      "estimated_time": 0,
      "budgeted_time": 0,
      "worked_time": 0,
      "time_to_close": null,
      "days_since_created": 0,
      "days_since_last_activity": 0,
      "days_in_current_stage": 0,
      "probability": 50,
      "previous_probability": null,
      "note_interpolated": "Meh",
      "proposal_note_interpolated": null,
      "footer_interpolated": null,
      "proposal_footer_interpolated": null,
      "todo_count": 0,
      "todo_due_date": null,
      "note": "Meh",
      "proposal_note": null,
      "lost_comment": null,
      "closed_at": null,
      "delivered_on": null,
      "last_activity_at": "2026-04-01T06:05:31.000+02:00",
      "deleted_at": null,
      "created_at": "2026-04-01T06:05:31.308+02:00",
      "sales_closed_at": null,
      "exchange_rate": "1.25",
      "exchange_date": "2026-04-01",
      "sales_closed_on": null,
      "sample_data": false,
      "external_id": "123",
      "external_sync": true,
      "manual_invoicing_status_id": 1,
      "footer": null,
      "proposal_footer": null,
      "access_to_deal": true,
      "currency": "EUR",
      "currency_default": "USD",
      "currency_normalized": "EUR",
      "revenue": 0,
      "revenue_default": 0,
      "revenue_normalized": 0,
      "services_revenue": 0,
      "services_revenue_default": 0,
      "services_revenue_normalized": 0,
      "budget_total": 0,
      "budget_total_default": 0,
      "budget_total_normalized": 0,
      "budget_used": 0,
      "budget_used_default": 0,
      "budget_used_normalized": 0,
      "projected_revenue": 0,
      "projected_revenue_default": 0,
      "projected_revenue_normalized": 0,
      "cost": 0,
      "cost_default": 0,
      "cost_normalized": 0,
      "profit": 0,
      "profit_default": 0,
      "profit_normalized": 0,
      "invoiced": 0,
      "invoiced_default": 0,
      "invoiced_normalized": 0,
      "pending_invoicing": 0,
      "pending_invoicing_default": 0,
      "pending_invoicing_normalized": 0,
      "manually_invoiced": 0,
      "manually_invoiced_default": 0,
      "manually_invoiced_normalized": 0,
      "draft_invoiced": 0,
      "draft_invoiced_default": 0,
      "draft_invoiced_normalized": 0,
      "amount_credited": 0,
      "amount_credited_default": 0,
      "amount_credited_normalized": 0,
      "expense": 0,
      "expense_default": 0,
      "expense_normalized": 0
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "403"
        }
      },
      "creator": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "document_type": {
        "meta": {
          "included": false
        }
      },
      "proposal_document_type": {
        "meta": {
          "included": false
        }
      },
      "responsible": {
        "meta": {
          "included": false
        }
      },
      "deal_status": {
        "meta": {
          "included": false
        }
      },
      "project": {
        "meta": {
          "included": false
        }
      },
      "lost_reason": {
        "meta": {
          "included": false
        }
      },
      "contract": {
        "meta": {
          "included": false
        }
      },
      "contact": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "template": {
        "meta": {
          "included": false
        }
      },
      "tax_rate": {
        "meta": {
          "included": false
        }
      },
      "pipeline": {
        "meta": {
          "included": false
        }
      },
      "origin_deal": {
        "meta": {
          "included": false
        }
      },
      "designated_approver": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "next_todo": {
        "meta": {
          "included": false
        }
      },
      "expense_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "time_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "invoice_template": {
        "meta": {
          "included": false
        }
      },
      "automatic_invoicing_rule": {
        "meta": {
          "included": false
        }
      },
      "primary_contact": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

Update a deal
PATCH/api/v2/deals/{id}

URI Parameters
HideShow
id
number (required) Example: 1

deal id

DELETE /api/v2/deals/1
Requestsdeletes deal

DELETE  /api/v2/deals/232

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Responses204
This response has no content.

Deletes a deal
DELETE/api/v2/deals/{id}

URI Parameters
HideShow
id
number (required) Example: 1

deal id

POST /api/v2/deals/create_from_origin
Requestscreates budget from origin dealreturns error

POST  /api/v2/deals/create_from_origin

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "deals",
    "relationships": {
      "origin_deal": {
        "data": {
          "type": "deals",
          "id": "237"
        }
      },
      "project": {
        "data": {
          "type": "projects",
          "id": "165"
        }
      }
    }
  }
}
Responses201
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "239",
    "type": "deals",
    "attributes": {
      "name": "test from origin",
      "date": "2026-04-01",
      "end_date": null,
      "number": "1",
      "deal_number": "1",
      "suffix": null,
      "time_approval": true,
      "expense_approval": true,
      "client_access": false,
      "deal_type_id": 2,
      "budget": true,
      "sales_status_updated_at": null,
      "tag_list": [],
      "origin_deal_id": 237,
      "profit_margin": "100.0",
      "profit_margin_normalized": "100.0",
      "profit_margin_default": "100.0",
      "email_key": "d9dead4aafe11156ee981d99f79eab94",
      "purchase_order_number": "abc",
      "custom_fields": null,
      "position": 1,
      "service_type_restricted_tracking": false,
      "tracking_type_id": 1,
      "editor_config": null,
      "discount": null,
      "man_day_minutes": 480,
      "rounding_interval_id": 2,
      "rounding_method_id": 4,
      "validate_expense_when_closing": false,
      "revenue_distribution_type": "default",
      "color_id": null,
      "connection_status": "none",
      "revenue_distribution_method": null,
      "retainer_interval": null,
      "retainer_interval_count": 1,
      "deal_value": "0.0",
      "deal_value_source": null,
      "deal_value_total": 0,
      "deal_value_total_default": 0,
      "deal_value_total_normalized": 0,
      "billable_time": 0,
      "budget_warning": 80,
      "estimated_time": 0,
      "budgeted_time": 0,
      "worked_time": 0,
      "time_to_close": null,
      "days_since_created": 0,
      "days_since_last_activity": 0,
      "days_in_current_stage": null,
      "probability": 100,
      "previous_probability": null,
      "note_interpolated": null,
      "proposal_note_interpolated": null,
      "footer_interpolated": null,
      "proposal_footer_interpolated": null,
      "todo_count": 0,
      "todo_due_date": null,
      "note": null,
      "proposal_note": null,
      "lost_comment": null,
      "closed_at": null,
      "delivered_on": null,
      "last_activity_at": "2026-04-01T06:05:32.000+02:00",
      "deleted_at": null,
      "created_at": "2026-04-01T06:05:32.840+02:00",
      "sales_closed_at": null,
      "exchange_rate": "1.25",
      "exchange_date": "2026-04-01",
      "sales_closed_on": null,
      "sample_data": false,
      "external_id": null,
      "external_sync": false,
      "manual_invoicing_status_id": 1,
      "footer": null,
      "proposal_footer": null,
      "access_to_deal": true,
      "currency": "EUR",
      "currency_default": "USD",
      "currency_normalized": "EUR",
      "revenue": 200000,
      "revenue_default": 250000,
      "revenue_normalized": 200000,
      "services_revenue": 0,
      "services_revenue_default": 0,
      "services_revenue_normalized": 0,
      "budget_total": 200000,
      "budget_total_default": 250000,
      "budget_total_normalized": 200000,
      "budget_used": 0,
      "budget_used_default": 0,
      "budget_used_normalized": 0,
      "projected_revenue": 0,
      "projected_revenue_default": 0,
      "projected_revenue_normalized": 0,
      "cost": 0,
      "cost_default": 0,
      "cost_normalized": 0,
      "profit": 200000,
      "profit_default": 250000,
      "profit_normalized": 200000,
      "invoiced": 0,
      "invoiced_default": 0,
      "invoiced_normalized": 0,
      "pending_invoicing": 200000,
      "pending_invoicing_default": 250000,
      "pending_invoicing_normalized": 200000,
      "manually_invoiced": 0,
      "manually_invoiced_default": 0,
      "manually_invoiced_normalized": 0,
      "draft_invoiced": 0,
      "draft_invoiced_default": 0,
      "draft_invoiced_normalized": 0,
      "amount_credited": 0,
      "amount_credited_default": 0,
      "amount_credited_normalized": 0,
      "expense": 0,
      "expense_default": 0,
      "expense_normalized": 0
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "407"
        }
      },
      "creator": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "document_type": {
        "meta": {
          "included": false
        }
      },
      "proposal_document_type": {
        "meta": {
          "included": false
        }
      },
      "responsible": {
        "meta": {
          "included": false
        }
      },
      "deal_status": {
        "meta": {
          "included": false
        }
      },
      "project": {
        "meta": {
          "included": false
        }
      },
      "lost_reason": {
        "meta": {
          "included": false
        }
      },
      "contract": {
        "meta": {
          "included": false
        }
      },
      "contact": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "template": {
        "meta": {
          "included": false
        }
      },
      "tax_rate": {
        "meta": {
          "included": false
        }
      },
      "pipeline": {
        "meta": {
          "included": false
        }
      },
      "origin_deal": {
        "meta": {
          "included": false
        }
      },
      "designated_approver": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "next_todo": {
        "meta": {
          "included": false
        }
      },
      "expense_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "time_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "invoice_template": {
        "meta": {
          "included": false
        }
      },
      "automatic_invoicing_rule": {
        "meta": {
          "included": false
        }
      },
      "primary_contact": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

POST  /api/v2/deals/create_from_origin

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "deals",
    "relationships": {}
  }
}
Responses422
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "errors": [
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "can't be blank",
      "meta": {},
      "source": {
        "pointer": "data/attributes/origin_deal"
      }
    }
  ]
}

Creates a budget from origin deal
POST/api/v2/deals/create_from_origin

URI Parameters
HideShow
id
number (required) Example: 1

deal id

POST /api/v2/deals/copy
Requestscopy from templatecopy from template

POST  /api/v2/deals/copy

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "deals",
    "attributes": {
      "name": "copied deal",
      "template_id": 283,
      "project_id": 177
    }
  }
}
Responses201
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "285",
    "type": "deals",
    "attributes": {
      "name": "copied deal",
      "date": "2026-04-01",
      "end_date": null,
      "number": "4",
      "deal_number": "4",
      "suffix": null,
      "time_approval": true,
      "expense_approval": true,
      "client_access": false,
      "deal_type_id": 2,
      "budget": false,
      "sales_status_updated_at": "2026-04-01T06:05:41.000+02:00",
      "tag_list": [],
      "origin_deal_id": null,
      "profit_margin": "100.0",
      "profit_margin_normalized": "100.0",
      "profit_margin_default": "100.0",
      "email_key": "bb1e0fa34958b08fd4a054680e3a7548",
      "purchase_order_number": null,
      "custom_fields": null,
      "position": 1,
      "service_type_restricted_tracking": false,
      "tracking_type_id": 1,
      "editor_config": {},
      "discount": null,
      "man_day_minutes": 480,
      "rounding_interval_id": null,
      "rounding_method_id": 1,
      "validate_expense_when_closing": false,
      "revenue_distribution_type": "even",
      "color_id": null,
      "connection_status": "none",
      "revenue_distribution_method": null,
      "retainer_interval": null,
      "retainer_interval_count": 1,
      "deal_value": "100000.0",
      "deal_value_source": "from_services",
      "deal_value_total": 100000,
      "deal_value_total_default": 125000,
      "deal_value_total_normalized": 100000,
      "billable_time": 0,
      "budget_warning": 80,
      "estimated_time": 0,
      "budgeted_time": 0,
      "worked_time": 0,
      "time_to_close": null,
      "days_since_created": 0,
      "days_since_last_activity": 0,
      "days_in_current_stage": 0,
      "probability": 50,
      "previous_probability": null,
      "note_interpolated": null,
      "proposal_note_interpolated": null,
      "footer_interpolated": null,
      "proposal_footer_interpolated": null,
      "todo_count": 0,
      "todo_due_date": null,
      "note": null,
      "proposal_note": null,
      "lost_comment": null,
      "closed_at": null,
      "delivered_on": null,
      "last_activity_at": "2026-04-01T06:05:40.000+02:00",
      "deleted_at": null,
      "created_at": "2026-04-01T06:05:41.093+02:00",
      "sales_closed_at": null,
      "exchange_rate": "1.25",
      "exchange_date": "2026-04-01",
      "sales_closed_on": null,
      "sample_data": false,
      "external_id": null,
      "external_sync": false,
      "manual_invoicing_status_id": 1,
      "footer": null,
      "proposal_footer": null,
      "access_to_deal": true,
      "currency": "EUR",
      "currency_default": "USD",
      "currency_normalized": "EUR",
      "revenue": 100000,
      "revenue_default": 125000,
      "revenue_normalized": 100000,
      "services_revenue": 0,
      "services_revenue_default": 0,
      "services_revenue_normalized": 0,
      "budget_total": 100000,
      "budget_total_default": 125000,
      "budget_total_normalized": 100000,
      "budget_used": 0,
      "budget_used_default": 0,
      "budget_used_normalized": 0,
      "projected_revenue": 50000,
      "projected_revenue_default": 62500,
      "projected_revenue_normalized": 50000,
      "cost": 0,
      "cost_default": 0,
      "cost_normalized": 0,
      "profit": 100000,
      "profit_default": 125000,
      "profit_normalized": 100000,
      "invoiced": 0,
      "invoiced_default": 0,
      "invoiced_normalized": 0,
      "pending_invoicing": 100000,
      "pending_invoicing_default": 125000,
      "pending_invoicing_normalized": 100000,
      "manually_invoiced": 0,
      "manually_invoiced_default": 0,
      "manually_invoiced_normalized": 0,
      "draft_invoiced": 0,
      "draft_invoiced_default": 0,
      "draft_invoiced_normalized": 0,
      "amount_credited": 0,
      "amount_credited_default": 0,
      "amount_credited_normalized": 0,
      "expense": 0,
      "expense_default": 0,
      "expense_normalized": 0
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "419"
        }
      },
      "creator": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "document_type": {
        "meta": {
          "included": false
        }
      },
      "proposal_document_type": {
        "meta": {
          "included": false
        }
      },
      "responsible": {
        "meta": {
          "included": false
        }
      },
      "deal_status": {
        "meta": {
          "included": false
        }
      },
      "project": {
        "meta": {
          "included": false
        }
      },
      "lost_reason": {
        "meta": {
          "included": false
        }
      },
      "contract": {
        "meta": {
          "included": false
        }
      },
      "contact": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "template": {
        "meta": {
          "included": false
        }
      },
      "tax_rate": {
        "meta": {
          "included": false
        }
      },
      "pipeline": {
        "meta": {
          "included": false
        }
      },
      "origin_deal": {
        "meta": {
          "included": false
        }
      },
      "designated_approver": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "next_todo": {
        "meta": {
          "included": false
        }
      },
      "expense_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "time_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "invoice_template": {
        "meta": {
          "included": false
        }
      },
      "automatic_invoicing_rule": {
        "meta": {
          "included": false
        }
      },
      "primary_contact": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

POST  /api/v2/deals/copy

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "deals",
    "attributes": {
      "name": "copied deal",
      "template_id": 324
    }
  }
}
Responses201
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "326",
    "type": "deals",
    "attributes": {
      "name": "copied deal",
      "date": "2026-04-01",
      "end_date": null,
      "number": "1",
      "deal_number": "1",
      "suffix": null,
      "time_approval": true,
      "expense_approval": true,
      "client_access": false,
      "deal_type_id": 2,
      "budget": true,
      "sales_status_updated_at": "2026-04-01T06:05:51.000+02:00",
      "tag_list": [],
      "origin_deal_id": null,
      "profit_margin": "100.0",
      "profit_margin_normalized": "100.0",
      "profit_margin_default": "100.0",
      "email_key": "728faac5ac3591d20b11eadedc09a343",
      "purchase_order_number": null,
      "custom_fields": null,
      "position": 1,
      "service_type_restricted_tracking": false,
      "tracking_type_id": 1,
      "editor_config": {},
      "discount": null,
      "man_day_minutes": 480,
      "rounding_interval_id": null,
      "rounding_method_id": 1,
      "validate_expense_when_closing": false,
      "revenue_distribution_type": "default",
      "color_id": null,
      "connection_status": "none",
      "revenue_distribution_method": null,
      "retainer_interval": null,
      "retainer_interval_count": 1,
      "deal_value": null,
      "deal_value_source": null,
      "deal_value_total": 0,
      "deal_value_total_default": 0,
      "deal_value_total_normalized": 0,
      "billable_time": 0,
      "budget_warning": 80,
      "estimated_time": 0,
      "budgeted_time": 0,
      "worked_time": 0,
      "time_to_close": null,
      "days_since_created": 0,
      "days_since_last_activity": 0,
      "days_in_current_stage": 0,
      "probability": 50,
      "previous_probability": null,
      "note_interpolated": null,
      "proposal_note_interpolated": null,
      "footer_interpolated": null,
      "proposal_footer_interpolated": null,
      "todo_count": 0,
      "todo_due_date": null,
      "note": null,
      "proposal_note": null,
      "lost_comment": null,
      "closed_at": null,
      "delivered_on": null,
      "last_activity_at": "2026-04-01T06:05:50.000+02:00",
      "deleted_at": null,
      "created_at": "2026-04-01T06:05:51.398+02:00",
      "sales_closed_at": null,
      "exchange_rate": "1.25",
      "exchange_date": "2026-04-01",
      "sales_closed_on": null,
      "sample_data": false,
      "external_id": null,
      "external_sync": false,
      "manual_invoicing_status_id": 1,
      "footer": null,
      "proposal_footer": null,
      "access_to_deal": true,
      "currency": "EUR",
      "currency_default": "USD",
      "currency_normalized": "EUR",
      "revenue": 100000,
      "revenue_default": 125000,
      "revenue_normalized": 100000,
      "services_revenue": 0,
      "services_revenue_default": 0,
      "services_revenue_normalized": 0,
      "budget_total": 100000,
      "budget_total_default": 125000,
      "budget_total_normalized": 100000,
      "budget_used": 0,
      "budget_used_default": 0,
      "budget_used_normalized": 0,
      "projected_revenue": 0,
      "projected_revenue_default": 0,
      "projected_revenue_normalized": 0,
      "cost": 0,
      "cost_default": 0,
      "cost_normalized": 0,
      "profit": 100000,
      "profit_default": 125000,
      "profit_normalized": 100000,
      "invoiced": 0,
      "invoiced_default": 0,
      "invoiced_normalized": 0,
      "pending_invoicing": 100000,
      "pending_invoicing_default": 125000,
      "pending_invoicing_normalized": 100000,
      "manually_invoiced": 0,
      "manually_invoiced_default": 0,
      "manually_invoiced_normalized": 0,
      "draft_invoiced": 0,
      "draft_invoiced_default": 0,
      "draft_invoiced_normalized": 0,
      "amount_credited": 0,
      "amount_credited_default": 0,
      "amount_credited_normalized": 0,
      "expense": 0,
      "expense_default": 0,
      "expense_normalized": 0
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "428"
        }
      },
      "creator": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "document_type": {
        "meta": {
          "included": false
        }
      },
      "proposal_document_type": {
        "meta": {
          "included": false
        }
      },
      "responsible": {
        "meta": {
          "included": false
        }
      },
      "deal_status": {
        "meta": {
          "included": false
        }
      },
      "project": {
        "meta": {
          "included": false
        }
      },
      "lost_reason": {
        "meta": {
          "included": false
        }
      },
      "contract": {
        "meta": {
          "included": false
        }
      },
      "contact": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "template": {
        "meta": {
          "included": false
        }
      },
      "tax_rate": {
        "meta": {
          "included": false
        }
      },
      "pipeline": {
        "meta": {
          "included": false
        }
      },
      "origin_deal": {
        "meta": {
          "included": false
        }
      },
      "designated_approver": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "next_todo": {
        "meta": {
          "included": false
        }
      },
      "expense_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "time_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "invoice_template": {
        "meta": {
          "included": false
        }
      },
      "automatic_invoicing_rule": {
        "meta": {
          "included": false
        }
      },
      "primary_contact": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

Copies a deal
POST/api/v2/deals/copy

URI Parameters
HideShow
id
number (required) Example: 1

deal id

PATCH /api/v2/deals/1/open
Requestsopens budget

PATCH  /api/v2/deals/334/open

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "334",
    "type": "deals",
    "attributes": {
      "name": "test name",
      "date": "2026-04-01",
      "end_date": null,
      "number": "1",
      "deal_number": "1",
      "suffix": null,
      "time_approval": true,
      "expense_approval": true,
      "client_access": false,
      "deal_type_id": 2,
      "budget": true,
      "sales_status_updated_at": "2026-04-01T06:05:00.000+02:00",
      "tag_list": [],
      "origin_deal_id": null,
      "profit_margin": 0,
      "profit_margin_normalized": 0,
      "profit_margin_default": 0,
      "email_key": "ddca929e87daf75a9e4a9b2d392c4dbb",
      "purchase_order_number": null,
      "custom_fields": null,
      "position": 1,
      "service_type_restricted_tracking": false,
      "tracking_type_id": 1,
      "editor_config": {},
      "discount": null,
      "man_day_minutes": 480,
      "rounding_interval_id": null,
      "rounding_method_id": 1,
      "validate_expense_when_closing": false,
      "revenue_distribution_type": null,
      "color_id": null,
      "connection_status": "none",
      "revenue_distribution_method": null,
      "retainer_interval": null,
      "retainer_interval_count": 1,
      "deal_value": "0.0",
      "deal_value_source": null,
      "deal_value_total": 0,
      "deal_value_total_default": 0,
      "deal_value_total_normalized": 0,
      "billable_time": 0,
      "budget_warning": null,
      "estimated_time": 0,
      "budgeted_time": 0,
      "worked_time": 0,
      "time_to_close": null,
      "days_since_created": 0,
      "days_since_last_activity": 0,
      "days_in_current_stage": 0,
      "probability": 50,
      "previous_probability": null,
      "note_interpolated": null,
      "proposal_note_interpolated": null,
      "footer_interpolated": null,
      "proposal_footer_interpolated": null,
      "todo_count": 0,
      "todo_due_date": null,
      "note": null,
      "proposal_note": null,
      "lost_comment": null,
      "closed_at": null,
      "delivered_on": null,
      "last_activity_at": "2026-04-01T06:05:53.000+02:00",
      "deleted_at": null,
      "created_at": "2026-04-01T06:05:53.388+02:00",
      "sales_closed_at": null,
      "exchange_rate": "1.25",
      "exchange_date": "2026-04-01",
      "sales_closed_on": null,
      "sample_data": false,
      "external_id": null,
      "external_sync": false,
      "manual_invoicing_status_id": 1,
      "footer": null,
      "proposal_footer": null,
      "access_to_deal": true,
      "currency": "EUR",
      "currency_default": "USD",
      "currency_normalized": "EUR",
      "revenue": 0,
      "revenue_default": 0,
      "revenue_normalized": 0,
      "services_revenue": 0,
      "services_revenue_default": 0,
      "services_revenue_normalized": 0,
      "budget_total": 0,
      "budget_total_default": 0,
      "budget_total_normalized": 0,
      "budget_used": 0,
      "budget_used_default": 0,
      "budget_used_normalized": 0,
      "projected_revenue": 0,
      "projected_revenue_default": 0,
      "projected_revenue_normalized": 0,
      "cost": 0,
      "cost_default": 0,
      "cost_normalized": 0,
      "profit": 0,
      "profit_default": 0,
      "profit_normalized": 0,
      "invoiced": 0,
      "invoiced_default": 0,
      "invoiced_normalized": 0,
      "pending_invoicing": 0,
      "pending_invoicing_default": 0,
      "pending_invoicing_normalized": 0,
      "manually_invoiced": 0,
      "manually_invoiced_default": 0,
      "manually_invoiced_normalized": 0,
      "draft_invoiced": 0,
      "draft_invoiced_default": 0,
      "draft_invoiced_normalized": 0,
      "amount_credited": 0,
      "amount_credited_default": 0,
      "amount_credited_normalized": 0,
      "expense": 0,
      "expense_default": 0,
      "expense_normalized": 0
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "431"
        }
      },
      "creator": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "document_type": {
        "meta": {
          "included": false
        }
      },
      "proposal_document_type": {
        "meta": {
          "included": false
        }
      },
      "responsible": {
        "meta": {
          "included": false
        }
      },
      "deal_status": {
        "meta": {
          "included": false
        }
      },
      "project": {
        "meta": {
          "included": false
        }
      },
      "lost_reason": {
        "meta": {
          "included": false
        }
      },
      "contract": {
        "meta": {
          "included": false
        }
      },
      "contact": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "template": {
        "meta": {
          "included": false
        }
      },
      "tax_rate": {
        "meta": {
          "included": false
        }
      },
      "pipeline": {
        "meta": {
          "included": false
        }
      },
      "origin_deal": {
        "meta": {
          "included": false
        }
      },
      "designated_approver": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "next_todo": {
        "meta": {
          "included": false
        }
      },
      "expense_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "time_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "invoice_template": {
        "meta": {
          "included": false
        }
      },
      "automatic_invoicing_rule": {
        "meta": {
          "included": false
        }
      },
      "primary_contact": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

Opens a deal
PATCH/api/v2/deals/{id}/open

URI Parameters
HideShow
id
number (required) Example: 1

deal id

PATCH /api/v2/deals/1/close
Requestscloses budget

PATCH  /api/v2/deals/336/close

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "336",
    "type": "deals",
    "attributes": {
      "name": "test name",
      "date": "2026-04-01",
      "end_date": null,
      "number": "1",
      "deal_number": "1",
      "suffix": null,
      "time_approval": true,
      "expense_approval": true,
      "client_access": false,
      "deal_type_id": 2,
      "budget": true,
      "sales_status_updated_at": "2026-04-01T06:05:00.000+02:00",
      "tag_list": [],
      "origin_deal_id": null,
      "profit_margin": 0,
      "profit_margin_normalized": 0,
      "profit_margin_default": 0,
      "email_key": "5996158c0d622969ee9e612c607c40e1",
      "purchase_order_number": null,
      "custom_fields": null,
      "position": 1,
      "service_type_restricted_tracking": false,
      "tracking_type_id": 1,
      "editor_config": {},
      "discount": null,
      "man_day_minutes": 480,
      "rounding_interval_id": null,
      "rounding_method_id": 1,
      "validate_expense_when_closing": false,
      "revenue_distribution_type": null,
      "color_id": null,
      "connection_status": "none",
      "revenue_distribution_method": null,
      "retainer_interval": null,
      "retainer_interval_count": 1,
      "deal_value": "0.0",
      "deal_value_source": null,
      "deal_value_total": 0,
      "deal_value_total_default": 0,
      "deal_value_total_normalized": 0,
      "billable_time": 0,
      "budget_warning": null,
      "estimated_time": 0,
      "budgeted_time": 0,
      "worked_time": 0,
      "time_to_close": null,
      "days_since_created": 0,
      "days_since_last_activity": 0,
      "days_in_current_stage": 0,
      "probability": 50,
      "previous_probability": null,
      "note_interpolated": null,
      "proposal_note_interpolated": null,
      "footer_interpolated": null,
      "proposal_footer_interpolated": null,
      "todo_count": 0,
      "todo_due_date": null,
      "note": null,
      "proposal_note": null,
      "lost_comment": null,
      "closed_at": "2026-04-01T06:05:53.000+02:00",
      "delivered_on": "2026-04-01",
      "last_activity_at": "2026-04-01T06:05:53.000+02:00",
      "deleted_at": null,
      "created_at": "2026-04-01T06:05:53.830+02:00",
      "sales_closed_at": null,
      "exchange_rate": "1.25",
      "exchange_date": "2026-04-01",
      "sales_closed_on": null,
      "sample_data": false,
      "external_id": null,
      "external_sync": false,
      "manual_invoicing_status_id": 1,
      "footer": null,
      "proposal_footer": null,
      "access_to_deal": true,
      "currency": "EUR",
      "currency_default": "USD",
      "currency_normalized": "EUR",
      "revenue": 0,
      "revenue_default": 0,
      "revenue_normalized": 0,
      "services_revenue": 0,
      "services_revenue_default": 0,
      "services_revenue_normalized": 0,
      "budget_total": 0,
      "budget_total_default": 0,
      "budget_total_normalized": 0,
      "budget_used": 0,
      "budget_used_default": 0,
      "budget_used_normalized": 0,
      "projected_revenue": 0,
      "projected_revenue_default": 0,
      "projected_revenue_normalized": 0,
      "cost": 0,
      "cost_default": 0,
      "cost_normalized": 0,
      "profit": 0,
      "profit_default": 0,
      "profit_normalized": 0,
      "invoiced": 0,
      "invoiced_default": 0,
      "invoiced_normalized": 0,
      "pending_invoicing": 0,
      "pending_invoicing_default": 0,
      "pending_invoicing_normalized": 0,
      "manually_invoiced": 0,
      "manually_invoiced_default": 0,
      "manually_invoiced_normalized": 0,
      "draft_invoiced": 0,
      "draft_invoiced_default": 0,
      "draft_invoiced_normalized": 0,
      "amount_credited": 0,
      "amount_credited_default": 0,
      "amount_credited_normalized": 0,
      "expense": 0,
      "expense_default": 0,
      "expense_normalized": 0
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "432"
        }
      },
      "creator": {
        "meta": {
          "included": false
        }
      },
      "company": {
        "meta": {
          "included": false
        }
      },
      "document_type": {
        "meta": {
          "included": false
        }
      },
      "proposal_document_type": {
        "meta": {
          "included": false
        }
      },
      "responsible": {
        "meta": {
          "included": false
        }
      },
      "deal_status": {
        "meta": {
          "included": false
        }
      },
      "project": {
        "meta": {
          "included": false
        }
      },
      "lost_reason": {
        "meta": {
          "included": false
        }
      },
      "contract": {
        "meta": {
          "included": false
        }
      },
      "contact": {
        "meta": {
          "included": false
        }
      },
      "subsidiary": {
        "meta": {
          "included": false
        }
      },
      "template": {
        "meta": {
          "included": false
        }
      },
      "tax_rate": {
        "meta": {
          "included": false
        }
      },
      "pipeline": {
        "meta": {
          "included": false
        }
      },
      "origin_deal": {
        "meta": {
          "included": false
        }
      },
      "designated_approver": {
        "meta": {
          "included": false
        }
      },
      "approval_policy_assignment": {
        "meta": {
          "included": false
        }
      },
      "next_todo": {
        "meta": {
          "included": false
        }
      },
      "expense_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "time_approval_workflow": {
        "meta": {
          "included": false
        }
      },
      "invoice_template": {
        "meta": {
          "included": false
        }
      },
      "automatic_invoicing_rule": {
        "meta": {
          "included": false
        }
      },
      "primary_contact": {
        "meta": {
          "included": false
        }
      },
      "custom_field_people": {
        "meta": {
          "included": false
        }
      },
      "custom_field_attachments": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

Closes a deal
PATCH/api/v2/deals/{id}/close

URI Parameters
HideShow
id
number (required) Example: 1

deal id

Generated by aglio on 01 Apr 2026