DP.

Documentation

API URL

GET /api/v1/sec-filings

Headers
Code
Content-Type: application/json
Query Parameters

Example GET Request

Code
GET https://datpaq.com/api/v1/sec-filings/filings?api_key=your-api-key&ticker=AAPL&forms=10-K,10-Q,8-K&sort=desc&fromDate=2024-01-01&toDate=2024-12-31&limit=10&offset=0

Successful Response

Status
HTML
200 OK
Body
Code
{
  "success": true,
  "source": "sec-edgar",
  "cached": true,
  "company": {
    "cik": "0000320193",
    "ticker": "AAPL",
    "name": "Apple Inc."
  },
  "count": 1,
  "filings": [
    {
      "form": "10-K",
      "accessionNumber": "0000320193-24-000123",
      "filingDate": "2024-11-01",
      "filingUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928x10k.htm"
    }
  ],
  "metadata": {
    "correlationId": "1784849006651-mgh1kq42p",
    "timestamp": "2026-10-12T12:00:00.000Z",
    "processingTime": "18ms",
    "api_token_name": null,
    "rate_limit": {
      "limit": null,
      "remaining": null,
      "reset": null
    }
  }
}

Error Response

Example
Code
HTTP 400 ValidationError: Invalid query parameters or invalid date-range bounds — Request rejected by Joi schema or route-level date validation; HTTP 401 AuthenticationError: Missing or invalid API key — Gateway authentication middleware rejected the request; HTTP 404 NotFound: Ticker not found in SEC mapping or unknown route — Entity resolution failure or request path mismatch; HTTP 429 RateLimitError: Service limit or SEC upstream throttling — Rate limiter or upstream response returned HTTP 429; HTTP 502 UpstreamProviderError: SEC upstream request failed or returned invalid JSON — SEC fetch failure or response parse failure; HTTP 504 TimeoutError: SEC upstream request exceeded the 8-second timeout — Request aborted after the configured timeout

Last Updated:  May 4, 2026