Get concepts

GET

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

GET

/organizations/:organization_id/taxonomy/concepts

$ curl -G https://api.contentful.com/organizations/0D9ZC8rLWiw6x5qizZGiRs/taxonomy/concepts \
>      -H "Authorization: Bearer <token>" \
>      -d conceptScheme=1Ijjir8N7tiDH7NfX1oAW3 \
>      -d limit=10 \
>      -d order=sys.createdAt \
>      -d query=bed \
>      --data-urlencode "sys.id[in]=5aisxSUzyfcnFpuzjmdY8J,1Ijjir8N7tiDH7NfX1oAW3"

200Taxonomy_getConcepts_example

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

Returns all taxonomy concepts for an organization, with cursor-based pagination. Filter by sys.id[in], conceptScheme, order, limit, query, pageNext, and pagePrev query parameters.

Authentication

AuthorizationBearer

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

Path parameters

organization_idstringRequired

The ID of the organization.

Query parameters

sys.id[in]stringOptional

Return only the concepts matching the given comma-separated list of concept IDs

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

conceptSchemestringOptional

Return only concepts belonging to the specified concept scheme

querystringOptional

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

Response headers

Content-TypestringOptional

Content-Type

Response

OK - Request successful