Authenticate a client
Authenticating with your client details to retrieve an access token using OAuth 2.0
Now that you have created a client when you want to perform an API request, you must first authenticate and receive an OpenCRVS access token. The token endpoint is OAuth 2.0 compliant.
Client access tokens are valid for a maximum of 10 minutes. After it expires you must authenticate again to retrieve a new access token.
You can use our Postman collections to test all client functionality. Postman is a tool you can download to test API access before building your integrations.
URL
Request payload
Example URL
Request Response
The token is a JWT containing with the following structure and must be included as a header:Authorization: Bearer <token>
in all future API requests. The content of an OpenCRVS access token looks like this: