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

# Attributed outcomes

> Each outcome attributed to what an agent did, newest first, with its method, band and finality. The `measurement` feature.



## OpenAPI

````yaml openapi/en/cell.json GET /v1/measure/outcomes
openapi: 3.1.0
info:
  title: Niadra data API
  version: '1'
  description: >-
    Writing, context, history, objects, identity, privacy and governance of one
    space. Every space has a stable address, with the space and the region in
    its name.
servers:
  - url: https://{space}.{region}.api.niadra.com
    variables:
      space:
        default: acme-prod
        description: The space, which comes in the source key.
      region:
        default: us-east-2
        description: The region of the space, which also comes in the key.
security: []
paths:
  /v1/measure/outcomes:
    get:
      tags:
        - signals
      summary: Attributed outcomes
      description: >-
        Outcomes attributed to what agents did, newest first: each link with its
        method, band and finality.


        **Authentication.** Console person token with the `analysis` role (or
        admin), or a source key with the `admin` scope. It answers only in a
        space with the `measurement` feature on (the `features` document); in a
        space without it, 404.
      operationId: outcomes_v1_measure_outcomes_get
      parameters:
        - in: query
          name: cursor
          required: false
          schema:
            anyOf:
              - maxLength: 200
                type: string
              - type: 'null'
            title: Cursor
        - in: query
          name: limit
          required: false
          schema:
            default: 50
            maximum: 200
            minimum: 1
            title: Limit
            type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OutcomePage'
          description: Successful Response
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
          description: The request does not match the contract.
      security:
        - sourceKey: []
        - personToken: []
components:
  schemas:
    OutcomePage:
      additionalProperties: false
      properties:
        items:
          items:
            $ref: '#/components/schemas/OutcomeLink'
          title: Items
          type: array
        next_cursor:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Cursor
      required:
        - items
      title: OutcomePage
      type: object
    Problem:
      additionalProperties: false
      description: RFC 9457 problem details; `code` comes from the versioned error catalog.
      properties:
        code:
          title: Code
          type: string
        detail:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Detail
        request_id:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Request Id
        status:
          title: Status
          type: integer
        title:
          title: Title
          type: string
        type:
          default: about:blank
          title: Type
          type: string
      required:
        - title
        - status
        - code
      title: Problem
      type: object
    OutcomeLink:
      additionalProperties: false
      description: >-
        One outcome attributed to what an agent did, by one method. `line` and
        `order` are deterministic: the

        exposure token the order line or the order carried, or the agent's own
        action on the object.

        `identity` and `assisted_handoff` are probable: the same item engaged
        with or shown within a window, or a

        handoff that assisted the sale. A link carries its line's value whole or
        none at all: a value is never

        weighted.
      properties:
        action_id:
          anyOf:
            - maxLength: 512
              minLength: 1
              type: string
            - type: 'null'
          title: Action Id
        agent:
          anyOf:
            - maxLength: 256
              minLength: 1
              type: string
            - type: 'null'
          title: Agent
        band:
          enum:
            - deterministic
            - probable
          title: Band
          type: string
        confidence:
          anyOf:
            - type: number
            - type: 'null'
          description: >-
            Of an `identity` link: how often that method names the exposure a
            line's own token names in this space, where both exist. Beside the
            value, never multiplied by it.
          title: Confidence
        currency:
          anyOf:
            - maxLength: 256
              minLength: 1
              type: string
            - type: 'null'
          title: Currency
        exposure_id:
          anyOf:
            - maxLength: 512
              minLength: 1
              type: string
            - type: 'null'
          title: Exposure Id
        final_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: When a provisional link becomes final.
          title: Final At
        finality:
          description: >-
            `provisional` until the exchange window ends or the object reaches a
            final state; `expired_without_outcome` when its deadline passed
            first.
          enum:
            - provisional
            - final
            - expired_without_outcome
          title: Finality
          type: string
        handoff_id:
          anyOf:
            - maxLength: 512
              minLength: 1
              type: string
            - type: 'null'
          title: Handoff Id
        known_at:
          format: date-time
          title: Known At
          type: string
        line:
          anyOf:
            - maxLength: 256
              minLength: 1
              type: string
            - type: 'null'
          title: Line
        link_id:
          maxLength: 512
          minLength: 1
          title: Link Id
          type: string
        method:
          enum:
            - line
            - order
            - identity
            - assisted_handoff
          title: Method
          type: string
        object:
          pattern: ^[a-z][a-z0-9_]{0,39}:[^:\s]{1,256}:\S{1,512}$
          title: Object
          type: string
        outcome:
          description: The outcome definition of the `measurement` document.
          maxLength: 256
          minLength: 1
          title: Outcome
          type: string
        position:
          anyOf:
            - type: integer
            - type: 'null'
          title: Position
        state:
          description: The state the object or its line is in.
          maxLength: 256
          minLength: 1
          title: State
          type: string
        turn_id:
          anyOf:
            - maxLength: 512
              minLength: 1
              type: string
            - type: 'null'
          title: Turn Id
        valid_at:
          description: When the outcome first counted.
          format: date-time
          title: Valid At
          type: string
        value_minor:
          anyOf:
            - type: integer
            - type: 'null'
          description: 'In the currency''s minor units; absent: none.'
          title: Value Minor
      required:
        - link_id
        - outcome
        - object
        - state
        - method
        - band
        - finality
        - valid_at
        - known_at
      title: OutcomeLink
      type: object
  securitySchemes:
    sourceKey:
      type: http
      scheme: bearer
      description: nia_sk_...
    personToken:
      type: http
      scheme: bearer
      bearerFormat: JWT

````