{
  "openapi": "3.1.0",
  "info": {
    "title": "Quarterly API",
    "version": "1.0.0",
    "summary": "Earnings dates, times and fiscal calendars for about 150 public tech, AI, chip and cloud companies, from SEC EDGAR, company announcements and Nasdaq",
    "description": "Earnings dates, times and fiscal calendars for about 150 public tech, AI, chip and cloud companies, from SEC EDGAR, company announcements and Nasdaq. Refreshed every morning at 05:30 UTC. Free to read; please cite \"Quarterly (quarterly.fru.dev)\" with a link. Responses are cached at the edge; keep to about 60 requests a minute. Guide: https://quarterly.fru.dev/agents",
    "contact": {
      "name": "fru.dev",
      "url": "https://fru.dev",
      "email": "fru.dev3@gmail.com"
    }
  },
  "externalDocs": {
    "description": "For AI agents",
    "url": "https://quarterly.fru.dev/agents"
  },
  "servers": [
    {
      "url": "https://quarterly.fru.dev"
    }
  ],
  "paths": {
    "/api/earnings": {
      "get": {
        "operationId": "earnings_between",
        "summary": "Earnings dates between two days, in date order",
        "description": "Earnings dates between two days, in date order. Returns dates with company, ticker, fiscal quarter, time (bmo, amc) and status.",
        "parameters": [
          {
            "name": "from",
            "in": "query",
            "required": false,
            "description": "First day, YYYY-MM-DD (default today)",
            "schema": {
              "type": "string"
            },
            "example": "2026-10-01"
          },
          {
            "name": "to",
            "in": "query",
            "required": false,
            "description": "Last day, YYYY-MM-DD (default today + 14)",
            "schema": {
              "type": "string"
            },
            "example": "2026-10-31"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Items per page, 1 to 200",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 200
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Items to skip, for the next page",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "dates with company, ticker, fiscal quarter, time (bmo, amc) and status",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "from": "2026-10-20",
                  "to": "2026-10-31",
                  "earnings": [
                    {
                      "id": 4165,
                      "companyId": "netflix",
                      "date": "2026-10-20",
                      "time": "amc",
                      "status": "estimated",
                      "periodKey": "2026-09",
                      "periodEnd": "",
                      "fiscalYear": 2026,
                      "fiscalQuarter": 3,
                      "source": "nasdaq",
                      "sourceUrl": "https://www.nasdaq.com/market-activity/earnings?date=2026-10-20",
                      "unverified": false,
                      "note": "Expected date on the Nasdaq earnings calendar (data from Zacks). Not yet announced by the company.",
                      "ticker": "NFLX"
                    },
                    {
                      "id": 4167,
                      "companyId": "manhattan-associates",
                      "date": "2026-10-20",
                      "time": "unknown",
                      "status": "estimated",
                      "periodKey": "2026-09",
                      "periodEnd": "",
                      "fiscalYear": 2026,
                      "fiscalQuarter": 3,
                      "source": "nasdaq",
                      "sourceUrl": "https://www.nasdaq.com/market-activity/earnings?date=2026-10-20",
                      "unverified": false,
                      "note": "Expected date on the Nasdaq earnings calendar (data from Zacks). Not yet announced by the company.",
                      "ticker": "MANH"
                    }
                  ],
                  "total": 34,
                  "limit": 5,
                  "offset": 0,
                  "next": "/api/earnings?from=2026-10-20&to=2026-10-31&limit=5&offset=5",
                  "note": "Not investment advice."
                }
              }
            }
          }
        }
      }
    },
    "/api/companies": {
      "get": {
        "operationId": "list_companies",
        "summary": "Every tracked company",
        "description": "Every tracked company. Returns companies with ticker, sector, fiscal year end month, investor relations and SEC links.",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Items per page, 1 to 200",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 200
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Items to skip, for the next page",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "companies with ticker, sector, fiscal year end month, investor relations and SEC links",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "companies": [
                    {
                      "id": "accenture",
                      "ticker": "ACN",
                      "name": "Accenture",
                      "legalName": "Accenture plc",
                      "cik": 1467373,
                      "exchange": "NYSE",
                      "sector": "hardware",
                      "domain": "accenture.com",
                      "irUrl": "https://investor.accenture.com",
                      "fiscalYearEnd": "0831",
                      "fyEndMonth": 8,
                      "calendarKind": "monthly",
                      "calendarNote": "Fiscal year ending on the last day of August",
                      "filer": "domestic"
                    },
                    {
                      "id": "adobe",
                      "ticker": "ADBE",
                      "name": "Adobe",
                      "legalName": "ADOBE INC.",
                      "cik": 796343,
                      "exchange": "Nasdaq",
                      "sector": "software",
                      "domain": "adobe.com",
                      "irUrl": "https://www.adobe.com/investor-relations.html",
                      "fiscalYearEnd": "1127",
                      "fyEndMonth": 11,
                      "calendarKind": "weeks",
                      "calendarNote": "52/53-week fiscal year ending on the Friday nearest the end of November",
                      "filer": "domestic"
                    }
                  ],
                  "total": 159,
                  "limit": 5,
                  "offset": 0,
                  "next": "/api/companies?limit=5&offset=5"
                }
              }
            }
          }
        }
      }
    },
    "/api/search": {
      "get": {
        "operationId": "search",
        "summary": "Search companies, upcoming earnings and pages",
        "description": "Search companies, upcoming earnings and pages. Returns up to 20 ranked results with title, link and one line.",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Company name, ticker or words",
            "schema": {
              "type": "string"
            },
            "example": "nvda"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Results, 1 to 20",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 20,
              "default": 20
            }
          }
        ],
        "responses": {
          "200": {
            "description": "up to 20 ranked results with title, link and one line",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "q": "nvda",
                  "results": [
                    {
                      "id": "co:nvidia",
                      "group": "companies",
                      "title": "Nvidia",
                      "subtitle": "NVDA · Chips · Next Nov 18, 2026",
                      "href": "/companies/nvidia",
                      "keywords": [
                        "NVDA",
                        "NVIDIA CORP"
                      ],
                      "logo": "https://img.logo.dev/nvidia.com?token=...&size=64&format=png&theme=light&retina=true&fallback=404",
                      "score": 1000
                    }
                  ]
                }
              }
            }
          }
        }
      }
    }
  }
}