List all custom field values

GET  https://:account.api-us1.com/api/3/dealCustomFieldData

• cURL

curl --request GET \
  --url https:///:account.api-us1.com/api/3/dealCustomFieldData

• Node

var request = require("request");

var options = { method: 'GET',
  url: 'https:///:account.api-us1.com/api/3/dealCustomFieldData' };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

• Ruby

require 'uri'
require 'net/http'

url = URI("https:///:account.api-us1.com/api/3/dealCustomFieldData")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

• JavaScript

var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https:///:account.api-us1.com/api/3/dealCustomFieldData");

xhr.send(data);

• Python

import requests

url = "https:///:account.api-us1.com/api/3/dealCustomFieldData"

response = requests.request("GET", url)

print(response.text)

 

200 OK

{
    "dealCustomFieldData": [
        {
            "id": "3",
            "dealCustomFieldMetumId": 1,
            "dealId": 1,
            "customFieldId": 1,
            "createdUtcTimestamp": "2018-11-06 02:26:07",
            "updatedUtcTimestamp": "2018-11-06 02:26:07",
            "fieldValue": "test title",
            "links": {
                "deal": "https://:account.api-us1.com/api/:version/dealCustomFieldData/3/deal",
                "dealCustomFieldMetum": "https://:account.api-us1.com/api/:version/dealCustomFieldData/3/dealCustomFieldMetum"
            }
        },
        {
            "id": "4",
            "dealCustomFieldMetumId": 1,
            "dealId": 3,
            "customFieldId": 1,
            "createdUtcTimestamp": "2018-11-06 02:26:51",
            "updatedUtcTimestamp": "2018-11-06 02:26:51",
            "fieldValue": "test title",
            "links": {
                "deal": "https://:account.api-us1.com/api/:version/dealCustomFieldData/4/deal",
                "dealCustomFieldMetum": "https://:account.api-us1.com/api/:version/dealCustomFieldData/4/dealCustomFieldMetum"
            }
        },
        {
            "id": "5",
            "dealCustomFieldMetumId": 1,
            "dealId": 2,
            "customFieldId": 1,
            "createdUtcTimestamp": "2018-11-06 02:27:05",
            "updatedUtcTimestamp": "2018-11-06 02:27:05",
            "fieldValue": "test title",
            "links": {
                "deal": "https://:account.api-us1.com/api/:version/dealCustomFieldData/5/deal",
                "dealCustomFieldMetum": "https://:account.api-us1.com/api/:version/dealCustomFieldData/5/dealCustomFieldMetum"
            }
        },
        {
            "id": "1",
            "dealCustomFieldMetumId": 5,
            "dealId": 2,
            "customFieldId": 5,
            "createdUtcTimestamp": "2018-10-29 20:40:38",
            "updatedUtcTimestamp": "2018-11-06 02:21:36",
            "fieldValue": "New title",
            "links": {
                "deal": "https://:account.api-us1.com/api/:version/dealCustomFieldData/1/deal",
                "dealCustomFieldMetum": "https://:account.api-us1.com/api/:version/dealCustomFieldData/1/dealCustomFieldMetum"
            }
        }
    ]
}

QUERY PARAMS

filters[dealId]

string                                           Filter results by a specific deal (note that Id uses a capital I)

 

To retrieve custom deal field values, the following permissions are required.

• Deal permission: the user should have permission to manage deals.
• Pipeline-specific permission: the user should have permission to manage the pipeline that the deal belongs to. If the user does not have the permission to manage the pipeline, limited deal data are returned with only id, title, and isDisabled set to 1.