{
  "opencollection": "1.0.0",
  "info": {
    "name": "Factset Analytics Datastore About Segments API",
    "version": "1.0.0"
  },
  "request": {
    "auth": {
      "type": "basic",
      "username": "{{username}}",
      "password": "{{password}}"
    }
  },
  "items": [
    {
      "info": {
        "name": "Segments",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Factset Returns Company Segment Data.",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.factset.com/segments",
            "params": [
              {
                "name": "ids",
                "value": "",
                "type": "query",
                "description": "The requested list of security identifiers. Accepted ID types include Market Tickers, SEDOL, ISINs, CUSIPs, or FactSet Permanent Ids. Limit of 1,000 per non-batch request / 2,000 per batch request (GET) or 30,000 per batch request (POST)."
              },
              {
                "name": "metrics",
                "value": "",
                "type": "query",
                "description": "Segment data metric. SALES = Sales/Revenue, OPINC = Operating Income/Loss, ASSETS = Total Assets, DEP = Depreciation Expense, CAPEX = Capital Expenditures."
              },
              {
                "name": "segmentType",
                "value": "",
                "type": "query",
                "description": "Segment type for the metrics. BUS = Business segments, GEO = Geographic segments."
              },
              {
                "name": "periodicity",
                "value": "",
                "type": "query",
                "description": "Periodicity for segment data. ANN = Annual Original, ANN_R = Annual Latest (includes restatements)."
              },
              {
                "name": "fiscalPeriodStart",
                "value": "",
                "type": "query",
                "description": "The fiscal period start expressed as YYYY-MM-DD. Calendar date that will fall back to the most recent completed period during resolution."
              },
              {
                "name": "fiscalPeriodEnd",
                "value": "",
                "type": "query",
                "description": "The fiscal period end expressed as YYYY-MM-DD. Calendar date that will fall back to the most recently completed period during resolution."
              },
              {
                "name": "batch",
                "value": "",
                "type": "query",
                "description": "Enables asynchronous batch processing, supporting long-running requests up to 20 minutes. Upon requesting batch=Y, the service will respond with HTTP 202. Use batch-status to check completion and batch-result to retrieve results."
              }
            ]
          },
          "docs": "Retrieves business and geographic segment data for individual companies. Segment metrics include SALES, OPINC (operating income), ASSETS, DEP (depreciation), and CAPEX (capital expenditures).\n\nThe `/segments` endpoint supports Long Running asynchronous requests up to **20 minutes** via batch parameter. Id limits are increased to 2,000 ids per request when using batch capability."
        },
        {
          "info": {
            "name": "Factset Returns Company Segment Data for a List of Identifiers.",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.factset.com/segments",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Retrieves segment data via POST for large identifier sets. Supports up to 30,000 ids per batch request."
        }
      ]
    }
  ],
  "bundled": true
}