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

Start Verification

Create verification with NIB configuration
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 "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "January 2024 NIB Verifications",
    "description": "Business registration verifications for January 2024"
  }'

​
Response

{
  "id": "3f8e9a2b-4c5d-6e7f-8g9h-1i2j3k4l5m6n",
  "group": {
    "id": "2e5eb232-1954-4ee0-8ca5-ac7b5ebd02d9",
    "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 "Authorization: Bearer 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": "3f8e9a2b-4c5d-6e7f-8g9h-1i2j3k4l5m6n",
      "group": {
        "id": "2e5eb232-1954-4ee0-8ca5-ac7b5ebd02d9",
        "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 "Authorization: Bearer YOUR_API_KEY"

​
Response

{
  "total": 1,
  "items": [
    {
      "id": "4b7e2a8d-9c1f-4e3b-8a2d-5c9e1f7a3b8d",
      "category": {
        "id": "199fcc58-b5c3-45a9-8e0c-46f10e13d33d",
        "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 "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "service_id": "4b7e2a8d-9c1f-4e3b-8a2d-5c9e1f7a3b8d",
    "folder_id": "3f8e9a2b-4c5d-6e7f-8g9h-1i2j3k4l5m6n",
    "configuration": {
      "nib": 1234567890
    }
  }'

​
Response

{
  "id": "8e7c3a1f-2b5d-4a9e-8c7f-9e1a3b5c7d9f",
  "service": {
    "id": "4b7e2a8d-9c1f-4e3b-8a2d-5c9e1f7a3b8d",
    "name": "NIB Verification"
  },
  "user_id": "user-uuid", // if by Token
  "api_key": "api-key", // if by API Key
  "folder_id": "3f8e9a2b-4c5d-6e7f-8g9h-1i2j3k4l5m6n",
  "result_id": "result-uuid",
  "execution_time": 0,
  "status": "IN_QUEUE",
  "start_date": null,
  "end_date": null,
  "input_config": {
    "nib": 1234567890
  },
  "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/8e7c3a1f-2b5d-4a9e-8c7f-9e1a3b5c7d9f \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

{
  "id": "8e7c3a1f-2b5d-4a9e-8c7f-9e1a3b5c7d9f",
  "service": {
    "id": "4b7e2a8d-9c1f-4e3b-8a2d-5c9e1f7a3b8d",
    "name": "NIB Verification"
  },
  "user_id": "user-uuid", // if by Token
  "api_key": "api-key", // if by API Key
  "folder_id": "3f8e9a2b-4c5d-6e7f-8g9h-1i2j3k4l5m6n",
  "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": 1234567890
  },
  "input_file_url": null,
  "output": {
    "is_valid_nib": true,
    "business_data": {
      "nib": 1234567890,
      "company_name": "PT ABC XYZ",
      "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": 1234567890,
      "company_name": "PT ABC XYZ",
      "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 nameAny valid company 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", "SMALL"

​
Response Example

Valid NIB Found: 
{
  "output": {
    "is_valid_nib": true,
    "business_data": {
      "nib": 1234567890123,
      "company_name": "PT ABC XYZ",
      "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
  }
}