API Documentation
Proposals ¶
Proposals ¶
Following diagram shows proposals in our data hierarchy:
Supported filter params
-
id (array)
-
deal_id (array)
-
status (array) (draft, sent)
GET /api/v2/proposals
Requests
GET /api/v2/proposals
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
Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"data": [
{
"id": "1",
"type": "proposals",
"attributes": {
"name": "test proposal",
"note": null,
"footer": null,
"status": "draft",
"purchase_order_number": null,
"date": "2025-08-02",
"end_date": null,
"sent_at": null,
"created_at": "2025-08-02T06:23:52.135+02:00",
"custom_fields": null,
"currency": "EUR",
"currency_default": "USD",
"currency_normalized": "EUR",
"note_interpolated": null,
"footer_interpolated": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "2260"
}
},
"client": {
"meta": {
"included": false
}
},
"deal": {
"meta": {
"included": false
}
},
"document_type": {
"meta": {
"included": false
}
},
"proposal_from": {
"meta": {
"included": false
}
},
"proposal_to": {
"meta": {
"included": false
}
},
"responsible": {
"meta": {
"included": false
}
},
"subsidiary": {
"meta": {
"included": false
}
},
"tax_rate": {
"meta": {
"included": false
}
},
"contact": {
"meta": {
"included": false
}
},
"deal_creator": {
"meta": {
"included": false
}
},
"project": {
"meta": {
"included": false
}
}
}
},
{
"id": "2",
"type": "proposals",
"attributes": {
"name": "test proposal",
"note": null,
"footer": null,
"status": "draft",
"purchase_order_number": null,
"date": "2025-08-02",
"end_date": null,
"sent_at": null,
"created_at": "2025-08-02T06:23:52.214+02:00",
"custom_fields": null,
"currency": "EUR",
"currency_default": "USD",
"currency_normalized": "EUR",
"note_interpolated": null,
"footer_interpolated": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "2260"
}
},
"client": {
"meta": {
"included": false
}
},
"deal": {
"meta": {
"included": false
}
},
"document_type": {
"meta": {
"included": false
}
},
"proposal_from": {
"meta": {
"included": false
}
},
"proposal_to": {
"meta": {
"included": false
}
},
"responsible": {
"meta": {
"included": false
}
},
"subsidiary": {
"meta": {
"included": false
}
},
"tax_rate": {
"meta": {
"included": false
}
},
"contact": {
"meta": {
"included": false
}
},
"deal_creator": {
"meta": {
"included": false
}
},
"project": {
"meta": {
"included": false
}
}
}
}
],
"links": {
"first": "http://api-test.productive.io/api/v2/proposals?page%5Bnumber%5D=1&page%5Bsize%5D=30",
"last": "http://api-test.productive.io/api/v2/proposals?page%5Bnumber%5D=1&page%5Bsize%5D=30"
},
"meta": {
"current_page": 1,
"total_pages": 1,
"total_count": 2,
"page_size": 30,
"max_page_size": 200
}
}
Get proposalsGET/api/v2/proposals
GET /api/v2/proposals/1
Requests
GET /api/v2/proposals/3
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
Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"data": {
"id": "3",
"type": "proposals",
"attributes": {
"name": "test proposal",
"note": null,
"footer": null,
"status": "draft",
"purchase_order_number": null,
"date": "2025-08-02",
"end_date": null,
"sent_at": null,
"created_at": "2025-08-02T06:23:52.344+02:00",
"custom_fields": null,
"currency": "EUR",
"currency_default": "USD",
"currency_normalized": "EUR",
"note_interpolated": null,
"footer_interpolated": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "2261"
}
},
"client": {
"meta": {
"included": false
}
},
"deal": {
"meta": {
"included": false
}
},
"document_type": {
"meta": {
"included": false
}
},
"proposal_from": {
"meta": {
"included": false
}
},
"proposal_to": {
"meta": {
"included": false
}
},
"responsible": {
"meta": {
"included": false
}
},
"subsidiary": {
"meta": {
"included": false
}
},
"tax_rate": {
"meta": {
"included": false
}
},
"contact": {
"meta": {
"included": false
}
},
"deal_creator": {
"meta": {
"included": false
}
},
"project": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}
GET /api/v2/proposals/1/sync_status
Requests
GET /api/v2/proposals/4/sync_status
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
Responses
Headers
Content-Type: application/json; charset=utf-8
Body
{
"data": {
"id": 4,
"in_sync": true
}
}
Get proposal's sync statusGET/api/v2/proposals/{id}/sync_status
URI Parameters
- id
number
(required) Example: 1proposal id
POST /api/v2/proposals
Requests
POST /api/v2/proposals
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": "proposals",
"attributes": {
"name": "test proposal",
"status": "draft"
},
"relationships": {
"deal": {
"data": {
"type": "deals",
"id": "1882"
}
},
"document_type": {
"data": {
"type": "document-types",
"id": "2171"
}
},
"tax_rate": {
"data": {
"type": "tax_rate",
"id": "50"
}
}
}
}
}
Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"data": {
"id": "5",
"type": "proposals",
"attributes": {
"name": "test proposal",
"note": null,
"footer": null,
"status": "draft",
"purchase_order_number": null,
"date": "2025-08-02",
"end_date": null,
"sent_at": null,
"created_at": "2025-08-02T06:23:52.707+02:00",
"custom_fields": null,
"currency": "EUR",
"currency_default": "USD",
"currency_normalized": "EUR",
"note_interpolated": null,
"footer_interpolated": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "2265"
}
},
"client": {
"meta": {
"included": false
}
},
"deal": {
"meta": {
"included": false
}
},
"document_type": {
"meta": {
"included": false
}
},
"proposal_from": {
"meta": {
"included": false
}
},
"proposal_to": {
"meta": {
"included": false
}
},
"responsible": {
"meta": {
"included": false
}
},
"subsidiary": {
"meta": {
"included": false
}
},
"tax_rate": {
"meta": {
"included": false
}
},
"contact": {
"meta": {
"included": false
}
},
"deal_creator": {
"meta": {
"included": false
}
},
"project": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}
Create a proposalPOST/api/v2/proposals
URI Parameters
- name
string
(required) Example: Namename
- status
string
(required) Example: draftproposal status (draft, sent)
- deal_id
number
(required) Example: 1deal
- document_type_id
number
(required) Example: 1document type
- tax_rate_id
number
(optional) Example: 1tax rate
PATCH /api/v2/proposals/1
Requests
PATCH /api/v2/proposals/6
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": "proposals",
"attributes": {
"name": "new name",
"status": "sent"
},
"relationships": {
"deal": {
"data": {
"type": "deals",
"id": "1883"
}
},
"document_type": {
"data": {
"type": "document-types",
"id": "2173"
}
},
"tax_rate": {
"data": {
"type": "tax_rate",
"id": "51"
}
}
}
}
}
Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"data": {
"id": "6",
"type": "proposals",
"attributes": {
"name": "new name",
"note": null,
"footer": null,
"status": "sent",
"purchase_order_number": null,
"date": "2025-08-02",
"end_date": null,
"sent_at": null,
"created_at": "2025-08-02T06:23:52.854+02:00",
"custom_fields": null,
"currency": "EUR",
"currency_default": "USD",
"currency_normalized": "EUR",
"note_interpolated": null,
"footer_interpolated": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "2266"
}
},
"client": {
"meta": {
"included": false
}
},
"deal": {
"meta": {
"included": false
}
},
"document_type": {
"meta": {
"included": false
}
},
"proposal_from": {
"meta": {
"included": false
}
},
"proposal_to": {
"meta": {
"included": false
}
},
"responsible": {
"meta": {
"included": false
}
},
"subsidiary": {
"meta": {
"included": false
}
},
"tax_rate": {
"meta": {
"included": false
}
},
"contact": {
"meta": {
"included": false
}
},
"deal_creator": {
"meta": {
"included": false
}
},
"project": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}
PATCH /api/v2/proposals/7
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": "proposals",
"attributes": {
"name": "new name"
},
"relationships": {
"deal": {
"data": {
"type": "deals",
"id": ""
}
}
}
}
}
Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"errors": [
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "attribute is invalid",
"source": {
"pointer": "data/attributes/deal"
}
}
]
}
PATCH /api/v2/proposals/8
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": "proposals",
"attributes": {
"name": "new name"
},
"relationships": {
"deal": {
"data": {
"type": "deals",
"id": ""
}
}
}
}
}
Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"errors": [
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "attribute is invalid",
"source": {
"pointer": "data/attributes/deal"
}
}
]
}
PATCH /api/v2/proposals/9
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": "proposals",
"attributes": {
"name": "new name",
"status": "sent"
},
"relationships": {
"deal": {
"data": {
"type": "deals",
"id": "1887"
}
},
"document_type": {
"data": {
"type": "document-types",
"id": "2179"
}
},
"tax_rate": {
"data": {
"type": "tax_rate",
"id": "57"
}
}
}
}
}
Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"errors": [
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "deal cannot be changed",
"source": {
"pointer": "data/attributes/deal"
}
},
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "cannot edit a proposal that is not in draft status",
"source": {
"pointer": "data/attributes/proposal"
}
}
]
}
PATCH /api/v2/proposals/10
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": "proposals",
"attributes": {
"name": "test proposal",
"status": "draft"
},
"relationships": {
"deal": {
"data": {
"type": "deals",
"id": "1888"
}
},
"document_type": {
"data": {
"type": "document-types",
"id": "2182"
}
},
"tax_rate": {
"data": {
"type": "tax_rate",
"id": "58"
}
}
}
}
}
Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"data": {
"id": "10",
"type": "proposals",
"attributes": {
"name": "test proposal",
"note": null,
"footer": null,
"status": "draft",
"purchase_order_number": null,
"date": "2025-08-02",
"end_date": null,
"sent_at": null,
"created_at": "2025-08-02T06:23:53.468+02:00",
"custom_fields": null,
"currency": "EUR",
"currency_default": "USD",
"currency_normalized": "EUR",
"note_interpolated": null,
"footer_interpolated": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "2270"
}
},
"client": {
"meta": {
"included": false
}
},
"deal": {
"meta": {
"included": false
}
},
"document_type": {
"meta": {
"included": false
}
},
"proposal_from": {
"meta": {
"included": false
}
},
"proposal_to": {
"meta": {
"included": false
}
},
"responsible": {
"meta": {
"included": false
}
},
"subsidiary": {
"meta": {
"included": false
}
},
"tax_rate": {
"meta": {
"included": false
}
},
"contact": {
"meta": {
"included": false
}
},
"deal_creator": {
"meta": {
"included": false
}
},
"project": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}
PATCH /api/v2/proposals/13/sync
Requests
PATCH /api/v2/proposals/11/sync
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
Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"data": {
"id": "11",
"type": "proposals",
"attributes": {
"name": "test proposal",
"note": null,
"footer": null,
"status": "draft",
"purchase_order_number": null,
"date": "2025-08-02",
"end_date": null,
"sent_at": null,
"created_at": "2025-08-02T06:23:53.632+02:00",
"custom_fields": null,
"currency": "EUR",
"currency_default": "USD",
"currency_normalized": "EUR",
"note_interpolated": null,
"footer_interpolated": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "2271"
}
},
"client": {
"meta": {
"included": false
}
},
"deal": {
"meta": {
"included": false
}
},
"document_type": {
"meta": {
"included": false
}
},
"proposal_from": {
"meta": {
"included": false
}
},
"proposal_to": {
"meta": {
"included": false
}
},
"responsible": {
"meta": {
"included": false
}
},
"subsidiary": {
"meta": {
"included": false
}
},
"tax_rate": {
"meta": {
"included": false
}
},
"contact": {
"meta": {
"included": false
}
},
"deal_creator": {
"meta": {
"included": false
}
},
"project": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}
PATCH /api/v2/proposals/12/sync
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
Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"errors": [
{
"status": "409",
"code": "not_in_draft_status",
"title": "Conflict error",
"source": {}
}
]
}
PATCH /api/v2/proposals/13/send
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": "proposals",
"attributes": {
"to": [
"test@email.com"
],
"cc": [
"test@productive.io",
"test-2@productive.io"
],
"bcc": [
"mail@something.com"
],
"subject": "Mail title",
"body": "Lorem ipsum dolor si amet"
}
}
}
Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"data": {
"id": "13",
"type": "proposals",
"attributes": {
"name": "test proposal",
"note": null,
"footer": null,
"status": "sent",
"purchase_order_number": null,
"date": "2025-08-02",
"end_date": null,
"sent_at": null,
"created_at": "2025-08-02T06:23:53.923+02:00",
"custom_fields": null,
"currency": "EUR",
"currency_default": "USD",
"currency_normalized": "EUR",
"note_interpolated": null,
"footer_interpolated": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "2273"
}
},
"client": {
"meta": {
"included": false
}
},
"deal": {
"meta": {
"included": false
}
},
"document_type": {
"meta": {
"included": false
}
},
"proposal_from": {
"meta": {
"included": false
}
},
"proposal_to": {
"meta": {
"included": false
}
},
"responsible": {
"meta": {
"included": false
}
},
"subsidiary": {
"meta": {
"included": false
}
},
"tax_rate": {
"meta": {
"included": false
}
},
"contact": {
"meta": {
"included": false
}
},
"deal_creator": {
"meta": {
"included": false
}
},
"project": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}
Generated by aglio on 02 Aug 2025