Financing Events

Recent financing events for one company domain.

Endpoint

GET /api/v1/signals/financing-events

Authentication

All requests require the X-Satellyte-API-Key header. See Quickstart.

Query parameters

Field	Type	Required	Notes
`company_domain`	string	Yes	Company domain.
`first_seen_at_from`	string	No	Lower bound for event first-seen date.
`first_seen_at_until`	string	No	Upper bound for event first-seen date.
`page`	number	No	Page number. Minimum `1`.
`limit`	number	No	Page size. Minimum `1`, maximum `50`.

cURL

curl -i "https://api-staging.satellyte.ai/api/v1/signals/financing-events?company_domain=openai.com&limit=10" \
  -H "X-Satellyte-API-Key: $API_KEY"

Response (200)

{
  "data": {
    "company_domain": "openai.com",
    "type": "financing_events",
    "count": 5,
    "items": [
      {
        "id": "e1725e7b-9711-45f8-ab4d-d50f8989e85a",
        "event_type": "financing_event",
        "categories": ["other"],
        "financing_type": null,
        "financing_type_normalized": null,
        "amount": "$75 million",
        "amount_normalized": 75000000,
        "effective_date": null,
        "found_at": "2024-02-06T11:05:04+01:00",
        "source_urls": [
          "https://www.channelnewsasia.com/business/robinhoods-venture-fund-invests-75-million-in-openai-6073721"
        ],
        "company": {
          "id": "62b85623-6793-55e1-a71b-4c3333599b2d",
          "name": "OpenAI",
          "domain": "openai.com",
          "ticker": null
        },
        "investors": [
          {
            "id": "6bdf9a17-c7c7-54a9-a039-7517ea5bf9a7",
            "name": "Robinhood",
            "domain": "robinhood.com",
            "ticker": "NASDAQ:HOOD"
          }
        ]
      }
    ]
  }
}

Response fields

Field	Type	Notes
`company_domain`	string	Normalized company domain that was queried.
`type`	string	Always `financing_events`.
`count`	number	Number of financing event records returned in `items`.
`items[].id`	string	Unique financing event ID.
`items[].event_type`	string	Event type, usually `financing_event`.
`items[].categories`	string[]	Event categories, for example `venture` or `other`.
`items[].financing_type`	string \| null	Financing type when available, for example `funding round`.
`items[].financing_type_normalized`	string \| null	Normalized financing type when available.
`items[].amount`	string \| null	Reported financing amount.
`items[].amount_normalized`	number \| null	Numeric amount when the amount can be normalized.
`items[].effective_date`	string \| null	Effective event date in `YYYY-MM-DD` format when available.
`items[].found_at`	string	Timestamp when the event was found.
`items[].source_urls`	string[]	Source URLs for the financing event.
`items[].company.id`	string	Related company ID.
`items[].company.name`	string	Related company name.
`items[].company.domain`	string	Related company domain.
`items[].company.ticker`	string \| null	Related company ticker when available.
`items[].investors[].id`	string	Investor ID when investors are available.
`items[].investors[].name`	string	Investor name.
`items[].investors[].domain`	string \| null	Investor company domain when available.
`items[].investors[].ticker`	string \| null	Investor ticker when available.

When events exist, each item includes the event id, financing metadata such as financing_type, amount, amount_normalized, effective_date, found_at, source_urls, plus related company and investors when available.

Error responses

All failed calls use the standard error envelope documented in Errors.

Status	Code	Notes
`400`	`validation_error`	Returned when required query parameters are missing or invalid.
`401`	`unauthorized`	Returned when `X-Satellyte-API-Key` is missing, invalid, or expired.
`404`	`not_found`	Returned when Public API access is not enabled or the requested Public API resource is unavailable.
`429`	`rate_limit_exceeded`	Returned when the API key exceeds its configured rate limit.
`500`	`service_error`	Returned when the service cannot complete the request. Retry with backoff.