Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Filings Tools Account API
version: 1.0.0
contact:
name: Dark Vector Cognition
email: hello@darkvectorcognition.ai
url: https://filings.tools/docs
termsOfService: https://filings.tools/terms
description: 'Operations tagged Account across 2 of this provider''s published API definitions: filings-tools-openapi.json, filings-tools-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://filings.tools
description: Production
security:
- {}
- ApiKeyAuth: []
- BearerAuth: []
tags:
- name: Account
description: Read your own allowance. Uses none of it.
paths:
/api/v1/me:
get:
operationId: getStanding
summary: Read your own allowance
description: Returns whether you call anonymously or with a key, your daily ceiling, what is left and when it resets. Reading it uses none of your allowance.
tags:
- Account
responses:
'200':
description: Your standing.
content:
application/json:
schema:
$ref: '#/components/schemas/Standing'
example:
product: filings
caller: anon
limitKind: calls_day
unit: calls
limit: 25
remaining: 20
used: 5
reset: 1790000000
resetIso: '2026-10-09T00:00:00.000Z'
backend: upstash
persistent: true
unavailable: false
recover: https://filings.tools/billing/regenerate
pricing: https://filings.tools/pricing
free_key: https://filings.tools/billing/free
servers:
- url: https://filings.tools
description: Production
components:
schemas:
Standing:
type: object
description: A caller's own standing. Reading it uses none of the allowance.
required:
- product
- caller
- limitKind
- unit
- limit
- remaining
- used
- reset
- resetIso
- persistent
- unavailable
- recover
- pricing
properties:
product:
type: string
enum:
- pdfmd
- filings
caller:
type: string
enum:
- anon
- key
label:
type: string
description: The plan name for a key.
plan:
type: string
description: The plan lookup key for a key, for example pdfmd_pro_monthly.
limitKind:
type: string
enum:
- calls_day
- pages_day
- pages_month
unit:
type: string
enum:
- calls
- pages
limit:
type: integer
remaining:
type: integer
used:
type: integer
maxPagesPerFile:
type: integer
description: 'Free tiers of pdfmd: the longest file one request may convert.'
reset:
type: integer
description: Unix seconds.
resetIso:
type: string
format: date-time
backend:
type: string
enum:
- upstash
- memory
persistent:
type: boolean
description: True when the count is in shared storage. False means it is held per instance and a deploy resets it.
unavailable:
type: boolean
description: True when a key was sent and the store could not confirm it.
recover:
type: string
format: uri
pricing:
type: string
format: uri
free_key:
type: string
format: uri
description: Only for a caller without a key.
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: Your filings.tools key. Optional. Without it the request is anonymous. Metered routes reject an unknown or revoked key with 401. Remove the header to use the anonymous tier.
BearerAuth:
type: http
scheme: bearer
description: 'The same key, sent as `Authorization: Bearer YOUR_KEY`. Use one of the two headers, not both.'
externalDocs:
description: 'filings.tools: SEC filings API guide'
url: https://filings.tools/docs
x-refined-from:
- filings-tools-openapi.json
- filings-tools-openapi.json
x-provenance:
method: harvested
publisher: filings.tools
source: https://filings.tools/openapi.json
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)