> ## 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.

# Attribution

> Outcomes and value by day, agent, method and band, without a person: deterministic and probable apart.



## OpenAPI

````yaml openapi/en/cell.json GET /v1/measure/attribution
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/attribution:
    get:
      tags:
        - signals
      summary: Attribution
      description: >-
        Outcomes and value by day, agent, method and band, without a person:
        deterministic and probable

        apart.


        **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: attribution_v1_measure_attribution_get
      parameters:
        - in: query
          name: since
          required: true
          schema:
            format: date
            title: Since
            type: string
        - in: query
          name: until
          required: true
          schema:
            format: date
            title: Until
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AttributionReport'
          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:
    AttributionReport:
      additionalProperties: false
      description: >-
        Value by day, agent, method and band, deterministic and probable apart;
        a value is never multiplied by

        a confidence, and no total adds a probable value to a deterministic one.
      properties:
        identity:
          $ref: '#/components/schemas/IdentityCalibration'
        rows:
          items:
            $ref: '#/components/schemas/AttributionRow'
          title: Rows
          type: array
        since:
          format: date
          title: Since
          type: string
        totals:
          items:
            $ref: '#/components/schemas/AttributionTotal'
          title: Totals
          type: array
        until:
          format: date
          title: Until
          type: string
      required:
        - since
        - until
        - rows
        - totals
        - identity
      title: AttributionReport
      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
    IdentityCalibration:
      additionalProperties: false
      description: >-
        How often the identity method names the exposure the line's own token
        names, on the lines where both

        exist: the confidence of that method in this space.
      properties:
        agreeing:
          title: Agreeing
          type: integer
        compared:
          title: Compared
          type: integer
        rate:
          anyOf:
            - type: number
            - type: 'null'
          title: Rate
      required:
        - agreeing
        - compared
      title: IdentityCalibration
      type: object
    AttributionRow:
      additionalProperties: false
      properties:
        agent:
          title: Agent
          type: string
        band:
          enum:
            - deterministic
            - probable
          title: Band
          type: string
        currency:
          title: Currency
          type: string
        day:
          format: date
          title: Day
          type: string
        finality:
          enum:
            - provisional
            - final
            - expired_without_outcome
          title: Finality
          type: string
        lines:
          title: Lines
          type: integer
        method:
          enum:
            - line
            - order
            - identity
            - assisted_handoff
          title: Method
          type: string
        outcome:
          maxLength: 256
          minLength: 1
          title: Outcome
          type: string
        outcomes:
          title: Outcomes
          type: integer
        value_minor:
          title: Value Minor
          type: integer
      required:
        - day
        - outcome
        - agent
        - method
        - band
        - finality
        - currency
        - outcomes
        - lines
        - value_minor
      title: AttributionRow
      type: object
    AttributionTotal:
      additionalProperties: false
      description: >-
        One method, band and finality over the period: deterministic and
        probable are never added together.
      properties:
        band:
          enum:
            - deterministic
            - probable
          title: Band
          type: string
        currency:
          title: Currency
          type: string
        finality:
          enum:
            - provisional
            - final
            - expired_without_outcome
          title: Finality
          type: string
        lines:
          title: Lines
          type: integer
        method:
          enum:
            - line
            - order
            - identity
            - assisted_handoff
          title: Method
          type: string
        outcome:
          maxLength: 256
          minLength: 1
          title: Outcome
          type: string
        outcomes:
          title: Outcomes
          type: integer
        value_minor:
          title: Value Minor
          type: integer
      required:
        - outcome
        - method
        - band
        - finality
        - currency
        - outcomes
        - lines
        - value_minor
      title: AttributionTotal
      type: object
  securitySchemes:
    sourceKey:
      type: http
      scheme: bearer
      description: nia_sk_...
    personToken:
      type: http
      scheme: bearer
      bearerFormat: JWT

````