Get all concepts | Documentation

curl -G https://cdn.contentful.com/spaces/yadj1kx9rmg0/environments/staging/taxonomy/concepts \
     -d limit=limit \
     -d pageNext=pageNext \
     -d pagePrev=pagePrev \
     -d conceptScheme=conceptScheme \
     -d order=order

{
  "sys": {
    "type": "Array"
  },
  "limit": 100,
  "pages": {
    "prev": "<url>",
    "next": "<url>"
  },
  "items": [
    {
      "sys": {
        "id": "3DMf5gdax6J22AfcJ6fvsC",
        "type": "TaxonomyConcept",
        "createdAt": "2025-09-22T06:43:45.000Z",
        "updatedAt": "2025-09-22T06:43:45.000Z",
        "version": 1
      },
      "uri": null,
      "prefLabel": {
        "en-US": "sofa"
      },
      "altLabels": {
        "en-US": []
      },
      "hiddenLabels": {
        "en-US": []
      },
      "notations": [],
      "note": {
        "en-US": ""
      },
      "changeNote": {
        "en-US": ""
      },
      "definition": {
        "en-US": ""
      },
      "editorialNote": {
        "en-US": ""
      },
      "example": {
        "en-US": ""
      },
      "historyNote": {
        "en-US": ""
      },
      "scopeNote": {
        "en-US": ""
      },
      "broader": [
        {
          "sys": {
            "id": "5YRe68gqRx6QlLyEE00Ue6",
            "type": "Link",
            "linkType": "TaxonomyConcept"
          }
        }
      ],
      "related": [
        {
          "sys": {
            "id": "5YRe68gqRx6QlLyEE00Ue6",
            "type": "Link",
            "linkType": "TaxonomyConcept"
          }
        }
      ],
      "conceptSchemes": [
        {
          "sys": {
            "type": "Link",
            "linkType": "TaxonomyConceptScheme",
            "id": "2s0F7127ajju1AVToMaCtE"
          }
        }
      ]
    }
  ]
}

Returns all taxonomy concepts for the organization, with cursor-based pagination. Filter by conceptScheme, order, limit, pageNext, and pagePrev query parameters.

Path parameters

space_idstringRequired

ID of the space

environment_idstringRequired

ID of the environment

Query parameters

limitstringOptional

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.

conceptSchemestringOptional

Return only concepts belonging to the specified concept scheme

orderstringOptional

Options: sys.createdAt, sys.updatedAt, prefLabel

Response headers

Content-Typestring

Content-Type

Response

OK - Request successful