This API allows you to retrieve custom field details using custom field ID.

👍
Note
For detailed information about our APIs and for hands-on testing, refer documentation in API overview and step-by-step guide on making your first API call in Make your first API call.

Example request

curl --location 'https://eu.api.capillarytech.com/api_gateway/v1/badges/customField/69660bb80772ad476ecf1809' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'accept: application/json' \
--header 'Authorization: Basic Z2VvcmdlLmRvY2RlbW86NjVhMDgzYjk1MWY5MNTY5NDk1YmNkNzUxYmJiY2U=' \
--header 'Cookie: _cfuvid=CmMMzZTCj5wZz.JiJzCNse2KGBmy.LNm5eua4-1768295785119-0.0.1.1-604800000' \
--data ''

Prerequisites

Authentication: Basic or OAuth authentication
Default access group

Resource information


URI	/api_gateway/v1/badges/customField/`{customFieldId}`
HTTP method	GET
Pagination supported	No
Rate limit	NA
Batch support	NA

API endpoint example

https://eucrm.cc.capillarytech.com/api_gateway/v1/badges/customField/65bb3daffd3e324f2cac883c

Request path parameter

Parameter Name	Data Type	Description
customFieldId*	String	Unique ID of the custom field.

Response parameters

Parameter Name	Data Type	Description
id	String	The unique identifier of the custom field.
orgId	Integer	The org ID the custom field belongs to.
name	String	The name of the custom field.
isMandatory	Boolean	Indicates if the custom field is mandatory.
defaultValue	String	The default value of the custom field.
isActive	Boolean	Indicates if the custom field is active.
dataType	Enum	The data type of the custom field's value.
createdOn	Date	The timestamp when the custom field was created. Timestamp in the ISO 8601 standard format format YYYY-MM-DDTHH:MM:SS.SSSZ.
createdOn	String	The timestamp when the custom field was created, in ISO timestamp format.
createdBy	Integer	The identifier of the user who created the custom field.
lastUpdatedOn	Date	The timestamp when the custom field was last updated. Timestamp in the ISO 8601 standard format format YYYY-MM-DDTHH:MM:SS.SSSZ.
lastUpdatedOnISO	String	The timestamp when the custom field was last updated, in ISO timestamp format.
lastUpdatedBy	Integer	The identifier of the user who last updated the custom field.
errors	Object	A list of errors if any occurred during the operation.
warnings	Object	A list of warnings if any occurred during the operation.

{
    "data": {
        "id": "69660bb80772ad476ecf1809",
        "orgId": 100737,
        "name": "CF31 date23",
        "isMandatory": false,
        "defaultValue": "cgvhjb",
        "isActive": true,
        "dataType": "STRING",
        "createdOn": 1768295352.346000000,
        "createdOnISO": "2026-01-13T09:09:12Z",
        "createdBy": 75197941,
        "lastUpdatedOn": 1768295588.086000000,
        "lastUpdatedOnISO": "2026-01-13T09:13:08Z",
        "lastUpdatedBy": 75197941
    },
    "errors": [],
    "warnings": []
}