Executive Moves

List executive moves

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

Authorization

apiKey

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.

country?string

Company headquarters country code.

countries?array<string>

Headquarters country codes (OR). Repeat the query key for multiple values.

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 on or after this date (YYYY-MM-DD). ISO-8601 timestamps are also accepted.

until?string

Return events discovered or announced on or before this date (YYYY-MM-DD, inclusive). ISO-8601 timestamps are also accepted.

limit?number

Maximum records to return.

Default20

Range1 <= value <= 100

Response Body

`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"        ],        "verticals": [          "ai",          "fintech"        ],        "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"        ],        "verticals": [          "ai",          "fintech"        ],        "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"  }}

List executive moves

Authorization

Query Parameters

Response Body

200application/json

400application/json

401application/json

402application/json

403application/json

429application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`