DatahyenaDatahyena
API Reference

Executive Moves

Executive job-change signals across tracked companies and people.

GET
/v1/exec-moves

Returns executive appointment, promotion, departure, and transition events ordered by discovery time. Costs one credit per returned record.

X-API-Key<token>

In: header

Query Parameters

cursor?string

Opaque pagination cursor returned as pagination.nextCursor.

companyId?string

Company UUID filter.

personId?string

Person UUID filter.

roleSeniority?array<>

Role seniority filters. Repeat the query key for multiple values.

moveType?array<>

Move type filters. Repeat the query key for multiple values.

since?string

Return events discovered or announced after this ISO-8601 timestamp.

until?string

Return events discovered or announced before this ISO-8601 timestamp.

limit?number

Maximum records to return.

Default20
Range1 <= value <= 100

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/exec-moves"
{  "success": true,  "data": [    {      "id": "019e8a3c-0a12-7e88-a3d1-4f5a6b7c8d9e",      "person": {        "id": "019e8a3c-2b10-7c44-8a1f-9d8e7c6b5a40",        "name": "Jane Doe",        "linkedinHandle": "jane-doe",        "linkedinUrl": "https://www.linkedin.com/in/jane-doe"      },      "company": {        "id": "019e8a3c-2b10-7c44-8a1f-9d8e7c6b5a40",        "name": "Acme AI",        "domain": "acme.ai",        "description": "AI workflow automation for enterprise revenue teams.",        "linkedinHandle": "acme-ai",        "linkedinUrl": "https://www.linkedin.com/company/acme-ai",        "linkedinGeoId": "90000084",        "linkedinIndustryId": "4",        "hqCity": "San Francisco",        "hqCountry": {          "code": "US",          "name": "United States"        },        "industryGroup": "Software Development",        "industrySubTags": [          "Artificial Intelligence",          "Sales Automation"        ],        "employeeCountBucket": "51-200",        "foundedYear": 2021,        "businessModel": "B2B SaaS",        "createdAt": "2026-05-01T12:00:00.000Z",        "updatedAt": "2026-05-30T12:00:00.000Z"      },      "fromCompany": {        "id": "019e8a3c-2b10-7c44-8a1f-9d8e7c6b5a40",        "name": "Acme AI",        "domain": "acme.ai",        "description": "AI workflow automation for enterprise revenue teams.",        "linkedinHandle": "acme-ai",        "linkedinUrl": "https://www.linkedin.com/company/acme-ai",        "linkedinGeoId": "90000084",        "linkedinIndustryId": "4",        "hqCity": "San Francisco",        "hqCountry": {          "code": "US",          "name": "United States"        },        "industryGroup": "Software Development",        "industrySubTags": [          "Artificial Intelligence",          "Sales Automation"        ],        "employeeCountBucket": "51-200",        "foundedYear": 2021,        "businessModel": "B2B SaaS",        "createdAt": "2026-05-01T12:00:00.000Z",        "updatedAt": "2026-05-30T12:00:00.000Z"      },      "role": "Chief Financial Officer",      "roleSeniority": "c_level",      "moveType": "appointment",      "announcedAt": "2026-05-29T00:00:00.000Z",      "effectiveDate": "2026-06-15T00:00:00.000Z",      "discoveredAt": "2026-05-30T12:00:00.000Z",      "sources": [        {          "url": "https://example.com/acme-names-cfo",          "extractedAt": "2026-05-30T12:00:00.000Z"        }      ]    }  ],  "pagination": {    "hasMore": true,    "nextCursor": "eyJpZCI6IjAxOWU4YTNjLTJiMTAtN2M0NC04YTFmLTlkOGU3YzZiNWE0MCJ9"  },  "meta": {    "endpoint": "funding_events.list",    "creditsUsed": 20,    "creditsRemaining": 980  }}
{  "success": false,  "error": {    "code": "INVALID_INPUT",    "message": "limit must not be greater than 100"  },  "meta": {    "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"  }}
{  "success": false,  "error": {    "code": "UNAUTHORIZED",    "message": "Missing or invalid API key."  },  "meta": {    "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"  }}
{  "success": false,  "error": {    "code": "PAYMENT_REQUIRED",    "message": "Workspace has no credits remaining. Top up to continue."  },  "meta": {    "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"  }}
{  "success": false,  "error": {    "code": "FORBIDDEN",    "message": "Request blocked by abuse prevention policy."  },  "meta": {    "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"  }}
{  "success": false,  "error": {    "code": "TOO_MANY_REQUESTS",    "message": "Rate limit exceeded for this workspace and plan."  },  "meta": {    "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"  }}