taxonomyConcepts

Gets taxonomy concepts by filter.

---

Arguments

input TaxonomyConceptsInput! Required

conceptTypeFilter TaxonomyConceptType

Filters by concept type. If empty, other filters apply. If all filters are empty, an error occurs.

conceptIdFilter [ID!]! Required

Filters concepts by SUID, UUID, or both. If empty, other filters apply. If all filters are empty, an error occurs.

customClassFilter CustomClassFilterInput! Required

Filters concepts by custom class. If empty, other filters apply. If all filters are empty, an error occurs.

customClasses [ID!]! Required

Filters concepts by custom-class SUIDs.

operation CustomClassFilterOperation

Operator for custom class filtering. Default: AND.

global Boolean default:false

Whether to include concepts that do not apply to the country and language codes. Default: false.

countryCode CountryCode

Two-character country code in ISO 3166-1 alpha-2 format.

languageCode LanguageCode

Two-character language code in ISO 639 format.

includeDeprecated Boolean

Whether to include deprecated TaxonomyConcepts.

Response

Returns TaxonomyConceptsPayload .

taxonomyConcepts [TaxonomyConcept!]

Concepts details.

key ID! Non-Null

Short unique ID (SUID) of the taxonomy concept. Primary key.

uuid ID! Non-Null

Universal unique ID (UUID) of the taxonomy concept. Prefer key instead.

label String! Non-Null

Preferred label of the concept.

Example: "Business etiquette"

alternativeLabels [String!]! Non-Null

Alternative labels for the concept.

Example: "Business manner"

mobileLabel String! Non-Null

Display label for the concept.

definitions [String!]! Non-Null

Definitions for the concept.

pathToRoot [TaxonomyConcept!]! Non-Null

Path from this concept to the taxonomy root.

key ID! Non-Null

Short unique ID (SUID) of the taxonomy concept. Primary key.

uuid ID! Non-Null

Universal unique ID (UUID) of the taxonomy concept. Prefer key instead.

label String! Non-Null

Preferred label of the concept.

Example: "Business etiquette"

alternativeLabels [String!]! Non-Null

Alternative labels for the concept.

Example: "Business manner"

mobileLabel String! Non-Null

Display label for the concept.

definitions [String!]! Non-Null

Definitions for the concept.

pathToRoot [TaxonomyConcept!]! Non-Null

Path from this concept to the taxonomy root.

children [TaxonomyConcept!]! Non-Null

Direct children of this concept in the taxonomy tree.

customClasses [CustomTaxonomyClass!]! Non-Null

Custom classes the concept belongs to.

Example: "Cross-Occupational Cluster"

taxonomyConceptType TaxonomyConceptType! Non-Null

Concept type.

isVerifiedJobAttribute Boolean! Non-Null

Whether the concept is a verified job attribute. Applies only when taxonomyConceptType is ATTRIBUTE.

isVerifiedResumeAttribute Boolean! Non-Null

Whether the concept is a verified resume attribute. Applies only when taxonomyConceptType is ATTRIBUTE.

children [TaxonomyConcept!]! Non-Null

Direct children of this concept in the taxonomy tree.

key ID! Non-Null

Short unique ID (SUID) of the taxonomy concept. Primary key.

uuid ID! Non-Null

Universal unique ID (UUID) of the taxonomy concept. Prefer key instead.

label String! Non-Null

Preferred label of the concept.

Example: "Business etiquette"

alternativeLabels [String!]! Non-Null

Alternative labels for the concept.

Example: "Business manner"

mobileLabel String! Non-Null

Display label for the concept.

definitions [String!]! Non-Null

Definitions for the concept.

pathToRoot [TaxonomyConcept!]! Non-Null

Path from this concept to the taxonomy root.

children [TaxonomyConcept!]! Non-Null

Direct children of this concept in the taxonomy tree.

customClasses [CustomTaxonomyClass!]! Non-Null

Custom classes the concept belongs to.

Example: "Cross-Occupational Cluster"

taxonomyConceptType TaxonomyConceptType! Non-Null

Concept type.

isVerifiedJobAttribute Boolean! Non-Null

Whether the concept is a verified job attribute. Applies only when taxonomyConceptType is ATTRIBUTE.

isVerifiedResumeAttribute Boolean! Non-Null

Whether the concept is a verified resume attribute. Applies only when taxonomyConceptType is ATTRIBUTE.

customClasses [CustomTaxonomyClass!]! Non-Null

Custom classes the concept belongs to.

Example: "Cross-Occupational Cluster"

key ID! Non-Null

SUID of this custom class. Primary key.

uuid ID! Non-Null

UUID of this custom class. Prefer key instead.

label String! Non-Null

Preferred label of the custom class. English only, not localized.

taxonomyConceptType TaxonomyConceptType! Non-Null

Concept type.

isVerifiedJobAttribute Boolean! Non-Null

Whether the concept is a verified job attribute. Applies only when taxonomyConceptType is ATTRIBUTE.

isVerifiedResumeAttribute Boolean! Non-Null

Whether the concept is a verified resume attribute. Applies only when taxonomyConceptType is ATTRIBUTE.

transactionId ID! Non-Null

Unique transaction ID for debugging and analysis.

responseStatus MdsResponseStatus! Non-Null

responseCode MdsResponseCode! Non-Null

Response code from the Occupational Metadata API, following standard GraphQL codes.

errorMessage String

Error descriptions from the Occupational Metadata API.

Example

Query

query TaxonomyConcepts($input: TaxonomyConceptsInput!) {
  taxonomyConcepts(input: $input) {
    taxonomyConcepts {
      key
      uuid
      label
      alternativeLabels
      mobileLabel
      definitions
      pathToRoot {
        key
        uuid
        label
        alternativeLabels
        mobileLabel
        definitions
        pathToRoot {
          key
          uuid
          label
          alternativeLabels
          mobileLabel
          definitions
          pathToRoot {
            key
            uuid
            label
            alternativeLabels
            mobileLabel
            definitions
            pathToRoot {
              ...TaxonomyConceptFragment
            }
            children {
              ...TaxonomyConceptFragment
            }
            customClasses {
              ...CustomTaxonomyClassFragment
            }
            taxonomyConceptType
            isVerifiedJobAttribute
            isVerifiedResumeAttribute
          }
          children {
            key
            uuid
            label
            alternativeLabels
            mobileLabel
            definitions
            pathToRoot {
              ...TaxonomyConceptFragment
            }
            children {
              ...TaxonomyConceptFragment
            }
            customClasses {
              ...CustomTaxonomyClassFragment
            }
            taxonomyConceptType
            isVerifiedJobAttribute
            isVerifiedResumeAttribute
          }
          customClasses {
            key
            uuid
            label
          }
          taxonomyConceptType
          isVerifiedJobAttribute
          isVerifiedResumeAttribute
        }
        children {
          key
          uuid
          label
          alternativeLabels
          mobileLabel
          definitions
          pathToRoot {
            key
            uuid
            label
            alternativeLabels
            mobileLabel
            definitions
            pathToRoot {
              ...TaxonomyConceptFragment
            }
            children {
              ...TaxonomyConceptFragment
            }
            customClasses {
              ...CustomTaxonomyClassFragment
            }
            taxonomyConceptType
            isVerifiedJobAttribute
            isVerifiedResumeAttribute
          }
          children {
            key
            uuid
            label
            alternativeLabels
            mobileLabel
            definitions
            pathToRoot {
              ...TaxonomyConceptFragment
            }
            children {
              ...TaxonomyConceptFragment
            }
            customClasses {
              ...CustomTaxonomyClassFragment
            }
            taxonomyConceptType
            isVerifiedJobAttribute
            isVerifiedResumeAttribute
          }
          customClasses {
            key
            uuid
            label
          }
          taxonomyConceptType
          isVerifiedJobAttribute
          isVerifiedResumeAttribute
        }
        customClasses {
          key
          uuid
          label
        }
        taxonomyConceptType
        isVerifiedJobAttribute
        isVerifiedResumeAttribute
      }
      children {
        key
        uuid
        label
        alternativeLabels
        mobileLabel
        definitions
        pathToRoot {
          key
          uuid
          label
          alternativeLabels
          mobileLabel
          definitions
          pathToRoot {
            key
            uuid
            label
            alternativeLabels
            mobileLabel
            definitions
            pathToRoot {
              ...TaxonomyConceptFragment
            }
            children {
              ...TaxonomyConceptFragment
            }
            customClasses {
              ...CustomTaxonomyClassFragment
            }
            taxonomyConceptType
            isVerifiedJobAttribute
            isVerifiedResumeAttribute
          }
          children {
            key
            uuid
            label
            alternativeLabels
            mobileLabel
            definitions
            pathToRoot {
              ...TaxonomyConceptFragment
            }
            children {
              ...TaxonomyConceptFragment
            }
            customClasses {
              ...CustomTaxonomyClassFragment
            }
            taxonomyConceptType
            isVerifiedJobAttribute
            isVerifiedResumeAttribute
          }
          customClasses {
            key
            uuid
            label
          }
          taxonomyConceptType
          isVerifiedJobAttribute
          isVerifiedResumeAttribute
        }
        children {
          key
          uuid
          label
          alternativeLabels
          mobileLabel
          definitions
          pathToRoot {
            key
            uuid
            label
            alternativeLabels
            mobileLabel
            definitions
            pathToRoot {
              ...TaxonomyConceptFragment
            }
            children {
              ...TaxonomyConceptFragment
            }
            customClasses {
              ...CustomTaxonomyClassFragment
            }
            taxonomyConceptType
            isVerifiedJobAttribute
            isVerifiedResumeAttribute
          }
          children {
            key
            uuid
            label
            alternativeLabels
            mobileLabel
            definitions
            pathToRoot {
              ...TaxonomyConceptFragment
            }
            children {
              ...TaxonomyConceptFragment
            }
            customClasses {
              ...CustomTaxonomyClassFragment
            }
            taxonomyConceptType
            isVerifiedJobAttribute
            isVerifiedResumeAttribute
          }
          customClasses {
            key
            uuid
            label
          }
          taxonomyConceptType
          isVerifiedJobAttribute
          isVerifiedResumeAttribute
        }
        customClasses {
          key
          uuid
          label
        }
        taxonomyConceptType
        isVerifiedJobAttribute
        isVerifiedResumeAttribute
      }
      customClasses {
        key
        uuid
        label
      }
      taxonomyConceptType
      isVerifiedJobAttribute
      isVerifiedResumeAttribute
    }
    transactionId
    responseStatus {
      responseCode
      errorMessage
    }
  }
}

Variables

{"input": TaxonomyConceptsInput}

Response

{
  "data": {
    "taxonomyConcepts": {
      "taxonomyConcepts": [TaxonomyConcept],
      "transactionId": "opaqueId",
      "responseStatus": MdsResponseStatus
    }
  }
}

 

Was this page helpful?