Get descendants of a concept

GET

https://api.contentful.com/organizations/:organization_id/taxonomy/concepts/:concept_id/descendants

GET

/organizations/:organization_id/taxonomy/concepts/:concept_id/descendants

$ curl -G https://api.contentful.com/organizations/0D9ZC8rLWiw6x5qizZGiRs/taxonomy/concepts/3kZdDUXy9n0l2Xi2cq8TPc/descendants \
>      -H "Authorization: Bearer <token>" \
>      -d depth=5 \
>      -d limit=10 \
>      -d order=sys.createdAt \
>      -d query=bed

200Taxonomy_getDescendantsOfAConcept_example

1 {
2   "sys": {
3     "type": "Array"
4   },
5   "limit": 100,
6   "pages": {
7     "prev": "<url>",
8     "next": "<url>"
9   },
10   "items": [
11     {
12       "sys": {
13         "id": "3kZdDUXy9n0l2Xi2cq8TPc",
14         "type": "TaxonomyConcept",
15         "organization": {
16           "sys": {
17             "id": "0D9ZC8rLWiw6x5qizZGiRs",
18             "type": "Link",
19             "linkType": "Organization"
20           }
21         },
22         "createdAt": "2025-11-24T16:26:37.000Z",
23         "createdBy": {
24           "sys": {
25             "type": "Link",
26             "linkType": "User",
27             "id": "7BslKh9TdKGOK41VmLDjFZ"
28           }
29         },
30         "updatedAt": "2025-11-24T16:26:37.000Z",
31         "updatedBy": {
32           "sys": {
33             "type": "Link",
34             "linkType": "User",
35             "id": "4FLrUHftHW3v2BLi9fzfjU"
36           }
37         },
38         "version": 0
39       },
40       "uri": "",
41       "prefLabel": {
42         "en-US": "Sofas"
43       },
44       "altLabels": {
45         "en-US": [
46           "Couches",
47           "Settees"
48         ]
49       },
50       "hiddenLabels": {
51         "en-US": [
52           "Davenports"
53         ]
54       },
55       "notations": [
56         "FURN0017B"
57       ],
58       "note": {
59         "en-US": ""
60       },
61       "changeNote": {
62         "en-US": ""
63       },
64       "definition": {
65         "en-US": ""
66       },
67       "editorialNote": {
68         "en-US": ""
69       },
70       "example": {
71         "en-US": ""
72       },
73       "historyNote": {
74         "en-US": ""
75       },
76       "scopeNote": {
77         "en-US": ""
78       },
79       "broader": [
80         {
81           "sys": {
82             "id": "1Py5SjffQHkGGY3dZ02W14",
83             "type": "Link",
84             "linkType": "TaxonomyConcept"
85           }
86         }
87       ],
88       "related": [
89         {
90           "sys": {
91             "id": "5abcWINB018mASQ5Fdrkbj",
92             "type": "Link",
93             "linkType": "TaxonomyConcept"
94           }
95         }
96       ],
97       "conceptSchemes": [
98         {
99           "sys": {
100             "type": "Link",
101             "linkType": "TaxonomyConceptScheme",
102             "id": "2s0F7127ajju1AVToMaCtE"
103           }
104         }
105       ]
106     }
107   ]
108 }

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

concept_idstringRequired

The ID of the concept.

organization_idstringRequired

The ID of the organization.

Query parameters

depthintegerOptional

Number of levels to traverse downwards to retrieve descendants. Default=1 (i.e. direct children only)

limitintegerOptional

Limits the maximum number of concepts returned (per page).

pageNextstringOptional

Pagination cursor from which to return the next page of concepts. Alternatively, just call the url at pages.next in the previous response.

pagePrevstringOptional

Pagination cursor from which to return the previous page of concepts. Alternatively, just use the full url from pages.prev in the previous response.

orderenumOptional

Options for ordering the results

querystringOptional

Filter results using a full-text search query, looking at prefLabel, altLabels, hiddenLabels and notations fields

Response headers

Content-Typestring

Content-Type

Response

OK - Request successful