Persona · Capability

Persona API

The Persona API enables identity verification, fraud prevention, and Know Your Customer (KYC) workflows. Use the API to create and manage inquiries, accounts, verifications, reports, transactions, lists, and webhooks for verifying users via document checks, selfie checks, and database lookups.

Run with Naftiko PersonaAPI

What You Can Do

GET
Listaccounts — List all Accounts
/accounts
POST
Createaccount — Create an Account
/accounts
GET
Retrieveaccount — Retrieve an Account
/accounts/{id}
PATCH
Updateaccount — Update an Account
/accounts/{id}
POST
Redactaccount — Redact an Account
/accounts/{id}/redact
POST
Addaccounttag — Add tag to an Account
/accounts/{id}/tags
DELETE
Removeaccounttag — Remove tag from an Account
/accounts/{id}/tags
GET
Listaccountrelations — Get all relations for an Account
/accounts/{id}/relations
POST
Consolidateaccounts — Consolidate Accounts
/accounts/consolidate
POST
Searchaccounts — Search Accounts
/accounts/search
GET
Listinquiries — List all Inquiries
/inquiries
POST
Createinquiry — Create an Inquiry
/inquiries
GET
Retrieveinquiry — Retrieve an Inquiry
/inquiries/{id}
PATCH
Updateinquiry — Update an Inquiry
/inquiries/{id}
POST
Redactinquiry — Redact an Inquiry
/inquiries/{id}/redact
POST
Approveinquiry — Approve an Inquiry
/inquiries/{id}/approve
POST
Declineinquiry — Decline an Inquiry
/inquiries/{id}/decline
POST
Expireinquiry — Expire an Inquiry
/inquiries/{id}/expire
POST
Retrieveverification — Retrieve a Verification
/verifications/{id}
GET
Listreports — List all Reports
/reports
POST
Createreport — Create a Report
/reports
GET
Retrievereport — Retrieve a Report
/reports/{id}
GET
Listlists — List all Lists
/lists
POST
Createlist — Create a List
/lists
GET
Listtransactions — List all Transactions
/transactions
POST
Createtransaction — Create a Transaction
/transactions
GET
Listwebhooks — List all Webhooks
/webhooks
POST
Createwebhook — Create a Webhook
/webhooks

MCP Tools

listaccounts

List all Accounts

read-only idempotent
createaccount

Create an Account

retrieveaccount

Retrieve an Account

read-only idempotent
updateaccount

Update an Account

redactaccount

Redact an Account

addaccounttag

Add tag to an Account

removeaccounttag

Remove tag from an Account

idempotent
listaccountrelations

Get all relations for an Account

read-only idempotent
consolidateaccounts

Consolidate Accounts

searchaccounts

Search Accounts

listinquiries

List all Inquiries

read-only idempotent
createinquiry

Create an Inquiry

retrieveinquiry

Retrieve an Inquiry

read-only idempotent
updateinquiry

Update an Inquiry

redactinquiry

Redact an Inquiry

approveinquiry

Approve an Inquiry

declineinquiry

Decline an Inquiry

expireinquiry

Expire an Inquiry

retrieveverification

Retrieve a Verification

listreports

List all Reports

read-only idempotent
createreport

Create a Report

retrievereport

Retrieve a Report

read-only idempotent
listlists

List all Lists

read-only idempotent
createlist

Create a List

listtransactions

List all Transactions

read-only idempotent
createtransaction

Create a Transaction

listwebhooks

List all Webhooks

read-only idempotent
createwebhook

Create a Webhook

Capability Spec

persona-capability.yaml Raw ↑ 
naftiko: 1.0.0-alpha2
info:
  label: Persona API
  description: The Persona API enables identity verification, fraud prevention, and Know Your Customer (KYC) workflows. Use
    the API to create and manage inquiries, accounts, verifications, reports, transactions, lists, and webhooks for verifying
    users via document checks, selfie checks, and database lookups.
  tags:
  - Persona
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: persona
    baseUri: https://withpersona.com/api/v1
    description: Persona API HTTP API.
    authentication:
      type: bearer
      token: '{{PERSONA_TOKEN}}'
    resources:
    - name: accounts
      path: /accounts
      operations:
      - name: listaccounts
        method: GET
        description: List all Accounts
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createaccount
        method: POST
        description: Create an Account
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: accounts-id
      path: /accounts/{id}
      operations:
      - name: retrieveaccount
        method: GET
        description: Retrieve an Account
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateaccount
        method: PATCH
        description: Update an Account
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: accounts-id-redact
      path: /accounts/{id}/redact
      operations:
      - name: redactaccount
        method: POST
        description: Redact an Account
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: accounts-id-tags
      path: /accounts/{id}/tags
      operations:
      - name: addaccounttag
        method: POST
        description: Add tag to an Account
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: removeaccounttag
        method: DELETE
        description: Remove tag from an Account
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: accounts-id-relations
      path: /accounts/{id}/relations
      operations:
      - name: listaccountrelations
        method: GET
        description: Get all relations for an Account
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: accounts-consolidate
      path: /accounts/consolidate
      operations:
      - name: consolidateaccounts
        method: POST
        description: Consolidate Accounts
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: accounts-search
      path: /accounts/search
      operations:
      - name: searchaccounts
        method: POST
        description: Search Accounts
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: inquiries
      path: /inquiries
      operations:
      - name: listinquiries
        method: GET
        description: List all Inquiries
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createinquiry
        method: POST
        description: Create an Inquiry
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: inquiries-id
      path: /inquiries/{id}
      operations:
      - name: retrieveinquiry
        method: GET
        description: Retrieve an Inquiry
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateinquiry
        method: PATCH
        description: Update an Inquiry
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: inquiries-id-redact
      path: /inquiries/{id}/redact
      operations:
      - name: redactinquiry
        method: POST
        description: Redact an Inquiry
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: inquiries-id-approve
      path: /inquiries/{id}/approve
      operations:
      - name: approveinquiry
        method: POST
        description: Approve an Inquiry
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: inquiries-id-decline
      path: /inquiries/{id}/decline
      operations:
      - name: declineinquiry
        method: POST
        description: Decline an Inquiry
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: inquiries-id-expire
      path: /inquiries/{id}/expire
      operations:
      - name: expireinquiry
        method: POST
        description: Expire an Inquiry
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: verifications-id
      path: /verifications/{id}
      operations:
      - name: retrieveverification
        method: POST
        description: Retrieve a Verification
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: reports
      path: /reports
      operations:
      - name: listreports
        method: GET
        description: List all Reports
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createreport
        method: POST
        description: Create a Report
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: reports-id
      path: /reports/{id}
      operations:
      - name: retrievereport
        method: GET
        description: Retrieve a Report
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: lists
      path: /lists
      operations:
      - name: listlists
        method: GET
        description: List all Lists
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createlist
        method: POST
        description: Create a List
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: transactions
      path: /transactions
      operations:
      - name: listtransactions
        method: GET
        description: List all Transactions
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createtransaction
        method: POST
        description: Create a Transaction
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: webhooks
      path: /webhooks
      operations:
      - name: listwebhooks
        method: GET
        description: List all Webhooks
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createwebhook
        method: POST
        description: Create a Webhook
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: persona-rest
    description: REST adapter for Persona API.
    resources:
    - path: /accounts
      name: listaccounts
      operations:
      - method: GET
        name: listaccounts
        description: List all Accounts
        call: persona.listaccounts
        outputParameters:
        - type: object
          mapping: $.
    - path: /accounts
      name: createaccount
      operations:
      - method: POST
        name: createaccount
        description: Create an Account
        call: persona.createaccount
        outputParameters:
        - type: object
          mapping: $.
    - path: /accounts/{id}
      name: retrieveaccount
      operations:
      - method: GET
        name: retrieveaccount
        description: Retrieve an Account
        call: persona.retrieveaccount
        outputParameters:
        - type: object
          mapping: $.
    - path: /accounts/{id}
      name: updateaccount
      operations:
      - method: PATCH
        name: updateaccount
        description: Update an Account
        call: persona.updateaccount
        outputParameters:
        - type: object
          mapping: $.
    - path: /accounts/{id}/redact
      name: redactaccount
      operations:
      - method: POST
        name: redactaccount
        description: Redact an Account
        call: persona.redactaccount
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /accounts/{id}/tags
      name: addaccounttag
      operations:
      - method: POST
        name: addaccounttag
        description: Add tag to an Account
        call: persona.addaccounttag
        outputParameters:
        - type: object
          mapping: $.
    - path: /accounts/{id}/tags
      name: removeaccounttag
      operations:
      - method: DELETE
        name: removeaccounttag
        description: Remove tag from an Account
        call: persona.removeaccounttag
        outputParameters:
        - type: object
          mapping: $.
    - path: /accounts/{id}/relations
      name: listaccountrelations
      operations:
      - method: GET
        name: listaccountrelations
        description: Get all relations for an Account
        call: persona.listaccountrelations
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /accounts/consolidate
      name: consolidateaccounts
      operations:
      - method: POST
        name: consolidateaccounts
        description: Consolidate Accounts
        call: persona.consolidateaccounts
        outputParameters:
        - type: object
          mapping: $.
    - path: /accounts/search
      name: searchaccounts
      operations:
      - method: POST
        name: searchaccounts
        description: Search Accounts
        call: persona.searchaccounts
        outputParameters:
        - type: object
          mapping: $.
    - path: /inquiries
      name: listinquiries
      operations:
      - method: GET
        name: listinquiries
        description: List all Inquiries
        call: persona.listinquiries
        outputParameters:
        - type: object
          mapping: $.
    - path: /inquiries
      name: createinquiry
      operations:
      - method: POST
        name: createinquiry
        description: Create an Inquiry
        call: persona.createinquiry
        outputParameters:
        - type: object
          mapping: $.
    - path: /inquiries/{id}
      name: retrieveinquiry
      operations:
      - method: GET
        name: retrieveinquiry
        description: Retrieve an Inquiry
        call: persona.retrieveinquiry
        outputParameters:
        - type: object
          mapping: $.
    - path: /inquiries/{id}
      name: updateinquiry
      operations:
      - method: PATCH
        name: updateinquiry
        description: Update an Inquiry
        call: persona.updateinquiry
        outputParameters:
        - type: object
          mapping: $.
    - path: /inquiries/{id}/redact
      name: redactinquiry
      operations:
      - method: POST
        name: redactinquiry
        description: Redact an Inquiry
        call: persona.redactinquiry
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /inquiries/{id}/approve
      name: approveinquiry
      operations:
      - method: POST
        name: approveinquiry
        description: Approve an Inquiry
        call: persona.approveinquiry
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /inquiries/{id}/decline
      name: declineinquiry
      operations:
      - method: POST
        name: declineinquiry
        description: Decline an Inquiry
        call: persona.declineinquiry
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /inquiries/{id}/expire
      name: expireinquiry
      operations:
      - method: POST
        name: expireinquiry
        description: Expire an Inquiry
        call: persona.expireinquiry
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /verifications/{id}
      name: retrieveverification
      operations:
      - method: POST
        name: retrieveverification
        description: Retrieve a Verification
        call: persona.retrieveverification
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /reports
      name: listreports
      operations:
      - method: GET
        name: listreports
        description: List all Reports
        call: persona.listreports
        outputParameters:
        - type: object
          mapping: $.
    - path: /reports
      name: createreport
      operations:
      - method: POST
        name: createreport
        description: Create a Report
        call: persona.createreport
        outputParameters:
        - type: object
          mapping: $.
    - path: /reports/{id}
      name: retrievereport
      operations:
      - method: GET
        name: retrievereport
        description: Retrieve a Report
        call: persona.retrievereport
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /lists
      name: listlists
      operations:
      - method: GET
        name: listlists
        description: List all Lists
        call: persona.listlists
        outputParameters:
        - type: object
          mapping: $.
    - path: /lists
      name: createlist
      operations:
      - method: POST
        name: createlist
        description: Create a List
        call: persona.createlist
        outputParameters:
        - type: object
          mapping: $.
    - path: /transactions
      name: listtransactions
      operations:
      - method: GET
        name: listtransactions
        description: List all Transactions
        call: persona.listtransactions
        outputParameters:
        - type: object
          mapping: $.
    - path: /transactions
      name: createtransaction
      operations:
      - method: POST
        name: createtransaction
        description: Create a Transaction
        call: persona.createtransaction
        outputParameters:
        - type: object
          mapping: $.
    - path: /webhooks
      name: listwebhooks
      operations:
      - method: GET
        name: listwebhooks
        description: List all Webhooks
        call: persona.listwebhooks
        outputParameters:
        - type: object
          mapping: $.
    - path: /webhooks
      name: createwebhook
      operations:
      - method: POST
        name: createwebhook
        description: Create a Webhook
        call: persona.createwebhook
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: persona-mcp
    transport: http
    description: MCP adapter for Persona API for AI agent use.
    tools:
    - name: listaccounts
      description: List all Accounts
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: persona.listaccounts
      outputParameters:
      - type: object
        mapping: $.
    - name: createaccount
      description: Create an Account
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: persona.createaccount
      outputParameters:
      - type: object
        mapping: $.
    - name: retrieveaccount
      description: Retrieve an Account
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: persona.retrieveaccount
      outputParameters:
      - type: object
        mapping: $.
    - name: updateaccount
      description: Update an Account
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: persona.updateaccount
      outputParameters:
      - type: object
        mapping: $.
    - name: redactaccount
      description: Redact an Account
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: persona.redactaccount
      with:
        id: tools.id
      inputParameters:
      - name: id
        type: string
        description: id
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: addaccounttag
      description: Add tag to an Account
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: persona.addaccounttag
      outputParameters:
      - type: object
        mapping: $.
    - name: removeaccounttag
      description: Remove tag from an Account
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: persona.removeaccounttag
      outputParameters:
      - type: object
        mapping: $.
    - name: listaccountrelations
      description: Get all relations for an Account
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: persona.listaccountrelations
      with:
        id: tools.id
      inputParameters:
      - name: id
        type: string
        description: id
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: consolidateaccounts
      description: Consolidate Accounts
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: persona.consolidateaccounts
      outputParameters:
      - type: object
        mapping: $.
    - name: searchaccounts
      description: Search Accounts
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: persona.searchaccounts
      outputParameters:
      - type: object
        mapping: $.
    - name: listinquiries
      description: List all Inquiries
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: persona.listinquiries
      outputParameters:
      - type: object
        mapping: $.
    - name: createinquiry
      description: Create an Inquiry
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: persona.createinquiry
      outputParameters:
      - type: object
        mapping: $.
    - name: retrieveinquiry
      description: Retrieve an Inquiry
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: persona.retrieveinquiry
      outputParameters:
      - type: object
        mapping: $.
    - name: updateinquiry
      description: Update an Inquiry
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: persona.updateinquiry
      outputParameters:
      - type: object
        mapping: $.
    - name: redactinquiry
      description: Redact an Inquiry
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: persona.redactinquiry
      with:
        id: tools.id
      inputParameters:
      - name: id
        type: string
        description: id
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: approveinquiry
      description: Approve an Inquiry
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: persona.approveinquiry
      with:
        id: tools.id
      inputParameters:
      - name: id
        type: string
        description: id
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: declineinquiry
      description: Decline an Inquiry
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: persona.declineinquiry
      with:
        id: tools.id
      inputParameters:
      - name: id
        type: string
        description: id
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: expireinquiry
      description: Expire an Inquiry
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: persona.expireinquiry
      with:
        id: tools.id
      inputParameters:
      - name: id
        type: string
        description: id
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: retrieveverification
      description: Retrieve a Verification
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: persona.retrieveverification
      with:
        id: tools.id
      inputParameters:
      - name: id
        type: string
        description: id
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: listreports
      description: List all Reports
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: persona.listreports
      outputParameters:
      - type: object
        mapping: $.
    - name: createreport
      description: Create a Report
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: persona.createreport
      outputParameters:
      - type: object
        mapping: $.
    - name: retrievereport
      description: Retrieve a Report
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: persona.retrievereport
      with:
        id: tools.id
      inputParameters:
      - name: id
        type: string
        description: id
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: listlists
      description: List all Lists
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: persona.listlists
      outputParameters:
      - type: object
        mapping: $.
    - name: createlist
      description: Create a List
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: persona.createlist
      outputParameters:
      - type: object
        mapping: $.
    - name: listtransactions
      description: List all Transactions
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: persona.listtransactions
      outputParameters:
      - type: object
        mapping: $.
    - name: createtransaction
      description: Create a Transaction
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: persona.createtransaction
      outputParameters:
      - type: object
        mapping: $.
    - name: listwebhooks
      description: List all Webhooks
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: persona.listwebhooks
      outputParameters:
      - type: object
        mapping: $.
    - name: createwebhook
      description: Create a Webhook
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: persona.createwebhook
      outputParameters:
      - type: object
        mapping: $.
binds:
- namespace: env
  keys:
    PERSONA_TOKEN: PERSONA_TOKEN