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

# Interleaving

> Interleaved lists of a tool's two rankings: which one engagement credited, impression by impression, with the sign test.



## OpenAPI

````yaml openapi/en/cell.json GET /v1/measure/interleaving
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/interleaving:
    get:
      tags:
        - signals
      summary: Interleaving
      description: >-
        Interleaved lists of a tool's two rankings: which one engagement
        credited, with the sign test.


        **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: interleaving_v1_measure_interleaving_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/InterleavingReport'
          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:
    InterleavingReport:
      additionalProperties: false
      description: >-
        Interleaved lists of a tool's two rankings (team draft, seeded by the
        turn): which ranking the

        person's engagement credited, impression by impression, by day and over
        the period.
      properties:
        rows:
          items:
            $ref: '#/components/schemas/InterleavingRow'
          title: Rows
          type: array
        since:
          format: date
          title: Since
          type: string
        totals:
          items:
            $ref: '#/components/schemas/InterleavingTotal'
          title: Totals
          type: array
        until:
          format: date
          title: Until
          type: string
      required:
        - since
        - until
        - rows
        - totals
      title: InterleavingReport
      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
    InterleavingRow:
      additionalProperties: false
      properties:
        day:
          format: date
          title: Day
          type: string
        experiment:
          maxLength: 256
          minLength: 1
          title: Experiment
          type: string
        impressions:
          title: Impressions
          type: integer
        ties:
          description: Impressions engaged with equally, or not at all.
          title: Ties
          type: integer
        tool:
          maxLength: 256
          minLength: 1
          title: Tool
          type: string
        wins_a:
          description: >-
            Impressions whose engagement went to the items ranking `a`
            contributed.
          title: Wins A
          type: integer
        wins_b:
          title: Wins B
          type: integer
      required:
        - day
        - experiment
        - tool
        - impressions
        - wins_a
        - wins_b
        - ties
      title: InterleavingRow
      type: object
    InterleavingTotal:
      additionalProperties: false
      properties:
        experiment:
          maxLength: 256
          minLength: 1
          title: Experiment
          type: string
        impressions:
          title: Impressions
          type: integer
        p_value:
          anyOf:
            - type: number
            - type: 'null'
          description: >-
            The two-sided sign test on the decided impressions; absent before
            any was decided.
          title: P Value
        ties:
          title: Ties
          type: integer
        tool:
          maxLength: 256
          minLength: 1
          title: Tool
          type: string
        wins_a:
          title: Wins A
          type: integer
        wins_b:
          title: Wins B
          type: integer
      required:
        - experiment
        - tool
        - impressions
        - wins_a
        - wins_b
        - ties
        - p_value
      title: InterleavingTotal
      type: object
  securitySchemes:
    sourceKey:
      type: http
      scheme: bearer
      description: nia_sk_...
    personToken:
      type: http
      scheme: bearer
      bearerFormat: JWT

````