> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cardapioweb.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Consultar categoria de insumo

> Retorna os detalhes de uma categoria de insumos.

Este endpoint exige autenticação OAuth 2.0 com escopo `catalog`. Não aceita API Key.



## OpenAPI

````yaml /reference/api-catalogo.json get /api/partner/v1/catalog/inventory/supply_categories/{id}
openapi: 3.1.0
info:
  title: API Catálogo
  version: '1.0'
  description: >-
    A API de catálogo fornece e gerencia o catálogo completo do estabelecimento,
    incluindo categorias, itens, grupos de complementos, opções e insumos.


    ## Autenticação


    Apps da CW App Store usam `Authorization: Bearer <access_token>` (OAuth 2.0)
    com escopo `catalog`.


    Integrações legadas exigem `X-API-KEY` e `X-PARTNER-KEY` nos endpoints de
    cardápio. Os endpoints de insumos exigem OAuth 2.0 e não aceitam API Key.


    Consulte a documentação em /autenticacao/modelos-de-autenticacao.


    ## Rate Limits


    Para o endpoint `GET /api/partner/v1/catalog`, o limite é de **5 requisições
    por minuto**.


    Para os demais endpoints do módulo de Catálogo (`/catalog/*`), o limite é de
    **100 requisições a cada 3 minutos**. Consulte /sobre-a-api#rate-limits.
  contact:
    email: integracao@cardapioweb.com
    url: https://cardapioweb.com
    name: Cardápio Web
servers:
  - url: https://integracao.sandbox.cardapioweb.com
    description: Sandbox
  - description: Produção
    url: https://integracao.cardapioweb.com
security:
  - bearerAuth: []
  - partnerKey: []
    apiKey: []
tags:
  - name: Catálogo completo
    description: Consulta do catálogo completo do estabelecimento.
  - name: Categorias
    description: Gerenciamento de categorias do cardápio.
  - name: Itens
    description: Gerenciamento de itens (produtos) do cardápio.
  - name: Grupos de complementos
    description: Gerenciamento de grupos de complementos (option groups) do cardápio.
  - name: Opções
    description: Gerenciamento de opções (subitens/complementos individuais) do cardápio.
  - name: Imagens
    description: Upload e remoção de imagens de categorias, itens e opções.
  - name: Categorias de insumos
    description: Gerenciamento de categorias de insumos do estabelecimento.
  - name: Insumos
    description: Gerenciamento de insumos do estabelecimento.
paths:
  /api/partner/v1/catalog/inventory/supply_categories/{id}:
    parameters:
      - name: id
        in: path
        required: true
        schema:
          type: integer
        description: ID da categoria de insumo.
    get:
      tags:
        - Categorias de insumos
      summary: Consultar categoria de insumo
      description: >-
        Retorna os detalhes de uma categoria de insumos.


        Este endpoint exige autenticação OAuth 2.0 com escopo `catalog`. Não
        aceita API Key.
      operationId: getSupplyCategory
      responses:
        '200':
          description: Categoria de insumo retornada com sucesso.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SupplyCategory'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
components:
  schemas:
    SupplyCategory:
      title: SupplyCategory
      type: object
      description: Categoria de insumos do estabelecimento.
      properties:
        id:
          type: integer
          description: Identificador único da categoria de insumos.
        name:
          type: string
          description: Nome da categoria de insumos.
        created_at:
          type: string
          format: date-time
          description: Data e hora de criação da categoria.
    Unauthorized:
      type: object
      title: Unauthorized
      description: >-
        Resposta de erro de autenticação. Retornado quando os headers
        `X-API-KEY` ou `X-PARTNER-KEY` estão ausentes ou são inválidos.
      examples:
        - code: 4010
          message: Token inválido.
      properties:
        code:
          type: integer
          description: Código interno de identificação do erro.
        message:
          type: string
          description: Mensagem de resumo do erro.
      required:
        - code
        - message
    Error:
      title: Error
      type: object
      description: Resposta de erro padrão da API.
      properties:
        code:
          type: integer
          description: Código interno de identificação do erro.
        message:
          type: string
          description: Mensagem de resumo do erro.
        details:
          type: string
          description: Detalhes adicionais do erro (quando disponível).
        errors:
          type: object
          description: Erros de validação por campo (quando disponível).
          additionalProperties:
            type: array
            items:
              type: string
      required:
        - code
        - message
  responses:
    Unauthorized:
      description: >-
        Não autorizado. Token OAuth inválido ou ausente, ou headers X-API-KEY /
        X-PARTNER-KEY inválidos ou ausentes no modelo legado.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Unauthorized'
          example:
            code: 4010
            message: Token inválido.
    NotFound:
      description: Recurso não encontrado.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            code: 4041
            message: Recurso não encontrado.
    TooManyRequests:
      description: >-
        Muitas requisições foram feitas em um curto período. Verifique as regras
        de rate limit na descrição da API.
      content: {}
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: OAuth2
      description: >-
        Access token OAuth 2.0 de app instalado na CW App Store. Escopo:
        catalog.
    partnerKey:
      name: X-PARTNER-KEY
      type: apiKey
      in: header
      description: >-
        Token de autenticação da integradora. Para ter esse token, a integradora
        precisa estar previamente cadastrada em nosso sistema. Deve ser enviado
        no header `X-PARTNER-KEY`.
    apiKey:
      name: X-API-KEY
      type: apiKey
      in: header
      description: Token de autenticação da API. Deve ser enviado no header `X-API-KEY`.

````