{"uid":"cap_iSals-jiKmbOK52R86S5t","slug":"particle-pro-list-companies-fe3d051c","name":"Particle Pro: List Companies","description":"List companies. Returns a paginated list of companies.","url":"https://api.particle.pro/v1/companies","method":"GET","headers":{},"bodySchema":{"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}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_TJiWpaAi5E_2oGO9FDkoG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a paginated, filterable list of companies with support for search by name, domain, ticker, CIK, Wikidata QID, or bulk slug/ID lookup.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Incremental company data sync","prompt":"Pull all companies from Particle Pro that have been updated since January 1, 2024 so I can sync our internal database with the latest records — use a limit of 50 per page."},{"title":"Bulk company lookup by slug","prompt":"I have a list of company slugs — apple, nvidia, microsoft, and amazon — can you fetch all of them at once from Particle Pro and return their full profiles?"},{"title":"Ticker-based company research","prompt":"Find the company records for tickers TSLA, AMZN, and GOOG on Particle Pro so I can see their domains and entity metadata."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:48:43.137Z","isFirstParty":false}