API Reference

Base URL and authentication

All API requests use the base URL:

https://api.salesmotion.io

Authenticate every request with a Bearer token (JWT) in the Authorization header:

Authorization: Bearer YOUR_API_TOKEN

API access is included with the Enterprise plan. Contact your account manager to receive your credentials.

Pagination

List endpoints return paginated results. Use the page and perPage query parameters to navigate:

Field selection

Most endpoints support the onlyWithFields query parameter — a comma-separated list of field names to return. This reduces payload size when you only need specific data:

GET /v1/accounts?onlyWithFields=id,name,domain,mainScore

Accounts

List accounts

GET /v1/accounts

Retrieve a paginated list of accounts with filtering and sorting.

Query parameters:

Example request:

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://api.salesmotion.io/v1/accounts?perPage=10&type=prospect&sortBy=mainScore&sortOrder=desc"

Response: Paginated array of Account objects.

Get account

GET /v1/accounts/{accountId}

Retrieve a single account by ID, with optional related resources.

Path parameters:

Query parameters:

Example request:

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://api.salesmotion.io/v1/accounts/12345?include=company"

Companies

Get company

GET /v1/companies/{companyId}

Retrieve a company by its canonical Salesmotion ID.

Path parameters:

Query parameters:

Example request:

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://api.salesmotion.io/v1/companies/abc123?include=latestEarningsCall,latestEarningsCallAnalysis"

Get company by external identifier

GET /v1/companies/by-input/{companyInputId}

Look up a company using a domain, URL, LinkedIn URL, Crunchbase URL, or company ID.

Path parameters:

Query parameters: Same as Get company above.

Example request:

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://api.salesmotion.io/v1/companies/by-input/salesforce.com"

Contacts

List contacts

GET /v1/contacts

Retrieve a paginated list of contacts with filtering.

Query parameters:

Example request:

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://api.salesmotion.io/v1/contacts?accountId=12345&changeType=newJoiner"

Get contact

GET /v1/contacts/{contactId}

Retrieve a single contact by ID.

Path parameters:

Query parameters:

Signals

List signals

GET /v1/signals

Retrieve a paginated list of signals with filtering.

Query parameters:

Example request:

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://api.salesmotion.io/v1/signals?accountId=12345&type=earnings-call,funding-alert&afterDate=2026-01-01"

Get signal counts

GET /v1/signals/counts

Retrieve aggregated signal counts by type. Useful for dashboards and prioritization.

Query parameters:

Response fields: all, accounts, plus counts per signal type.

Get signal

GET /v1/signals/{signalId}

Retrieve a single signal by ID, including full content and sources.

Path parameters:

Query parameters:

Usage

Get usage

GET /v1/usage

Retrieve API usage and quota information for your organization.

Query parameters:

Response: Quota snapshot, totals (requests, successful, failed), and breakdown by endpoint.

Get usage limits

GET /v1/usage/limits

Retrieve your contracted daily and monthly API limits.

Feedback

Submit feedback

POST /v1/feedback

Submit feedback on API data quality or feature requests.

Request body (JSON):

Example request:

curl -X POST -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"message": "Missing earnings data for MSFT Q3", "category": "missing-data", "context": {"accountId": "12345"}}' \
  "https://api.salesmotion.io/v1/feedback"

Data schemas

Account fields

id · organizationId · companyId · ownerId · createdAt · updatedAt · name · domain · logoUrl · featuredImageUrl · description · industry · headquartersLocation · numberOfEmployees · type · priority · mainScore · mainScoreComponents · summary · insights · swotAnalysis · threeWhys · valuePyramid · valueProposition · valueHypothesis · pointOfView · linkedInUrl · crunchbaseUrl · zoomInfoUrl · salesforceUrl · salesNavigatorUrl · addedOn · lastRefreshAt · countryCode

Contact fields

id · organizationId · accountId · firstName · lastName · currentTitle · currentCompanyName · changeType · inCurrentRoleSince · lastChangeDetectedOn · mainScore · linkedInUrl · email · emailStatus · phone · location · previousTitle · previousCompanyName · profilePictureUrl · type · contactRole · personInsights · talkingPoints · positionWhenFormerUser · introPaths · matchingTargetKeywords · matchingTargetJobTitles · matchingTargetLocations · matchingTargetTechnologies

Signal fields

id · organizationId · accountId · type · subtype · headline · description · date · sources · matchingKeywords · relevance · fullContent · smartSummary · playUrls · slidesUrls · documentsUrls · clinicalTrialPrimaryCompletionDate · clinicalTrialStudyCompletionDate · clinicalTrialLastKnownStatus · clinicalTrialCollaborators · createdAt · updatedAt

Company fields

id · name · domain · websiteUrl · description · industry · headquartersLocation · numberOfEmployees · mainStockSymbol · crunchbaseUrl · linkedInUrl · zoomInfoUrl · fiscalYearInfo · insights

Frequently asked questions

What authentication method does the API use?

The API uses Bearer token (JWT) authentication. Include your token in the Authorization header of every request. Your account manager will provide your token when you activate API access.

What are the rate limits?

Standard rate limits apply to ensure fair usage. Use the /v1/usage and /v1/usage/limits endpoints to monitor your consumption. Contact your account manager if you need higher throughput.

Can I look up a company by domain instead of ID?

Yes. Use the GET /v1/companies/by-input/{companyInputId} endpoint with the company's domain (e.g. salesforce.com), LinkedIn URL, or Crunchbase URL.

How do I get signals for a specific account?

Use the GET /v1/signals endpoint with the accountId query parameter. You can also filter by signal type and date range.

Is there a sandbox or test environment?

Contact your account manager to discuss testing options. We recommend starting with read-only requests against a small set of accounts to validate your integration before scaling.