Dow Jones Disposition API

The Disposition API allows clients to create, retrieve, update and delete historical dispositions representing prior adjudication decisions.

Operations 6

POST /disposition Create a historical disposition #
GET /disposition Get historical dispositions #
GET /disposition/{disposition_id} Get a historical disposition #
PATCH /disposition/{disposition_id} Update a historical disposition #
DELETE /disposition/{disposition_id} Delete a historical disposition #
POST /disposition/bulk Bulk delete historical dispositions #

Documentation

📖
Documentation
https://developer.dowjones.com/documents/site-docs-risk_and_compliance_apis-screening_and_monitoring_api-batch_screening_api
📖
Documentation
https://developer.dowjones.com/documents/site-docs-risk_and_compliance_apis-screening_and_monitoring_api-batch_screening_api_private_list
📖
Documentation
https://developer.dowjones.com/documents/site-docs-risk_and_compliance_apis-advanced-screening-and-monitoring-api
📖
Documentation
https://developer.dowjones.com/documents/site-docs-risk_and_compliance_apis-risk_and_compliance_2_0-risk_search_api
📖
Documentation
https://developer.dowjones.com/documents/site-docs-risk_and_compliance_apis-risk_and_compliance_2_0-risk_profiles_api-risk_and_compliance_profiles
📖
Documentation
https://developer.dowjones.com/documents/site-docs-risk_and_compliance_apis-risk_and_compliance_2_0-risk_taxonomy_api
📖
Documentation
https://developer.dowjones.com/documents/site-docs-risk_and_compliance_apis-risk_and_compliance_2_0-risk_profiles_api-profile_history_api
📖
Documentation
https://developer.dowjones.com/documents/site-docs-risk_and_compliance_apis-due_diligence_reports_api-risk_reports_api
📖
Documentation
https://developer.dowjones.com/documents/site-docs-risk_and_compliance_apis-third_party_api
📖
Documentation
https://developer.dowjones.com/documents/site-docs-newswires_apis-dow_jones_newswires_real_time_api-real_time_search_api
📖
Documentation
https://developer.dowjones.com/documents/site-docs-newswires_apis-dow_jones_newswires_top_stories_api-top_stories_api
📖
Documentation
https://developer.dowjones.com/documents/site-docs-newswires_apis-dow_jones_financial_calendars_api-financial_calendars_api
📖
Documentation
https://developer.dowjones.com/documents/site-docs-newswires_apis
📖
Documentation
https://developer.dowjones.com/documents/factiva_integration-factiva_workflow_toolkit-endpoints-get_article
📖
Documentation
https://developer.dowjones.com/documents/factiva_integration-factiva_workflow_toolkit-endpoints-newsletters-newsletters
📖
Documentation
https://developer.dowjones.com/documents/site-docs-factiva_apis-factiva_workflow_apis_rest-factiva_news_search-news_radar_api-news_radar

Specifications

Other Resources

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/dow-jones-disposition-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

dow-jones-disposition-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Advanced Screening and Monitoring Disposition API
  description: 'Dow Jones


    ### Rate limits


    Most endpoints are subject to a general rate limit of 10,000 requests per user per 15 minutes.


    Some endpoints are also subject to a global concurrent request limit of 5 simultaneous requests per customer.'
  version: '3'
  license: {}
  contact: {}
servers:
- url: API_INSTANCE
security:
- basicAuth: []
- jwt: []
- clientCert: []
tags:
- name: Disposition
  description: The Disposition API allows clients to create, retrieve, update and delete historical dispositions representing prior adjudication decisions.
paths:
  /disposition:
    post:
      operationId: dispositionCreate
      tags:
      - Disposition
      summary: Create a historical disposition
      description: 'Request to create a historical disposition in the system ### Rate Limits

        This endpoint is subject to a general rate limit of 10,000 requests per user per 15 minutes.

        '
      security:
      - basicAuth: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - matchedProfiles
              - sourceSystemId
              properties:
                clientId:
                  type: string
                  description: Optional client identifier (can be added later)
                sourceSystemId:
                  type: string
                  description: External identifier linking decisions to client record (e.g., assessment ID, onboarding case ID)
                mediaFlag:
                  type: integer
                  minimum: 1
                  description: 'Optional assessment code ID to apply to media-only evidences.

                    Must be a valid assessment code from configuration.

                    If provided with a relevant code (relevant: true), media processing is skipped.

                    Only non-relevant codes are applied to media-only evidences.

                    Available codes:

                    - 10001: Relevant - high confidence evidence references a client correctly associated with risk (relevant: true)

                    - 10002: Not relevant - document is not about the client or a related entity (relevant: false)

                    - 10003: Not relevant - document is not about risk (relevant: false)

                    - 10004: Not relevant - risk in document does not relate to the client (relevant: false)

                    - 10005: Not relevant - this type of document is not useful (relevant: false)

                    - 10006: Not relevant - the matched record could never be the client (relevant: false, breakEntityLink: true)

                    - 10007: Not relevant - the matched record does not contain any risk (relevant: false)

                    - 10008: Not relevant - the matched record is unlikely to be the client (relevant: false)

                    '
                  example: 10002
                matchedProfiles:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    required:
                    - profileSource
                    - profileId
                    - outcome
                    - adjudicationDate
                    - adjudicatedBy
                    properties:
                      profileSource:
                        type: string
                        enum:
                        - DJID
                        - RPID
                        - HRNID
                        - INTID
                        - LXID
                        - KHID
                        - RZLTID
                        - WCHID
                        description: Identifier domain (e.g., DJID, RPID, HRNID, INTID, LXID, KHID, RZLTID, WCHID)
                        example: DJID
                      profileId:
                        type: string
                        description: Profile identifier within the source domain
                        example: DJ-12345
                      outcome:
                        type: array
                        uniqueItems: true
                        minItems: 1
                        items:
                          type: integer
                          minimum: 1
                        description: "Array of unique assessment code IDs from configuration. \nCode 10001 (Relevant) cannot be combined with any other code in the same array.\nValidated against active configuration at runtime.\nAvailable codes:\n- 10001: Relevant - high confidence evidence references a client correctly associated with risk (relevant: true)\n- 10002: Not relevant - document is not about the client or a related entity (relevant: false)\n- 10003: Not relevant - document is not about risk (relevant: false)\n- 10004: Not relevant - risk in document does not relate to the client (relevant: false)\n- 10005: Not relevant - this type of document is not useful (relevant: false)\n- 10006: Not relevant - the matched record could never be the client (relevant: false, breakEntityLink: true)\n- 10007: Not relevant - the matched record does not contain any risk (relevant: false)\n- 10008: Not relevant - the matched record is unlikely to be the client (relevant: false)\n"
                        example:
                        - 10002
                      adjudicationDate:
                        type: string
                        pattern: ^\d{4}-\d{2}-\d{2}$
                        description: Date when adjudication was made (YYYY-MM-DD format, converted to timestamp on storage)
                        example: '2024-01-15'
                      adjudicatedBy:
                        type: string
                        description: Identity of the individual who made the decision
                        example: analyst@company.com
                      ttl:
                        type: integer
                        minimum: 1
                        description: Days until this match expires for auto-disposition purposes
                        example: 365
                      comment:
                        type: string
                        maxLength: 1000
                        description: Free-text comment or notes about the adjudication decision
                        example: Verified against official government records
                  description: Array of matched profiles with adjudication outcomes
            example:
              clientId: client-id-42
              sourceSystemId: ASSESSMENT-12345
              mediaFlag: 10002
              matchedProfiles:
              - profileSource: DJID
                profileId: DJ-001
                outcome:
                - 10002
                adjudicationDate: '2024-01-15'
                adjudicatedBy: analyst@company.com
                comment: Name similarity only, different DOB confirmed
              - profileSource: RPID
                profileId: RP-002
                outcome:
                - 10001
                adjudicationDate: '2024-01-15'
                adjudicatedBy: compliance.team@company.com
                ttl: 365
      responses:
        '201':
          description: Historical disposition created successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: integer
                    description: Unique internal identifier
                    example: 1
                  clientId:
                    type: string
                    description: Optional client identifier
                    example: CLIENT-001
                  sourceSystemId:
                    type: string
                    description: External source system identifier
                    example: ASSESSMENT-12345
                  mediaFlag:
                    type: integer
                    description: Assessment code ID applied to media-only evidences
                    example: 10002
                  matchedProfiles:
                    type: array
                    items:
                      type: object
                      required:
                      - profileSource
                      - profileId
                      - outcome
                      - adjudicationDate
                      - adjudicatedBy
                      properties:
                        profileSource:
                          type: string
                          enum:
                          - DJID
                          - RPID
                          - HRNID
                          - INTID
                          - LXID
                          - KHID
                          - RZLTID
                          - WCHID
                          description: Identifier domain (e.g., DJID, RPID, HRNID, INTID, LXID, KHID, RZLTID, WCHID)
                          example: DJID
                        profileId:
                          type: string
                          description: Profile identifier within the source domain
                          example: DJ-12345
                        outcome:
                          type: array
                          uniqueItems: true
                          minItems: 1
                          items:
                            type: integer
                            minimum: 1
                          description: Array of unique assessment code IDs applied to evidence
                          example:
                          - 10002
                        adjudicationDate:
                          type: string
                          pattern: ^\d{4}-\d{2}-\d{2}$
                          description: Date when adjudication was made (YYYY-MM-DD format, converted to timestamp on storage)
                          example: '2024-01-15'
                        adjudicatedBy:
                          type: string
                          description: Identity of the individual who made the decision
                          example: analyst@company.com
                        ttl:
                          type: integer
                          minimum: 1
                          description: Days until this match expires for auto-disposition purposes
                          example: 365
                        comment:
                          type: string
                          maxLength: 1000
                          description: Free-text comment or notes about the adjudication decision
                          example: Verified against official government records
                    description: Resolved matched profiles (duplicates removed)
                  createdAt:
                    type: integer
                    description: Timestamp when record was created (epoch ms)
                    example: 1705276800000
                  updatedAt:
                    type: integer
                    description: Timestamp when record was last updated (epoch ms)
                    example: 1705363200000
        '400':
          description: Bad request - validation failed
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error message
                  statusCode:
                    type: integer
                    description: HTTP status code
        '401':
          description: Not authorized to use this endpoint
        '403':
          description: Forbidden - insufficient permissions
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error message
                  statusCode:
                    type: integer
                    description: HTTP status code
    get:
      operationId: dispositionList
      tags:
      - Disposition
      summary: Get historical dispositions
      description: 'Request to get historical dispositions by filters ### Rate Limits

        This endpoint is subject to a general rate limit of 10,000 requests per user per 15 minutes.

        '
      security:
      - basicAuth: []
      parameters:
      - in: query
        name: clientId
        schema:
          type: string
        required: false
        description: Client identifier used to scope historical dispositions
      - in: query
        name: sourceSystemId
        schema:
          type: string
        required: false
        description: Source system identifier associated with historical dispositions
      - in: query
        name: profileId
        schema:
          type: string
        required: false
        description: Profile identifier to filter historical dispositions
      - in: query
        name: skip
        schema:
          type: integer
          default: 0
        required: false
        description: Number of items to skip from the beginning
      - in: query
        name: limit
        schema:
          type: integer
          default: 30
        required: false
        description: Maximum number of items to return
      responses:
        '200':
          description: Historical dispositions retrieved successfully
          content:
            application/json:
              schema:
                type: object
                description: List response with pagination metadata
                properties:
                  total:
                    type: integer
                    description: Total number of elements available for the given filter
                    example: 42
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: integer
                          description: Unique internal identifier
                          example: 1
                        clientId:
                          type: string
                          description: Optional client identifier
                          example: CLIENT-001
                        sourceSystemId:
                          type: string
                          description: External source system identifier
                          example: ASSESSMENT-12345
                        mediaFlag:
                          type: integer
                          description: Assessment code ID applied to media-only evidences
                          example: 10002
                        matchedProfiles:
                          type: array
                          items:
                            type: object
                            required:
                            - profileSource
                            - profileId
                            - outcome
                            - adjudicationDate
                            - adjudicatedBy
                            properties:
                              profileSource:
                                type: string
                                enum:
                                - DJID
                                - RPID
                                - HRNID
                                - INTID
                                - LXID
                                - KHID
                                - RZLTID
                                - WCHID
                                description: Identifier domain (e.g., DJID, RPID, HRNID, INTID, LXID, KHID, RZLTID, WCHID)
                                example: DJID
                              profileId:
                                type: string
                                description: Profile identifier within the source domain
                                example: DJ-12345
                              outcome:
                                type: array
                                uniqueItems: true
                                minItems: 1
                                items:
                                  type: integer
                                  minimum: 1
                                description: Array of unique assessment code IDs applied to evidence
                                example:
                                - 10002
                              adjudicationDate:
                                type: string
                                pattern: ^\d{4}-\d{2}-\d{2}$
                                description: Date when adjudication was made (YYYY-MM-DD format, converted to timestamp on storage)
                                example: '2024-01-15'
                              adjudicatedBy:
                                type: string
                                description: Identity of the individual who made the decision
                                example: analyst@company.com
                              ttl:
                                type: integer
                                minimum: 1
                                description: Days until this match expires for auto-disposition purposes
                                example: 365
                              comment:
                                type: string
                                maxLength: 1000
                                description: Free-text comment or notes about the adjudication decision
                                example: Verified against official government records
                          description: Resolved matched profiles (duplicates removed)
                        createdAt:
                          type: integer
                          description: Timestamp when record was created (epoch ms)
                          example: 1705276800000
                        updatedAt:
                          type: integer
                          description: Timestamp when record was last updated (epoch ms)
                          example: 1705363200000
        '400':
          description: Bad request - validation failed
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error message
                  statusCode:
                    type: integer
                    description: HTTP status code
        '401':
          description: Not authorized to use this endpoint
        '403':
          description: Forbidden - insufficient permissions
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error message
                  statusCode:
                    type: integer
                    description: HTTP status code
  /disposition/{disposition_id}:
    get:
      operationId: dispositionGetById
      tags:
      - Disposition
      summary: Get a historical disposition
      description: 'Request to get a historical disposition identified by id ### Rate Limits

        This endpoint is subject to a general rate limit of 10,000 requests per user per 15 minutes.

        '
      security:
      - basicAuth: []
      parameters:
      - name: disposition_id
        in: path
        description: Identifier of the historical disposition
        required: true
        schema:
          type: integer
        example: 42
      responses:
        '200':
          description: Historical disposition retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: integer
                    description: Unique internal identifier
                    example: 1
                  clientId:
                    type: string
                    description: Optional client identifier
                    example: CLIENT-001
                  sourceSystemId:
                    type: string
                    description: External source system identifier
                    example: ASSESSMENT-12345
                  mediaFlag:
                    type: integer
                    description: Assessment code ID applied to media-only evidences
                    example: 10002
                  matchedProfiles:
                    type: array
                    items:
                      type: object
                      required:
                      - profileSource
                      - profileId
                      - outcome
                      - adjudicationDate
                      - adjudicatedBy
                      properties:
                        profileSource:
                          type: string
                          enum:
                          - DJID
                          - RPID
                          - HRNID
                          - INTID
                          - LXID
                          - KHID
                          - RZLTID
                          - WCHID
                          description: Identifier domain (e.g., DJID, RPID, HRNID, INTID, LXID, KHID, RZLTID, WCHID)
                          example: DJID
                        profileId:
                          type: string
                          description: Profile identifier within the source domain
                          example: DJ-12345
                        outcome:
                          type: array
                          uniqueItems: true
                          minItems: 1
                          items:
                            type: integer
                            minimum: 1
                          description: Array of unique assessment code IDs applied to evidence
                          example:
                          - 10002
                        adjudicationDate:
                          type: string
                          pattern: ^\d{4}-\d{2}-\d{2}$
                          description: Date when adjudication was made (YYYY-MM-DD format, converted to timestamp on storage)
                          example: '2024-01-15'
                        adjudicatedBy:
                          type: string
                          description: Identity of the individual who made the decision
                          example: analyst@company.com
                        ttl:
                          type: integer
                          minimum: 1
                          description: Days until this match expires for auto-disposition purposes
                          example: 365
                        comment:
                          type: string
                          maxLength: 1000
                          description: Free-text comment or notes about the adjudication decision
                          example: Verified against official government records
                    description: Resolved matched profiles (duplicates removed)
                  createdAt:
                    type: integer
                    description: Timestamp when record was created (epoch ms)
                    example: 1705276800000
                  updatedAt:
                    type: integer
                    description: Timestamp when record was last updated (epoch ms)
                    example: 1705363200000
        '400':
          description: Bad request - validation failed
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error message
                  statusCode:
                    type: integer
                    description: HTTP status code
        '401':
          description: Not authorized to use this endpoint
        '403':
          description: Forbidden - insufficient permissions
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error message
                  statusCode:
                    type: integer
                    description: HTTP status code
    patch:
      operationId: dispositionUpdate
      tags:
      - Disposition
      summary: Update a historical disposition
      description: 'Request to update a historical disposition in the system ### Rate Limits

        This endpoint is subject to a general rate limit of 10,000 requests per user per 15 minutes.

        '
      security:
      - basicAuth: []
      parameters:
      - name: disposition_id
        in: path
        description: Identifier of the historical disposition
        required: true
        schema:
          type: integer
          minimum: 1
        example: 42
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              description: Partial update payload for an existing historical disposition
              additionalProperties: false
              properties:
                clientId:
                  type: string
                  description: Client identifier associated with the historical disposition
                  example: CLIENT-42
                mediaFlag:
                  type: integer
                  nullable: true
                  minimum: 1
                  description: 'Assessment code ID applied to media-only evidences (null to clear).

                    Available codes:

                    - 10001: Relevant - high confidence evidence references a client correctly associated with risk (relevant: true)

                    - 10002: Not relevant - document is not about the client or a related entity (relevant: false)

                    - 10003: Not relevant - document is not about risk (relevant: false)

                    - 10004: Not relevant - risk in document does not relate to the client (relevant: false)

                    - 10005: Not relevant - this type of document is not useful (relevant: false)

                    - 10006: Not relevant - the matched record could never be the client (relevant: false, breakEntityLink: true)

                    - 10007: Not relevant - the matched record does not contain any risk (relevant: false)

                    - 10008: Not relevant - the matched record is unlikely to be the client (relevant: false)

                    '
                  example: 10002
                sourceSystemId:
                  type: string
                  description: External identifier linking decisions to client record (e.g., assessment ID)
                  example: ASSESSMENT-42
            example:
              sourceSystemId: source-system-id-42
              clientId: client-id-42
              mediaFlag: 10002
      responses:
        '200':
          description: Historical disposition updated successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: integer
                    description: Unique internal identifier
                    example: 1
                  clientId:
                    type: string
                    description: Optional client identifier
                    example: CLIENT-001
                  sourceSystemId:
                    type: string
                    description: External source system identifier
                    example: ASSESSMENT-12345
                  mediaFlag:
                    type: integer
                    description: Assessment code ID applied to media-only evidences
                    example: 10002
                  matchedProfiles:
                    type: array
                    items:
                      type: object
                      required:
                      - profileSource
                      - profileId
                      - outcome
                      - adjudicationDate
                      - adjudicatedBy
                      properties:
                        profileSource:
                          type: string
                          enum:
                          - DJID
                          - RPID
                          - HRNID
                          - INTID
                          - LXID
                          - KHID
                          - RZLTID
                          - WCHID
                          description: Identifier domain (e.g., DJID, RPID, HRNID, INTID, LXID, KHID, RZLTID, WCHID)
                          example: DJID
                        profileId:
                          type: string
                          description: Profile identifier within the source domain
                          example: DJ-12345
                        outcome:
                          type: array
                          uniqueItems: true
                          minItems: 1
                          items:
                            type: integer
                            minimum: 1
                          description: Array of unique assessment code IDs applied to evidence
                          example:
                          - 10002
                        adjudicationDate:
                          type: string
                          pattern: ^\d{4}-\d{2}-\d{2}$
                          description: Date when adjudication was made (YYYY-MM-DD format, converted to timestamp on storage)
                          example: '2024-01-15'
                        adjudicatedBy:
                          type: string
                          description: Identity of the individual who made the decision
                          example: analyst@company.com
                        ttl:
                          type: integer
                          minimum: 1
                          description: Days until this match expires for auto-disposition purposes
                          example: 365
                        comment:
                          type: string
                          maxLength: 1000
                          description: Free-text comment or notes about the adjudication decision
                          example: Verified against official government records
                    description: Resolved matched profiles (duplicates removed)
                  createdAt:
                    type: integer
                    description: Timestamp when record was created (epoch ms)
                    example: 1705276800000
                  updatedAt:
                    type: integer
                    description: Timestamp when record was last updated (epoch ms)
                    example: 1705363200000
        '400':
          description: Bad request - validation failed
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error message
                  statusCode:
                    type: integer
                    description: HTTP status code
        '401':
          description: Not authorized to use this endpoint
        '403':
          description: Forbidden - insufficient permissions
        '404':
          description: Historical disposition not found for the given disposition_id
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error message
                  statusCode:
                    type: integer
                    description: HTTP status code
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    descriptio

# --- truncated at 32 KB (39 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/dow-jones/refs/heads/main/openapi/dow-jones-disposition-api-openapi.yml