Skip to content
API Reference/
/
Retrieve an individual en...

BNDRY API (v1alpha)

API for the BNDRY platform

Download OpenAPI description
openapi.json
openapi.yaml
Overview
License

MIT License

Languages
Servers
Mock server

https://docs.bndry.net/_mock/apis/openapi/

BNDRY API

https://api.bndry.app/

Forms

Operations

Entities

Operations

Entity Risk Rating

Service for managing risk rating jobs for individual entities.

Operations

Individual Entity Verification

Service for managing individual entity verification jobs.

Operations

Retrieve an individual entity verification job

Request

Retrieves details about a specific individual entity verification job.

Security
oauth2_client_credentials or oauth2_authorization_code
Path
individualEntityVerificationJobstringrequired

The individualEntityVerificationJob id.

curl -i -X GET \
  'https://docs.bndry.net/_mock/apis/openapi/v1alpha/individualEntityVerificationJobs/{individualEntityVerificationJob}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Success

Bodyapplication/json
namestring(name)

(IDENTIFIER) Output only. The resource name of the job. Format: individualEntityVerificationJobs/{individual_entity_verification_job} correct_name_format // name must follow format 'individualEntityVerificationJobs/*' string.example = ["individualEntityVerificationJobs/verification-job-2024-0127-kycind-743891"]

providerConfigobject(bndry.api.risk.entities.v1alpha.ProviderConfig)required
providerConfig.​truuthVerificationConfigobject(bndry.api.risk.truuth.v1alpha.TruuthVerificationConfig)
enrichEntityboolean(enrich_entity)

(OPTIONAL) Optional. If true, entity will be enriched by verification response. TODO: Implement this logic

webhookUristring(uri)(webhook_uri)required

Required. Webhook target URI for notifications. string.example = ["https://api.example.com/webhooks/onboarding/individual/entity-job-status"] string.uri = true // value must be a valid URI string.uri_empty = true // value is empty, which is not a valid URI

createTimestring(date-time)(google.protobuf.Timestamp)read-only
updateTimestring(date-time)(google.protobuf.Timestamp)read-only
Response
application/json
{
  "name": "individualEntityVerificationJobs/verification-job-2024-0127-kycind-743891",
  "providerConfig": {
    "truuthVerificationConfig": { … }
  },
  "enrichEntity": true,
  "webhookUri": "https://api.example.com/webhooks/onboarding/individual/entity-job-status",
  "createTime": "2023-01-15T01:30:15.01Z",
  "updateTime": "2023-01-15T01:30:15.01Z"
}

List individual entity verification jobs

Request

Lists individual entity verification jobs for a specific entity.

Security
oauth2_client_credentials or oauth2_authorization_code
Query
pageSizeinteger(int32)(page_size)

Optional. The maximum number of jobs to return. The service may return fewer than this value. If unspecified, at most 10 jobs will be returned. The maximum value is 100; values above 100 will be coerced to 100.

pageTokenstring(page_token)

Optional. A page token, received from a previous ListIndividualEntityVerificationJobs call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListIndividualEntityVerificationJobs must match the call that provided the page token.

skipinteger(int32)(skip)>= 0

Optional. The number of jobs to skip before starting to collect the result set.

curl -i -X GET \
  'https://docs.bndry.net/_mock/apis/openapi/v1alpha/individualEntityVerificationJobs?pageSize=25&pageToken=ChAIAhABGAEiAggC&skip=0' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Success

Bodyapplication/json
individualEntityVerificationJobsArray of objects(individual_entity_verification_jobs)

The list of individual entity verification jobs.

nextPageTokenstring(next_page_token)

A token to retrieve the next page of results, or empty if there are no more results in the list. string.example = ["ChAIAhABGAEiAggD"]

totalSizeinteger(int32)(total_size)

The total number of jobs matching the request. int32.example = [47]

Response
application/json
{
  "individualEntityVerificationJobs": [
    { … }
  ],
  "nextPageToken": "ChAIAhABGAEiAggD",
  "totalSize": 47
}

Create an individual entity verification job

Request

Creates a new individual entity verification job.

Security
oauth2_client_credentials or oauth2_authorization_code
Query
individualEntityVerificationJobIdstring(individual_entity_verification_job_id)[ 4 .. 63 ] charactersrequired

REQUIRED. The ID to use for the job, which will become the final component of the job's resource name. This value should be 4-63 characters, and valid characters are /[a-z][0-9]-/.

Bodyapplication/json

Required. The individual entity verification job to create.

namestring(name)

(IDENTIFIER) Output only. The resource name of the job. Format: individualEntityVerificationJobs/{individual_entity_verification_job} correct_name_format // name must follow format 'individualEntityVerificationJobs/*' string.example = ["individualEntityVerificationJobs/verification-job-2024-0127-kycind-743891"]

providerConfigobject(bndry.api.risk.entities.v1alpha.ProviderConfig)required
providerConfig.​truuthVerificationConfigobject(bndry.api.risk.truuth.v1alpha.TruuthVerificationConfig)
enrichEntityboolean(enrich_entity)

(OPTIONAL) Optional. If true, entity will be enriched by verification response. TODO: Implement this logic

webhookUristring(uri)(webhook_uri)required

Required. Webhook target URI for notifications. string.example = ["https://api.example.com/webhooks/onboarding/individual/entity-job-status"] string.uri = true // value must be a valid URI string.uri_empty = true // value is empty, which is not a valid URI

curl -i -X POST \
  'https://docs.bndry.net/_mock/apis/openapi/v1alpha/individualEntityVerificationJobs?individualEntityVerificationJobId=verification-001' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "individualEntityVerificationJobs/verification-job-2024-0127-kycind-743891",
    "providerConfig": {
      "truuthVerificationConfig": {
        "verificationType": "TRUUTH_VERIFICATION_TYPE_UNSPECIFIED"
      }
    },
    "enrichEntity": true,
    "webhookUri": "https://api.example.com/webhooks/onboarding/individual/entity-job-status",
    "createTime": "2023-01-15T01:30:15.01Z",
    "updateTime": "2023-01-15T01:30:15.01Z"
  }'

Responses

Success

Bodyapplication/json
namestring(name)

(IDENTIFIER) Output only. The resource name of the job. Format: individualEntityVerificationJobs/{individual_entity_verification_job} correct_name_format // name must follow format 'individualEntityVerificationJobs/*' string.example = ["individualEntityVerificationJobs/verification-job-2024-0127-kycind-743891"]

providerConfigobject(bndry.api.risk.entities.v1alpha.ProviderConfig)required
providerConfig.​truuthVerificationConfigobject(bndry.api.risk.truuth.v1alpha.TruuthVerificationConfig)
enrichEntityboolean(enrich_entity)

(OPTIONAL) Optional. If true, entity will be enriched by verification response. TODO: Implement this logic

webhookUristring(uri)(webhook_uri)required

Required. Webhook target URI for notifications. string.example = ["https://api.example.com/webhooks/onboarding/individual/entity-job-status"] string.uri = true // value must be a valid URI string.uri_empty = true // value is empty, which is not a valid URI

createTimestring(date-time)(google.protobuf.Timestamp)read-only
updateTimestring(date-time)(google.protobuf.Timestamp)read-only
Response
application/json
{
  "name": "individualEntityVerificationJobs/verification-job-2024-0127-kycind-743891",
  "providerConfig": {
    "truuthVerificationConfig": { … }
  },
  "enrichEntity": true,
  "webhookUri": "https://api.example.com/webhooks/onboarding/individual/entity-job-status",
  "createTime": "2023-01-15T01:30:15.01Z",
  "updateTime": "2023-01-15T01:30:15.01Z"
}

Run an individual entity verification job

Request

Runs an individual entity verification job.

Security
oauth2_client_credentials or oauth2_authorization_code
Path
individualEntityVerificationJobstringrequired

The individualEntityVerificationJob id.

Bodyapplication/jsonrequired
entityResourceNamestring(entity_resource_name)required

Required. The resource name of the entity to verify. Format: entities/{entity} correct_entity_format // entity must follow format 'entities/*' string.example = ["entities/john-smith-001"]

redirectUristring(uri)(redirect_uri)required

Required. The final redirect URI where the user should be sent after verification is complete. string.example = ["https://app.example.com/verification/complete"] string.uri = true // value must be a valid URI string.uri_empty = true // value is empty, which is not a valid URI

curl -i -X POST \
  'https://docs.bndry.net/_mock/apis/openapi/v1alpha/individualEntityVerificationJobs/{individualEntityVerificationJob}:run' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "entityResourceName": "entities/john-smith-001",
    "redirectUri": "https://app.example.com/verification/complete"
  }'

Responses

Success

Bodyapplication/json
One of:

This resource represents a long-running operation that is the result of a network API call.

namestring(name)

The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should be a resource name ending with operations/{unique_id}.

metadataobject(google.protobuf.Any)
doneboolean(done)

If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.

errorobject(google.rpc.Status)required
error.​codeinteger(int32)(code)

The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].

error.​messagestring(message)

A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.

error.​detailsArray of objects(details)

A list of messages that carry the error details. There is a common set of message types for APIs to use.

Response
application/json
{
  "name": "string",
  "metadata": {
    "type": "string",
    "value": "string"
  },
  "done": true,
  "error": {
    "code": 0,
    "message": "string",
    "details": [ … ]
  }
}

GetOperation

Request

Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.

Security
oauth2_client_credentials or oauth2_authorization_code
Path
individualEntityVerificationJobstringrequired

The individualEntityVerificationJob id.

operationstringrequired

The operation id.

curl -i -X GET \
  'https://docs.bndry.net/_mock/apis/openapi/v1alpha/individualEntityVerificationJobs/{individualEntityVerificationJob}/operations/{operation}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Success

Bodyapplication/json
One of:

This resource represents a long-running operation that is the result of a network API call.

namestring(name)

The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should be a resource name ending with operations/{unique_id}.

metadataobject(google.protobuf.Any)
doneboolean(done)

If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.

errorobject(google.rpc.Status)required
error.​codeinteger(int32)(code)

The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].

error.​messagestring(message)

A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.

error.​detailsArray of objects(details)

A list of messages that carry the error details. There is a common set of message types for APIs to use.

Response
application/json
{
  "name": "string",
  "metadata": {
    "type": "string",
    "value": "string"
  },
  "done": true,
  "error": {
    "code": 0,
    "message": "string",
    "details": [ … ]
  }
}

Onboard Individual Entity

Service for managing individual entity onboarding jobs.

Operations

Entity PEP Sanctions Check

Service for managing PEP and sanctions screening jobs for individual entities.

Operations