curl --request GET \
--url https://platform.kodexa.ai/api/data-definitions \
--header 'x-api-key: <api-key>'{
"content": [
{
"changeSequence": 123,
"createdOn": "2023-11-07T05:31:56Z",
"deprecated": true,
"extensionPackRef": "<string>",
"id": "d3456789-01ab-cdef-2345-678901abcdef",
"metadata": {
"checksum": "<string>",
"deleteProtection": true,
"description": "<string>",
"enabled": true,
"externalDataTaxonomyRefs": [
"<string>"
],
"icon": "<string>",
"imageUrl": "<string>",
"overviewMarkdown": "<string>",
"provider": "<string>",
"providerImageUrl": "<string>",
"providerUrl": "<string>",
"taxonomyType": "<string>",
"taxons": [
{
"additionContexts": [
"<string>"
],
"cardinality": "<string>",
"children": "<array>",
"color": "<string>",
"conditionalFormats": [
{
"background": "<string>",
"color": "<string>",
"condition": "<string>",
"formula": "<string>",
"icon": "<string>",
"name": "<string>",
"properties": {},
"style": "<string>",
"type": "<string>"
}
],
"dataPath": "<string>",
"denormalizeToChildren": true,
"description": "<string>",
"enableFallbackExpression": true,
"enableSerializationExpression": true,
"enabled": true,
"expression": "<string>",
"externalName": "<string>",
"fallbackExpression": "<string>",
"generateName": true,
"group": true,
"guideProperties": {
"guidanceKey": true,
"guidanceKeyExpression": "<string>",
"ifPresentRequired": true,
"overviewMarkdown": "<string>",
"useGuidanceForClassification": true
},
"id": "<string>",
"label": "<string>",
"lexicalRelations": [
{
"type": "<string>",
"value": "<string>",
"weight": 123
}
],
"metadataValue": "<string>",
"multiValue": true,
"name": "<string>",
"naturalKeys": [
{
"name": "<string>"
}
],
"nodeTypes": [
"<string>"
],
"notUserLabelled": true,
"nullValue": "<string>",
"nullable": true,
"options": [
{
"aliases": [
"<string>"
],
"default": {},
"description": "<string>",
"developerOnly": true,
"displayProperties": {
"columns": 123,
"rows": 123,
"width": 123
},
"falseLabel": "<string>",
"featureFlag": "<string>",
"groupOptions": "<array>",
"hint": "<string>",
"label": "<string>",
"listDescription": "<string>",
"listLabel": "<string>",
"listType": "<string>",
"name": "<string>",
"overviewMarkdown": "<string>",
"possibleValues": [
{
"description": "<string>",
"label": "<string>",
"value": "<string>"
}
],
"properties": {
"color": "<string>",
"icon": "<string>"
},
"required": true,
"showIf": "<string>",
"showOnPopup": true,
"subType": "<string>",
"supportArticle": "<string>",
"tabName": "<string>",
"type": "<string>"
}
],
"order": 123,
"overviewMarkdown": "<string>",
"path": "<string>",
"postExpression": "<string>",
"properties": {
"alignment": "<string>",
"visible": true,
"width": 123
},
"selectWeight": 123,
"selectionOptions": [
{
"conditionalFormula": "<string>",
"description": "<string>",
"disabled": "<string>",
"id": "<string>",
"isConditional": true,
"label": "<string>",
"lexicalRelations": [
{
"type": "<string>",
"value": "<string>",
"weight": 123
}
]
}
],
"semanticDefinition": "<string>",
"serializationExpression": "<string>",
"synonyms": [
"<string>"
],
"taxonType": "STRING",
"typeFeatures": {
"allowTemplating": true,
"cardinality": "<string>",
"chunkingStrategy": "<string>",
"classificationContent": "<string>",
"classificationStrategy": "<string>",
"contextHeadLines": 123,
"contextTailLines": 123,
"currencyCode": "<string>",
"dateFormat": "<string>",
"decimalPlaces": 123,
"embedded": true,
"enableAiFallback": true,
"enableLineFallback": true,
"enablePlanningThinkingMode": true,
"enableStructureReview": true,
"enableStructureReviewThinkingMode": true,
"enableThinkingMode": true,
"expected": true,
"extractionModel": "<string>",
"formulaExpression": "<string>",
"hierarchyMaxLinesPerCall": 123,
"hierarchyWindowOverlap": 123,
"ignoreNonWords": true,
"imageWidth": 123,
"includeDataElementsInClassificationPrompt": true,
"includeExplanation": true,
"includeImages": true,
"instanceBoundaryThreshold": 123,
"labelDocument": true,
"markdown": true,
"maxChildLines": 123,
"maxPagesFromRerank": 123,
"merge": true,
"mergeInstances": true,
"mergeInstructions": "<string>",
"mergeWithAI": true,
"nPages": 123,
"overrideExtractionModel": true,
"planningModel": "<string>",
"promptStrategy": "<string>",
"raiseExceptionOnAiFallback": true,
"raiseExceptionOnFallback": true,
"rerank": true,
"restrictClassification": true,
"skipExtraction": true,
"structureReview": "<string>",
"summarize": true,
"tagPage": true
},
"usePostExpression": true,
"userEditable": true,
"validationRules": [
{
"conditional": true,
"conditionalFormula": "<string>",
"description": "<string>",
"detailFormula": "<string>",
"disabled": true,
"exceptionId": "<string>",
"messageFormula": "<string>",
"name": "<string>",
"overridable": true,
"ruleFormula": "<string>",
"supportArticleId": "<string>"
}
],
"valuePath": "VALUE_OR_ALL_CONTENT"
}
]
},
"name": "Invoice Taxonomy",
"organizationId": "<string>",
"publicAccess": true,
"slug": "invoice-taxonomy",
"template": true,
"updatedOn": "2023-11-07T05:31:56Z",
"uuid": "<string>"
}
],
"first": true,
"last": true,
"number": 123,
"numberOfElements": 123,
"pageable": {
"offset": 123,
"pageNumber": 123,
"pageSize": 123,
"paged": true,
"sort": {
"empty": true,
"sorted": true,
"unsorted": true
},
"unpaged": true
},
"size": 123,
"sort": {
"empty": true,
"sorted": true,
"unsorted": true
},
"totalElements": 123,
"totalPages": 123
}Returns a paginated list of Data Definitions. Data definitions (taxonomies) define document structure and extraction rules.
curl --request GET \
--url https://platform.kodexa.ai/api/data-definitions \
--header 'x-api-key: <api-key>'{
"content": [
{
"changeSequence": 123,
"createdOn": "2023-11-07T05:31:56Z",
"deprecated": true,
"extensionPackRef": "<string>",
"id": "d3456789-01ab-cdef-2345-678901abcdef",
"metadata": {
"checksum": "<string>",
"deleteProtection": true,
"description": "<string>",
"enabled": true,
"externalDataTaxonomyRefs": [
"<string>"
],
"icon": "<string>",
"imageUrl": "<string>",
"overviewMarkdown": "<string>",
"provider": "<string>",
"providerImageUrl": "<string>",
"providerUrl": "<string>",
"taxonomyType": "<string>",
"taxons": [
{
"additionContexts": [
"<string>"
],
"cardinality": "<string>",
"children": "<array>",
"color": "<string>",
"conditionalFormats": [
{
"background": "<string>",
"color": "<string>",
"condition": "<string>",
"formula": "<string>",
"icon": "<string>",
"name": "<string>",
"properties": {},
"style": "<string>",
"type": "<string>"
}
],
"dataPath": "<string>",
"denormalizeToChildren": true,
"description": "<string>",
"enableFallbackExpression": true,
"enableSerializationExpression": true,
"enabled": true,
"expression": "<string>",
"externalName": "<string>",
"fallbackExpression": "<string>",
"generateName": true,
"group": true,
"guideProperties": {
"guidanceKey": true,
"guidanceKeyExpression": "<string>",
"ifPresentRequired": true,
"overviewMarkdown": "<string>",
"useGuidanceForClassification": true
},
"id": "<string>",
"label": "<string>",
"lexicalRelations": [
{
"type": "<string>",
"value": "<string>",
"weight": 123
}
],
"metadataValue": "<string>",
"multiValue": true,
"name": "<string>",
"naturalKeys": [
{
"name": "<string>"
}
],
"nodeTypes": [
"<string>"
],
"notUserLabelled": true,
"nullValue": "<string>",
"nullable": true,
"options": [
{
"aliases": [
"<string>"
],
"default": {},
"description": "<string>",
"developerOnly": true,
"displayProperties": {
"columns": 123,
"rows": 123,
"width": 123
},
"falseLabel": "<string>",
"featureFlag": "<string>",
"groupOptions": "<array>",
"hint": "<string>",
"label": "<string>",
"listDescription": "<string>",
"listLabel": "<string>",
"listType": "<string>",
"name": "<string>",
"overviewMarkdown": "<string>",
"possibleValues": [
{
"description": "<string>",
"label": "<string>",
"value": "<string>"
}
],
"properties": {
"color": "<string>",
"icon": "<string>"
},
"required": true,
"showIf": "<string>",
"showOnPopup": true,
"subType": "<string>",
"supportArticle": "<string>",
"tabName": "<string>",
"type": "<string>"
}
],
"order": 123,
"overviewMarkdown": "<string>",
"path": "<string>",
"postExpression": "<string>",
"properties": {
"alignment": "<string>",
"visible": true,
"width": 123
},
"selectWeight": 123,
"selectionOptions": [
{
"conditionalFormula": "<string>",
"description": "<string>",
"disabled": "<string>",
"id": "<string>",
"isConditional": true,
"label": "<string>",
"lexicalRelations": [
{
"type": "<string>",
"value": "<string>",
"weight": 123
}
]
}
],
"semanticDefinition": "<string>",
"serializationExpression": "<string>",
"synonyms": [
"<string>"
],
"taxonType": "STRING",
"typeFeatures": {
"allowTemplating": true,
"cardinality": "<string>",
"chunkingStrategy": "<string>",
"classificationContent": "<string>",
"classificationStrategy": "<string>",
"contextHeadLines": 123,
"contextTailLines": 123,
"currencyCode": "<string>",
"dateFormat": "<string>",
"decimalPlaces": 123,
"embedded": true,
"enableAiFallback": true,
"enableLineFallback": true,
"enablePlanningThinkingMode": true,
"enableStructureReview": true,
"enableStructureReviewThinkingMode": true,
"enableThinkingMode": true,
"expected": true,
"extractionModel": "<string>",
"formulaExpression": "<string>",
"hierarchyMaxLinesPerCall": 123,
"hierarchyWindowOverlap": 123,
"ignoreNonWords": true,
"imageWidth": 123,
"includeDataElementsInClassificationPrompt": true,
"includeExplanation": true,
"includeImages": true,
"instanceBoundaryThreshold": 123,
"labelDocument": true,
"markdown": true,
"maxChildLines": 123,
"maxPagesFromRerank": 123,
"merge": true,
"mergeInstances": true,
"mergeInstructions": "<string>",
"mergeWithAI": true,
"nPages": 123,
"overrideExtractionModel": true,
"planningModel": "<string>",
"promptStrategy": "<string>",
"raiseExceptionOnAiFallback": true,
"raiseExceptionOnFallback": true,
"rerank": true,
"restrictClassification": true,
"skipExtraction": true,
"structureReview": "<string>",
"summarize": true,
"tagPage": true
},
"usePostExpression": true,
"userEditable": true,
"validationRules": [
{
"conditional": true,
"conditionalFormula": "<string>",
"description": "<string>",
"detailFormula": "<string>",
"disabled": true,
"exceptionId": "<string>",
"messageFormula": "<string>",
"name": "<string>",
"overridable": true,
"ruleFormula": "<string>",
"supportArticleId": "<string>"
}
],
"valuePath": "VALUE_OR_ALL_CONTENT"
}
]
},
"name": "Invoice Taxonomy",
"organizationId": "<string>",
"publicAccess": true,
"slug": "invoice-taxonomy",
"template": true,
"updatedOn": "2023-11-07T05:31:56Z",
"uuid": "<string>"
}
],
"first": true,
"last": true,
"number": 123,
"numberOfElements": 123,
"pageable": {
"offset": 123,
"pageNumber": 123,
"pageSize": 123,
"paged": true,
"sort": {
"empty": true,
"sorted": true,
"unsorted": true
},
"unpaged": true
},
"size": 123,
"sort": {
"empty": true,
"sorted": true,
"unsorted": true
},
"totalElements": 123,
"totalPages": 123
}API key for authentication. Create one from the Kodexa platform UI under Settings > Access Tokens.
Page number (1-indexed). Defaults to 1.
Number of items per page (1-1000). Defaults to 20, maximum 1000.
Sort expression as field,direction. Direction is asc or desc. Multiple sort fields can be specified by repeating the parameter.
RSQL/FIQL filter expression. Supported operators: == (equals), != (not equals), =like= (contains), =in= (in list), > / >= / < / <= (comparison), =isnull=true (is null), =isnull=false (is not null). Combine with ; (AND) or , (OR). Example: name=='Acme Corp';status==active
Full-text search query matching against the entity's searchable fields.
Page of Taxonomies
Paginated response containing TaxonomyMetadata items.
Array of TaxonomyMetadata items on this page.
Show child attributes
Whether this is the first page.
Whether this is the last page.
Current page number (0-indexed).
Number of items on the current page.
Pagination metadata.
Show child attributes
Page size (number of items per page).
Sort metadata.
Show child attributes
Total number of items across all pages.
Total number of pages.