Troubleshooting

If you're experiencing issues with your Intrinio account, API, SDK, or data access, this guide covers the most common problems and how to resolve them. Most issues can be fixed in just a few minutes.

API Authentication Issues

"401 Unauthorized"

A 401 Unauthorized response almost always means your request was not authenticated correctly.

Verify your API Key

Confirm you're using your active Intrinio API key.
Make sure there are no extra spaces before or after the key.
If using Basic Authentication, ensure the API key is sent in the username field with a blank password (depending on your client library).

Confirm Your Subscription

Your account may not have access to the endpoint or dataset you're requesting.

To verify your access:

Log into your Intrinio account.
Navigate to Account → Subscription or Account → Access.
Review the data feeds included with your subscription.

Using the MCP Server?

The Intrinio MCP Server does not authenticate with your API key.

Instead, it uses OAuth 2.0 authentication.

Do not send your API key as:

Authorization: Bearer YOUR_API_KEY

This will return a 401 Unauthorized error.

Instead:

Complete the OAuth authentication flow.
Obtain an OAuth access token.
Connect using:

Authorization: Bearer YOUR_OAUTH_ACCESS_TOKEN

If you're using one of the official MCP SDKs (Python, JavaScript, etc.), use the SDK's built-in OAuth support rather than creating your own HTTP or SSE connection.

"403 Forbidden"

A 403 response typically means your account is authenticated but does not have permission to access the requested data.

Possible reasons include:

Your subscription doesn't include that dataset.
You're attempting to access Enterprise-only data.
Your trial doesn't include the requested historical depth.
Your account has reached a licensing restriction.

If you're unsure whether your subscription includes a dataset, review your available data feeds from your account dashboard.

"404 Not Found"

This usually means one of the following:

The endpoint URL is incorrect.
The ticker or identifier doesn't exist.
The requested resource has been removed.
The identifier format is invalid.

Double-check:

Endpoint spelling
API version
Ticker symbols
Company identifiers
Dates

Rate Limit Errors (429)

If you receive HTTP 429 responses:

Reduce request frequency.
Add retry logic with exponential backoff.
Cache responses when appropriate.
Batch requests whenever possible.

If your application consistently exceeds your available request limits, consider upgrading your subscription.

Missing Data

If expected data is missing:

Verify the Dataset

Not every endpoint is included with every subscription.

The fastest way to determine which endpoints are available for your account is:

Log into your Intrinio account.
Navigate to Account → Subscription or Account → Access.
Select a data feed.
Click View API Documentation.

The documentation automatically filters to endpoints available for that specific data feed. You can also toggle between:

My Endpoints – endpoints available with your subscription
All Endpoints – every endpoint offered by Intrinio

This is the fastest way to determine whether the data you're looking for is included with your account.

Check Date Availability

Some datasets begin on different historical dates.

Verify that your requested date falls within the available history for that dataset.

Trial Limitations

During the free trial:

Bulk downloads contain approximately six months of data.
After converting to a paid subscription, the full historical bulk files become available.

WebSocket Connection Problems

If your WebSocket connection fails:

Verify your authentication credentials.
Confirm your subscription includes the requested real-time feed.
Ensure your firewall allows outbound WebSocket connections.
Reconnect after temporary network interruptions.

SDK Issues

If you're using an official SDK:

Upgrade to the latest SDK version.
Confirm you're using the latest API documentation.
Verify your API credentials.
Ensure your environment supports the SDK version you're using.

Finding the Right Endpoint

If you're unsure which endpoint to use:

Option 1: Account Documentation

From your Intrinio account:

Open Subscription or Access
Select a data feed
Click View API Documentation

The documentation automatically filters to the endpoints available for your subscription.

Option 2: Use the Intrinio MCP Server

The Intrinio MCP Server understands your account's data entitlements and can recommend:

Appropriate datasets
Available endpoints
Implementation guidance
Data feed recommendations

based on your natural language requests and current subscription.

Subscription Questions

To verify what your account includes:

Log into your Intrinio account.
Open Subscription or Access.
Review your included data feeds.
Select any feed to see the associated API documentation.

Trial Questions

New self-service accounts receive:

A 14-day free trial
Immediate API access
Access to included trial datasets

Unless canceled before the trial ends, the subscription automatically converts to a paid subscription after the 14-day trial period.

Canceling Your Subscription

You can cancel your subscription at any time from your account:

Log into Intrinio.
Go to Billing & Invoices.
Scroll to the bottom of the page.
Click Cancel Subscription.

Individual subscriptions remain active until the end of the current monthly billing period.

Startup subscriptions remain active through the end of the contract term shown on the Subscription page.

Still Need Help?

If you've worked through the steps above and are still experiencing issues:

Review the API documentation for your subscribed datasets.
Verify your account's included data feeds.
If you believe you're encountering a platform issue, contact Intrinio Support with:
- The endpoint you're calling
- The full error message
- HTTP status code
- Timestamp of the request
- Sample request (with your API key removed)

Providing this information will help the support team diagnose your issue as quickly as possible.