Skip to content

SourceID API Overview

Welcome to the SourceID API documentation! The SourceID API provides a powerful and flexible way to integrate identity and access management capabilities into your applications. With SourceID, you can securely verify users and manage identities with ease.

Key Features

  • Authentication: Implement secure user verification using industry-standard protocols.
  • Identity Management: Group and customize verification types to suit your application's needs, giving you full control over how user verifications are structured and managed.
  • Scalability: Designed to handle high volumes of requests, ensuring reliability for applications of any size.
  • Developer-Friendly: Comprehensive API endpoints with detailed documentation to simplify integration.

Base URL

The SourceID API is available in two environments:

  • Sandbox: Use the following base URL for testing and development purposes:
    https://api.sbx.sourceid.tech

  • Production: The production URL will be provided by the support team. The API will be accessible at a URL similar to:
    https://api.sourceid.tech

Please ensure you are using the correct environment for your use case.

Sandbox Test Parameters

When testing the API in sandbox mode, you can use the following test parameters to simulate different response scenarios. These parameters are specifically designed for testing purposes and will return predictable responses.

Test Values for Different Scenarios

Parameter Type Valid Test Value Invalid Test Value Error Test Value
BVN 12345678901 00000000000 99999999999
NIN 12345678901 00000000000 99999999999
EMAIL [email protected] [email protected] [email protected]
PHONE 08012345678 00000000000 99999999999
TIN 12345678-00001 00000000-00000 99999999-99999
PASSPORT A00400000 B00000000 C99999999
RC_NUMBER RC123456 RC000000 RC999999
GHANA_CARD GHA123456789 GHA000000000 GHA999999999
ALIEN_ID ALN123456789 ALN000000000 ALN999999999
DRIVERS_LICENSE DL123456789 DL000000000 DL999999999
NATIONAL_ID NID123456789 NID000000000 NID999999999

Response Behavior

  • Valid Test Values: Will return a successful response with mock data
  • Invalid Test Values: Will return a validation error response
  • Error Test Values: Will simulate a server error response

Testing Tip

Use these test values during development to ensure your application handles all possible API response scenarios correctly.

Authentication

The SourceID API uses token-based authentication. You will need to include an access token in the x-api-key header of each request:

x-api-key: {API-KEY}

Getting Started

  1. Sign Up: Register for a SourceID account to obtain your API credentials.
  2. Obtain API KEY: Use your credentials to authenticate your API request.
  3. Explore Endpoints: Use the API to verify users.

Example Request

Here’s an example of a simple API request to fetch user details:

GET /v1/customer
Host: api.rd.usesourceid.com
x-api-key: {API-KEY}

Support

If you have any questions or need assistance, please contact our support team or refer to the detailed endpoint documentation.

Start building with the SourceID API today and unlock seamless identity and access management for your applications!