---
updatedAt: 2026-04-20T21:41:08.000Z
agentTools:
  projectIndex: https://puzzle-api.readme.io/llms.txt
---

# Get Income Statement

Retrieves the income statement for a company with flexible filtering options.

This endpoint returns income statement data broken down by the specified time interval (month, quarter, or year). You can filter results by departments and locations.

Required scope: read:company

# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "Puzzle Api",
    "description": "Puzzle Api",
    "version": "0"
  },
  "servers": [
    {
      "url": "https://api.puzzle.io/rest/v0"
    }
  ],
  "paths": {
    "/company/{id}/statements/profitLoss": {
      "get": {
        "operationId": "incomeStatementApi",
        "summary": "Get Income Statement",
        "description": "Retrieves the income statement for a company with flexible filtering options.\n\nThis endpoint returns income statement data broken down by the specified time interval (month, quarter, or year). You can filter results by departments and locations.\n\nRequired scope: read:company",
        "tags": [
          "Reports"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The company ID",
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "Partner-facing external identifier"
            }
          },
          {
            "name": "basis",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "cash",
                "accrual"
              ],
              "description": "The value is normalized before matching, so any casing that maps onto a listed value is accepted."
            }
          },
          {
            "name": "viewBy",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "month",
                "quarter",
                "year",
                "totals",
                "departments"
              ],
              "description": "The value is normalized before matching, so any casing that maps onto a listed value is accepted."
            }
          },
          {
            "name": "startPeriod",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "minLength": 1
            }
          },
          {
            "name": "endPeriod",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "minLength": 1
            }
          },
          {
            "name": "dateMacro",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "CurrentMonth",
                "LastFullMonth",
                "LastThreeMonths",
                "LastThreeFullMonths",
                "CurrentYear",
                "LastYear",
                "QuarterToDate",
                "YearToDate"
              ]
            }
          },
          {
            "name": "departments",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              ],
              "description": "One or more cls_ classification segment IDs returned by GET /company/{id}/classifications, or the case-insensitive literal \"none\". Values may be repeated or comma-separated."
            }
          },
          {
            "name": "locations",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              ],
              "description": "One or more cls_ classification segment IDs returned by GET /company/{id}/classifications, or the case-insensitive literal \"none\". Values may be repeated or comma-separated."
            }
          },
          {
            "name": "expandCounterparties",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Boolean flag; \"true\" enables, any other value disables"
            }
          },
          {
            "name": "expandRevenueSources",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "Boolean flag; \"true\" enables, any other value disables"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "columns": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "key": {
                            "type": "string"
                          },
                          "label": {
                            "type": "string"
                          },
                          "dateRange": {
                            "type": "object",
                            "properties": {
                              "start": {
                                "type": "string",
                                "minLength": 1,
                                "description": "Calendar date, YYYY-MM-DD"
                              },
                              "end": {
                                "type": "string",
                                "minLength": 1,
                                "description": "Calendar date, YYYY-MM-DD"
                              }
                            },
                            "required": [
                              "start",
                              "end"
                            ],
                            "nullable": true
                          }
                        },
                        "required": [
                          "key",
                          "label"
                        ]
                      }
                    },
                    "lines": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "minLength": 1,
                            "description": "Partner-facing external identifier"
                          },
                          "title": {
                            "type": "string"
                          },
                          "values": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "balance": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "Arbitrary-precision decimal, serialized as a string"
                                },
                                "columnKey": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "balance",
                                "columnKey"
                              ]
                            }
                          },
                          "accountId": {
                            "type": "string",
                            "minLength": 1,
                            "description": "Partner-facing external identifier",
                            "nullable": true
                          },
                          "accountNumber": {
                            "type": "string",
                            "nullable": true
                          },
                          "parentId": {
                            "type": "string",
                            "minLength": 1,
                            "description": "Partner-facing external identifier",
                            "nullable": true
                          },
                          "childIds": {
                            "type": "array",
                            "items": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Partner-facing external identifier"
                            }
                          },
                          "lineType": {
                            "type": "string",
                            "enum": [
                              "account",
                              "rollup",
                              "parent_account_group",
                              "counterparty",
                              "accrualRevenueSource",
                              "department",
                              "event",
                              "revenueSource"
                            ]
                          },
                          "metadata": {
                            "type": "object",
                            "properties": {
                              "counterpartyName": {
                                "type": "string",
                                "nullable": true
                              },
                              "counterpartyType": {
                                "type": "string",
                                "enum": [
                                  "customer",
                                  "vendor",
                                  "employee",
                                  "contractor"
                                ],
                                "nullable": true
                              },
                              "revenueSourceType": {
                                "type": "string",
                                "enum": [
                                  "transaction",
                                  "invoice",
                                  "schedule",
                                  "mje",
                                  "other",
                                  "subledger"
                                ],
                                "nullable": true
                              }
                            },
                            "required": [
                              "counterpartyName",
                              "counterpartyType",
                              "revenueSourceType"
                            ],
                            "nullable": true
                          }
                        },
                        "required": [
                          "id",
                          "title",
                          "values",
                          "childIds",
                          "lineType"
                        ]
                      }
                    }
                  },
                  "required": [
                    "columns",
                    "lines"
                  ]
                }
              }
            }
          }
        }
      }
    }
  }
}
```