companies

Company timelines (bulk)

Resolve up to 25 companies and return each timeline. Costs one credit per record (company plus each included event) per resolved company. Companies are served in order until credits run out; the rest are marked skipped. Unresolved companies cost nothing.

post/v1/companies/timeline

Request

  • Base URL: https://api.datahyena.com
  • URL: https://api.datahyena.com/v1/companies/timeline
  • Auth: API key in header X-API-Key

Request body

includestring[]

Which event kinds to include. Defaults to all. Each pulled event costs one credit.

Example request

{
  "companies": [
    {
      "domain": "legora.com",
      "name": "Legora",
      "linkedinUrl": "https://www.linkedin.com/company/wearelegora"
    }
  ]
}

Response

queryobject required

The selector this entry was resolved from.

status'served' | 'skipped_insufficient_credits' | 'not_found' required
costnumber

Credits this timeline costs (company + events). Present when resolved.

Example response

[
  {
    "timeline": {
      "company": {
        "name": "Acme AI",
        "naicsLevel": 4,
        "hqCountry": {
          "code": "US",
          "name": "United States"
        },
        "industrySubTags": [
          "Artificial Intelligence",
          "Sales Automation"
        ],
        "verticals": [
          "ai",
          "fintech"
        ]
      },
      "events": [
        {
          "funding": {
            "id": "019e8a3c-0a12-7e88-a3d1-4f5a6b7c8d9e",
            "investors": [
              {
                "id": "019e8a3c-3c21-7d55-bb2e-0e1f2a3b4c5d",
                "name": "Example Ventures"
              }
            ],
            "discoveredAt": "2026-05-30T12:00:00.000Z",
            "company": {
              "name": "Acme AI",
              "naicsLevel": 4,
              "hqCountry": {
                "code": "US",
                "name": "United States"
              },
              "industrySubTags": [
                "Artificial Intelligence",
                "Sales Automation"
              ],
              "verticals": [
                "ai",
                "fintech"
              ]
            }
          },
          "acquisition": {
            "id": "019e8a3c-0a12-7e88-a3d1-4f5a6b7c8d9e",
            "paymentType": "cash",
            "discoveredAt": "2026-05-30T12:00:00.000Z",
            "acquirer": {
              "name": "Acme AI",
              "naicsLevel": 4,
              "hqCountry": {
                "code": "US",
                "name": "United States"
              },
              "industrySubTags": [
                "Artificial Intelligence",
                "Sales Automation"
              ],
              "verticals": [
                "ai",
                "fintech"
              ]
            },
            "target": {
              "name": "Acme AI",
              "naicsLevel": 4,
              "hqCountry": {
                "code": "US",
                "name": "United States"
              },
              "industrySubTags": [
                "Artificial Intelligence",
                "Sales Automation"
              ],
              "verticals": [
                "ai",
                "fintech"
              ]
            }
          },
          "execMove": {
            "id": "019e8a3c-0a12-7e88-a3d1-4f5a6b7c8d9e",
            "person": {
              "name": "Jane Doe"
            },
            "role": "Chief Financial Officer",
            "roleSeniority": "c_level",
            "moveType": "appointment",
            "discoveredAt": "2026-05-30T12:00:00.000Z",
            "company": {
              "name": "Acme AI",
              "naicsLevel": 4,
              "hqCountry": {
                "code": "US",
                "name": "United States"
              },
              "industrySubTags": [
                "Artificial Intelligence",
                "Sales Automation"
              ],
              "verticals": [
                "ai",
                "fintech"
              ]
            },
            "fromCompany": {
              "name": "Acme AI",
              "naicsLevel": 4,
              "hqCountry": {
                "code": "US",
                "name": "United States"
              },
              "industrySubTags": [
                "Artificial Intelligence",
                "Sales Automation"
              ],
              "verticals": [
                "ai",
                "fintech"
              ]
            }
          },
          "hiring": {
            "id": "019e8a3c-0a12-7e88-a3d1-4f5a6b7c8d9e",
            "eventType": "leadership_opening",
            "function": "sales",
            "country": {
              "code": "US",
              "name": "United States"
            },
            "technologies": [
              "salesforce",
              "gong"
            ],
            "announcedAt": "2026-10-02",
            "active": true,
            "roleCount": 2,
            "roles": [
              {
                "title": "Head of Sales",
                "function": "sales",
                "seniority": "head",
                "salary": {
                  "interval": "year"
                },
                "technologies": [
                  "salesforce",
                  "gong"
                ]
              }
            ],
            "board": "ashby",
            "discoveredAt": "2026-10-13T09:20:00.000Z",
            "company": {
              "name": "Acme AI",
              "naicsLevel": 4,
              "hqCountry": {
                "code": "US",
                "name": "United States"
              },
              "industrySubTags": [
                "Artificial Intelligence",
                "Sales Automation"
              ],
              "verticals": [
                "ai",
                "fintech"
              ]
            }
          }
        }
      ]
    }
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.