Skip to content
luranta/docs

Search documentation

Search pages, sections and API operations.

List company events
.md

API Reference/Facts

List company events

GET
/v0/company-events

Authorization

Authorization
Bearerrequired

Organisation API key supplied only through the Authorization header. Required scopes: companies:read.

Query parameters

matchingJobs
objectoptional

Explicit facts that must match one published job at the company. Action and target selections match one assertion.

company
objectoptional

Company context. Values within each category use OR; categories combine with AND. Employee bounds must contain the whole disclosed interval. FTE never satisfies an employee-count filter.

query
stringoptional

Company-name query using case-insensitive substring and similarity matching. Normalized to Unicode NFC with folded whitespace; 1–200 characters.

Range:1200
Examples ["Acme"]Maximum length 200Minimum length 1
countries
enum[]optional

ISO 3166-1 alpha-2 country codes. Companies in any supplied country are returned.

Maximum items:50
Available options:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW
Default []Examples [["GB"]]Maximum items 50
industries
enum[]optional

Industry sector codes assigned to the company. Companies matching any supplied sector are returned.

Maximum items:23
Available options:agriculture-forestry-fishingmining-natural-resourcesenergy-utilitiesenvironmental-waste-servicesmanufacturingfashion-textiles-apparelconsumer-goodsconstructionreal-estatewholesale-retailtransport-logistics-postalhospitality-food-travelmedia-arts-entertainmenttechnology-information-servicestelecommunicationsfinance-insuranceprofessional-business-serviceseducationhealthcare-life-sciencessocial-caregovernment-public-sectornonprofit-associationspersonal-household-services
Default []Examples [["technology-information-services"]]Maximum items 23
sort
enumoptional
Available options:namerecency
paginationToken
stringoptional

Opaque keyset token from meta.nextToken or meta.previousToken. Reuse it with unchanged filters and sort. Expires after 24 hours.

Range:11000
Maximum length 1000Minimum length 1

Responses

A page of source-attributed observation bundles.

Pagination

meta
objectrequired

data
object[]required
Maximum items:50
Maximum items 50

Headers

Luranta-Cost-USD
stringoptional

Credit consumed as a USD decimal string. Present only on successful billable responses.

Pattern:^(?:0|[1-9]\d*)\.\d{2,6}$
Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$
Luranta-Credit-Balance-USD
stringoptional

Organisation credit remaining after settlement. Present only on successful billable responses.

Pattern:^(?:0|[1-9]\d*)\.\d{2,6}$
Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$
Luranta-Resources-Returned
integeroptional

Number of resources returned and charged. Present only on successful billable responses.

Range:02147483647
Maximum 2147483647Minimum 0
traceparent
stringrequired

W3C trace context generated for this request attempt.

Pattern:^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$
Pattern ^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$
X-Request-Id
stringrequired

Unique UUIDv7 identifier for this request attempt.

Format:uuid
Format uuid