List all custom fields

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

• cURL

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

• Node

var request = require("request");

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

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/dealCustomFieldMeta")

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/dealCustomFieldMeta");

xhr.send(data);

• Python

import requests

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

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

print(response.text)

 

200 OK

{
    "dealCustomFieldMeta": [
        {
            "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"
            }
        }
    ]
}

 

To retrieve custom deal fields, 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.