# SEC Annual Cash Conversion Brief (`jpmarketdata/sec-annual-cash-conversion-brief`) Actor

Compare two full fiscal years of SEC 10-K revenue and operating cash flow for exact company CIKs, with a revenue-up/cashflow-down flag and filing evidence.

- **URL**: https://apify.com/jpmarketdata/sec-annual-cash-conversion-brief.md
- **Developed by:** [h ichi](https://apify.com/jpmarketdata) (community)
- **Categories:** Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$10.00 / 1,000 annual cash conversion brief createds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## SEC Annual Cash Conversion Brief

For each exact company CIK, compare revenue and operating cash flow in the latest eligible SEC 10-K and its prior fiscal year. Use the result for periodic investment or vendor due diligence: did revenue increase while cash generated by operations declined? It is a factual screening aid, not an investment recommendation or an assertion about earnings quality.

### Input

Provide 1–5 exact numeric company CIKs in `ciks` (Apple `0000320193`, Microsoft `0000789019`). The Actor normalizes leading zeros to 10 digits and requires the source CIK to match. The default contains both Apple and Microsoft. Ticker and company-name search are not supported. Only US-GAAP 10-K annual data with two complete years and the required tagged concepts is supported. An unsupported or incomplete CIK fails explicitly without a dataset row or charge.

### Output

One row per usable CIK. The row gives two same-filing fiscal years of USD revenue and operating cash flow, year-over-year percentages, operating-cash-flow-to-revenue percentages, a `revenueUpCashflowDown` flag, exact SEC accession/date, source URL, and observation time. Both facts must share the same accession and exact start/end dates for each full-year period. A year is 330–390 days. The same latest 10-K supplies both years so restatements do not silently mix sources. Operating cash-flow change divides the year-over-year difference by the absolute prior value, preserving the direction of change when prior cash flow was negative. A prior operating cash flow of zero makes its change rate undefined, so the field is omitted; the cash-flow-to-revenue ratios remain defined because revenue must be positive. No earnings-quality score or investment advice is provided.

### Limits

Official SEC companyfacts JSON only, one request per CIK, at most five CIKs and seven total HTTP requests including robots and one bounded retry, 180 seconds, 6 MiB per response, 256 MB memory. Requests use a declared User-Agent and at least two seconds between requests. No proxy, browser, login, paid key, bulk download, or HTML crawl. The Actor rejects redirect, source block, rate limit, malformed/missing facts, unmatched periods, or a zero-row result before charging. The SEC can revise XBRL facts; each run is a fresh snapshot.

### Privacy

Only a company CIK/name, annual aggregate financial facts, SEC accession and source URL are returned. Person names, contact details, addresses, filing text, and raw source JSON are excluded. SEC is the data source and does not endorse this Actor.

### Price

One primary `annual-cash-conversion-created` event costs $0.01 per delivered usable CIK row, so a 1–5 CIK run costs $0.01–$0.05. No start event or charge for failed/incomplete rows.

# Actor input Schema

## `ciks` (type: `array`):

One to five exact numeric SEC company CIKs; leading zeros are normalized to 10 digits. No tickers or company names.

## Actor input object example

```json
{
  "ciks": [
    "0000320193",
    "0000789019"
  ]
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "ciks": [
        "0000320193",
        "0000789019"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("jpmarketdata/sec-annual-cash-conversion-brief").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "ciks": [
        "0000320193",
        "0000789019",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("jpmarketdata/sec-annual-cash-conversion-brief").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "ciks": [
    "0000320193",
    "0000789019"
  ]
}' |
apify call jpmarketdata/sec-annual-cash-conversion-brief --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,jpmarketdata/sec-annual-cash-conversion-brief"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/4CmEV46hr7yPP2lGB/builds/f18jLJaK5n1i00htP/openapi.json