Skip to main content

Verification Creation Workflow

1

Get Folder ID

Create folder or get existing folder ID
2

Get Service ID

Get service list and find service ID
3

Submit Verification

Create verification with configuration based on service type
4

Get Results

Poll verification status and get results

Step 1: Get Folder ID

Create Folder

curl -X POST "https://staging-api.anycheck.ai/folders" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "January 2024 NIB Verifications"
  }'

Response

{
  "id": "folder-uuid",
  "group": {
    "id": "group-uuid",
    "name": "My Group"
  },
  "name": "January 2024 NIB Verifications",
  "is_starred": false,
  "total_service": 0,
  "total_result": 0,
  "created_at": "2024-01-15T10:00:00Z",
  "created_by": "user-uuid",
  "updated_at": "2024-01-15T10:00:00Z",
  "updated_by": "user-uuid"
}

Get Existing Folders

curl -X GET "https://staging-api.anycheck.ai/groups/{group_id}/folders?page_size=10&page_offset=0&search=NIB" \
  -H "X-API-Key: YOUR_API_KEY"

Query Parameters

ParameterTypeRequiredDescription
page_sizenumberNoNumber of folders to return per page (default: 10, max: 100)
page_offsetnumberNoNumber of items to skip for pagination (default: 0)
searchstringNoSearch term to filter folders by name (case-insensitive)

Response

{
  "total": 25,
  "items": [
    {
      "id": "folder-uuid",
      "group": {
        "id": "group-uuid",
        "name": "My Group"
      },
      "name": "NIB Verifications January 2024",
      "is_starred": true,
      "total_service": 3,
      "total_result": 15,
      "created_at": "2024-01-15T10:00:00Z",
      "created_by": "user-uuid",
      "updated_at": "2024-01-15T10:00:00Z",
      "updated_by": "user-uuid"
    }
  ]
}

Step 2: Get Service ID

curl -X GET "https://staging-api.anycheck.ai/services" \
  -H "X-API-Key: YOUR_API_KEY"

Response

{
  "total": 11,
  "items": [
    {
      "id": "service-uuid",
      "category": {
        "id": "category-uuid",
        "name": "Ownership Verification",
        "type": "DOCUMENT_VERIFICATION"
      },
      "code": "NIB_CHECK",
      "name": "NIB Check",
      "description": "Verifying business identification and status by checking NIB",
      "icon_file_url": "https://example.com/icon.png",
      "credit_cost_default": 10,
      "action_type": "WEBVIEW",
      "action_param": {},
      "is_enabled": true,
      "created_at": "2024-01-15T10:00:00Z",
      "created_by": "admin-uuid",
      "updated_at": "2024-01-15T10:00:00Z",
      "updated_by": "admin-uuid"
    },
    ...
  ]
}

Step 3: Start Verification

curl -X POST "https://staging-api.anycheck.ai/verifications" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "service_id": "service-uuid",
    "folder_id": "folder-uuid",
    "configuration": {
      "nib": "1234567890123"
    }
  }'

Response

{
  "id": "verification-uuid",
  "service": {
    "id": "service-uuid",
    "name": "NIB Check"
  },
  "user_id": "user-uuid", // if by Token
  "api_key": "api-key", // if by API Key
  "folder_id": "folder-uuid",
  "result_id": "result-uuid",
  "execution_time": 0,
  "status": "IN_QUEUE",
  "start_date": null,
  "end_date": null,
  "input_config": {
    "nib": "1234567890123"
  },
  "input_file_url": null,
  "output": null,
  "output_file_url": null,
  "output_status": null,
  "external_job_id": null,
  "webhook_url": null,
  "webhook_metadata": null,
  "export_file_url": null,
  "credit_used": 0,
  "total_files": 0,
  "total_pages": 0
}

Step 4: Get Results

curl -X GET "https://staging-api.anycheck.ai/verifications/verification-uuid" \
  -H "X-API-Key: YOUR_API_KEY"

Response

{
  "id": "verification-uuid",
  "service": {
    "id": "service-uuid",
    "name": "NIB Check"
  },
  "user_id": "user-uuid", // if by Token
  "api_key": "api-key", // if by API Key
  "folder_id": "folder-uuid",
  "result_id": "result-uuid",
  "execution_time": 12.5,
  "status": "COMPLETED",
  "start_date": "2024-01-15T10:05:00Z",
  "end_date": "2024-01-15T10:05:12Z",
  "input_config": {
    "nib": "1234567890123"
  },
  "input_file_url": null,
  "output": {
    "is_valid_nib": true,
    "business_data": {
      "nib": "1234567890123",
      "company_name": "PT ABC XYZ",
      "owner_name": null,
      "active_status": "ACTIVE",
      "migration_status": "OSS RBA",
      "investment_type": "PMA",
      "business_scale": "LARGE"
    }
  },
  "output_file_url": "https://example.com/output.json",
  "output_status": "VERIFIED",
  "external_job_id": null,
  "webhook_url": null,
  "webhook_metadata": null,
  "export_file_url": null,
  "credit_used": 10,
  "total_files": 0,
  "total_pages": 0
}

NIB Input Configuration

{
  "nib": "1234567890123"
}

Input Fields

FieldTypeRequiredDescription
nibstringYes13-digit Nomor Induk Berusaha (Business Identification Number)

NIB Output

{
  "output": {
    "is_valid_nib": true,
    "business_data": {
      "nib": "1234567890123",
      "company_name": "PT ABC XYZ",
      "owner_name": null,
      "active_status": "ACTIVE",
      "migration_status": "OSS RBA",
      "investment_type": "PMA",
      "business_scale": "LARGE"
    }
  }
}

Output Fields

FieldTypeDescriptionPossible Values
is_valid_nibboolean | nullIndicates if the NIB is valid and found in databasetrue, false, null
business_dataobject | nullComplete business information from government registryObject with business details or null

Business Data Fields

FieldTypeDescriptionPossible Values
nibstringThe verified NIB number13-digit numberic string
company_namestringOfficial registered company name (NIB Badan Usaha)Any valid company name
owner_namestringOfficial registered owner name (NIB Perorangan)Any valid name
active_statusstringCurrent business operational status"ACTIVE", "INACTIVE"
migration_statusstringOSS (Online Single Submission) migration status"OSS RBA", "NON OSS", etc.
investment_typestringType of investment classification"PMA" (Foreign), "PMDN" (Domestic), etc.
business_scalestringBusiness size classification"LARGE", "MEDIUM", "SMALL", "MICRO"

Response Example

Valid NIB Found:
{
  "output": {
    "is_valid_nib": true,
    "business_data": {
      "nib": "1234567890123",
      "company_name": "PT ABC XYZ",
      "owner_name": null,
      "active_status": "ACTIVE",
      "migration_status": "OSS RBA",
      "investment_type": "PMA",
      "business_scale": "LARGE"
    }
  }
}
Invalid NIB:
{
  "output": {
    "is_valid_nib": false
  }
}
Service Error:
{
  "output": {
    "error": "Unexpected error occured",
    "retry_count": 2
  }
}