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

# Get Risk Signal

> The latest VIASignal for one agent: its risk score at one instant as an SD-JWT signed by the platform's key (did:web:humanos.tech), verifiable offline and recomputable from the chain.  
Issued daily for every scored agent and on demand by its organization; valid 48 hours; each names the one before it.  
Your own organization receives every disclosure (the evidence behind each factor, the remediations, the posture). A partner organization, under a sharing grant, receives the same signature with those disclosures withheld.



## OpenAPI

````yaml /versions/2026-10-16.yaml get /intelligence/risk/signal
openapi: 3.1.0
info:
  title: Humanos API
  description: Humanos API
  version: '1.0'
  contact: {}
servers:
  - url: https://api.humanos.tech
security: []
tags:
  - name: humanosApp
    description: ''
paths:
  /intelligence/risk/signal:
    get:
      tags:
        - Intelligence
      summary: Get Risk Signal
      description: >-
        The latest VIASignal for one agent: its risk score at one instant as an
        SD-JWT signed by the platform's key (did:web:humanos.tech), verifiable
        offline and recomputable from the chain.  

        Issued daily for every scored agent and on demand by its organization;
        valid 48 hours; each names the one before it.  

        Your own organization receives every disclosure (the evidence behind
        each factor, the remediations, the posture). A partner organization,
        under a sharing grant, receives the same signature with those
        disclosures withheld.
      operationId: intelligence_riskSignal
      parameters:
        - name: orgDid
          required: true
          in: query
          description: >-
            DID of the organization whose data is consulted. Your own
            organization DID needs no grant; any other requires an active
            sharing grant from that organization to yours.
          schema:
            example: did:web:org-a.example
            type: string
        - name: did
          required: true
          in: query
          description: DID of the agent to score.
          schema:
            example: did:web:humanos.tech:agent:RRJyvYvj0T-ZRBU-
            type: string
        - name: days
          required: false
          in: query
          description: Behaviour window in days, ending now. Default 30, at most 366.
          schema:
            example: 30
            type: string
        - $ref: '#/components/parameters/ApiVersion'
      responses:
        '200':
          description: >-
            Returns the latest signal, or an empty body when none has been
            issued yet.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IntelligenceRiskSignalEntity'
        '400':
          description: 'Invalid query parameters: `orgDid` or `did` missing.'
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: number
                    example: 400
                  message:
                    type: string
                    example: did must be a string
                  error:
                    type: string
                    example: Bad Request
        '404':
          description: >-
            sharing_not_enabled: the organization does not exist or does not
            share with you; or that organization operates no such agent.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: number
                    example: 404
                  message:
                    type: string
                    example: >-
                      sharing_not_enabled: the organization does not share with
                      you
                  error:
                    type: string
                    example: Not Found
components:
  parameters:
    ApiVersion:
      name: API-Version
      in: header
      required: false
      schema:
        type: string
        pattern: ^\d{4}-\d{2}-\d{2}$
        example: '2026-10-16'
      description: >-
        Pin request, response, and webhook shapes to a specific dated API
        version (YYYY-MM-DD). Omit to use the version pinned to your API key
        (set when the key is created; new keys default to the latest version).
        New integrations should target the latest version.
  schemas:
    IntelligenceRiskSignalEntity:
      type: object
      properties:
        urn:
          type: string
          description: The signal's URN.
          example: urn:via:signal:11111111-2222-4333-8444-555555555555
        did:
          type: string
          description: DID of the agent the signal scores.
          example: did:web:humanos.tech:agent:2f8b6c41-9d37-4e5a-8b02-6c1d9e7a4f35
        score:
          type: number
          description: The score the signal carries.
          example: 31
        issuedAt:
          type: string
          description: When the platform signed it.
          example: '2026-09-10T04:30:00.000Z'
        validFrom:
          type: string
          description: When it starts to hold.
          example: '2026-09-10T04:30:00.000Z'
        validUntil:
          type: string
          description: Two days after issuance.
          example: '2026-09-12T04:30:00.000Z'
        previousUrn:
          type:
            - string
            - 'null'
          description: >-
            The prior signal for this agent, so the sequence is checkable; null
            on the first.
          example: urn:via:signal:00000000-1111-4222-8333-444444444444
        digest:
          type: string
          description: >-
            SRI digest of the issuer-signed JWT — the stable name of these
            bytes.
          example: sha256-…
        sdJwt:
          type: string
          description: >-
            The SD-JWT (`dc+sd-jwt`, EdDSA). Verify against the platform key at
            did:web:humanos.tech. Disclosures follow the `~` separators; a
            partner copy carries none.
          example: >-
            eyJhbGciOiJFZERTQSIsInR5cCI6ImRjK3NkLWp3dCJ9.eyJzdWIiOiJkaWQ6d2ViOi4uLiJ9.c2lnbmF0dXJl~WyJzYWx0IiwiZXZpZGVuY2UiLFtdXQ~
      required:
        - urn
        - did
        - score
        - issuedAt
        - validFrom
        - validUntil
        - previousUrn
        - digest
        - sdJwt

````

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