API Documentation
FilingFlow API
SEC filings: 10-K, 10-Q, 8-K, Form D, 13F, and more
GlobalComply API
OFAC, EU, UK, Canada, DFAT, SECO sanctions lists
2. Getting Started
2.1 Registration
Create an account easily
Register with your email address. Upon successful registration, you will receive a confirmation email.
Verify their email
Click on the verification link in your email to activate your account.
Log in
After verification, log in to your dashboard.
Retrieve their API token
Your API token will be displayed on the dashboard and sent to your email.
View and manage their subscription plan
See your current plan details and usage limits.
Upgrade or downgrade plans
Change your subscription based on your needs.
Monitor real-time API usage
Track your API calls and data consumption.
View billing history
Access invoices and payment records.
Alternative Method — Register via API Endpoint
Request Body (application/json)
{
"username": "your_username",
"email": "your_email@example.com",
"password": "your_secure_password"
}
Sample Response
{
"message": "User registered. Please check your email to verify your account and get your API token."
}
2.2 Email Verification
- A verification link
- Their API token
Subject: Welcome to Datadock!
Hello,
Welcome to Datadock!
Here is your API token:
To verify your email address and activate your API token, click the link below:
https://api.datadock.ai/auth/verify?email=you@example.com
Thanks for joining us!
— The Datadock Team
Once the email is verified, the token becomes active and can be used immediately to access the APIs.
2.3 Authentication
All protected endpoints (e.g., /api/v1/filingflow, /api/v1/globalcomply) require the API token to be included in the request header.
Authorization Header
Authorization: Bearer your_api_token
cURL
GET /api/v1/filingflow?form_type=form_8k
Authorization: Bearer c49ca84bcc452f873********b280776d
If the token is missing or invalid, the API will return an authentication error.
2.4 Rate Limiting
| Endpoint Type | Limit |
|---|---|
| Default | 100 requests per hour |
| High-load endpoints | 5 requests per minute |
- Rate limits may vary depending on subscription plans and can be seen/tracked from your dashboard.
3. FilingFlow Query API – SEC Filings
The FilingFlow API enables querying metadata from U.S. Securities and Exchange Commission (SEC) filings across various form types. The data is pulled from the EDGAR index and made available for structured search and export.
Each filing is returned in JSON format, containing metadata such as company name, form type, filing and event dates, geographic info, reporting persons, and filing sources.
3.1 Use Cases
- Monitor institutional investors (e.g., BlackRock 13F-HR filings)
- Screen for startup/private placement activity via Form D
- Export filtered filings to JSON or Excel
3.2 Global Filterable Fields
- Form-specific tables by type (e.g., sec.13f_hr, sec.d)
- Support partial (contains) and case-insensitive matches
- Export results in .json, .json_download, or .excel
- Offset-based pagination for smooth UI/UX integration
5. Bulk Data Download API
Download large volumes of data from supported data sources (workstreams). Users can apply filters to refine results and choose their preferred download format.
5.2 Supported Workstreams
| Workstream | Description |
|---|---|
filingflow
|
SEC filings data such as Form D, 13F-HR, and 13F-NT |
globalcomply
|
Global sanctions and compliance lists from government and international agencies |
5.3 Authentication
Header Example
Authorization: "Bearer "
Content-Type: "application/json"
5.4 Request Parameters
| Field | Type | Required | Description |
|---|---|---|---|
workstream
|
string | Yes | Data source: realtystream, filingflow, or globalcomply |
filters
|
object | No | Filters to narrow down results (structure depends on workstream) |
format
|
string | No | Download format: "json" (default) or "excel" |
Request Body
{
"workstream": "globalcomply",
"filters": {
"country": "Belarus",
"sanction_type": "canada_sanctions"
},
"format": "json"
}
Request Body
{
"workstream": "globalcomply",
"filters": {
"country": "Belarus",
"sanction_type": "canada_sanctions"
},
"format": "excel"
}
5.5 Successful Responses
- Status Code: 200 OK
- Content-Type: application/json
- Header: Content-Disposition: attachment; filename=_data.json
Example Response
[
{
"country": "Belarus",
"last_name": "Atabekov",
"given_name": "Khazalbek Bakhtibekovich",
"aliases": null,
"schedule": "1, Part 1",
"item": "1",
"dob": "1800-01-01",
"entity": null,
"date_of_listing": "2020-09-28",
"sanctions_origin": "Canada"
}
]
- Status Code: 200 OK
- Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
- Header: Content-Disposition: attachment; filename=_data.xlsx
The response body contains an Excel file with the requested dataset.
| Status Code | Description | Example |
|---|---|---|
| 400 | Invalid or missing parameters |
{"error": "Invalid or missing workstream..."}
|
| 403 | Download quota exceeded |
{"error": "Quota exceeded", "message": "..."}
|
| 404 | No data found |
{"message": "No data found for the given filters"}
|
| 500 | Internal server error |
{"error": "Internal server error..."}
|
5.8 Quota Policy
-
Tip
To avoid interruptions, monitor your quota usage through your account dashboard or request smaller, filtered downloads.
- This endpoint supports bulk data exports for analytics, reporting, and compliance use cases
- Filtering helps reduce download size and improve response times
- Available formats: JSON (machine-readable) and Excel (.xlsx) (for spreadsheets)
- Large downloads may take several seconds to process depending on data volume
- All downloads are securely logged and tied to your API key for quota tracking
- Export recent SEC filings for specific issuers or form types
- Download the latest global sanctions list for compliance checks
6. Tips for Success
- Always test your queries with an API testing tool before integrating them into your application
- Start with simple requests and then use filters to narrow down results
- Revisit this guide for updates and new features
7. Error Handling
| 200 | Success — Request completed successfully |
| 400 | Bad Request — Invalid filter parameters or missing form type |
| 401 | Unauthorized — Invalid or missing API token |
| 404 | Not Found — No records match the given filters |
| 500 | Internal Server Error — Database connection failure or other server errors |
8. Contact & Support
Happy coding!