New Access Request

Make a request to a user requesting access to their personal data

The access request endpoint (/business/new-access-request) enables you programmatically make a request to a user with respect to that user sharing his/her personal information with you. Please note that the user might approve or turn down your request which in any case you would be notified.

Endpoint

POST https://api.amala.cloud/v1/business/new-access-request

Requires two query parameters id and api_key. Note that duplicate requests (from a service provider to the same user) are not allowed.

Here's an example request:

curl -X POST "https://api.amala.cloud/v1/business/new-access-request?api_key=94c9a525f3d3ac72e9f953d0be4dfea1&id=JD123456"

Response:

Status: 201 CREATED

Body:

{
    "status": "Success",
    "data": {
        "requester": "Amala",
        "authorizer_first_name": "John",
        "authorizer_last_name": "Doe",
        "authorizer_amala_id": "JD447812",
        "status": "pending",
        "created": "2023-06-14T08:36:17.901273Z"
    }
}

Response status codes

201 - Created
400 - Bad Request
401 - Unauthorized
404 - Not Found
409 - Duplicate Request