---
title: "Retrieve one cartola"
method: GET
path: "/v1/cartolas/{cartola_id}"
tags: ["Cartola"]
---

# Retrieve one cartola

`GET /v1/cartolas/{cartola_id}`

## Request

- Base URL: `https://api.cardda.com`
- URL: `https://api.cardda.com/v1/cartolas/{cartola_id}`
- Auth: HTTP bearer

Returns a single cartola by id, including the ids of the accounting-ledger transactions
assigned to it (`cardda_transaction_ids`). Requires the `transactions_view` permission.

## Path parameters

- `cartola_id` string, uuid, required

## Headers

- `company-id` string, uuid, required

## Response `200`

The requested cartola

- Cartola: A cartola — a company's monthly account statement, identified by `year` + `month`. It aggregates the transactions posted in that period and can carry an attached generated document (Excel/PDF).
  - `id` string, uuid, required
  - `company_id` string, uuid
  - `month` integer, required
  - `year` integer, required
  - `total_income` string, nullable: Total income in the period (decimal).
  - `total_outcome` string, nullable: Total outcome in the period (decimal).
  - `initial_balance` string, nullable: Opening balance for the period.
  - `final_balance` string, nullable: Closing balance for the period.
  - `stamp` object, nullable: Metadata about the generated document stamp.
  - `pdf` object, nullable: Metadata about the generated PDF document.
  - `document_attached` boolean: Whether a generated statement document is currently attached.
  - `cardda_transaction_ids` string[]: Ids of the accounting-ledger transactions assigned to this cartola. Present on the show response only.
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `401`: Unauthorized
- `404`: Cartola not found

---

[API](https://skmtc.dev/cardda/apis/accounting-api.md) - [All operations](https://skmtc.dev/cardda/apis/accounting-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cardda/apis/accounting-api/revisions/49cf78d0f7ab?raw)