> ## Documentation Index
> Fetch the complete documentation index at: https://doc.astreus.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Conflict detail

> One published conflict with parties, their periods, reported outcomes and source evidence. Draft review actions are not exposed by this operation.



## OpenAPI

````yaml https://astreus.ai/openapi.json get /api/v1/military/conflicts/{key}
openapi: 3.1.0
info:
  title: Astreus API
  version: '2026-11-11'
  description: >-
    Astreus is a financial data terminal that turns the world's unstructured
    financial disclosure into structured, traceable data. It reads what
    companies, exchanges and central banks publish — annual and interim reports,
    SEC filings, results announcements, investor presentations, earnings calls,
    8-Ks, regulator notices and policy text — across the United States, the Gulf
    (Tadawul, DFM, ADX, Boursa Kuwait, QSE), Japan, Taiwan, Korea, the UK and
    Europe, and serves it as data a program can trust: standardized financial
    statements (annual, quarterly, semiannual), segments and KPIs, the tables
    inside the notes, filing sections as text, investor decks page by page,
    earnings-call transcripts and audio, span-anchored observations, management
    guidance scored against outcomes, typed 8-K events, an attributed intraday
    news tape, insider and 13F ownership, a people registry, macro series (the
    current vintage: the latest published value for each period) and
    central-bank text, benchmark, commodity and compute-price series, and a
    source-linked claim graph with declared validation limits. Use `fact-source`
    and document metadata to retain available provenance. Publication and
    entitlement gates apply per dataset; inspect availability and tool
    limitations.


    Coverage is published live: `GET /api/v1/landing/coverage` (no key) returns
    every market served with company counts, history depth, completeness and
    periods held per data type — ask it before answering "what do you cover?".
    `{id}` is a ticker, a numeric SEC CIK, or a platform key for a non-SEC
    issuer (XSAU000001) — the `cik` field of the company payload. Human-readable
    guides: https://doc.astreus.ai (coverage at /coverage, data catalog at
    /data-catalog).


    Tiers: `public` endpoints need no credentials. Everything else takes an
    **API key** — create one on the Developers page in the terminal
    (https://astreus.ai/developers) and send it as `X-API-KEY: pk_live_...` (or
    `Authorization: Bearer pk_live_...`). Signed-in terminal sessions may use
    their Cognito ID token instead.


    Rate limits and quotas are per plan (fixed UTC windows): Free — 30 req/min,
    250 req/day; Build — 300 req/min, 100,000 req/month; Scale — custom. Build,
    Scale and prepaid credits are set up with sales
    (https://astreus.ai/contact), not self-serve. Responses carry RateLimit-*,
    X-Quota-* and, when credits pay, X-Billing-Source/X-Credits-Remaining-USD
    headers; a 429 carries `Retry-After` and a machine `code` of rate_limited or
    quota_exceeded (with sales_email).


    Server-side use: `/api/v1` sends no CORS headers, so a browser page on
    another origin cannot call it. Call it from a server, a script or an agent,
    and keep the key there.


    Versioning: `info.version` is the UTC date the contract last changed, and
    every response carries it in `x-astreus-api-version`. Within `/api/v1`
    changes are additive; a field or parameter that will go is marked
    `deprecated` first and kept for at least 90 days. Policy:
    https://doc.astreus.ai/versioning.


    Not investment advice. See /terms.
  contact:
    email: saif@astreus.ai
  termsOfService: https://astreus.ai/terms
  license:
    name: 'Proprietary: Astreus terms of service'
    url: https://astreus.ai/terms
servers:
  - url: https://astreus.ai
security: []
tags:
  - name: Search & Meta
    description: Entity resolution and platform metadata.
  - name: Company Data
    description: Profiles, structure, leadership, calendars.
  - name: Geo & Assets
    description: >-
      Physical assets on the map — what a company owns, operates or develops,
      where, since when, at what location precision, and the source behind each
      fact.
  - name: Financial Statements
    description: >-
      Standardized XBRL-derived statements — every line traceable to its filing
      via fact provenance.
  - name: SEC Filings
    description: >-
      The filing index and documents (SEC and exchange-published), parsed
      section text, and the tables inside the notes as gated grids and series.
  - name: 8-K Events
    description: >-
      Material events: 8-K items and exchange disclosures by item code,
      filterable by family, with extracted item text.
  - name: News
    description: >-
      The intraday news tape: filings, releases and licensed wires with source
      attribution, storylines and topics.
  - name: Transcripts & Calls
    description: Earnings-call transcripts, span-anchored observations, IR decks.
  - name: Guidance & Scorecards
    description: What management promised vs. what happened.
  - name: Ownership & Insiders
    description: 13F holders, Forms 3/4/5, the people registry.
  - name: Macro
    description: >-
      Economic series (the current vintage: the latest published value for each
      period) and central-bank text.
  - name: Market Data
    description: Daily bars for stocks, benchmarks, commodities and compute.
  - name: Intelligence
    description: Narratives and source-linked claims with declared validation status.
  - name: Analytics
    description: Charting over any catalog series.
paths:
  /api/v1/military/conflicts/{key}:
    get:
      tags:
        - Macro
      summary: Conflict detail
      description: >-
        One published conflict with parties, their periods, reported outcomes
        and source evidence. Draft review actions are not exposed by this
        operation.
      operationId: get-conflict-detail
      parameters:
        - name: key
          in: path
          required: true
          description: >-
            Conflict key returned by search or the conflict index, e.g.
            ucdp:14609.
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  conflict:
                    type: object
                    properties:
                      key:
                        type: string
                      name:
                        type: string
                      kind:
                        type: string
                      incompatibility:
                        type: 'null'
                      territoryName:
                        type: 'null'
                      location:
                        type: string
                      locationIso2:
                        type: array
                        items:
                          type: string
                      region:
                        type: string
                      start:
                        type: string
                        format: date
                      startPrecision:
                        type: string
                      end:
                        type: 'null'
                      endPrecision:
                        type: 'null'
                      activeYears:
                        type: array
                        items: {}
                      intensity:
                        type: 'null'
                      battleDeaths:
                        type: 'null'
                      battleDeathsLow:
                        type: 'null'
                      battleDeathsHigh:
                        type: 'null'
                      battleDeathsSpan:
                        type: 'null'
                      summary:
                        type: string
                      sourceCode:
                        type: string
                      sourceRef:
                        type: 'null'
                      sources:
                        type: array
                        items:
                          type: object
                          properties:
                            url:
                              type: string
                            title:
                              type: string
                      dataThrough:
                        type: integer
                      draft:
                        type: boolean
                      parties:
                        type: array
                        items:
                          type: object
                          properties:
                            name:
                              type: string
                            iso2:
                              type:
                                - string
                                - 'null'
                            side:
                              type: string
                            role:
                              type: string
                            from:
                              type: string
                              format: date
                            fromPrecision:
                              type: string
                            to:
                              type: 'null'
                            toPrecision:
                              type: 'null'
                            activeYears:
                              type: array
                              items: {}
                            outcome:
                              type: 'null'
                            opponents:
                              type: array
                              items:
                                type: string
                            note:
                              type: string
                            draft:
                              type: boolean
                      continues:
                        type: 'null'
                      continuedBy:
                        type: array
                        items: {}
                      partOf:
                        type: 'null'
                      events:
                        type: array
                        items: {}
                      review:
                        type: object
                        properties:
                          state:
                            type: string
                          note:
                            type: 'null'
                          at:
                            type: 'null'
                      countryNames:
                        type: object
                        properties:
                          ET:
                            type: string
                          ER:
                            type: string
                      notices:
                        type: array
                        items: {}
                description: >-
                  Inferred from captured responses: every field shown was
                  returned by a real call; a field may be absent or null on
                  other calls.
                x-schema-source: inferred
              example:
                conflict:
                  key: seed:ethiopia-eritrea-2026
                  name: Ethiopia–Eritrea armed confrontation (2026)
                  kind: interstate
                  incompatibility: null
                  territoryName: null
                  location: >-
                    Eastern Tigray (Adigrat, Zalambessa, Idaga Hamus, Rama);
                    northern Afar
                  locationIso2:
                    - ET
                    - ER
                  region: africa
                  start: '2026-10-01'
                  startPrecision: month
                  end: null
                  endPrecision: null
                  activeYears: []
                  intensity: null
                  battleDeaths: null
                  battleDeathsLow: null
                  battleDeathsHigh: null
                  battleDeathsSpan: null
                  summary: >-
                    During Ethiopia's September–October 2026 fighting with a
                    TPLF-led rebel alliance, witnesses reported Eritrean troops
                    in Adigrat and eastern Tigray from about 7 October 2026 and
                    Ethiopia says its drone…
                  sourceCode: seed
                  sourceRef: null
                  sources:
                    - url: https://www.bbc.com/news/articles/crpd0d0jl0y0o
                      title: >-
                        BBC: Ethiopia and Eritrea cut diplomatic ties
                        (2026-10-02)
                    - url: >-
                        https://www.aljazeera.com/news/2026/10/7/witnesses-spot-eritrean-troops-inside-northern-ethiopia-as-tensions-flare
                      title: >-
                        Al Jazeera (Reuters): Witnesses spot Eritrean troops
                        inside northern Ethiopia as tensions flare (2026-10-07)
                  dataThrough: 2026
                  draft: true
                  parties:
                    - name: Ethiopia
                      iso2: ET
                      side: A
                      role: primary
                      from: '2026-10-01'
                      fromPrecision: month
                      to: null
                      toPrecision: null
                      activeYears: []
                      outcome: null
                      opponents:
                        - Eritrea
                      note: >-
                        Foreign Minister Gedion Timothewos told the UN Security
                        Council on 8 October 2026 that Eritrean troops had
                        advanced up to 60 km into Tigray and that Ethiopia was
                        defending itself, citing drone strikes…
                      draft: true
                    - name: Tigray Peace Force
                      iso2: null
                      side: A
                      role: secondary
                      from: '2026-10-01'
                      fromPrecision: month
                      to: null
                      toPrecision: null
                      activeYears: []
                      outcome: null
                      opponents:
                        - Eritrea
                      note: >-
                        This pro-government Tigrayan force reported Eritrean
                        troops in Adigrat on 6–7 October and claimed on 15
                        October 2026 that they had suffered significant
                        casualties and retreated (not independently veri…
                      draft: true
                  continues: null
                  continuedBy: []
                  partOf: null
                  events: []
                  review:
                    state: draft
                    note: null
                    at: null
                  countryNames:
                    ET: Ethiopia
                    ER: Eritrea
                  notices: []
        '400':
          description: >-
            A query parameter the route does not take (unknown_parameter), a
            value outside its type, enum or range (invalid_parameter), or a
            required one missing (missing_parameter); `param` names it. A
            request refused against this spec's parameter list is not metered.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Missing or invalid bearer token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Unknown company, country, symbol or resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limited. Honour Retry-After.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - apiKey: []
        - cognitoIdToken: []
components:
  schemas:
    Error:
      type: object
      required:
        - error
        - code
      properties:
        error:
          type: string
          description: Human-readable message. It may change; branch on `code`.
        code:
          type: string
          description: >-
            Stable machine code; every error carries one. unknown_parameter,
            invalid_parameter and missing_parameter come with `param`;
            unknown_parameter also with `allowed`. A route may add codes of its
            own (e.g. key_limit); treat an unlisted code by its HTTP status.
          enum:
            - unknown_parameter
            - invalid_parameter
            - missing_parameter
            - invalid_request
            - unauthenticated
            - upgrade_required
            - forbidden
            - not_found
            - conflict
            - too_large
            - unsupported_media_type
            - rate_limited
            - quota_exceeded
            - auth_unavailable
            - upstream_unavailable
            - internal_error
        param:
          type: string
          description: The query parameter at fault, when one is.
        allowed:
          type: array
          items:
            type: string
          description: 'With unknown_parameter: every query parameter the route takes.'
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-API-KEY
      description: >-
        Astreus API key (pk_live_...), created on the Developers page in the
        terminal. Also accepted as `Authorization: Bearer pk_live_...`.
      x-default: pk_live_YOUR_KEY
    cognitoIdToken:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Amazon Cognito ID token (token_use=id) for the Astreus user pool — the
        terminal's own session credential. API consumers should use an API key
        instead.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.