OneID Documentation & Support

Comprehensive guides, API references, and troubleshooting resources for the OneID platform.

Last updated: November 2025 API v2.1.0 PCI DSS Compliant

Overview

OneID is a unified digital identity platform that enables citizens to access government services across multiple cities through a single, secure account. This documentation provides comprehensive information for users, developers, and administrators.

For Users

Learn how to create an account, access services, and manage your digital identity.

For Developers

API documentation, integration guides, and SDK references for system integration.

For Cities

Onboarding process, service integration, and administration guides for partner cities.

API Documentation

The OneID REST API provides programmatic access to platform functionality. All API endpoints require authentication and use JSON for request/response formatting.

POST
Create User Session
/api/v2/auth/login

Authenticate a user and obtain access token.

Request Body:

{
  "username": "user@example.com",
  "password": "securepassword123",
  "remember_me": false
}
                    
Response:

{
  "success": true,
  "data": {
    "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "refresh_token": "dGhpcyBpcyBhIHJlZnJlc2ggdG9rZW4...",
    "expires_in": 3600,
    "user": {
      "id": "usr_123456",
      "email": "user@example.com",
      "full_name": "Juan Dela Cruz"
    }
  }
}
                    
GET
Get User Services
/api/v2/users/{user_id}/services

Retrieve all services accessible to a user across partner cities.

Headers:

Authorization: Bearer {access_token}
X-API-Key: {api_key}
                    

Frequently Asked Questions

How do I reset my password?

Click the "Forgot Password" link on the login page. Enter your registered email address and follow the instructions sent to your email. Password reset links are valid for 24 hours.

Can I use OneID in multiple cities?

Yes! OneID is designed for multi-city access. Once registered, you can add additional cities through your profile settings. Each city may require additional verification based on their requirements.

How secure is my data?

OneID uses industry-standard encryption (AES-256) for data at rest and TLS 1.3 for data in transit. We are compliant with the Philippine Data Privacy Act (DPA) and regularly undergo security audits.

What browsers are supported?

OneID supports Chrome 80+, Firefox 75+, Safari 13+, and Edge 80+. For optimal experience, ensure JavaScript is enabled and you're using an updated browser.

Integration Guide

This guide walks you through integrating your city's services with the OneID platform.

Prerequisites

  • API credentials (provided during onboarding)
  • HTTPS-enabled endpoint for webhooks
  • Compliance with OneID data standards

Integration Steps

1. Environment Setup


# Install OneID SDK
npm install @oneid/sdk

# Or using pip for Python
pip install oneid-sdk
                

2. Initialize SDK


// JavaScript/Node.js Example
const OneID = require('@oneid/sdk');

const oneid = new OneID({
  apiKey: 'YOUR_API_KEY',
  secret: 'YOUR_API_SECRET',
  environment: 'sandbox' // or 'production'
});

// Python Example
import oneid

client = oneid.Client(
    api_key='YOUR_API_KEY',
    api_secret='YOUR_API_SECRET',
    environment='sandbox'
)
                

3. Verify User Identity


// Verify a user's OneID
const user = await oneid.users.verify('oneid_123456');

if (user.verified) {
  // Grant access to city services
  console.log(`User ${user.full_name} is verified`);
}
                

Contact Support

Technical Support

Email: support@oneid.systems
Phone: (63956) 771-9415
Hours: Mon-Fri, 8AM-6PM PHT

For API issues, integration problems, and technical queries.

Partnership Inquiries

Email: partnerships@oneid.systems
Contact: City Partnership Team

For cities interested in joining the OneID network.

Emergency Contacts

For security incidents or system outages:

  • Security Incident: security@oneid.systems
  • System Outage: infra@oneid.systems
  • Legal/Compliance: legal@oneid.systems

Documentation version: 2.1.0 | Last updated: November 15, 2025

© 2025 OneID Platform. This documentation is licensed under Creative Commons Attribution 4.0 International.