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

# /2025-04/retail-media/categories/{categoryId}

> Endpoint to search for a specific category by categoryId.



## OpenAPI

````yaml https://api.criteo.com/2025-04/retailmedia/open-api-specifications.json get /2025-04/retail-media/categories/{categoryId}
openapi: 3.0.1
info:
  title: Criteo API
  description: Criteo API - RetailMedia
  version: 2025-04
servers:
  - url: https://api.criteo.com
security:
  - oauth: []
tags:
  - name: Accounts
  - name: Analytics
  - name: Audience
  - name: Balance
  - name: Campaign
  - name: Gateway
paths:
  /2025-04/retail-media/categories/{categoryId}:
    get:
      tags:
        - Campaign
      summary: /2025-04/retail-media/categories/{categoryId}
      description: Endpoint to search for a specific category by categoryId.
      operationId: GetCategory
      parameters:
        - name: categoryId
          in: path
          description: ID of the desired category
          required: true
          schema:
            type: string
            format: int32
      responses:
        '200':
          description: Retrieval completed and category is returned.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Category202204'
      security:
        - oauth:
            - RetailMedia_Campaign_Read
components:
  schemas:
    Category202204:
      required:
        - name
        - parentId
        - text
      type: object
      properties:
        name:
          type: string
          description: Category Name
        parentId:
          type: string
          description: Category ParentId
        text:
          type: string
          description: Category Text
      additionalProperties: false
      description: >-
        List of retailer's categories, including the full hierarchy of
        categories and their parent category ID
      nullable: true
  securitySchemes:
    oauth:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://api.criteo.com/oauth2/token
          scopes: {}
        authorizationCode:
          authorizationUrl: https://api.criteo.com/oauth2
          tokenUrl: https://api.criteo.com/oauth2/token
          scopes: {}

````