---
title: "Retrieve category"
method: GET
path: "/categories/{companyId}/{id}"
tags: ["Categories"]
---

# Retrieve category

`GET /categories/{companyId}/{id}`

Returns a single category by its Embat `id`.

## Path parameters

- `id` string, required
- `companyId` string, required

## Response `200`

Successful Response

- GetCategoriesResponseSchema — Category response data schema
  - `id` string, required — Embat category ID. Referenced as `categoryId` on transactions, forecasts and operations.
  - `companyId` string, required — Embat company ID. You can get them from "companies" endpoints
  - `updatedAt` string, date-time, required — Last updated date of the entity in the database
  - `createdAt` string, date-time, required — Created date of the entity in the database
  - `name` string, required — Category name.
  - `parentId` string, nullable — Embat ID of the parent category. `null` for a top-level category.

## Other responses

- `401` — Unauthorized. The bearer token is missing, invalid or expired.
- `404` — Company not found, or no category matches the given `id`.
- `422` — Validation Error

---

[API](https://skmtc.dev/embat/apis/embat-api.md) · [All operations](https://skmtc.dev/embat/apis/embat-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/embat/embat-api/revisions/490466f3823b/schema)