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

# Company Cashflow Statement

> Current and historical cash flow statement of publicly listed companies

## 现金流量表

**URL**: `/v1/stock/company-cashflow-statement`
**方法**: `POST`\
**描述**: 获取公司现金流量表数据。

### 请求参数

| 参数名             | 类型  | 必填 | 描述                                                |
| --------------- | --- | -- | ------------------------------------------------- |
| symbol          | str | 是  | 股票代码。                                             |
| period          | str | 否  | 报告周期：`annual`、`quarterly`、`cumulative quarterly`。 |
| limit           | int | 否  | 返回最近 N 条记录，默认 8。                                  |
| start\_date     | str | 否  | 开始日期（YYYY-MM-DD）。                                 |
| end\_date       | str | 否  | 结束日期（YYYY-MM-DD）。                                 |
| calendar        | str | 否  | `calendar` 或 `fiscal`，默认 `fiscal`。                |
| fiscal\_year    | str | 否  | 指定财年（如 `2023`）。                                   |
| fiscal\_quarter | str | 否  | 指定财季（Q1, Q2, Q3, Q4, FY, H1, `Q3 (9 months)`）。    |

### 响应参数

| 参数名                                                                       | 类型     | 描述                   |
| ------------------------------------------------------------------------- | ------ | -------------------- |
| status                                                                    | int    | HTTP 状态码。            |
| code                                                                      | int    | 响应代码（0 表示成功）。        |
| message                                                                   | str    | 响应消息。                |
| data                                                                      | array  | 现金流量表数据列表。           |
|   currency                                                                | str    | 货币单位。                |
|   end\_date                                                               | str    | 报告期结束日期（YYYY-MM-DD）。 |
|   symbol                                                                  | str    | 股票代码。                |
|   fiscal\_year                                                            | str    | 财年。                  |
|   fiscal\_quarter                                                         | str    | 财季。                  |
|   period                                                                  | str    | 报告周期类型。              |
|   filling\_date                                                           | str    | 填报日期（YYYY-MM-DD）。    |
|   cash\_flows\_from\_operating\_activities                                | object | 经营活动现金流。             |
|     net\_cash\_flows\_from\_operating\_activities                         | number | 经营活动产生的现金流量净额。       |
|   cash\_flows\_from\_investing\_activities                                | object | 投资活动现金流。             |
|     net\_cash\_flows\_from\_investing\_activities                         | number | 投资活动产生的现金流量净额。       |
|   cash\_flows\_from\_financing\_activities                                | object | 筹资活动现金流。             |
|     net\_cash\_flows\_from\_financing\_activities                         | number | 筹资活动产生的现金流量净额。       |
|     effect\_of\_exchange\_rate\_changes\_on\_cash\_and\_cash\_equivalents | number | 汇率变动对现金及现金等价物的影响。    |
|     net\_increase\_in\_cash\_and\_cash\_equivalents                       | number | 现金及现金等价物净增加额。        |
|     cash\_and\_cash\_equivalents\_at\_beginning\_of\_year                 | number | 期初现金及现金等价物余额。        |
|     cash\_and\_cash\_equivalents\_at\_end\_of\_year                       | number | 期末现金及现金等价物余额。        |

### 请求示例

**cURL**

```bash theme={null}
curl -X POST https://api.reportify.cn/v1/stock/company-cashflow-statement \
-H "Authorization: Bearer 447460****09c9" \
-H "Content-Type: application/json" \
-d '{
    "symbol": "00700",
    "limit": 2
}'
```

**Python**

```python theme={null}
import requests

url = "https://api.reportify.cn/v1/stock/company-cashflow-statement"
headers = {
    "Authorization": "Bearer 447460****09c9",
    "Content-Type": "application/json"
}
data = {
    "symbol": "00700",
    "limit": 2
}

response = requests.post(url, headers=headers, json=data)
print(response.json())
```

### 响应示例

```json theme={null}
{
  "status": 200,
  "code": 0,
  "message": "",
  "data": [
    {
      "currency": "CNY",
      "end_date": "2025-09-30",
      "symbol": "00700",
      "fiscal_year": "2025",
      "fiscal_quarter": "Q3",
      "period": "quarterly",
      "filling_date": "2025-11-13",
      "cash_flows_from_operating_activities": {
        "net_cash_flows_from_operating_activities": 85312000000.0
      },
      "cash_flows_from_investing_activities": {
        "net_cash_flows_from_investing_activities": -75507000000.0
      },
      "cash_flows_from_financing_activities": {
        "net_cash_flows_from_financing_activities": -30637000000.0,
        "effect_of_exchange_rate_changes_on_cash_and_cash_equivalents": -1243000000.0,
        "net_increase_in_cash_and_cash_equivalents": -20832000000.0,
        "cash_and_cash_equivalents_at_beginning_of_year": 0.0,
        "cash_and_cash_equivalents_at_end_of_year": -22075000000.0
      }
    }
  ]
}
```

### 错误响应

| 状态码 | 描述        |
| --- | --------- |
| 422 | 请求参数验证失败。 |


## OpenAPI

````yaml POST /v1/stock/company-cashflow-statement
openapi: 3.1.0
info:
  title: Reportify API
  version: 1.0.0
  description: API documentation for Reportify's document management and search services.
servers:
  - url: https://api.reportify.cn
    description: Production server
security:
  - BearerAuth: []
paths:
  /v1/stock/company-cashflow-statement:
    post:
      tags:
        - openapi-v2-stock
      summary: Company Cashflow Statement
      description: Current and historical cash flow statement of publicly listed companies
      operationId: >-
        company_cashflow_statement_reportify_api_v2_stock_company_cashflow_statement_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CompanyCashflowStatementInput'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StockAPIResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - BearerAuth: []
components:
  schemas:
    CompanyCashflowStatementInput:
      properties:
        symbol:
          type: string
          title: Symbol
          description: Stock symbol
        period:
          type: string
          title: Period
          description: 'Report cycle: ''annual'', ''quarterly'', ''cumulative quarterly'''
        limit:
          type: integer
          title: Limit
          description: Return latest N records, default 8
        start_date:
          type: string
          title: Start Date
          description: Start date (YYYY-MM-DD)
        end_date:
          type: string
          title: End Date
          description: End date (YYYY-MM-DD)
        calendar:
          type: string
          title: Calendar
          description: '''calendar'' or ''fiscal'', default ''fiscal'''
        fiscal_year:
          type: string
          title: Fiscal Year
          description: Specific fiscal year (e.g., '2023')
        fiscal_quarter:
          type: string
          title: Fiscal Quarter
          description: Specific fiscal quarter (Q1, Q2, Q3, Q4, FY, H1, 'Q3 (9 months)')
      type: object
      required:
        - symbol
      title: CompanyCashflowStatementInput
      description: Input schema for company cashflow statement
    StockAPIResponse:
      properties:
        status:
          type: integer
          title: Status
          description: HTTP status code
        code:
          type: integer
          title: Code
          description: Response code (0 for success)
        message:
          type: string
          title: Message
          description: Response message
        data:
          type: object
          title: Data
          description: Response data (structure varies by endpoint)
      type: object
      title: StockAPIResponse
      description: Generic response wrapper from stock API
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Enter your Bearer token

````