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.
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.
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.
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"
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 } }}