# Particle Pro: List Companies

> Particle Pro: List Companies is a paid API for AI agents from api.particle.pro, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns a paginated, filterable list of companies with support for search by name, domain, ticker, CIK, Wikidata QID, or bulk slug/ID lookup.

## Facts

- Endpoint: GET https://api.particle.pro/v1/companies
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/particle-pro-list-companies-fe3d051c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_iSals-jiKmbOK52R86S5t

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability particle-pro-list-companies-fe3d051c
```

Example prompt: Search Particle Pro for companies with 'apple' in their name and also pull up any results matching the ticker AAPL or domain apple.com — show me the first 10 results.

## When to prefer this

Use this endpoint when you need to search, filter, or paginate through company records using flexible identifiers such as name queries, domains, tickers, SEC CIKs, Wikidata QIDs, or bulk slugs. Prefer this over the single-company GET endpoint when you need multiple companies at once or want to discover companies via search. Ideal for incremental data syncs using the updated_after parameter or for building company directories and enrichment pipelines.

## Known failure modes

- Invalid or unrecognized cursor returns an error or empty result set
- Requesting more than 100 IDs in bulk lookup may be rejected
- Malformed ISO 8601 date in updated_after causes a validation error
- Filtering by a non-existent ticker or CIK returns an empty list
- Payment not fulfilled results in 402 Payment Required response
- Comma-separated arrays passed as a single string instead of array items may not parse correctly

## How this service works

List companies. Returns a paginated list of companies.

## Output

A paginated list of company objects, each containing identifiers (slug, ID, domain), names, stock tickers, SEC CIK numbers, Wikidata QIDs, and other metadata. Includes an opaque cursor for fetching the next page of results. When using the `ids` bulk-get parameter, returns exactly those companies (omitting unresolved refs) and ignores other filters.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "q": {
       "type": "string",
       "description": "Search by name (case-insensitive partial match)"
      },
      "cik": {
       "type": "array",
       "items": {
        "type": "string"
       },
       "description": "Filter by SEC CIK(s), comma-separated"
      },
      "ids": {
       "type": "array",
       "items": {
        "type": "string"
       },
       "description": "Bulk multi-get: one or more company slugs (e.g. 'apple'), domains (e.g. 'apple.com'), or IDs, comma-separated (max 100) — the same identifiers GET /v1/companies/{id} accepts. When set, returns exactly those companies and the other filters/search and pagination are ignored. Refs that don't resolve are omitted from the response."
      },
      "qid": {
       "type": "array",
       "items": {
        "type": "string"
       },
       "description": "Filter by Wikidata QID(s), comma-separated"
      },
      "limit": {
       "type": "integer",
       "format": "int64",
       "description": "Results per page"
      },
      "cursor": {
       "type": "string",
       "description": "Opaque pagination cursor from previous response"
      },
      "domain": {
       "type": "array",
       "items": {
        "type": "string"
       },
       "description": "Filter by company domain(s), comma-separated"
      },
      "ticker": {
       "type": "array",
       "items": {
        "type": "string"
       },
       "description": "Filter by stock ticker symbol(s), comma-separated"
      },
      "entity_id": {
       "type": "array",
       "items": {
        "type": "string"
       },
       "description": "Entity slug(s) (e.g., 'apple', 'nvidia') or ID(s), comma-separated"
      },
      "updated_after": {
       "type": "string",
       "description": "Only items updated after this ISO 8601 date or date-time (e.g. 2024-01-01 or 2024-01-01T00:00:00Z). Useful for incremental syncing."
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/particle-pro-list-companies-fe3d051c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.particle.pro](https://www.zero.xyz/host/api.particle.pro/llms.txt)