Topograph · Arazzo Workflow

Resolve a company and retrieve KYB data

Version 1.0.0

Search for a company, request its data and documents, then poll for the result.

1 workflow 2 source APIs 1 provider
View Spec View on GitHub CompanyKYBCompany DataBusiness RegistersComplianceIdentity VerificationBeneficial OwnershipAMLDue DiligenceFintechArazzoWorkflows

Provider

topograph

Workflows

resolveAndRetrieveCompany
Search-first resolution, then request company data and poll by requestId.
3 steps inputs: countryCode, dataPoints, query outputs: requestId

Source API Descriptions

Arazzo Workflow Specification

Raw ↑
arazzo: 1.0.1
info:
  title: Resolve a company and retrieve KYB data
  version: 1.0.0
  summary: Search for a company, request its data and documents, then poll for the result.
sourceDescriptions:
- name: dataApi
  url: ../openapi/topograph-data-api-openapi.yml
  type: openapi
- name: searchApi
  url: ../openapi/topograph-search-api-openapi.yml
  type: openapi
workflows:
- workflowId: resolveAndRetrieveCompany
  summary: Search-first resolution, then request company data and poll by requestId.
  inputs:
    type: object
    required: [countryCode, query]
    properties:
      countryCode: {type: string, example: FR}
      query: {type: string, example: Acme SAS}
      dataPoints: {type: array, items: {type: string}, example: [shareholders, ultimateBeneficialOwners]}
  steps:
  - stepId: search
    operationId: SearchController_searchV2_v2
    parameters:
    - name: countryCode
      in: query
      value: $inputs.countryCode
    - name: query
      in: query
      value: $inputs.query
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      companyId: $response.body#/0/id
  - stepId: requestCompany
    operationId: CompanyController_getCompany_v2
    requestBody:
      contentType: application/json
      payload:
        id: $steps.search.outputs.companyId
        countryCode: $inputs.countryCode
        dataPoints: $inputs.dataPoints
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      requestId: $response.body#/requestId
  - stepId: pollResult
    operationId: CompanyController_getCompanyRequest_v2
    parameters:
    - name: requestId
      in: path
      value: $steps.requestCompany.outputs.requestId
    successCriteria:
    - condition: $statusCode == 200
  outputs:
    requestId: $steps.requestCompany.outputs.requestId

Work with this as data

Every workflow 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 arazzo workflows

4 MCP tools reach this
  • find_arazzoBrowse and filter every workflow in the catalog.
  • 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 workflow
curl "https://apis.io/api/v1/arazzo/topograph-resolve-and-retrieve"
All arazzo workflows
curl "https://apis.io/api/v1/arazzo?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.