Skip to main content

Authentication

All eCore API requests require a Core API Token passed in the Authorization header.

Header Format​

Authorization: Token YOUR_API_TOKEN

Base URL​

https://app.ecoreservice.com/backend/api/v1/

Endpoints documented in this reference are appended to this base. For example, GET /external/search/ resolves to https://app.ecoreservice.com/backend/api/v1/external/search/.

Getting Your API Token​

Get your API token from the eCore dashboard under Settings → API Tokens.

Keep your token secret — anyone with the token can make requests against your account and spend your wallet credits.

Example Request​

curl -X GET \
  "https://app.ecoreservice.com/backend/api/v1/external/search/?industry=Technology&limit=5" \
  -H "Authorization: Token YOUR_API_TOKEN"

Error Response — Invalid or Missing Token​

{
  "detail": "Invalid token."
}

HTTP 401 Unauthorized. See Error Codes for the full list.

Note on Account and Contact Enrichment​

The Account and Contact Enrichment endpoints (Submit / Status / Results / Control) use a Bearer token instead of a Token token:

Authorization: Bearer YOUR_API_TOKEN

Each endpoint page calls out its own auth header — check the page you're using.