API Dashboard Overview

Dropbox Sign's API Dashboard collects information from API calls sent by your account (including test_mode) and pulls it into dynamic charts and discovery tools. The API Dashboard gives customers deeper insight into their API activity and signature requests—empowering you to do things like:

Monitor the overall health of your integration.
Troubleshoot and solve issues directly.
Analyze signature request activity.
Build a better integration using insights from the API Dashboard.

API Dashboard Location

The link to the API Dashboard lives at the top of your API settings page.

Here's how to navigate there:

Steps	Screenshot
Log into Dropbox Sign. Click API in the sidebar. On the API Settings page, click View API Dashboard. Enjoy exploring your API data!

Using the API Dashboard

This section contains information, examples, and tips on using the API Dashboard to discover valuable knowledge about your integration with the Dropbox Sign API.

General Usage Tips

Here's a short of helpful tips to get you started:

Topic	Notes
Live data vs Test data	The API Dashboard shows two types of data: - Live - data generated by API calls. - Test - data generated by API calls using `test_mode`.
Interacting with everything	The API Dashboard is highly interactive and contains many elements that can dynamically filter data, update graphs, and reveal new information. Feel empowered to jump in and start twisting knobs and changing settings to see what you can discover! You can't damage any data and refreshing the page will reset any filters. Enjoy!
Customizing charts with filters	You can customize the charts using their drop-down menus. For example: - Modify the date range to 24 hours, 7 days, 30 days, or custom. - Click an item on the legend to toggle it on or off. - Select the specific endpoint(s) you want to see data for.
Navigating using links in charts	Clicking links inside charts can fast track your discovery of new, valuable insights and revolutionize how you troubleshoot your integration .

Monitoring Integration Health

The tools in the API Dashboard can help you monitor and maintain the health of your integration. The API requests chart on the Insights will be one of your most powerful tools to discover insights about health. You'll see it in many of the examples in this guide.

Identify health issues by monitoring trends in errors

Failed API calls can create reliability issues in your application that lead to a bad experience for your users. They're strong signals about the overall health of your integration.

Read the example below to see how a user navigates this tool and what the charts reveal along the way.

Notes	Screenshot
The API request chart will often serve as source of discovery and primary point of entry for deeper troubleshooting work.
Change the time frame. → Click Last 7 days. → Select Last 30 days from drop-down. Examine the chart. → Notice the spike in failed API requests? Note: you can also choose from 24 hours, 7 days, or a custom date range.
Group data by endpoint. → Click API error distribution. → Select Endpoint from the drop-down. Examine the new chart. → Notice the high failure rate for Get Signature Request? Note: You can also select your own endpoints for custom grouping.
Group data by status code. → Click Endpoint. → Select HTTP Status from drop-down. Examine the new chart. → Notice the high failure rate for `Rate limit - 429` and `Bad request - 400`. Note: you can toggle endpoints on and off by clicking them in the legend.

In the example above, the API requests chart gave us the following insights into the health of our integration:

There was a spike in failed API requests around April 7th.
The Get signature request endpoint had the most failed requests.
The error is likely a rate limit or malformed request.

Now we've identified the problem and have a head start for debugging it.

Discover service disruptions to our API

Any changes to the health of the Dropbox Sign API (such as an outage, degradation of service, or planned maintenance) are immediately added to a banner at the top of the API Dashboard.

The table below demonstrates where to find and track incident information if there was a service issue.

Notes	Screenshot
Discover impacted service from the banner at the top of the page. → Click View incident history for more information.
The incident report page contains: → information about the services impacted. → an incident report and chronological updates.

Troubleshooting and Debugging

The API Dashboard offers a range of tools for interacting with your data—empowering you to troubleshoot and debug issues with your integration directly. Our API Support team is still available when you need it, but engaging them after you've done some of your own debugging means you can you can include identifiers, links, or information that can lead to a resolution more quickly.

Use all your tools There are multiple paths to discovery when you're troubleshooting. Remember to use the full set of tools available to you.

API requests chart
Search
Filters
Clicking through connected data

Improve integration health using insights from failed API calls

Did you know you can click through chart results on the Insights page? That approach is one of the best ways to start troubleshooting health issues you see in charts (especially for failed api calls). The links direct you to the list of data populating the graph with filters already applied.

Let's step through an example of how you might approach troubleshooting a health issues.

Notes	Screenshot
While using the API Dashboard you notice a spike in failed API calls and decide to investigate. → On the API requests graph, hover over a specific day to reveal a pop up with more information. → Click Failed to be redirected to the API requests page.
The API requests page will list all failed API calls pre-filtered by: → Date (from previous step). → HTTP Status.
Click on a single entry to learn more about that specific call.
Review details associated with that call. → Take note of the error in the Response body. → Cross-reference with the POST Parameters sent in the request.

Understanding Signature Request Activity

Having a clear understanding of your signature request activity is an essential part of maintaining a healthy integration. The API Dashboard can give you visibility into things like:

Quota consumption
Signature request health
Historical trends in signature request usage

Exploring data around signature request usage (and signature requests themselves) is a great way to discover optimizations that lead to more completed signature requests. Think about it like troubleshooting a health issues in the signing experience you offer your users.

Track account subscription and quota consumption

The quota usage section of the API Dashboard gives you direct insight into your most important usage information for your current billing period. Here's what you'll find there:

Number of signature requests and templates remaining.
Usage data for any add ons you have (SMS delivery, Qualified Electronic Signature, etc).
Subscription information like quota refresh date, next billing date, and subscription tier.

Billing usage section of the API Dashboard

Learn from trends in signature request usage

Exploring patterns around signature request usage can reveal valuable insights about your customers, your integration, and help you make proactive decisions around your subscription. Here are examples of the type of insights you might discover:

Seasonal or recurring bursts of signer activity.
- Upgrade your API plan to meet demand before your busy season.
- Proactively make a plan for hitting rate limits.
Historical signature request usage
- Identify a shift in your marketing strategy.
- Explore how a market condition impacted your signature request usage during a specific time frame
Identify Customers with a high rate of growth
- If you have a model where your customers each have their own api app, then looking at signature request usage by client_id might give you signal on who needs your attention.
Recurring patterns
- "Our signature requests peak every quarter. Let's hire a temp every 3 months."

Appendix

Limitations on data in the API Dashboard

API dashboard Tool	Data limitation
Search	90 days of data
App Callbacks Page Account Callbacks Page API Requests Page	90 days of data
Insights Page → API requests chart (all data groupings) → Signature request status chart	90 days of data
Insights Page → Signature request usage chart	12 months of data
Insights Page → Quota usage chart	Current billing cycle
Signature request status page Signature request usage page CSV download page	5 years of data

Frequently Asked Questions

Why is my dashboard empty?

Your haven't generated enough data on your account yet. You need to reach a minimum threshold before the API Dashboard can populate with data. Go send some test_mode calls!

What API plans can use the dashboard?

The API dashboard is available for all API accounts, both paid and free.

What information can I use in the search?

You can't search for:

Text inside a document
Data outside a 90 day window
(see data limitations)

You can search for:

Document
Event Hash ID
Signature request Id
Request type

How often does the service alert banner get updated? Is it automatic?

The banner at the top of the page will update every 5 minutes. After the incident is resolved, the banner is displayed for a minimum of 24 hours.