Get concept schemes

GET

https://api.contentful.com/organizations/:organization_id/taxonomy/concept-schemes

GET

/organizations/:organization_id/taxonomy/concept-schemes

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

200Taxonomy_getConceptSchemes_example

1 {
2   "sys": {
3     "type": "Array"
4   },
5   "limit": 5,
6   "pages": {
7     "prev": "<url>",
8     "next": "<url>"
9   },
10   "items": [
11     {
12       "sys": {
13         "id": "2s0F7127ajju1AVToMaCtE",
14         "type": "TaxonomyConceptScheme",
15         "organization": {
16           "sys": {
17             "id": "0D9ZC8rLWiw6x5qizZGiRs",
18             "type": "Link",
19             "linkType": "Organization"
20           }
21         },
22         "createdAt": "2025-12-11T04:33:20.000Z",
23         "createdBy": {
24           "sys": {
25             "type": "Link",
26             "linkType": "User",
27             "id": "7BslKh9TdKGOK41VmLDjFZ"
28           }
29         },
30         "updatedAt": "2025-12-11T04:33:20.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": "Home Products"
43       },
44       "definition": {
45         "en-US": ""
46       },
47       "topConcepts": [
48         {
49           "sys": {
50             "id": "1Py5SjffQHkGGY3dZ02W14",
51             "type": "Link",
52             "linkType": "TaxonomyConcept"
53           }
54         }
55       ],
56       "concepts": [
57         {
58           "sys": {
59             "id": "1Py5SjffQHkGGY3dZ02W14",
60             "type": "Link",
61             "linkType": "TaxonomyConcept"
62           }
63         }
64       ],
65       "totalConcepts": 1
66     }
67   ]
68 }

Authentication

AuthorizationBearer

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

Path parameters

concept_scheme_idstringRequired

The ID of the concept scheme.

organization_idstringRequired

The ID of the organization.

Query parameters

limitintegerOptional

Limits the maximum number of concept schemes returned (per page).

pageNextstringOptional

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

pagePrevstringOptional

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

orderenumOptional

Options for ordering the results

querystringOptional

Full-text search query, looking at prefLabel, altLabels, hiddenLabels and notations fields

Response headers

Content-Typestring

Content-Type

Response

OK - Request successful