{
  "info": {
    "_postman_id": "d8a98192-e77b-42c6-9dc5-c4a926cb7a44",
    "name": "FilingSift REST API v1",
    "description": "Public and scoped API-key examples. The api_key variable is intentionally blank. Personal saved research uses Secure HttpOnly browser sessions in the signed-in UI, not Bearer session tokens. Preserve source, evidence, accession, and verification fields; never coerce missing values to zero.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    {
      "key": "base_url",
      "value": "https://api.filingsift.com/api/v1",
      "type": "string"
    },
    {
      "key": "api_key",
      "value": "",
      "type": "secret"
    },
    {
      "key": "ticker",
      "value": "AAPL",
      "type": "string"
    },
    {
      "key": "accession",
      "value": "0000320193-26-000020",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "Public",
      "item": [
        {
          "name": "Get company",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": "{{base_url}}/companies/{{ticker}}",
            "description": "Public compatibility route with filing provenance and explicit verification state."
          }
        },
        {
          "name": "List filing comparisons",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": "{{base_url}}/filing-comparisons?ticker={{ticker}}&limit=20",
            "description": "Follow meta.pagination.nextCursor exactly; do not construct cursors."
          }
        },
        {
          "name": "Read filing evidence",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": "{{base_url}}/reader/filings/{{accession}}",
            "description": "Bounded source-backed passages, material exhibits, stable deep links, and related filing graph."
          }
        },
        {
          "name": "Download source-linked evidence PDF",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/pdf"
              }
            ],
            "url": "{{base_url}}/reader/filings/{{accession}}/report.pdf",
            "description": "Use Send and Download to save the bounded PDF with clickable SEC sources."
          }
        },
        {
          "name": "Search filing and exhibit text",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"query\": \"\\\"credit agreement\\\" OR revolver\",\n  \"useSynonyms\": true,\n  \"filters\": {\n    \"tickers\": [\n      \"AAPL\"\n    ]\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": "{{base_url}}/search",
            "description": "Boolean, phrase, proximity, wildcard, and financing-aware synonym search with exact evidence snippets."
          }
        },
        {
          "name": "Screen financing evidence",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"screen\": \"lifecycle\",\n  \"filters\": {\n    \"tickers\": [\n      \"AAPL\"\n    ]\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": "{{base_url}}/screens/financing",
            "description": "Evidence-backed lifecycle, maturity, liquidity, availability, covenant, and default screens across primary filings and material exhibits."
          }
        },
        {
          "name": "Compare financing matrix",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"tickers\": [\n    \"AAPL\"\n  ],\n  \"metrics\": [\n    \"total_debt\",\n    \"nearest_maturity_amount\",\n    \"lifecycle_event\",\n    \"covenant_event\",\n    \"default_event\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": "{{base_url}}/screens/comparison-matrix",
            "description": "Up to 20 issuers and 10 evidence-backed metrics."
          }
        }
      ]
    },
    {
      "name": "Authenticated account",
      "auth": {
        "type": "bearer",
        "bearer": [
          {
            "key": "token",
            "value": "{{api_key}}",
            "type": "string"
          }
        ]
      },
      "item": [
        {
          "name": "Get coverage and onboarding status",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": "{{base_url}}/coverage"
          }
        },
        {
          "name": "Add ticker and request bounded onboarding",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ticker\": \"{{ticker}}\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": "{{base_url}}/account/companies"
          }
        },
        {
          "name": "Retry bounded onboarding",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": "{{base_url}}/account/companies/{{ticker}}/onboarding"
          }
        },
        {
          "name": "Export events CSV",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "text/csv"
              }
            ],
            "url": "{{base_url}}/events.csv?ticker={{ticker}}",
            "description": "Use Send and Download in Postman to save the CSV."
          }
        },
        {
          "name": "Get Monitoring v2",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": "{{base_url}}/account/monitoring"
          }
        },
        {
          "name": "Save Monitoring v2 preferences",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"enabled\": true,\n  \"newFilingAlerts\": true,\n  \"financingChangeAlerts\": true,\n  \"delayedIngestionAlerts\": true,\n  \"deliveryMode\": \"instant\",\n  \"tickers\": [\n    \"AAPL\"\n  ],\n  \"forms\": [\n    \"10-K\",\n    \"10-K/A\",\n    \"10-Q\",\n    \"10-Q/A\",\n    \"8-K\",\n    \"8-K/A\"\n  ],\n  \"eventCategories\": [\n    \"debt\",\n    \"liquidity\",\n    \"covenant\",\n    \"going_concern\"\n  ],\n  \"quietStartUtc\": 22,\n  \"quietEndUtc\": 6,\n  \"dailyDeliveryHourUtc\": 13,\n  \"weeklyDeliveryWeekday\": 1,\n  \"advancedAlertsEnabled\": true\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": "{{base_url}}/account/monitoring/preferences",
            "description": "Changes organization Monitoring preferences. Requires monitoring:write. This example explicitly opts into advanced disclosure alerts so the selected covenant category is eligible; category selection alone is insufficient. Review all settings before sending. Indexed evidence, account access, quiet hours and delivery retries still apply."
          }
        },
        {
          "name": "Send Monitoring v2 test alert",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": "{{base_url}}/account/monitoring/test"
          }
        },
        {
          "name": "List alert delivery history",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": "{{base_url}}/account/monitoring/deliveries?limit=50"
          }
        },
        {
          "name": "Build analyst financing tables",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"tickers\": [\n    \"{{ticker}}\"\n  ],\n  \"periods\": 8,\n  \"metrics\": [\n    \"total_debt\",\n    \"cash\",\n    \"revolver_capacity\",\n    \"revolver_drawn\",\n    \"letters_of_credit\",\n    \"revolver_availability\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": "{{base_url}}/analyst/tables/financing",
            "description": "Bounded multi-period debt, liquidity, maturity, lifecycle, covenant, default, and comparable-table JSON with exact filing evidence."
          }
        },
        {
          "name": "Download source-linked analyst XLSX",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"tickers\": [\n    \"{{ticker}}\"\n  ],\n  \"periods\": 8,\n  \"metrics\": [\n    \"total_debt\",\n    \"cash\",\n    \"revolver_capacity\",\n    \"revolver_drawn\",\n    \"letters_of_credit\",\n    \"revolver_availability\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": "{{base_url}}/analyst/exports/xlsx",
            "description": "Use Send and Download. Verify X-Export-Sha256 and retain X-Manifest-Sha256 with the workbook."
          }
        },
        {
          "name": "Get analyst export manifest",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"tickers\": [\n    \"{{ticker}}\"\n  ],\n  \"periods\": 8,\n  \"metrics\": [\n    \"total_debt\",\n    \"cash\",\n    \"revolver_capacity\",\n    \"revolver_drawn\",\n    \"letters_of_credit\",\n    \"revolver_availability\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": "{{base_url}}/analyst/exports/xlsx/manifest",
            "description": "Reproduces the request, dataset, comparable-table, and workbook SHA-256 checksums."
          }
        }
      ]
    },
    {
      "name": "Get financing intelligence",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{api_key}}",
            "type": "text",
            "disabled": true
          }
        ],
        "url": "{{base_url}}/intelligence/issuers/AAPL/financing",
        "description": "Bounded source-linked instrument, facility, covenant, event, maturity, timeline, and quality ledger."
      }
    },
    {
      "name": "Get debt lifecycle and maturities",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{api_key}}",
            "type": "text",
            "disabled": true
          }
        ],
        "url": "{{base_url}}/intelligence/issuers/AAPL/debt-lifecycle",
        "description": "Exact-identity lifecycle matching, explicit unresolved events, instrument maturity changes, and source-compatible schedule roll-forwards."
      }
    },
    {
      "name": "Get covenant tracker",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{api_key}}",
            "type": "text",
            "disabled": true
          }
        ],
        "url": "{{base_url}}/intelligence/issuers/AAPL/covenant-tracker",
        "description": "Evidence-backed covenant thresholds, observed values, test schedules, explicitly calculable headroom, threshold history, amendments, and unresolved identities without a compliance conclusion."
      }
    },
    {
      "name": "Get default and remediation timeline",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{api_key}}",
            "type": "text",
            "disabled": true
          }
        ],
        "url": "{{base_url}}/intelligence/issuers/AAPL/default-remediation",
        "description": "Explicit-occurrence defaults and breaches, same-evidence remediation links, unresolved mentions, and going-concern detection changes without legal, compliance, severity, or investment conclusions."
      }
    },
    {
      "name": "Get instrument terms comparison",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{api_key}}",
            "type": "text",
            "disabled": true
          }
        ],
        "url": "{{base_url}}/intelligence/issuers/AAPL/instrument-terms",
        "description": "Exact-identity rates, benchmarks, floors, spreads, collateral, guarantors, security packages, compatible deltas, and changed agreement passages with both SEC sources and no legal or investment conclusion."
      }
    },
    {
      "name": "Get financing timeline",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{api_key}}",
            "type": "text",
            "disabled": true
          }
        ],
        "url": "{{base_url}}/intelligence/issuers/AAPL/timeline"
      }
    },
    {
      "name": "Get financing quality candidates",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{api_key}}",
            "type": "text",
            "disabled": true
          }
        ],
        "url": "{{base_url}}/intelligence/issuers/AAPL/quality"
      }
    }
  ]
}