Authentication

Authenticating with accountedfor API

Once you have obtained a Sandbox Authority, you will need to generate a sandbox API Key. The API Key format is as follows:

JWTBody = {
    credential_uuid: "4e8196b7-8d88-420a-86f0-5472ef4186b5",
    legal_entity_uuid: "04fba48a-aa8b-4efa-b618-1b0ea111d361",
    machine_credential: true,
    sandbox: true,
}

The full JWT will be of the form:

header.body.signature

and you may use this to call the Hello, World accountedfor endpoint:

https://api.accountedfor.com.au/machine/hello-world

With a GET HTTP Request, that should result in the following JSON Response:

{
    status: "ok",
    response_message: "Hello, Computer!",
    legal_entity_name: "Sandy Shores (Proposed Name)",
    credential_body: {
        credential_uuid: "4e8196b7-8d88-420a-86f0-5472ef4186b5",
        legal_entity_uuid: "04fba48a-aa8b-4efa-b618-1b0ea111d361",
        machine_credential: true,
        sandbox: true,
    },
}

This token response indicates the Legal Entity upon behalf of which your machine credential operates.

Once you have Received 200 OK from /hello-world you are ready to proceed to create your first Customer and Invoice

Visit the next section: Customers