LogoLogo
CommunityLicense
1.0.0
1.0.0
  • 🏠Home
  • 🏢Architecture
  • 📋Registration
    • Registration Interfaces
      • Mobile Registration App
      • Self Service Portal
      • API Interface
    • ID Verification
    • Registry
  • 🅿️Program Management
    • Eligibility Assessment
    • Enrolment
    • Deduplication
    • Disbursement Cycles
    • Entitlement
    • Verifiable Credentials
  • 💵Payment Management
    • Payment Cycles
    • Payment Batches
    • Payment Manager
    • Payment Types
      • In Account
      • Voucher
      • Cash
      • In Kind
    • Payment Rails
    • Accounting
      • Accounting
      • Reconciliation
      • Reports
  • Notifications
  • 📊Monitoring and Reporting
  • ⛓️Workflows
    • Cash grant scenario
    • On-Demand Assistance
  • 🔗Integrations
    • Mojaloop Integration
    • MOSIP Integration
      • ODK MTS Connector
      • Registry MTS Connector
      • Integration with e-Signet
  • ↔️API
  • ⚒️Testing
  • 👥Community
    • Contributing
    • Code of Conduct
  • 📗License
  • Guides
    • 📔How-To Guides
      • Create Program
      • Configure Proxy Mean Test
      • Create User and Assign Role
      • Create ODK Form
      • Create Portal Form
      • Provide Form Access to Field Agent
      • Download Form on ODK Collect
      • Register Offline
      • Self Register Online
      • Create MTS Connector
        • Create ODK MTS Connector
        • Create OpenG2P Registry MTS Connector
      • Enrol Registrants into Program
      • Create and Approve Disbursement Cycle
      • Prepare and Send Payment
      • Create Payment Manager under Program
      • Create Payment Manager Types
        • Create Payment Hub EE Payment Manager
        • Create Payment Interoperability Layer Payment Manager
        • Create Default Payment Manager
      • Create Eligibility Manager under Program
      • Create Eligibility Manager Types
        • Create Default Eligibility Manager
        • Create ID Document Eligibility Manager
        • Create Phone Number Eligibility Manager
      • Create Deduplication Manager under Program
      • Create Deduplication Manager Types
        • Create ID Deduplication Manager
        • Create Phone Number Deduplication
      • Create Notification Manager under Program
      • Create Notification Manager Types
        • Create SMS Notification Manager
        • Create Email Notification Manager
        • Create Fast2SMS Notification Manager
      • Send Notification to Individual Registrants
      • Configure ID Types
      • Map ODK Form
      • Integrate with MOSIP e-Signet
      • Map Self Service Portal Form
      • Install WireGuard App And Activate Tunnel
      • Install SmartScanner App
      • Submit Reimbursement Using the Service Provider Portal
    • 📙Documentation Guides
      • Creating Diagrams
      • Writing Guidelines For How-To Guides
    • 👩‍💻👩💻 👩💻 👩💻 👩💻 👩💻 Developer Zone
      • Getting Started
      • Technology Stack
      • About Github Repositories
        • openg2p-registry
        • openg2p-program
    • 📘Deployment Guide
      • Deployment on Kubernetes
        • K8s Cluster Requirements
        • K8s Cluster Setup
        • Rancher Server Setup
        • NFS Server Setup
        • SSL Certificates using Letsencrypt
      • Access to Deployed Setup
      • Post Install Configuration
      • Packaging OpenG2P Docker
Powered by GitBook
LogoLogo

Copyright © OpenG2P. This work is licensed under Creative Common Attribution (CC-BY-4.0) International license unless otherwise noted.

On this page
Export as PDF

API

PreviousIntegration with e-SignetNextTesting

Last updated 1 year ago

User authentication

Individual Registration

Group Registration

↔️

Search for partners :param partner_search_param: An instance of partner.search.param :return: List of partner.short.info

get
Authorizations
Query parameters
idintegerOptional
include_members_fullbooleanOptional
namestringOptional
Responses
200Success
application/json
400
One of the given parameter is not valid
401
The user is not authorized. Authentication is required
403
You don't have the permission to access the requested resource.
404
Requested resource not found
get
GET /api/v1/registry/group/ HTTP/1.1
Host: mec.openg2p.net
Accept: */*
[
  {
    "id": 1,
    "name": "text",
    "reg_ids": [
      {
        "id": 1,
        "id_type_as_str": "text",
        "value": "text",
        "expiry_date": "2025-05-16"
      }
    ],
    "is_group": true,
    "registration_date": "2025-05-16",
    "phone_number_ids": [
      {
        "id": 1,
        "phone_no": "text",
        "phone_sanitized": "text",
        "date_collected": "2025-05-16",
        "disabled": "2025-05-16"
      }
    ],
    "email": "text",
    "address": "text",
    "additional_g2p_info": "",
    "program_membership_ids": [
      {
        "program_id": 1,
        "state": "text",
        "enrollment_date": "2025-05-16",
        "exit_date": "2025-05-16"
      }
    ],
    "notification_preference": "none"
  }
]

Get partner's information

get
Authorizations
Path parameters
idinteger · int32Required
Responses
200Success
application/json
400
One of the given parameter is not valid
401
The user is not authorized. Authentication is required
403
You don't have the permission to access the requested resource.
404
Requested resource not found
get
GET /api/v1/registry/group/{id} HTTP/1.1
Host: mec.openg2p.net
Accept: */*
{
  "id": 1,
  "name": "text",
  "reg_ids": [
    {
      "id": 1,
      "id_type_as_str": "text",
      "value": "text",
      "expiry_date": "2025-05-16"
    }
  ],
  "is_group": true,
  "registration_date": "2025-05-16",
  "phone_number_ids": [
    {
      "id": 1,
      "phone_no": "text",
      "phone_sanitized": "text",
      "date_collected": "2025-05-16",
      "disabled": "2025-05-16"
    }
  ],
  "email": "text",
  "address": "text",
  "additional_g2p_info": "",
  "program_membership_ids": [
    {
      "program_id": 1,
      "state": "text",
      "enrollment_date": "2025-05-16",
      "exit_date": "2025-05-16"
    }
  ],
  "notification_preference": "none",
  "group_membership_ids": [
    {
      "id": 1,
      "individual": {
        "id": 1,
        "name": "text",
        "reg_ids": [
          {
            "id": 1,
            "id_type_as_str": "text",
            "value": "text",
            "expiry_date": "2025-05-16"
          }
        ],
        "is_group": false,
        "registration_date": "2025-05-16",
        "phone_number_ids": [
          {
            "id": 1,
            "phone_no": "text",
            "phone_sanitized": "text",
            "date_collected": "2025-05-16",
            "disabled": "2025-05-16"
          }
        ],
        "email": "text",
        "address": "text",
        "additional_g2p_info": "",
        "program_membership_ids": [
          {
            "program_id": 1,
            "state": "text",
            "enrollment_date": "2025-05-16",
            "exit_date": "2025-05-16"
          }
        ],
        "notification_preference": "none",
        "given_name": "text",
        "addl_name": "text",
        "family_name": "text",
        "gender": "text",
        "birthdate": "2025-05-16",
        "age": "text",
        "birth_place": "text"
      },
      "kind": [
        {
          "name": "text"
        }
      ]
    }
  ],
  "kind_as_str": "text",
  "is_partial_group": true
}

Search for partners :param partner_search_param: An instance of partner.search.param :return: List of partner.short.info

get
Authorizations
Query parameters
idintegerOptional
include_members_fullbooleanOptional
namestringOptional
Responses
200Success
application/json
400
One of the given parameter is not valid
401
The user is not authorized. Authentication is required
403
You don't have the permission to access the requested resource.
404
Requested resource not found
get
GET /api/v1/registry/group/search HTTP/1.1
Host: mec.openg2p.net
Accept: */*
[
  {
    "id": 1,
    "name": "text",
    "reg_ids": [
      {
        "id": 1,
        "id_type_as_str": "text",
        "value": "text",
        "expiry_date": "2025-05-16"
      }
    ],
    "is_group": true,
    "registration_date": "2025-05-16",
    "phone_number_ids": [
      {
        "id": 1,
        "phone_no": "text",
        "phone_sanitized": "text",
        "date_collected": "2025-05-16",
        "disabled": "2025-05-16"
      }
    ],
    "email": "text",
    "address": "text",
    "additional_g2p_info": "",
    "program_membership_ids": [
      {
        "program_id": 1,
        "state": "text",
        "enrollment_date": "2025-05-16",
        "exit_date": "2025-05-16"
      }
    ],
    "notification_preference": "none"
  }
]

Create a new Group :param group_info: An instance of the group info :return: An instance of partner.info

post
Authorizations
Body
namestringRequired
registration_datestring · dateOptional
is_groupbooleanOptionalDefault: true
emailstringOptional
addressstringOptional
additional_g2p_infoany ofOptional
object[]Optional
or
objectOptional
notification_preferencestringOptionalDefault: none
kindstringOptional
is_partial_groupbooleanOptional
Responses
200Success
application/json
400
One of the given parameter is not valid
401
The user is not authorized. Authentication is required
403
You don't have the permission to access the requested resource.
404
Requested resource not found
post
POST /api/v1/registry/group/ HTTP/1.1
Host: mec.openg2p.net
Content-Type: application/json
Accept: */*
Content-Length: 927

{
  "name": "text",
  "ids": [
    {
      "id_type": "text",
      "value": "text",
      "expiry_date": "2025-05-16"
    }
  ],
  "registration_date": "2025-05-16",
  "is_group": true,
  "phone_numbers": [
    {
      "phone_no": "text",
      "date_collected": "2025-05-16"
    }
  ],
  "email": "text",
  "address": "text",
  "additional_g2p_info": [
    {}
  ],
  "program_memberships": [
    {
      "name": "text",
      "enrollment_date": "2025-05-16"
    }
  ],
  "notification_preference": "none",
  "members": [
    {
      "name": "text",
      "given_name": "text",
      "addl_name": "text",
      "family_name": "text",
      "ids": [
        {
          "id_type": "text",
          "value": "text",
          "expiry_date": "2025-05-16"
        }
      ],
      "registration_date": "2025-05-16",
      "phone_numbers": [
        {
          "phone_no": "text",
          "date_collected": "2025-05-16"
        }
      ],
      "email": "text",
      "address": "text",
      "gender": "text",
      "birthdate": "2025-05-16",
      "birth_place": "text",
      "kind": [
        {
          "name": "text"
        }
      ],
      "is_group": false,
      "additional_g2p_info": [
        {}
      ],
      "program_memberships": [
        {
          "name": "text",
          "enrollment_date": "2025-05-16"
        }
      ],
      "notification_preference": "none"
    }
  ],
  "kind": "text",
  "is_partial_group": true
}
{
  "id": 1,
  "name": "text",
  "reg_ids": [
    {
      "id": 1,
      "id_type_as_str": "text",
      "value": "text",
      "expiry_date": "2025-05-16"
    }
  ],
  "is_group": true,
  "registration_date": "2025-05-16",
  "phone_number_ids": [
    {
      "id": 1,
      "phone_no": "text",
      "phone_sanitized": "text",
      "date_collected": "2025-05-16",
      "disabled": "2025-05-16"
    }
  ],
  "email": "text",
  "address": "text",
  "additional_g2p_info": "",
  "program_membership_ids": [
    {
      "program_id": 1,
      "state": "text",
      "enrollment_date": "2025-05-16",
      "exit_date": "2025-05-16"
    }
  ],
  "notification_preference": "none",
  "group_membership_ids": [
    {
      "id": 1,
      "individual": {
        "id": 1,
        "name": "text",
        "reg_ids": [
          {
            "id": 1,
            "id_type_as_str": "text",
            "value": "text",
            "expiry_date": "2025-05-16"
          }
        ],
        "is_group": false,
        "registration_date": "2025-05-16",
        "phone_number_ids": [
          {
            "id": 1,
            "phone_no": "text",
            "phone_sanitized": "text",
            "date_collected": "2025-05-16",
            "disabled": "2025-05-16"
          }
        ],
        "email": "text",
        "address": "text",
        "additional_g2p_info": "",
        "program_membership_ids": [
          {
            "program_id": 1,
            "state": "text",
            "enrollment_date": "2025-05-16",
            "exit_date": "2025-05-16"
          }
        ],
        "notification_preference": "none",
        "given_name": "text",
        "addl_name": "text",
        "family_name": "text",
        "gender": "text",
        "birthdate": "2025-05-16",
        "age": "text",
        "birth_place": "text"
      },
      "kind": [
        {
          "name": "text"
        }
      ]
    }
  ],
  "kind_as_str": "text",
  "is_partial_group": true
}
post
Responses
400
One of the given parameter is not valid
401
The user is not authorized. Authentication is required
403
You don't have the permission to access the requested resource.
404
Requested resource not found
post
POST /session/auth/login HTTP/1.1
Host: mec.openg2p.net
Accept: */*

No content

post
Authorizations
Responses
400
One of the given parameter is not valid
401
The user is not authorized. Authentication is required
403
You don't have the permission to access the requested resource.
404
Requested resource not found
post
POST /session/auth/logout HTTP/1.1
Host: mec.openg2p.net
Accept: */*

No content

  • User authentication
  • POST/login
  • POST/logout
  • Individual Registration
  • GET Search for partners :param partner_search_param: An instance of partner.search.param :return: List of partner.info
  • POST Create a new Individual :param individual_info: An instance of the individual info :return: An instance of partner info
  • GET Get partner's information
  • GET Search for partners :param partner_search_param: An instance of partner.search.param :return: List of partner.info
  • PATCH Update Individual Identification :param reg_id: An instance of the partner.reg_id :return: An instance of partner.reg_id
  • Group Registration
  • GET Search for partners :param partner_search_param: An instance of partner.search.param :return: List of partner.short.info
  • POST Create a new Group :param group_info: An instance of the group info :return: An instance of partner.info
  • GET Get partner's information
  • GET Search for partners :param partner_search_param: An instance of partner.search.param :return: List of partner.short.info

Search for partners :param partner_search_param: An instance of partner.search.param :return: List of partner.info

get
Authorizations
Query parameters
idintegerOptional
namestringOptional
Responses
200Success
application/json
400
One of the given parameter is not valid
401
The user is not authorized. Authentication is required
403
You don't have the permission to access the requested resource.
404
Requested resource not found
get

Get partner's information

get
Authorizations
Path parameters
idinteger · int32Required
Responses
200Success
application/json
400
One of the given parameter is not valid
401
The user is not authorized. Authentication is required
403
You don't have the permission to access the requested resource.
404
Requested resource not found
get

Search for partners :param partner_search_param: An instance of partner.search.param :return: List of partner.info

get
Authorizations
Query parameters
idintegerOptional
namestringOptional
Responses
200Success
application/json
400
One of the given parameter is not valid
401
The user is not authorized. Authentication is required
403
You don't have the permission to access the requested resource.
404
Requested resource not found
get
GET /api/v1/registry/individual/ HTTP/1.1
Host: mec.openg2p.net
Accept: */*
[
  {
    "id": 1,
    "name": "text",
    "reg_ids": [
      {
        "id": 1,
        "id_type_as_str": "text",
        "value": "text",
        "expiry_date": "2025-05-16"
      }
    ],
    "is_group": false,
    "registration_date": "2025-05-16",
    "phone_number_ids": [
      {
        "id": 1,
        "phone_no": "text",
        "phone_sanitized": "text",
        "date_collected": "2025-05-16",
        "disabled": "2025-05-16"
      }
    ],
    "email": "text",
    "address": "text",
    "additional_g2p_info": "",
    "program_membership_ids": [
      {
        "program_id": 1,
        "state": "text",
        "enrollment_date": "2025-05-16",
        "exit_date": "2025-05-16"
      }
    ],
    "notification_preference": "none",
    "given_name": "text",
    "addl_name": "text",
    "family_name": "text",
    "gender": "text",
    "birthdate": "2025-05-16",
    "age": "text",
    "birth_place": "text"
  }
]

Create a new Individual :param individual_info: An instance of the individual info :return: An instance of partner info

post
Authorizations
Body
namestringRequired
registration_datestring · dateOptional
is_groupbooleanOptionalDefault: false
emailstringOptional
addressstringOptional
additional_g2p_infoany ofOptional
object[]Optional
or
objectOptional
notification_preferencestringOptionalDefault: none
given_namestringOptional
addl_namestringOptional
family_namestringOptional
genderstringOptional
birthdatestring · dateOptional
birth_placestringOptional
Responses
200Success
application/json
400
One of the given parameter is not valid
401
The user is not authorized. Authentication is required
403
You don't have the permission to access the requested resource.
404
Requested resource not found
post
POST /api/v1/registry/individual/ HTTP/1.1
Host: mec.openg2p.net
Content-Type: application/json
Accept: */*
Content-Length: 487

{
  "name": "text",
  "ids": [
    {
      "id_type": "text",
      "value": "text",
      "expiry_date": "2025-05-16"
    }
  ],
  "registration_date": "2025-05-16",
  "is_group": false,
  "phone_numbers": [
    {
      "phone_no": "text",
      "date_collected": "2025-05-16"
    }
  ],
  "email": "text",
  "address": "text",
  "additional_g2p_info": [
    {}
  ],
  "program_memberships": [
    {
      "name": "text",
      "enrollment_date": "2025-05-16"
    }
  ],
  "notification_preference": "none",
  "given_name": "text",
  "addl_name": "text",
  "family_name": "text",
  "gender": "text",
  "birthdate": "2025-05-16",
  "birth_place": "text"
}
{
  "id": 1,
  "name": "text",
  "reg_ids": [
    {
      "id": 1,
      "id_type_as_str": "text",
      "value": "text",
      "expiry_date": "2025-05-16"
    }
  ],
  "is_group": false,
  "registration_date": "2025-05-16",
  "phone_number_ids": [
    {
      "id": 1,
      "phone_no": "text",
      "phone_sanitized": "text",
      "date_collected": "2025-05-16",
      "disabled": "2025-05-16"
    }
  ],
  "email": "text",
  "address": "text",
  "additional_g2p_info": "",
  "program_membership_ids": [
    {
      "program_id": 1,
      "state": "text",
      "enrollment_date": "2025-05-16",
      "exit_date": "2025-05-16"
    }
  ],
  "notification_preference": "none",
  "given_name": "text",
  "addl_name": "text",
  "family_name": "text",
  "gender": "text",
  "birthdate": "2025-05-16",
  "age": "text",
  "birth_place": "text"
}
GET /api/v1/registry/individual/{id} HTTP/1.1
Host: mec.openg2p.net
Accept: */*
{
  "id": 1,
  "name": "text",
  "reg_ids": [
    {
      "id": 1,
      "id_type_as_str": "text",
      "value": "text",
      "expiry_date": "2025-05-16"
    }
  ],
  "is_group": false,
  "registration_date": "2025-05-16",
  "phone_number_ids": [
    {
      "id": 1,
      "phone_no": "text",
      "phone_sanitized": "text",
      "date_collected": "2025-05-16",
      "disabled": "2025-05-16"
    }
  ],
  "email": "text",
  "address": "text",
  "additional_g2p_info": "",
  "program_membership_ids": [
    {
      "program_id": 1,
      "state": "text",
      "enrollment_date": "2025-05-16",
      "exit_date": "2025-05-16"
    }
  ],
  "notification_preference": "none",
  "given_name": "text",
  "addl_name": "text",
  "family_name": "text",
  "gender": "text",
  "birthdate": "2025-05-16",
  "age": "text",
  "birth_place": "text"
}
GET /api/v1/registry/individual/search HTTP/1.1
Host: mec.openg2p.net
Accept: */*
[
  {
    "id": 1,
    "name": "text",
    "reg_ids": [
      {
        "id": 1,
        "id_type_as_str": "text",
        "value": "text",
        "expiry_date": "2025-05-16"
      }
    ],
    "is_group": false,
    "registration_date": "2025-05-16",
    "phone_number_ids": [
      {
        "id": 1,
        "phone_no": "text",
        "phone_sanitized": "text",
        "date_collected": "2025-05-16",
        "disabled": "2025-05-16"
      }
    ],
    "email": "text",
    "address": "text",
    "additional_g2p_info": "",
    "program_membership_ids": [
      {
        "program_id": 1,
        "state": "text",
        "enrollment_date": "2025-05-16",
        "exit_date": "2025-05-16"
      }
    ],
    "notification_preference": "none",
    "given_name": "text",
    "addl_name": "text",
    "family_name": "text",
    "gender": "text",
    "birthdate": "2025-05-16",
    "age": "text",
    "birth_place": "text"
  }
]

Update Individual Identification :param reg_id: An instance of the partner.reg_id :return: An instance of partner.reg_id

patch
Authorizations
Body
id_typestringOptional
valuestringOptional
expiry_datestring · dateOptional
partner_idintegerRequired
Responses
200Success
application/json
400
One of the given parameter is not valid
401
The user is not authorized. Authentication is required
403
You don't have the permission to access the requested resource.
404
Requested resource not found
patch
PATCH /api/v1/registry/individual/updateIdentification HTTP/1.1
Host: mec.openg2p.net
Content-Type: application/json
Accept: */*
Content-Length: 75

{
  "id_type": "text",
  "value": "text",
  "expiry_date": "2025-05-16",
  "partner_id": 1
}
{
  "id": 1,
  "id_type_as_str": "text",
  "value": "text",
  "expiry_date": "2025-05-16",
  "partner_id": 1
}