> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://contentful.com/developers/docs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://contentful.com/_mcp/server.

# Get concepts

GET https://api.contentful.com/organizations/{organization_id}/taxonomy/concepts

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.

Reference: https://contentful.com/developers/docs/references/content-management-api/taxonomy/get-concepts

## Authentication

- `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer <token>`, where token is your auth token.

## Request

### Path parameters

- `organization_id` (string, required) — The ID of the organization.

### Query parameters

- `sys.id[in]` (string, optional) — Return only the concepts matching the given comma-separated list of concept IDs
- `limit` (integer, optional) — Limits the maximum number of concepts returned (per page).
- `pageNext` (string, optional) — Pagination cursor from which to return the next page of concepts. Alternatively, just call the url at `pages.next` in the previous response.
- `pagePrev` (string, optional) — Pagination cursor from which to return the previous page of concepts. Alternatively, just use the full url from `pages.prev` in the previous response.
- `order` (enum, optional) — Options for ordering the results
  - Allowed values: `sys.createdAt`, `sys.updatedAt`, `prefLabel`, `-sys.createdAt`, `-sys.updatedAt`, `-prefLabel`
- `conceptScheme` (string, optional) — Return only concepts belonging to the specified concept scheme
- `query` (string, optional) — Filter results using a full-text search query, looking at _prefLabel_, _altLabels_, _hiddenLabels_ and _notations_ fields

## Response

### 200

OK - Request successful

- `map from string to any`

## Examples

**Response**

```json
{
  "items": [
    {
      "altLabels": {
        "en-US": [
          "Couches",
          "Settees"
        ]
      },
      "broader": [
        {
          "sys": {
            "id": "1Py5SjffQHkGGY3dZ02W14",
            "linkType": "TaxonomyConcept",
            "type": "Link"
          }
        }
      ],
      "changeNote": {
        "en-US": ""
      },
      "conceptSchemes": [
        {
          "sys": {
            "id": "2s0F7127ajju1AVToMaCtE",
            "linkType": "TaxonomyConceptScheme",
            "type": "Link"
          }
        }
      ],
      "definition": {
        "en-US": ""
      },
      "editorialNote": {
        "en-US": ""
      },
      "example": {
        "en-US": ""
      },
      "hiddenLabels": {
        "en-US": [
          "Davenports"
        ]
      },
      "historyNote": {
        "en-US": ""
      },
      "notations": [
        "FURN0017B"
      ],
      "note": {
        "en-US": ""
      },
      "prefLabel": {
        "en-US": "Sofas"
      },
      "related": [
        {
          "sys": {
            "id": "5abcWINB018mASQ5Fdrkbj",
            "linkType": "TaxonomyConcept",
            "type": "Link"
          }
        }
      ],
      "scopeNote": {
        "en-US": ""
      },
      "sys": {
        "createdAt": "2025-04-19T21:11:14.000Z",
        "createdBy": {
          "sys": {
            "id": "7BslKh9TdKGOK41VmLDjFZ",
            "linkType": "User",
            "type": "Link"
          }
        },
        "id": "3kZdDUXy9n0l2Xi2cq8TPc",
        "organization": {
          "sys": {
            "id": "0D9ZC8rLWiw6x5qizZGiRs",
            "linkType": "Organization",
            "type": "Link"
          }
        },
        "type": "TaxonomyConcept",
        "updatedAt": "2025-04-19T21:11:14.000Z",
        "updatedBy": {
          "sys": {
            "id": "4FLrUHftHW3v2BLi9fzfjU",
            "linkType": "User",
            "type": "Link"
          }
        },
        "version": 0
      },
      "uri": ""
    }
  ],
  "limit": 100,
  "pages": {
    "next": "<url>",
    "prev": "<url>"
  },
  "sys": {
    "type": "Array"
  }
}
```

**SDK Code**

```android Android
SDK currently doesn't implement this endpoint.
```

```java Java
SDK currently doesn't implement this endpoint.
```

```kotlin Kotlin
SDK currently doesn't implement this endpoint.
```

```swift Swift
We currently don't provide a CMA SDK for this platform.
```

```js-legacy JavaScript (legacy)
Please use the Javascript (Plain client) for this endpoint.
```

```javascript JavaScript
import { createClient } from 'contentful-management'

// Client init
const client = contentful.createClient({
  accessToken: '<content_management_api_key>'
})

const { pages, items } = await client.concept.getMany({
  organizationId: '<organization_id>',
})

// Get next page
if( pages?.next ) {
  const nextPage = await client.concept.getMany({
    organizationId: '<organization_id>',
    query: {
      pageUrl: pages.next
    }
  })
}
```

```php PHP
SDK currently doesn't implement this endpoint.
```

```ruby Ruby
SDK currently doesn't implement this endpoint.
```

```python Python
SDK currently doesn't implement this endpoint.
```

```.net .NET
csharp
// This client should only be created once per application.
var httpClient = new HttpClient();

var client = new ContentfulManagementClient(httpClient, "<content_management_api_key>", "<space_id>");

// Get all concepts
var concepts = await managementClient.GetTaxonomyConcepts(organizationId, limit: 100);

// Get concepts for a specific scheme
var schemeConcepts = await managementClient.GetTaxonomyConcepts(organizationId, conceptScheme: "scheme-id");

// Get total number of concepts
var totalConcepts = await managementClient.GetTotalTaxonomyConcepts(organizationId);
```