Get client tag

GET /api/v2/companysettings/clienttags/{TagGUID}

Bearer auth

This endpoint allows users to retrieve details for a company client tag.

Path parameters

TagGUID string(uuid) Required

The GUID of the client tag to update.

Query parameters

ExcludeFormattedValues string

If set to any value, formatted values will be excluded from the response.

Responses

200 application/json

Success
Hide response attributes Show response attributes object
- success boolean
  
  Default value is true.
- data object
  
  Hide data attributes Show data attributes object
  
  TagGUID string(uuid)
  
  CompanyGUID string(uuid)
  
  TagName string
  
  TagColour string
  
  TotalUsingTag integer
  
  FormattedValues object
404 application/json

Client tag not found
Hide response attributes Show response attributes object
- success boolean
  
  Default value is false.
- message string

GET /api/v2/companysettings/clienttags/{TagGUID}

curl \
 --request GET 'https://api.fincalc.co.uk/api/v2/companysettings/clienttags/{TagGUID}' \
 --header "Authorization: Bearer $ACCESS_TOKEN"

Response examples (200)

{
  "success": true,
  "data": {
    "TagGUID": "3F0B1C88-6D80-4C17-BB3E-1D68E6D26405",
    "CompanyGUID": "72204219-8DFF-0F26-B66E-39C4F9DD5799",
    "TagName": "Accumulation",
    "TagColour": "#000FFF",
    "TotalUsingTag": 14,
    "FormattedValues": {
      "CompanyGUID": "FinCalc"
    }
  }
}

Response examples (404)

{
  "success": false,
  "message": "Company client tag not found."
}