---
search:
  tags:
    - Catégories
    - GET
seo:
  description: >-
    Récupère une catégorie par id. Un élément supprimé logiquement est renvoyé
    avec deleted: true.
sidebar:
  label: Obtenir une catégorie par ID
  badge: GET
title: Obtenir une catégorie par ID
type: openapi-operation
---
Récupère une catégorie par id. Un élément supprimé logiquement est renvoyé avec `deleted: true`.

`GET /categories/{categoryId}`

**Responses**

- `200` — Détails de la catégorie
- `403` — Clé API absente, inconnue ou inactive, ou clé Read sur une opération d’écriture.
- `404` — Aucun élément avec cet id.

Response example, 200:

```json
{
  "data": {
    "id": "cat_01",
    "name": "Boissons",
    "index": 1,
    "showOnScreen": true,
    "imageUrl": ""
  }
}
```

Response example, 403:

```json
{
  "statusCode": 403,
  "message": "Unknown Error",
  "timestamp": "2024-04-20T12:00:00.000Z",
  "path": "/api/v1/products"
}
```