To send and API request, you can create a service account (which is a bit like a user account) within your organisation. You can then set its permissions. For example, a service account might be permitted to issue certificates from a particular scheme.
Within a service account, you can create and name one or more API keys. These behave like passwords to authenticate the service account when it makes a request. The API key is presented as an X-Org-Token in the request header.
It is good practice to restrict the permissions of an API service account to only those that are needed. You should also keep your API keys secret and only share then with people you trust, for example an IT consultant setting up your APIs.
For logged in users, we have more detailed API schema information available here. We also have some other API endpoints available for other features, so do let us know if there is another specific task you'd like to perform and we'll be happy to help.
These service account APIs help to automate what would otherwise be a manual search for public information on BlockMark Registry:
Search public certificates of an organisation You can send either the exact (case-insensitive) organisation name or its BlockMark Registry ID (e.g. ’BlockMark Technologies Ltd or ‘GBLTD10821944’). The response will be a list of their public certificates and some associated information, if any. The results are paginated as 10 certificates per page. Each page that contains any results is charged as per the Advanced Service Account API service.
Search public organisations You can send a search string to return up to 10 close matches of an organisation name / trading name / previous name / name on associated (public) certificate. The response will be the organisation name, the organisation ID and the organisation profile page. Each page that contains any results is charged as per the Advanced Service Account API service.
[ARRIVING SOON] Confirm public certificate details based on the id number You can send the long identification number of a certificate. If the certificate exists and is public, the response will be the details of the certificate including the scheme name, name on the certificate, certification dates, status, etc. Each result is charged as per the Advanced Service Account API service.
These service account APIs help to further automate data synchronisation associated with your platform usage, improving what would otherwise be a manual process:
We'll be adding more services here soon...