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

# Get an Intelligence Evaluation

> Strictly scoped to the calling surface: authenticated callers can only retrieve evaluations created
under their own merchant account; anonymous callers can only retrieve public-test evaluations.
A foreign evaluation ID is a 404 — indistinguishable from a nonexistent one.




## OpenAPI

````yaml GET /v1/intelligence/evaluations/{id}
openapi: 3.1.0
info:
  title: Anton Payments API
  version: 1.0.0
  summary: Cross-border payout infrastructure. Fiat, stablecoin, and crypto.
  description: >
    The Anton Payments merchant API. Versioned, idempotent, cursor-paginated.


    - **Authentication**: OAuth 2.0 client_credentials with DPoP
    proof-of-possession (RFC 6749 §4.4 + RFC 9449). Programmatic clients
    exchange `(client_id, client_secret)` for a short-lived access token at
    `POST /oauth/token`, then send each request with `Authorization: DPoP
    <access_token>` plus a per-request `DPoP: <proof>` header. Static API keys
    are not accepted on v1.

    - Base URLs: `https://api.antonpayments.com` (production),
    `https://api.antonpayments.dev` (sandbox).

    - Monetary amounts are decimal strings. Never floats.

    - Timestamps are RFC 3339 UTC.

    - All mutating endpoints support the `Idempotency-Key` header.

    - Anton's OAuth public signing key is published at `GET
    /.well-known/jwks.json` (5-minute cache; RFC 8615).


    **Capabilities and scopes.** Every account carries a capability set
    (`payouts`, `intelligence`) and every

    credential carries a scope set validated against it at creation.
    AI-compliance-only accounts hold only

    `intelligence` — all payout-surface endpoints return `403
    capability_required` for them. A credential

    minted without a scope returns `403 insufficient_scope` on that surface.
    Effective access is

    `scopes ∩ capabilities`. Access tokens embed the grants as a space-delimited
    `scope` claim, echoed in the

    token response.


    See the Cross-Cutting section of the docs for idempotency, pagination, rate
    limits, errors, webhook events, and webhook signing.
  contact:
    name: Anton Payments Support
    url: https://help.antonpayments.com
  license:
    name: Proprietary
    url: https://www.antonpayments.com
servers:
  - url: https://api.antonpayments.com
    description: Production
  - url: https://api.antonpayments.dev
    description: Sandbox
security:
  - oauthDPoP: []
    dpopHeader: []
tags:
  - name: Authentication
    description: >-
      OAuth 2.0 token endpoint and JWKS publication. See the API description for
      the full DPoP-bound flow.
  - name: OAuth Clients
    description: >-
      Manage OAuth credentials (programmatic access). Portal-only — JWT auth
      required.
  - name: Reference Data
    description: Currencies, countries, and supported payment methods.
  - name: Beneficiaries
    description: Create and manage the people and businesses you pay.
  - name: Instruments
    description: >-
      Payment instruments attached to beneficiaries — bank accounts, wallets,
      cards.
  - name: Payouts
    description: Initiate and track payouts.
  - name: Batches
    description: CSV-driven bulk payout processing.
  - name: Balances
    description: Merchant balance by currency.
  - name: Accounts
    description: Virtual accounts for merchant funding.
  - name: Webhooks
    description: Subscribe to event notifications.
  - name: Documents
    description: Upload and manage KYB and supporting documents.
  - name: RFIs
    description: Respond to Requests for Information raised during review.
  - name: Pricing
    description: Read merchant pricing plans and quote fees.
  - name: FX
    description: Quote, lock, and execute currency exchanges between balances.
  - name: Corridors
    description: Active cross-border corridors for your merchant.
  - name: Balance Alerts
    description: >-
      Per-currency low-balance thresholds that drive the `balance.low` webhook
      event.
  - name: Sandbox
    description: Reset and seed your sandbox environment.
  - name: Merchant
    description: Merchant profile, branding, preferences, and security posture.
  - name: API Keys
    description: Issue, list, and revoke API keys.
  - name: Users
    description: Self-service profile, MFA, and team management.
  - name: Notifications
    description: Per-user notification channels and preferences.
  - name: Velocity
    description: Merchant-scoped risk rules and what-if simulation.
  - name: Engine
    description: Glass-box view of Anton's risk intelligence.
  - name: Intelligence
    description: >-
      Normalized payee, instrument, payout, and merchant risk intelligence
      evaluations.
  - name: Onboarding
    description: Authenticated KYB onboarding draft and submission.
  - name: Public Onboarding
    description: >-
      Session-authenticated hosted onboarding flow. Not intended for SDK
      consumption.
paths:
  /v1/intelligence/evaluations/{id}:
    get:
      tags:
        - Intelligence
      summary: Retrieve an intelligence evaluation
      description: >
        Strictly scoped to the calling surface: authenticated callers can only
        retrieve evaluations created

        under their own merchant account; anonymous callers can only retrieve
        public-test evaluations.

        A foreign evaluation ID is a 404 — indistinguishable from a nonexistent
        one.
      parameters:
        - $ref: '#/components/parameters/IntelligenceEvaluationID'
      responses:
        '200':
          description: Concise evaluation result.
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                properties:
                  data:
                    $ref: '#/components/schemas/IntelligenceEvaluation'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
      security:
        - {}
        - oauthDPoP: []
          dpopHeader: []
components:
  parameters:
    IntelligenceEvaluationID:
      name: id
      in: path
      required: true
      description: Intelligence evaluation ID.
      schema:
        type: string
        pattern: ^eval_[a-zA-Z0-9]+$
  schemas:
    IntelligenceEvaluation:
      type: object
      required:
        - contract_version
        - evaluation_id
        - event_id
        - event_type
        - status
        - decision
        - rationale
        - scoring
        - peer_statuses
        - policy
        - audit
        - evaluated_at
        - latency_ms
      properties:
        contract_version:
          type: string
          enum:
            - intelligence-public-v1
        evaluation_id:
          type: string
        event_id:
          type: string
        event_type:
          type: string
          enum:
            - payout.create
            - payee.create
            - instrument.create
            - merchant.onboard
            - monitoring.evaluate
        status:
          type: string
          enum:
            - complete
            - partial
            - error
        decision:
          type: string
          enum:
            - approve
            - review_auto
            - review_manual
            - decline
        risk_level:
          type: string
          enum:
            - low
            - medium
            - high
            - critical
        rationale:
          type: string
        next_action:
          type: string
          enum:
            - none
            - request_more_information
            - manual_review
            - decline
        summary:
          $ref: '#/components/schemas/IntelligenceEvaluationSummary'
        scoring:
          $ref: '#/components/schemas/IntelligenceScoring'
        missing_disambiguators:
          type: array
          items:
            type: string
        peer_statuses:
          type: array
          items:
            $ref: '#/components/schemas/IntelligencePeerStatus'
        policy:
          $ref: '#/components/schemas/IntelligencePolicy'
        audit:
          $ref: '#/components/schemas/IntelligenceAudit'
        evaluated_at:
          $ref: '#/components/schemas/Timestamp'
        latency_ms:
          type: integer
          format: int64
    IntelligenceEvaluationSummary:
      type: object
      additionalProperties: false
      properties:
        screened:
          type: array
          items:
            type: string
            enum:
              - entity
              - instrument
              - payout
              - context
        use_case:
          type: string
          enum:
            - payee_registration
            - instrument_screening
            - payout_screening
            - merchant_onboarding
            - monitoring
        instrument_type:
          type: string
          enum:
            - bank_account
            - crypto_wallet
            - card
            - iban
        payout_rail:
          type: string
          enum:
            - bank
            - card
            - crypto
            - wallet
            - internal
            - other
        findings_count:
          type: integer
        highest_severity:
          type: string
          enum:
            - low
            - medium
            - high
            - critical
        identity_confidence:
          type: string
          enum:
            - none
            - possible
            - likely
            - confirmed
        missing_fields:
          type: array
          items:
            type: string
    IntelligenceScoring:
      type: object
      required:
        - model
        - scale
        - overall_score
        - risk_level
        - dimensions
      additionalProperties: false
      properties:
        model:
          type: string
          enum:
            - anton-scoring-v1
        scale:
          $ref: '#/components/schemas/IntelligenceScoringScale'
        overall_score:
          type: integer
          minimum: 0
          maximum: 1000
        risk_level:
          type: string
          enum:
            - low
            - medium
            - high
            - critical
        dimensions:
          type: array
          minItems: 5
          maxItems: 5
          items:
            $ref: '#/components/schemas/IntelligenceScoringDimension'
    IntelligencePeerStatus:
      type: object
      required:
        - peer
        - status
        - found
      properties:
        peer:
          type: string
          enum:
            - sentinel
            - engine
            - brain
        status:
          type: string
          enum:
            - complete
            - partial
            - error
            - timeout
            - not_configured
            - skipped
        found:
          type: boolean
    IntelligencePolicy:
      type: object
      required:
        - version
        - rule_fired
      properties:
        version:
          type: string
          example: triad-policy-v2
        rule_fired:
          type: string
        reasons:
          type: array
          items:
            type: string
    IntelligenceAudit:
      type: object
      required:
        - hash
        - persisted
      properties:
        hash:
          type: string
        persisted:
          type: boolean
    Timestamp:
      type: string
      format: date-time
      description: RFC 3339 / ISO 8601 timestamp in UTC.
      example: '2026-04-15T14:30:00Z'
    ErrorEnvelope:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - message
          properties:
            message:
              type: string
              description: Human-readable description of what went wrong.
            code:
              type: string
              description: Machine-readable error code. Branch on this, not on `message`.
              example: insufficient_balance
      example:
        error:
          message: insufficient funds for this payout
          code: insufficient_balance
    IntelligenceScoringScale:
      type: object
      required:
        - min
        - max
      additionalProperties: false
      properties:
        min:
          type: integer
          enum:
            - 0
        max:
          type: integer
          enum:
            - 1000
    IntelligenceScoringDimension:
      type: object
      required:
        - code
        - name
        - score
        - risk_level
        - status
      additionalProperties: false
      properties:
        code:
          type: string
          enum:
            - TRS
            - ORS
            - TM
            - AD
            - GI
        name:
          type: string
          enum:
            - Transaction Risk
            - Onboarding Risk
            - Transaction Monitoring
            - Anomaly Detection
            - Graph Intelligence
        score:
          type: integer
          minimum: 0
          maximum: 1000
        risk_level:
          type: string
          enum:
            - low
            - medium
            - high
            - critical
        status:
          type: string
          enum:
            - complete
            - not_applicable
            - not_configured
            - partial
            - error
        signals:
          type: array
          items:
            type: string
  responses:
    NotFound:
      description: The resource does not exist, or belongs to a different merchant.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    RateLimited:
      description: >-
        Rate limit exceeded. See `Retry-After`. The `X-RateLimit-*` headers are
        present on every API response, not only on 429s — they are documented
        here because this is where clients act on them.
      headers:
        Retry-After:
          $ref: '#/components/headers/Retry-After'
        X-RateLimit-Limit:
          $ref: '#/components/headers/X-RateLimit-Limit'
        X-RateLimit-Remaining:
          $ref: '#/components/headers/X-RateLimit-Remaining'
        X-RateLimit-Reset:
          $ref: '#/components/headers/X-RateLimit-Reset'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
          examples:
            rate_limit_exceeded:
              summary: Retry after the limiter resets
              value:
                error:
                  code: rate_limit_exceeded
                  message: rate limit exceeded, retry after 60 seconds
  headers:
    Retry-After:
      description: Seconds to wait before retrying. Included on 429 responses.
      schema:
        type: integer
    X-RateLimit-Limit:
      description: Maximum requests permitted in the current window.
      schema:
        type: integer
    X-RateLimit-Remaining:
      description: Requests remaining in the current window.
      schema:
        type: integer
    X-RateLimit-Reset:
      description: Unix timestamp when the current window resets.
      schema:
        type: integer
  securitySchemes:
    oauthDPoP:
      type: oauth2
      description: >
        OAuth 2.0 client_credentials grant (RFC 6749 §4.4) bound to a DPoP
        keypair (RFC 9449).


        **Flow** (every authenticated `/v1` call requires both an access token
        AND a fresh per-request DPoP proof):


        1. Register a credential via the merchant portal. Anton issues a
        `client_id` (`ant_oc_<env>_<32hex>`) and a `client_secret`
        (`ant_ocs_<env>_<48hex>`, shown ONCE). The portal generates an ES256 or
        Ed25519 DPoP keypair in your browser; you store the private half.

        2. Mint an access token: `POST /oauth/token` with `Authorization: Basic
        <client_id:client_secret>` and `Content-Type:
        application/x-www-form-urlencoded`. Body:
        `grant_type=client_credentials`. A `DPoP` header carrying a proof signed
        for the token endpoint is required (no `ath` claim on this proof).

        3. Use the token: send `Authorization: DPoP <access_token>` plus a fresh
        `DPoP: <proof>` header on every `/v1` request. The proof JWT MUST carry
        `htm` (request method), `htu` (request URL, no query/fragment), `iat`
        (within ±60s), `jti` (unique within 5 min), and `ath` (SHA-256 of the
        access token, base64url).


        Tokens expire in **1 hour** in production / staging and **8 hours** in
        sandbox. There are no refresh tokens — call `/oauth/token` again with
        your secret. Anton's public signing key is published at
        `/.well-known/jwks.json`.


        OpenAPI 3.0 has no native DPoP scheme; this declaration plus
        `dpopHeader` together convey both the access-token Authorization and the
        per-request proof header.
      flows:
        clientCredentials:
          tokenUrl: /oauth/token
          scopes:
            payouts: >-
              Money movement — payouts, batches, beneficiaries, instruments,
              balances, funding, FX.
            intelligence: Anton Intelligence — screening evaluations and evidence.
    dpopHeader:
      type: apiKey
      in: header
      name: DPoP
      description: >
        Per-request DPoP proof JWT (RFC 9449). MUST accompany the
        `Authorization: DPoP <access_token>` header on every protected
        operation. The proof is signed by the merchant's private DPoP key and
        carries `htm`, `htu`, `iat`, `jti`, and `ath` claims.

````